PARSE · VALIDATE · CORRELATE

Message examples: pass and fail a concrete fixture

Edit a real request document. Follow validation, decoded payloads, a local handler and response-id matching.

Offline protocol fixture · 60-second inspection at 1×

Editable request

Response received by the client

Local receiver effects

Your experiment

The opening text part contains a number. Repair it, replay the same source and verify one local receipt. Then mismatch the response id and explain why executing a handler does not establish client acceptance.

Use Play for a full minute at 1×, Pause to inspect a gate, or Next gate for manual review. The timeline and speed control operate on this exact validation trace. Editing an input resets the inspection without autoplay.

Validated part inspector

Version-pinned teaching subset: JSON-RPC 2.0 and the A2A v0.3.0 message/part shape. This is not a complete A2A SDK or a conformance validator. Only message/send is dispatched; batches, streaming, tasks, authentication and extensions are not implemented. The notification example teaches the generic JSON-RPC no-response rule, not a supported A2A call shape. Unknown fields are not a full-schema validation. File bytes use canonical padded Base64; URI references use a strict reserved example host and are never fetched. MIME labels are not content-sniffed. The handler creates only an in-memory teaching receipt. Sixty seconds is inspection time, not measured latency. JSON-RPC specification · Pinned A2A message reference · Official AICassindra articles.

Turn an example into a negative test

Begin with Valid request and preserve its editor text in your notes. Change the text field of its text part from a string to the number 42. The request remains valid JSON but fails message validation with -32602. Restore the string and enable Inject server fault: validation now passes before the handler returns -32603. Restore the example again to obtain a result. Comparing these three traces is more informative than checking that a copied example merely parses, because each failure belongs to a different contract boundary.

Edit an actual request document

Fixture loads a complete JSON example into the request editor. Selecting another fixture replaces your edits. The editor then becomes the source of truth: parsing, envelope validation, method dispatch and part validation all examine its current text. Keep the JSON-RPC request id separate from the nested messageId. Response correlation checks the former and preserves its type; neither identifier is a security credential or an implemented idempotency key in this lesson.

Apply a local validation policy

Per-part byte limit counts UTF-8 text, serialized JSON-object data, or decoded Base64 file bytes. It is not a limit on total request size or MIME content validation. Allow URI references permits only the fixture reserved HTTPS host and never fetches the linked content, whose size is consequently unknown. Mismatch response id corrupts correlation after handling; Inject server fault fails the local handler before a receipt is created. These toggles isolate different failure boundaries rather than simulating remote infrastructure.

Follow the earliest failed gate

Play presents the validation trace over a minute; Pause, Next gate, Restart, Speed and the timeline provide controlled inspection. An input edit resets the inspection. If a gate fails, later dispatch or handler stages are not run, but an error response can still be inspected. A successful local handler with a mismatched response id is not accepted by the client. Removing the top-level id illustrates a generic JSON-RPC notification without a response; it must not be treated as confirmed success or a fully supported A2A notification contract.

Views are my own and do not represent any employer, past or present.

Search