opencode-a2a 1.0.0__tar.gz → 1.1.0__tar.gz

{opencode_a2a-1.0.0/src/opencode_a2a.egg-info → opencode_a2a-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-a2a
-Version: 1.0.0
+Version: 1.1.0
 Summary: OpenCode A2A runtime
 Author: liujuanjuan1984@Intelligent-Internet
 License-Expression: Apache-2.0

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/docs/compatibility.md

@@ -8,7 +8,7 @@ This document defines the compatibility promises `opencode-a2a` currently uphold
 - A2A SDK line: `1.x.y`
 - Supported A2A protocol line: `1.0`
 
-The repository currently pins one concrete SDK release in `pyproject.toml` within that v1 line. Upgrade the SDK deliberately rather than relying on floating dependency resolution.
+The repository currently pins one concrete SDK release in `pyproject.toml` within that v1 line. Upgrade the SDK deliberately rather than relying on floating dependency resolution. The SDK-owned core JSON-RPC method set follows that pinned release and is locked by repository tests so SDK upgrades trigger an explicit compatibility review.
 
 ## Contract Honesty
 
@@ -53,6 +53,7 @@ This repository still ships as an alpha project. Within that alpha line, these d
 - authenticated extended card and OpenAPI wire-contract metadata
 
 Changes to those surfaces should be treated as compatibility-sensitive and should include corresponding test updates.
+- provider-private session query params use one top-level request shape; the repository does not promise parallel nested `query.*` aliases for the same filters.
 
 Service-level behavior layered on top of those core methods should also be declared explicitly when interoperability depends on it. Current examples:
 

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/docs/extension-specifications.md

@@ -1,6 +1,6 @@
 # Extension Specifications
 
-This document is the stable specification index for the shared and provider-private extension URIs published by `opencode-a2a`. It is intentionally a compact URI/spec map, not the main consumer guide. For runtime behavior, request examples, and operational setup, see [`guide.md`](./guide.md). For compatibility promises and stability expectations, see [`compatibility.md`](./compatibility.md).
+This document is the stable specification index for extension URIs published by `opencode-a2a`. It is intentionally a compact URI/spec map, not the main consumer guide. For runtime behavior, request examples, and operational setup, see [`guide.md`](./guide.md). For compatibility promises and stability expectations, see [`compatibility.md`](./compatibility.md).
 
 ## Discovery Surface Note
 
@@ -15,6 +15,7 @@ Provider-private contract note:
 - `opencode.*` methods in this repository are deployment-specific provider extensions, not portable A2A baseline capabilities.
 - Shared `metadata.shared.*` contracts are intended to remain low-risk and transportable.
 - Compatibility and wire-contract URIs are descriptive metadata contracts, not activatable runtime capabilities.
+- URI path segments identify the contract, not its auth or disclosure tier; public-vs-extended disclosure is controlled by Agent Card and OpenAPI surfaces.
 
 ## SDK and Discovery Compatibility
 
@@ -26,20 +27,20 @@ Provider-private contract note:
 
 | Extension | Scope | Disclosure | URI | Section |
 | --- | --- | --- | --- | --- |
-| Shared Session Binding v1 | Shared request metadata | Public + extended | `urn:opencode-a2a:extension:shared:session-binding:v1` | [Shared Session Binding v1](#shared-session-binding-v1) |
-| Shared Model Selection v1 | Shared request metadata | Public + extended | `urn:opencode-a2a:extension:shared:model-selection:v1` | [Shared Model Selection v1](#shared-model-selection-v1) |
-| Shared Stream Hints v1 | Shared response/stream metadata | Public + extended | `urn:opencode-a2a:extension:shared:stream-hints:v1` | [Shared Stream Hints v1](#shared-stream-hints-v1) |
-| Shared Interactive Interrupt v1 | Shared JSON-RPC callback methods | Public + extended | `urn:opencode-a2a:extension:shared:interactive-interrupt:v1` | [Shared Interactive Interrupt v1](#shared-interactive-interrupt-v1) |
-| OpenCode Session Management v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:private:session-management:v1` | [OpenCode Session Management v1](#opencode-session-management-v1) |
-| OpenCode Provider Discovery v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:private:provider-discovery:v1` | [OpenCode Provider Discovery v1](#opencode-provider-discovery-v1) |
-| OpenCode Workspace Control v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:private:workspace-control:v1` | [OpenCode Workspace Control v1](#opencode-workspace-control-v1) |
-| OpenCode Interrupt Recovery v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:private:interrupt-recovery:v1` | [OpenCode Interrupt Recovery v1](#opencode-interrupt-recovery-v1) |
-| A2A Compatibility Profile v1 | Authenticated discovery metadata | Extended only | `urn:opencode-a2a:extension:private:compatibility-profile:v1` | [A2A Compatibility Profile v1](#a2a-compatibility-profile-v1) |
-| A2A Wire Contract v1 | Authenticated discovery metadata | Extended only | `urn:opencode-a2a:extension:private:wire-contract:v1` | [A2A Wire Contract v1](#a2a-wire-contract-v1) |
+| Shared Session Binding v1 | Shared request metadata | Public + extended | `urn:opencode-a2a:extension:session-binding:v1` | [Shared Session Binding v1](#shared-session-binding-v1) |
+| Shared Model Selection v1 | Shared request metadata | Public + extended | `urn:opencode-a2a:extension:model-selection:v1` | [Shared Model Selection v1](#shared-model-selection-v1) |
+| Shared Stream Hints v1 | Shared response/stream metadata | Public + extended | `urn:opencode-a2a:extension:stream-hints:v1` | [Shared Stream Hints v1](#shared-stream-hints-v1) |
+| Shared Interactive Interrupt v1 | Shared JSON-RPC callback methods | Public + extended | `urn:opencode-a2a:extension:interactive-interrupt:v1` | [Shared Interactive Interrupt v1](#shared-interactive-interrupt-v1) |
+| OpenCode Session Management v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:session-management:v1` | [OpenCode Session Management v1](#opencode-session-management-v1) |
+| OpenCode Provider Discovery v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:provider-discovery:v1` | [OpenCode Provider Discovery v1](#opencode-provider-discovery-v1) |
+| OpenCode Workspace Control v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:workspace-control:v1` | [OpenCode Workspace Control v1](#opencode-workspace-control-v1) |
+| OpenCode Interrupt Recovery v1 | Provider-private JSON-RPC methods | Extended only | `urn:opencode-a2a:extension:interrupt-recovery:v1` | [OpenCode Interrupt Recovery v1](#opencode-interrupt-recovery-v1) |
+| A2A Compatibility Profile v1 | Authenticated discovery metadata | Extended only | `urn:opencode-a2a:extension:compatibility-profile:v1` | [A2A Compatibility Profile v1](#a2a-compatibility-profile-v1) |
+| A2A Wire Contract v1 | Authenticated discovery metadata | Extended only | `urn:opencode-a2a:extension:wire-contract:v1` | [A2A Wire Contract v1](#a2a-wire-contract-v1) |
 
 ## Shared Session Binding v1
 
-Extension URI: `urn:opencode-a2a:extension:shared:session-binding:v1`
+Extension URI: `urn:opencode-a2a:extension:session-binding:v1`
 
 - Scope: shared A2A request metadata for rebinding to an existing upstream OpenCode session, plus negotiated response/task session metadata
 - Disclosure: public Agent Card and authenticated extended Agent Card
@@ -51,7 +52,7 @@ Extension URI: `urn:opencode-a2a:extension:shared:session-binding:v1`
 
 ## Shared Model Selection v1
 
-Extension URI: `urn:opencode-a2a:extension:shared:model-selection:v1`
+Extension URI: `urn:opencode-a2a:extension:model-selection:v1`
 
 - Scope: shared request-scoped model override for the main chat path
 - Disclosure: public Agent Card and authenticated extended Agent Card
@@ -64,20 +65,27 @@ Extension URI: `urn:opencode-a2a:extension:shared:model-selection:v1`
 
 ## Shared Stream Hints v1
 
-Extension URI: `urn:opencode-a2a:extension:shared:stream-hints:v1`
+Extension URI: `urn:opencode-a2a:extension:stream-hints:v1`
 
 - Scope: shared response/task/stream metadata for block identity, progress, and usage hints
 - Disclosure: public Agent Card and authenticated extended Agent Card
 - Activation: client requests the URI via `A2A-Extensions`; runtime emits shared metadata on streamed events and final task payloads
-- Runtime fields: `metadata.shared.stream`, `metadata.shared.progress`, `metadata.shared.usage`
-- Detailed-only correlation fields: `metadata.shared.stream.message_id` and `metadata.shared.stream.event_id` may be emitted for timeline stitching and diagnostics, but are not part of the minimum public consumer contract
+- Declared field map:
+  - `metadata.shared.stream.block_type`
+  - `metadata.shared.stream.sequence`
+  - `metadata.shared.progress.type`
+  - `metadata.shared.progress.status`
+  - `metadata.shared.usage.input_tokens`
+  - `metadata.shared.usage.output_tokens`
+  - `metadata.shared.usage.total_tokens`
+- Clients must not treat undeclared metadata under this namespace as part of the shared v1 contract
 - Dependencies: none declared by this version
 - Security boundary: this extension is observational metadata only; callback methods are defined by the separate shared interactive interrupt extension
 - Versioning: breaking changes require a new versioned URI
 
 ## Shared Interactive Interrupt v1
 
-Extension URI: `urn:opencode-a2a:extension:shared:interactive-interrupt:v1`
+Extension URI: `urn:opencode-a2a:extension:interactive-interrupt:v1`
 
 - Scope: shared JSON-RPC callback methods used to answer interactive permission and question interrupts
 - Disclosure: public Agent Card and authenticated extended Agent Card
@@ -90,7 +98,7 @@ Extension URI: `urn:opencode-a2a:extension:shared:interactive-interrupt:v1`
 
 ## OpenCode Session Management v1
 
-Extension URI: `urn:opencode-a2a:extension:private:session-management:v1`
+Extension URI: `urn:opencode-a2a:extension:session-management:v1`
 
 - Scope: OpenCode session read, mutation, and control methods exposed as A2A JSON-RPC extension methods
 - Disclosure: authenticated extended Agent Card only
@@ -102,7 +110,7 @@ Extension URI: `urn:opencode-a2a:extension:private:session-management:v1`
 
 ## OpenCode Provider Discovery v1
 
-Extension URI: `urn:opencode-a2a:extension:private:provider-discovery:v1`
+Extension URI: `urn:opencode-a2a:extension:provider-discovery:v1`
 
 - Scope: OpenCode provider and model discovery methods exposed as A2A JSON-RPC extension methods
 - Disclosure: authenticated extended Agent Card only
@@ -114,7 +122,7 @@ Extension URI: `urn:opencode-a2a:extension:private:provider-discovery:v1`
 
 ## OpenCode Workspace Control v1
 
-Extension URI: `urn:opencode-a2a:extension:private:workspace-control:v1`
+Extension URI: `urn:opencode-a2a:extension:workspace-control:v1`
 
 - Scope: OpenCode project, workspace, and worktree discovery/control methods exposed as A2A JSON-RPC extension methods
 - Disclosure: authenticated extended Agent Card only
@@ -126,7 +134,7 @@ Extension URI: `urn:opencode-a2a:extension:private:workspace-control:v1`
 
 ## OpenCode Interrupt Recovery v1
 
-Extension URI: `urn:opencode-a2a:extension:private:interrupt-recovery:v1`
+Extension URI: `urn:opencode-a2a:extension:interrupt-recovery:v1`
 
 - Scope: local interrupt recovery methods exposed as A2A JSON-RPC extension methods
 - Disclosure: authenticated extended Agent Card only
@@ -138,7 +146,7 @@ Extension URI: `urn:opencode-a2a:extension:private:interrupt-recovery:v1`
 
 ## A2A Compatibility Profile v1
 
-Extension URI: `urn:opencode-a2a:extension:private:compatibility-profile:v1`
+Extension URI: `urn:opencode-a2a:extension:compatibility-profile:v1`
 
 - Scope: authenticated discovery metadata describing protocol support, extension retention, and stable service behaviors
 - Disclosure: authenticated extended Agent Card only
@@ -150,7 +158,7 @@ Extension URI: `urn:opencode-a2a:extension:private:compatibility-profile:v1`
 
 ## A2A Wire Contract v1
 
-Extension URI: `urn:opencode-a2a:extension:private:wire-contract:v1`
+Extension URI: `urn:opencode-a2a:extension:wire-contract:v1`
 
 - Scope: authenticated discovery metadata describing supported methods, HTTP endpoints, extension URIs, and unified error semantics
 - Disclosure: authenticated extended Agent Card only

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/docs/guide.md

@@ -229,9 +229,7 @@ If one deployment works while another fails against the same upstream provider,
   - text chunks use a stable text artifact ID
   - reasoning chunks use a stable reasoning artifact ID
   - tool-call updates use a stable per-tool-part artifact ID when the upstream part is identifiable
-- `artifact.metadata.shared.stream.event_id` preserves the original cross-artifact stream timeline, even when different logical lanes use different artifact IDs.
-- `artifact.metadata.shared.stream.message_id` remains best-effort metadata: when upstream omits `message_id`, the service falls back to a stable request-scoped message identity.
-- `message_id` and `event_id` are advanced correlation fields: they help timeline stitching, deduplication, diagnostics, and advanced UI linking, but generic A2A consumers must not require them.
+- The shared stream-hints v1 contract only declares `block_type` and `sequence` under `artifact.metadata.shared.stream`.
 - `artifact.metadata.shared.stream.sequence` carries the canonical per-request stream sequence.
 - A final complete text snapshot is emitted only when streaming chunks did not already produce the same final text.
 - That final complete text snapshot uses `append=false` on the text artifact so clients and the task store can treat it as the canonical replace-on-finish version rather than another fragment.
@@ -242,13 +240,15 @@ If one deployment works while another fails against the same upstream provider,
 - If `application/json` is not accepted but `text/plain` is still accepted, those `tool_call` blocks are downgraded to stable compact JSON text so text-only clients retain the same observable state transitions.
 - When a request restricts `acceptedOutputModes`, the stream applies the same output filtering before persistence so later task snapshots do not re-expose filtered structured blocks.
 - Persistence is canonicalized separately from transport: stream subscribers still receive incremental artifact updates, while task-store persistence rewrites those updates into compact per-artifact snapshots so `GetTask` and terminal replay do not accumulate token-level fragments.
-- Final status event metadata may include normalized token usage at `metadata.shared.usage` with fields such as `input_tokens`, `output_tokens`, `total_tokens`, optional `reasoning_tokens`, optional `cache_tokens.read_tokens` / `cache_tokens.write_tokens`, and optional `cost`.
-- Progress metadata at `metadata.shared.progress` is emitted only when the client negotiated `urn:opencode-a2a:extension:shared:stream-hints:v1`; baseline streams do not emit duplicate generic `working` status updates just to carry progress hints.
+- The shared stream-hints v1 contract declares normalized usage fields `input_tokens`, `output_tokens`, and `total_tokens` at `metadata.shared.usage`.
+- Progress metadata at `metadata.shared.progress` is emitted only when the client negotiated `urn:opencode-a2a:extension:stream-hints:v1`; baseline streams do not emit duplicate generic `working` status updates just to carry progress hints.
 - Usage is extracted from documented info payloads and supported usage parts such as `step-finish`; non-usage parts with similar fields are ignored.
-- Interrupt events (`permission.asked` / `question.asked`) are mapped to `TaskStatusUpdateEvent(final=false, state=input-required)` with details at `metadata.shared.interrupt` when the client negotiated `urn:opencode-a2a:extension:shared:interactive-interrupt:v1`.
+- Interrupt events (`permission.asked` / `question.asked`) are mapped to `TaskStatusUpdateEvent(final=false, state=input-required)` with details at `metadata.shared.interrupt` when the client negotiated `urn:opencode-a2a:extension:interactive-interrupt:v1`.
 - Resolved interrupt events (`permission.replied` / `question.replied` / `question.rejected`) are emitted as `TaskStatusUpdateEvent(final=false, state=working)` with `metadata.shared.interrupt.phase=resolved` only when the same interactive interrupt extension is negotiated.
 - Duplicate or unknown resolved events are suppressed unless the matching request is still pending.
 - Non-streaming requests return a `Task` directly. When `configuration.returnImmediately=true`, the initial response is a working `Task` snapshot and completion continues in the background for later `GetTask` reads.
+- For successful non-streaming `message:send` completions, `Task.artifacts` is the canonical carrier for the assistant result text.
+- The terminal `Task.status.message` may carry a short completion status such as `Completed.`, but it does not duplicate the full result text.
 - Non-streaming `message:send` responses may include normalized token usage at `Task.metadata.shared.usage` with the same field schema.
 
 ## Auth, Limits, and Failure Contract
@@ -286,6 +286,7 @@ Current behavior:
 - `all_jsonrpc_methods` is the runtime truth for the current deployment.
 - The current SDK-owned core JSON-RPC surface includes `GetExtendedAgentCard` and `tasks/pushNotificationConfig/*`.
 - The current SDK-owned REST surface also includes `GET /v1/tasks` and the task push notification config routes.
+- The SDK-owned core JSON-RPC method set follows the pinned `a2a-sdk` release and is locked by repository tests; review that surface deliberately when upgrading the SDK.
 - Push notification config routes/methods are currently exposed only because they are part of the SDK-owned core surface. This runtime does not configure a push config store or push sender, so push notification operations remain unsupported. REST routes currently return HTTP `501`, while JSON-RPC methods surface SDK-owned unsupported error envelopes.
 
 When `A2A_ENABLE_SESSION_SHELL=false`, `opencode.sessions.shell` is omitted from `all_jsonrpc_methods` and exposed only through `extensions.conditionally_available_methods`.
@@ -458,7 +459,7 @@ Important distinction:
 
 Stable specification URI:
 
-- `urn:opencode-a2a:extension:shared:session-binding:v1`
+- `urn:opencode-a2a:extension:session-binding:v1`
 
 This section focuses on how clients should use the binding at runtime. For the stable URI record and public-vs-extended disclosure policy, see [`extension-specifications.md`](./extension-specifications.md).
 
@@ -505,7 +506,7 @@ curl -sS http://127.0.0.1:8000/v1/message:send \
 
 Stable specification URI:
 
-- `urn:opencode-a2a:extension:shared:model-selection:v1`
+- `urn:opencode-a2a:extension:model-selection:v1`
 
 This section focuses on request-scoped usage. For the stable URI record and public-vs-extended disclosure policy, see [`extension-specifications.md`](./extension-specifications.md).
 
@@ -558,7 +559,7 @@ curl -sS http://127.0.0.1:8000/v1/message:send \
 
 Stable specification URI:
 
-- `urn:opencode-a2a:extension:shared:stream-hints:v1`
+- `urn:opencode-a2a:extension:stream-hints:v1`
 
 This section focuses on how clients should interpret runtime metadata. For the stable URI record and public-vs-extended disclosure policy, see [`extension-specifications.md`](./extension-specifications.md).
 
@@ -571,24 +572,25 @@ Runtime payload:
 Shared runtime fields:
 
 - `metadata.shared.stream`
-  - block-level stream metadata such as `block_type`, `message_id`, `event_id`, and `sequence`
+  - declared shared v1 fields: `block_type` and `sequence`
 - `metadata.shared.usage`
-  - normalized usage data such as `input_tokens`, `output_tokens`, `total_tokens`, optional `reasoning_tokens`, optional `cache_tokens.read_tokens` / `cache_tokens.write_tokens`, and optional `cost`
+  - declared shared v1 fields: `input_tokens`, `output_tokens`, and `total_tokens`
+- clients must ignore undeclared fields when interpreting the shared v1 contract
 
 Consumer guidance:
 
 - Use the extension declaration to know the server emits canonical shared stream hints.
 - Use runtime metadata to render block timelines, progress states, and token usage.
-- Treat `message_id` and `event_id` as optional advanced correlation fields rather than baseline consumer requirements.
+- Do not rely on undeclared fields under `metadata.shared.stream` or `metadata.shared.usage` as stable contract surface.
 - Do not infer capability support only from seeing one runtime field on one response; rely on Agent Card discovery first when possible.
 
 Minimal stream semantics summary:
 
 - `text`, `reasoning`, and `tool_call` are emitted as canonical block types
 - `text` and `reasoning` blocks use text parts, while `tool_call` uses structured v1 part payloads
-- `message_id` and `event_id` preserve stable timeline identity where possible and are emitted only as optional advanced correlation hints
+- only `block_type` and `sequence` are part of the declared shared stream field map
 - `sequence` is the per-request canonical stream sequence
-- final task/status metadata may repeat normalized usage after the streaming phase ends
+- final task/status metadata may repeat declared usage totals
 
 ## OpenCode Session Management A2A Extension
 
@@ -621,11 +623,13 @@ Detailed contract discovery for this provider-private surface is intentionally a
 - Session list filters:
   - optional `directory`, `roots`, `start`, `search`, `limit`
   - optional `metadata.opencode.workspace.id`
+  - nested `query` objects are not supported; pass filters at the top level only
   - `directory` is normalized through the same workspace-boundary rules used by other OpenCode directory overrides before reaching upstream
   - when `metadata.opencode.workspace.id` is present, the adapter routes by workspace and ignores `directory`
 - Session message history filters:
   - optional `limit`, `before`
   - optional `metadata.opencode.workspace.id`
+  - nested `query` objects are not supported; pass filters at the top level only
   - `before` is an opaque cursor for loading older messages and is only supported on `opencode.sessions.messages.list`
 - Mutation methods:
   - `opencode.sessions.fork`

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/scripts/README.md

@@ -11,7 +11,7 @@ Executable scripts live in this directory. This file is the entry index for the
 
 ## Other Scripts
 
-- [`doctor.sh`](./doctor.sh): primary local development regression entrypoint (uv sync + dependency compatibility + lint + mypy + tests + coverage + built-wheel smoke test)
+- [`doctor.sh`](./doctor.sh): primary local development regression entrypoint with explicit fix/verify/package phases (uv sync + dependency compatibility + lint + mypy + tests + coverage + built-wheel smoke test)
 - [`conformance.sh`](./conformance.sh): local/manual external A2A conformance experiment entrypoint; caches the official TCK, can launch a dummy-backed local SUT, and preserves raw artifacts under `run/conformance/`
 - [`dependency_health.sh`](./dependency_health.sh): development dependency review entrypoint (`sync`/`pip check` + outdated + dev audit), while blocking CI/publish audits focus on runtime dependencies
 - [`check_coverage.py`](./check_coverage.py): enforces the overall coverage floor and per-file minimums for critical modules
@@ -23,5 +23,6 @@ Executable scripts live in this directory. This file is the entry index for the
 
 - `doctor.sh` and `dependency_health.sh` intentionally remain separate entrypoints and share common prerequisites through [`health_common.sh`](./health_common.sh).
 - `doctor.sh` covers the default local validation baseline, while `dependency_health.sh` remains focused on standalone dependency review and audit flow.
+- `doctor.sh` stops early when `pre-commit` rewrites files so you can review the changes and rerun `doctor.sh` from the updated worktree.
 - [`.github/dependabot.yml`](../.github/dependabot.yml) prefers a single weekly grouped Dependabot PR for `uv`, while `dependency_health.sh` remains the explicit review/audit entrypoint.
 - External conformance experiments remain intentionally separate from the default regression path. See [`../docs/conformance.md`](../docs/conformance.md).

opencode_a2a-1.1.0/scripts/doctor.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# shellcheck source=./health_common.sh
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/health_common.sh"
+
+doctor_repo_state_fingerprint() {
+  {
+    git diff --no-ext-diff --binary --cached -- .
+    git diff --no-ext-diff --binary -- .
+    while IFS= read -r -d '' path; do
+      printf 'untracked %s\n' "$path"
+      cat "$path"
+      printf '\n'
+    done < <(git ls-files --others --exclude-standard -z)
+  } | git hash-object --stdin
+}
+
+run_doctor_fix_phase() {
+  local pre_commit_exit_code=0
+  local repo_state_before
+  local repo_state_after
+
+  echo "[doctor] run fix phase"
+  repo_state_before="$(doctor_repo_state_fingerprint)"
+
+  if uv run pre-commit run --all-files; then
+    pre_commit_exit_code=0
+  else
+    pre_commit_exit_code=$?
+  fi
+
+  repo_state_after="$(doctor_repo_state_fingerprint)"
+  if [[ "$repo_state_before" != "$repo_state_after" ]]; then
+    echo "[doctor] pre-commit modified files; review the changes and rerun doctor" >&2
+    exit 1
+  fi
+
+  if (( pre_commit_exit_code != 0 )); then
+    exit "$pre_commit_exit_code"
+  fi
+}
+
+run_doctor_verify_phase() {
+  echo "[doctor] run verify phase"
+
+  echo "[doctor] run type checks"
+  uv run mypy src/opencode_a2a
+
+  echo "[doctor] run tests"
+  uv run pytest
+
+  echo "[doctor] enforce coverage policy"
+  uv run python ./scripts/check_coverage.py
+}
+
+run_doctor_package_phase() {
+  echo "[doctor] run package phase"
+
+  echo "[doctor] build release artifacts"
+  rm -f dist/opencode_a2a-*.whl dist/opencode_a2a-*.tar.gz
+  uv build --no-sources
+
+  echo "[doctor] smoke test built wheel"
+  bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a-*.whl
+}
+
+run_shared_repo_health_prerequisites "doctor"
+run_doctor_fix_phase
+run_doctor_verify_phase
+run_doctor_package_phase

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/src/opencode_a2a/client/config.py

@@ -74,13 +74,13 @@ def _normalize_transport(value: str) -> str:
     normalized = value.strip().lower()
     if normalized in {"jsonrpc", "json-rpc", "json_rpc"}:
         return "JSONRPC"
-    if normalized in {"http+json", "http_json", "http-json", "httpjson", "http+json+"}:
+    if normalized in {"http+json", "http-json", "http_json"}:
         return "HTTP+JSON"
     if normalized in {"grpc"}:
         return "GRPC"
     if not normalized:
         return "JSONRPC"
-    return value.strip()
+    raise ValueError(f"supported_transports contains unsupported transport {value!r}")
 
 
 def _parse_transports(

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/src/opencode_a2a/client/error_mapping.py

@@ -238,10 +238,7 @@ def map_agent_card_error(
 ) -> A2AClientError:
     if isinstance(exc, AgentCardResolutionError):
         if exc.status_code is not None:
-            return _attach_http_status(
-                map_client_error("agent-card/fetch", SDKClientError(str(exc))),
-                exc.status_code,
-            )
+            return map_http_error("agent-card/fetch", exc)
         return A2APeerProtocolError(
             "Remote A2A peer returned an invalid agent card payload",
             error_code="invalid_agent_card",

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/src/opencode_a2a/client/payload_text.py

@@ -2,8 +2,8 @@
 
 from __future__ import annotations
 
-from collections.abc import Mapping
-from typing import Any
+from collections.abc import Iterable, Mapping
+from typing import Any, cast
 
 from a2a.types import Message, Part, StreamResponse
 from google.protobuf.json_format import MessageToDict
@@ -11,8 +11,13 @@ from google.protobuf.message import Message as ProtoMessage
 
 
 def extract_text(payload: Any) -> str | None:
+    def is_item_sequence(value: Any) -> bool:
+        return isinstance(value, Iterable) and not isinstance(
+            value, (str, bytes, bytearray, Mapping)
+        )
+
     def extract_from_iterable(items: Any) -> str | None:
-        if not isinstance(items, (list, tuple)):
+        if not is_item_sequence(items):
             return None
         for item in items:
             extracted = extract_text(item)
@@ -21,7 +26,7 @@ def extract_text(payload: Any) -> str | None:
         return None
 
     def extract_from_parts(parts: Any) -> str | None:
-        if not isinstance(parts, (list, tuple)):
+        if not is_item_sequence(parts):
             return None
         collected: list[str] = []
         for part in parts:
@@ -47,14 +52,14 @@ def extract_text(payload: Any) -> str | None:
     def extract_from_mapping(payload_map: Mapping[str, Any]) -> str | None:
         for key in (
             "content",
-            "message",
-            "messages",
             "result",
-            "status",
             "text",
             "parts",
             "artifact",
             "artifacts",
+            "message",
+            "messages",
+            "status",
             "history",
             "events",
             "root",
@@ -76,7 +81,7 @@ def extract_text(payload: Any) -> str | None:
                 artifact_text = extract_text(value)
                 if artifact_text:
                     return artifact_text
-            if isinstance(value, (list, tuple)) and key in (
+            if is_item_sequence(value) and key in (
                 "messages",
                 "artifacts",
                 "history",
@@ -90,7 +95,7 @@ def extract_text(payload: Any) -> str | None:
                 return nested_text
         return None
 
-    if isinstance(payload, (list, tuple)):
+    if is_item_sequence(payload):
         return extract_from_iterable(payload)
 
     if isinstance(payload, Message):
@@ -110,21 +115,30 @@ def extract_text(payload: Any) -> str | None:
     if isinstance(payload, str):
         return payload.strip() or None
 
-    status_payload = getattr(payload, "status", None)
-    if status_payload is not None:
-        text = extract_text(status_payload)
+    artifact_payload = getattr(payload, "artifact", None)
+    if artifact_payload is not None:
+        text = extract_text(artifact_payload)
         if text:
             return text
 
+    artifacts = getattr(payload, "artifacts", None)
+    if is_item_sequence(artifacts):
+        for artifact in cast(Iterable[Any], artifacts):
+            artifact_parts = getattr(artifact, "parts", None)
+            if is_item_sequence(artifact_parts):
+                text = extract_from_parts(artifact_parts)
+                if text:
+                    return text
+
     message_payload = getattr(payload, "message", None)
     if message_payload is not None:
         text = extract_text(message_payload)
         if text:
             return text
 
-    artifact_payload = getattr(payload, "artifact", None)
-    if artifact_payload is not None:
-        text = extract_text(artifact_payload)
+    status_payload = getattr(payload, "status", None)
+    if status_payload is not None:
+        text = extract_text(status_payload)
         if text:
             return text
 
@@ -135,21 +149,12 @@ def extract_text(payload: Any) -> str | None:
             return text
 
     history = getattr(payload, "history", None)
-    if isinstance(history, (list, tuple)) and history:
-        for item in reversed(history):
+    if is_item_sequence(history) and history:
+        for item in reversed(list(cast(Iterable[Any], history))):
             text = extract_text(item)
             if text:
                 return text
 
-    artifacts = getattr(payload, "artifacts", None)
-    if isinstance(artifacts, (list, tuple)):
-        for artifact in artifacts:
-            artifact_parts = getattr(artifact, "parts", None)
-            if isinstance(artifact_parts, (list, tuple)):
-                text = extract_from_parts(artifact_parts)
-                if text:
-                    return text
-
     text = extract_from_parts(getattr(payload, "parts", None))
     if text:
         return text

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/src/opencode_a2a/contracts/extensions/catalog.py

@@ -139,11 +139,6 @@ SESSION_METHOD_CONTRACTS: dict[str, SessionQueryMethodContract] = {
             "roots",
             "start",
             "search",
-            "query.limit",
-            "query.directory",
-            "query.roots",
-            "query.start",
-            "query.search",
         ),
         unsupported_params=SESSION_QUERY_PAGINATION_UNSUPPORTED,
         result_fields=("items",),
@@ -158,8 +153,6 @@ SESSION_METHOD_CONTRACTS: dict[str, SessionQueryMethodContract] = {
             "limit",
             "before",
             OPENCODE_WORKSPACE_METADATA_FIELD,
-            "query.limit",
-            "query.before",
         ),
         unsupported_params=SESSION_QUERY_PAGINATION_UNSUPPORTED,
         result_fields=("items", "next_cursor"),

{opencode_a2a-1.0.0 → opencode_a2a-1.1.0}/src/opencode_a2a/contracts/extensions/identifiers.py

@@ -15,62 +15,16 @@ OPENCODE_WORKSPACE_METADATA_FIELD = "metadata.opencode.workspace.id"
 EXTENSION_URI_NAMESPACE = "urn:opencode-a2a:extension:"
 EXTENSION_SPEC_INDEX_DOCUMENT_PATH = "docs/extension-specifications.md"
 
-
-def _extension_uri(*segments: str) -> str:
-    normalized_segments = [segment.strip("/") for segment in segments if segment.strip("/")]
-    return f"{EXTENSION_URI_NAMESPACE}{':'.join(normalized_segments)}"
-
-
-SESSION_BINDING_EXTENSION_URI = _extension_uri(
-    "shared",
-    "session-binding",
-    "v1",
-)
-MODEL_SELECTION_EXTENSION_URI = _extension_uri(
-    "shared",
-    "model-selection",
-    "v1",
-)
-STREAMING_EXTENSION_URI = _extension_uri(
-    "shared",
-    "stream-hints",
-    "v1",
-)
-SESSION_MANAGEMENT_EXTENSION_URI = _extension_uri(
-    "private",
-    "session-management",
-    "v1",
-)
-PROVIDER_DISCOVERY_EXTENSION_URI = _extension_uri(
-    "private",
-    "provider-discovery",
-    "v1",
-)
-INTERRUPT_CALLBACK_EXTENSION_URI = _extension_uri(
-    "shared",
-    "interactive-interrupt",
-    "v1",
-)
-INTERRUPT_RECOVERY_EXTENSION_URI = _extension_uri(
-    "private",
-    "interrupt-recovery",
-    "v1",
-)
-WORKSPACE_CONTROL_EXTENSION_URI = _extension_uri(
-    "private",
-    "workspace-control",
-    "v1",
-)
-COMPATIBILITY_PROFILE_EXTENSION_URI = _extension_uri(
-    "private",
-    "compatibility-profile",
-    "v1",
-)
-WIRE_CONTRACT_EXTENSION_URI = _extension_uri(
-    "private",
-    "wire-contract",
-    "v1",
-)
+SESSION_BINDING_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}session-binding:v1"
+MODEL_SELECTION_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}model-selection:v1"
+STREAMING_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}stream-hints:v1"
+SESSION_MANAGEMENT_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}session-management:v1"
+PROVIDER_DISCOVERY_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}provider-discovery:v1"
+INTERRUPT_CALLBACK_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}interactive-interrupt:v1"
+INTERRUPT_RECOVERY_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}interrupt-recovery:v1"
+WORKSPACE_CONTROL_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}workspace-control:v1"
+COMPATIBILITY_PROFILE_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}compatibility-profile:v1"
+WIRE_CONTRACT_EXTENSION_URI = f"{EXTENSION_URI_NAMESPACE}wire-contract:v1"
 PUBLIC_EXTENSION_URIS: tuple[str, ...] = (
     SESSION_BINDING_EXTENSION_URI,
     MODEL_SELECTION_EXTENSION_URI,