Skip to content

docs(adr): record coding-agent target runtime contract#1655

Merged
christso merged 2 commits into
mainfrom
coding-runtime-adr
Jul 5, 2026
Merged

docs(adr): record coding-agent target runtime contract#1655
christso merged 2 commits into
mainfrom
coding-runtime-adr

Conversation

@christso

@christso christso commented Jul 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

Future coding-agent provider work now has a durable ADR for the runtime contract instead of relying on implementation plans, Bead notes, or draft PR context. The decision locks the authored target shape around id, provider, runtime, and config; keeps host runtime as the first supported path; and records SDK transports as explicit advanced providers that run inside an AgentV child-runner process on the host.

The ADR also separates current generic Docker sandbox support from future sandbox-aware coding-agent runners, documents why AgentV diverges from Promptfoo's target identity conventions, and records the beta decision to remove provider: copilot-log from authored live target YAML in favor of provider-agnostic replay/import work.

Related

Related: EntityProcess/agentv-beads#20
Beads: av-y7eq.10, av-t2o5, av-y7eq.9, av-t2o5.2

Validation

  • git diff --check
  • bun run beads:check (0 errors; existing warning that .beads/config.yaml is absent in this worktree)
  • node_modules/.bin/biome check docs/adr/0018-coding-agent-target-runtime-contract.md (not applicable: Biome processed 0 Markdown files)
  • GitHub Actions on e3344f5f: Build, Check Links, Cloudflare Pages, Lint, Test, Typecheck, Validate Evals, and Validate Marketplace passed

GitHub Actions is the authoritative merge gate.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 5, 2026

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: e3344f5
Status: ✅  Deploy successful!
Preview URL: https://78bd00d6.agentv.pages.dev
Branch Preview URL: https://coding-runtime-adr.agentv.pages.dev

View logs

@christso christso merged commit 2c94ce8 into main Jul 5, 2026
8 checks passed
@christso christso deleted the coding-runtime-adr branch July 5, 2026 03:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant