[tbrandenburg]

变更范围

增加显式选择的 OpenCode V2 session-transport 切片，V1 仍为默认；不自动探测，也不 fallback。

• 实现 V2 /api/info、/api/location 及 session create/get/list 的 native envelope。
• V2 A2A prompt execution 在创建 session 或提交 prompt 前失败；streaming 声明为关闭。
• 以统一 API-version capability policy 隐藏 V2 Agent Card/OpenAPI 中不可用的 extension，直接调用 opencode.* 或 shared interrupt extension 返回 -32601，不访问 upstream HTTP。
• 带入 refactor: add typed upstream protocol adapter boundary #551 的 coordinator 安全修复：非成功 outcome 不能触发工具/成功路径，无效 submission 不能回退重发。

关联议题：tbrandenburg#3 ；capability gate：tbrandenburg#6 。

堆叠与限制

保持 Draft，依赖 #551。 当前对 upstream main 的 diff 包含 adapter 准备切片，不是独立 diff；应先审查 #551，不能先合并本 PR。本次只追加提交，未 rebase、force push 或合并。

不声明 V2 A2A model execution、task-scoped cancellation、permission/form intervention、request-scoped model override 或完整 V2 兼容性。

当前 PR head 验证

验证 head：cc8470d7b631b00e580de741324d5956ef673780。

• bash ./scripts/doctor.sh：通过；890 passed，coverage 92.88%。包含 locked dependency sync、兼容性检查、pre-commit、mypy、pytest、coverage policy、hash-locked build 和 built-wheel smoke。
• uv run --all-extras pytest --no-cov tests/execution/test_streaming_output_contract_core.py -k 'non_completed_outcome_without_error_metadata_is_terminal_before_tools or invalid_prompt_submission_fails_without_legacy_resend'：4 passed。
• uv run --all-extras pytest --no-cov tests/jsonrpc/test_jsonrpc_unsupported_method.py tests/contracts/test_extension_contract_consistency.py tests/server/test_agent_card.py tests/execution/test_v2_prompt_failfast.py tests/upstream/test_v2_upstream_adapter.py：118 passed，覆盖 capability 一致性、禁用方法零 upstream HTTP、消息 fail-fast 和 V2 session transport。

移植过程记录：capability gate 仅有两处文档冲突，保留本切片范围，没有带入后续 correlation 调查文档。首次 doctor 为 1 failed / 889 passed：新增测试依赖后续集成分支的错误文案；已将断言适配为本切片现有 fail-closed 文案，保留失败终态、拒绝 streaming 和零 upstream HTTP 断言。随后一次 doctor 因 formatter 自动修改此断言而停止，审查并追加格式提交后，上述精确 head 的完整 doctor 通过。

以上结果来自本 PR 的精确 head，不借用集成分支结果。本次未运行 live OpenCode/model smoke 或 conformance。

[tbrandenburg]

Related to #550 (OpenCode V2 server API compatibility). Non-closing reference; this PR alone does not deliver complete V2 support.