ASSEMBLE · VERIFY · INSPECT
A2A artifact assembly: append, replace and finish
Follow exact content through assembly, a conditional write and a scoped version read.
Your experiment
Compare append enabled and disabled with three text chunks. The first chunk replaces the empty buffer; later chunks must append to preserve the entire text. Remove the final marker: this application refuses to store a partial artifact.
Play inspects the whole trace over 60 seconds at 1×. Pause, step, restart or change speed. Parameters reset the trace without autoplay. Teaching time is not network, storage or SDK latency.
Exact visible content
Decision trace
Complete state inspector
Artifact event fields illustrate the pinned A2A v0.3 shape, not full protocol conformance. Storage is a separate application policy: a final marker is required before commit; expected generation protects the current live version; generation 0 cannot replace this already-existing object. File input is encoded text, not an upload. The byte limit counts decoded or serialized content, not base64/wire overhead. Data uses JSON parsing/serialization and does not preserve whitespace or duplicate keys. Version retention and read grants are explicit fixture policies, not full ADK/GCS semantics. No IAM, encryption, malware scanning, checksums, lifecycle rules or remote durability is implemented. All records, objects and identities are fictional. No credentials, files, cloud services or external model are accessed. Pinned A2A v0.3 reference · Cloud Storage preconditions · Official AICassindra articles.
Why assembly order matters
This experiment separates receiving parts from committing a complete artifact. Set Fixture content to ABCDEF, Maximum text chunks to 3, and leave Append later text parts enabled. The three received text parts are AB, CD and EF; the stored body should be ABCDEF. Disable append and inspect the final body: only EF remains. This is a replacement decision, not packet loss. Now disable the final marker. Even if all six characters arrived, this application refuses to commit because its completion gate is not satisfied.
Assemble the content
Part kind selects text, a JSON object, or an inline file made from the entered text. Fixture content is the actual payload; Load valid example replaces it with a valid example for the selected kind. Maximum text chunks bounds the number of Unicode-code-point chunks, not the number of bytes. Append later text parts preserves earlier chunks; disabling it replaces the buffer at every update. Send final artifact marker tells this application that assembly has finished. Data and file parts are single units here, so text-chunk settings do not apply to them.
Control storage and ownership
Actor tenant chooses the owner Alpha or the foreign reader Beta. Another writer commits first advances the live generation before this client attempts its write. Require matching live generation compares Expected live generation with that live value; it does not compare with an old retained version. Per-version UTF-8 byte limit rejects content that is too large after assembly. Retain earlier versions keeps the baseline and subsequent generations available. Retry the same write intent repeats the commit with the same expected generation, so a successful conditional write makes that unchanged condition stale.
Inspect the handoff
Grant Beta read access only permits a foreign read but never a foreign write. Reader version chooses the live object or generation 1; removing history can make generation 1 unavailable. Inspect Exact visible content and Decision trace together: a failed write does not mean that no previous readable object exists. Play reveals the trace over sixty seconds, Pause freezes it, Next operation advances one stage, Restart rewinds inspection, Speed changes teaching playback, and Inspection seeks without changing storage policy. Changing a fixture input constructs a fresh experiment rather than mutating a remote service.