Skip to content

Commit bac3380

Browse files
committed
docs(agents): sharpen the compat-mapper citation
a2aproject#1403 is an error-handling divergence on the v0.3 REST surface rather than a field-mapping one, so describe it as the second shape the same gRPC-vs- JSON-RPC/REST split produces instead of implying it dropped a field. Signed-off-by: andy <linux2011@qq.com>
1 parent 2ab36de commit bac3380

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

  • .agents/skills/task-state-invariants

‎.agents/skills/task-state-invariants/SKILL.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,10 @@ Each claim is anchored to current `main`. Re-read the file before quoting.
7676
7. **v0.3 compat has two independent mappers.** `compat/v0_3/proto_utils.py`
7777
serves the gRPC surface and `compat/v0_3/conversions.py` serves JSON-RPC
7878
and REST. A field mapped in one and not the other appears and disappears
79-
by transport — see #1276 (status timestamp dropped on gRPC only) and
80-
#1403. Any compat field change must touch and test both.
79+
by transport — see #1276 (status timestamp mapped for JSON-RPC/REST but
80+
dropped on gRPC). The same split bites error handling rather than fields:
81+
early failures on v0.3 REST streams had to be fixed separately in #1403.
82+
Any compat change must touch and test both mappers.
8183
8. **Continuation identity is inferred, not invented.** With only
8284
`message.task_id`, the SDK must reuse the task's `context_id`
8385
(A2A v1.0 §3.4.3); generating a fresh one makes events disagree with the

0 commit comments

Comments
 (0)