[TC-07] Add runtime loop orchestration and transcript replay

[tanaysd]

Summary

• add a runtime package exposing AgentRuntime, SessionTranscript, and AgentState
• track streaming state transitions, transcript snapshots, and lifecycle logging
• add deterministic runtime loop tests covering replay, metadata, and cancellation

Testing

• pytest tests/test_runtime_loop.py

Closes #29

https://chatgpt.com/codex/tasks/task_e_68faa0020bac8322b9968e71e03362f0

[github-actions]

Review Brief

Task

• Task Card: TC-07
• Linked Issue: Not detected

Risk

• Level: high
• Changed files: 13

Scope

• src/foundry/runtime (3 files)
• tests (3 files)
• tests/harness (2 files)
• .github/workflows (1 file)
• scripts/ci (1 file)
• src/foundry/core/adapters (1 file)
• tests/adapters (1 file)
• tests/fixtures (1 file)

Coverage

Coverage report not found. Run pytest with --cov to generate coverage.xml.

API changes

Removed functions

• foundry.core.adapters.openai.create_openai_stream: (client: Any, payload: Mapping[str, Any]) -> Any

Added classes

• foundry.runtime.loop.AgentRuntime (methods: aclose, closed, on_complete, on_event, on_tool)
• foundry.runtime.loop.SessionTranscript (methods: events, record, replay, states)
• foundry.runtime.state.AgentState (methods: snapshot)

Contracts

No contract tests changed. High-risk change — run pytest tests/contracts for safety.

Notes

• ℹ️ coverage.xml not found; coverage section includes guidance.

[github-actions]

Review Brief

Task

• Task Card: TC-07
• Linked Issue: [TC-07] Runtime Loop: Agent Orchestration Engine #29

Risk

• Level: high
• Changed files: 13

Scope

• src/foundry/runtime (3 files)
• tests (3 files)
• tests/harness (2 files)
• .github/workflows (1 file)
• scripts/ci (1 file)
• src/foundry/core/adapters (1 file)
• tests/adapters (1 file)
• tests/fixtures (1 file)

Coverage

Coverage report not found. Run pytest with --cov to generate coverage.xml.

API changes

Removed functions

• foundry.core.adapters.openai.create_openai_stream: (client: Any, payload: Mapping[str, Any]) -> Any

Added classes

• foundry.runtime.loop.AgentRuntime (methods: aclose, closed, on_complete, on_event, on_tool)
• foundry.runtime.loop.SessionTranscript (methods: events, record, replay, states)
• foundry.runtime.state.AgentState (methods: snapshot)

Contracts

No contract tests changed. High-risk change — run pytest tests/contracts for safety.

Notes

• ℹ️ coverage.xml not found; coverage section includes guidance.