ag-ui-validate 0.2.0 → 0.4.0

package/spec/event-categories.json

@@ -0,0 +1,60 @@
+{
+  "$comment": "Wire-type -> category/deprecation data for the canonical event table. Hand-maintained (not derivable from the SDK schemas themselves); shared by every language's event-table derivation tool so this classification is written once. Categories are display/grouping metadata only, not conformance rules — those live in catalog.json.",
+  "categories": [
+    "lifecycle",
+    "text",
+    "toolcall",
+    "state",
+    "activity",
+    "reasoning",
+    "thinking",
+    "special",
+    "subagent"
+  ],
+  "eventCategory": {
+    "RUN_STARTED": "lifecycle",
+    "RUN_FINISHED": "lifecycle",
+    "RUN_ERROR": "lifecycle",
+    "STEP_STARTED": "lifecycle",
+    "STEP_FINISHED": "lifecycle",
+    "TEXT_MESSAGE_START": "text",
+    "TEXT_MESSAGE_CONTENT": "text",
+    "TEXT_MESSAGE_END": "text",
+    "TEXT_MESSAGE_CHUNK": "text",
+    "TOOL_CALL_START": "toolcall",
+    "TOOL_CALL_ARGS": "toolcall",
+    "TOOL_CALL_END": "toolcall",
+    "TOOL_CALL_CHUNK": "toolcall",
+    "TOOL_CALL_RESULT": "toolcall",
+    "STATE_SNAPSHOT": "state",
+    "STATE_DELTA": "state",
+    "MESSAGES_SNAPSHOT": "state",
+    "ACTIVITY_SNAPSHOT": "activity",
+    "ACTIVITY_DELTA": "activity",
+    "REASONING_START": "reasoning",
+    "REASONING_MESSAGE_START": "reasoning",
+    "REASONING_MESSAGE_CONTENT": "reasoning",
+    "REASONING_MESSAGE_END": "reasoning",
+    "REASONING_MESSAGE_CHUNK": "reasoning",
+    "REASONING_END": "reasoning",
+    "REASONING_ENCRYPTED_VALUE": "reasoning",
+    "THINKING_START": "thinking",
+    "THINKING_END": "thinking",
+    "THINKING_TEXT_MESSAGE_START": "thinking",
+    "THINKING_TEXT_MESSAGE_CONTENT": "thinking",
+    "THINKING_TEXT_MESSAGE_END": "thinking",
+    "RAW": "special",
+    "CUSTOM": "special",
+    "SUBAGENT_STARTED": "subagent",
+    "SUBAGENT_FINISHED": "subagent",
+    "SUBAGENT_ERROR": "subagent"
+  },
+  "$deprecatedComment": "@deprecated markers in @ag-ui/core's type definitions, 'Will be removed in 1.0.0'. Maps a deprecated wire type to its replacement.",
+  "deprecated": {
+    "THINKING_START": "REASONING_START",
+    "THINKING_END": "REASONING_END",
+    "THINKING_TEXT_MESSAGE_START": "REASONING_MESSAGE_START",
+    "THINKING_TEXT_MESSAGE_CONTENT": "REASONING_MESSAGE_CONTENT",
+    "THINKING_TEXT_MESSAGE_END": "REASONING_MESSAGE_END"
+  }
+}

package/spec/fixtures/README.md

@@ -0,0 +1,91 @@
+# AG-UI conformance fixture corpus
+
+A language-neutral corpus for testing AG-UI protocol validators. Any
+implementation — TypeScript, Python, Go — that consumes the shared rule
+catalog ([`catalog.json`](../catalog.json)) can be tested
+against these files. The corpus, not per-rule test code, is the suite: adding
+a rule to the catalog means adding a fixture directory here.
+
+## Layout
+
+```
+fixtures/
+├── valid/                       one stream per canonical AG-UI feature
+│   ├── agentic-chat.jsonl
+│   ├── agentic-chat.expected.json     (optional; assumed [] when absent)
+│   └── …
+└── invalid/                     one directory per rule
+    ├── AGUI203-unterminated-tool-call/
+    │   ├── stream.jsonl         the event stream
+    │   ├── expected.json        the exact expected Diagnostic[]
+    │   └── options.json         (optional) validator options for this run
+    └── AGUI506-keepalive-gap/   transport rules use a scenario instead
+        ├── scenario.json        an HTTP response body as timed byte chunks
+        └── expected.json
+```
+
+## Running the corpus against an implementation
+
+For every event-stream fixture (`stream.jsonl`):
+
+1. Read the `.jsonl` file and split it into lines; drop empty lines.
+2. Feed each remaining line to the validator **as a raw string** — do not
+   pre-parse. Malformed lines are intentional (they exercise AGUI502); a
+   conforming validator treats them as diagnostics, never exceptions.
+3. If `options.json` exists, construct the validator with those options
+   (e.g. `{"features": ["shared-state"]}` for AGUI305).
+4. After the last line, finalize (end-of-stream checks).
+5. Deep-compare the accumulated diagnostics with `expected.json`. Order
+   matters: diagnostics are emitted in stream order, and end-of-stream
+   diagnostics use `eventIndex: -1`.
+
+For every transport fixture (`scenario.json`) — these exercise the rules that
+need a live connection (AGUI501, AGUI505–AGUI508):
+
+1. The scenario describes an HTTP response: `contentType` and `chunks`, each
+   chunk being `{ "gapMs": n, "text": "…" }` — the raw bytes as they arrived,
+   with `gapMs` of simulated silence before the chunk.
+2. Feed the chunk bytes through your transport layer (SSE or NDJSON per the
+   content type, sniffing when unknown) with a simulated clock that advances
+   by each `gapMs`; the keepalive window is the default 30 000 ms.
+3. `"abnormalEof": true` means the connection errored after the last chunk
+   (as opposed to closing cleanly) — the AGUI508 condition.
+4. Finalize and deep-compare diagnostics with `expected.json` as above.
+
+Every `invalid/` fixture must fire its directory's namesake rule; every
+`valid/` fixture must produce exactly its `*.expected.json` (usually nothing —
+they are the false-positive guards). `valid/predictive-state-updates` expects
+one `info` finding: the Dojo's real `PredictState` custom event name is
+un-namespaced (AGUI903, see `docs/spec-questions.md` SQ-14).
+
+## Diagnostic shape
+
+```json
+{
+  "rule": "AGUI203",
+  "severity": "error",
+  "message": "TOOL_CALL_START id 'call_7' never terminated",
+  "eventIndex": 3,
+  "eventType": "RUN_FINISHED",
+  "pointer": "/toolCallId",
+  "relatedEventIndex": 1,
+  "specUrl": "https://docs.ag-ui.com/concepts/events#tool-call-events"
+}
+```
+
+`eventType`, `pointer`, and `relatedEventIndex` are optional and omitted when
+absent. Messages come from the catalog's `messageTemplate`s, so independent
+implementations produce identical output.
+
+## Maintenance
+
+Fixtures are generated by [`scripts/build-fixtures.mjs`](../../js/scripts/build-fixtures.mjs),
+which declares each stream's *intended* rule hits independently of the
+validator and refuses to write anything on mismatch — regeneration can never
+silently bake an implementation bug into `expected.json`.
+
+## Not yet covered
+
+- **`valid/real-world/`** — captures from real frameworks (LangGraph, CrewAI,
+  Pydantic AI, Agno, Langflow `stream_protocol=agui`). Contributions welcome;
+  sanitise credentials before submitting.

package/spec/fixtures/invalid/AGUI001-first-event-not-run-started/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI001",
+    "severity": "error",
+    "message": "First event of the run is TEXT_MESSAGE_START; expected RUN_STARTED",
+    "eventIndex": 0,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#runstarted",
+    "eventType": "TEXT_MESSAGE_START"
+  }
+]

package/spec/fixtures/invalid/AGUI001-first-event-not-run-started/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300007900}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_001","delta":"Hello without a run.","timestamp":1755300008000}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_001","timestamp":1755300008100}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","timestamp":1755300008200}

package/spec/fixtures/invalid/AGUI002-duplicate-run-started/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI002",
+    "severity": "error",
+    "message": "Duplicate RUN_STARTED (runId 'run_002') before the active run terminated",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#lifecycle-events",
+    "eventType": "RUN_STARTED",
+    "relatedEventIndex": 0
+  }
+]

package/spec/fixtures/invalid/AGUI002-duplicate-run-started/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300008300}
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_002","timestamp":1755300008400}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300008500}

package/spec/fixtures/invalid/AGUI003-run-never-terminated/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI003",
+    "severity": "error",
+    "message": "Run 'run_001' ended without RUN_FINISHED or RUN_ERROR",
+    "eventIndex": -1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#runfinished",
+    "relatedEventIndex": 0
+  }
+]

package/spec/fixtures/invalid/AGUI003-run-never-terminated/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300008600}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300008700}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_001","delta":"This run just stops.","timestamp":1755300008800}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_001","timestamp":1755300008900}

package/spec/fixtures/invalid/AGUI004-event-after-terminal/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI004",
+    "severity": "error",
+    "message": "TEXT_MESSAGE_START follows the run's terminal RUN_FINISHED",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#lifecycle-events",
+    "eventType": "TEXT_MESSAGE_START",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI004-event-after-terminal/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300009000}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300009100}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300009200}

package/spec/fixtures/invalid/AGUI005-finished-and-error/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI005",
+    "severity": "error",
+    "message": "RUN_ERROR emitted after the run already terminated with RUN_FINISHED",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#runfinished",
+    "eventType": "RUN_ERROR",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI005-finished-and-error/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300009300}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300009400}
+{"type":"RUN_ERROR","message":"boom","timestamp":1755300009500}

package/spec/fixtures/invalid/AGUI006-step-finished-unmatched/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI006",
+    "severity": "error",
+    "message": "STEP_FINISHED 'plan' has no open STEP_STARTED",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#stepfinished",
+    "eventType": "STEP_FINISHED",
+    "pointer": "/stepName"
+  }
+]

package/spec/fixtures/invalid/AGUI006-step-finished-unmatched/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300009600}
+{"type":"STEP_FINISHED","stepName":"plan","timestamp":1755300009700}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300009800}

package/spec/fixtures/invalid/AGUI007-step-unterminated/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI007",
+    "severity": "error",
+    "message": "STEP_STARTED 'plan' never finished",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#stepstarted",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI007-step-unterminated/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300009900}
+{"type":"STEP_STARTED","stepName":"plan","timestamp":1755300010000}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300010100}

package/spec/fixtures/invalid/AGUI008-unstable-run-ids/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI008",
+    "severity": "warning",
+    "message": "RUN_FINISHED runId 'run_999' does not match RUN_STARTED runId 'run_001'",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#runstarted",
+    "eventType": "RUN_FINISHED",
+    "pointer": "/runId",
+    "relatedEventIndex": 0
+  }
+]

package/spec/fixtures/invalid/AGUI008-unstable-run-ids/stream.jsonl

@@ -0,0 +1,2 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300010200}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_999","outcome":{"type":"success"},"timestamp":1755300010300}

package/spec/fixtures/invalid/AGUI101-content-without-start/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI101",
+    "severity": "error",
+    "message": "TEXT_MESSAGE_CONTENT for messageId 'msg_ghost' with no open TEXT_MESSAGE_START",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#text-message-events",
+    "eventType": "TEXT_MESSAGE_CONTENT",
+    "pointer": "/messageId"
+  }
+]

package/spec/fixtures/invalid/AGUI101-content-without-start/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300010400}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_ghost","delta":"orphan","timestamp":1755300010500}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300010600}

package/spec/fixtures/invalid/AGUI102-end-without-start/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI102",
+    "severity": "error",
+    "message": "TEXT_MESSAGE_END for messageId 'msg_ghost' with no open TEXT_MESSAGE_START",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#textmessageend",
+    "eventType": "TEXT_MESSAGE_END",
+    "pointer": "/messageId"
+  }
+]

package/spec/fixtures/invalid/AGUI102-end-without-start/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300010700}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_ghost","timestamp":1755300010800}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300010900}

package/spec/fixtures/invalid/AGUI103-message-unterminated/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI103",
+    "severity": "error",
+    "message": "TEXT_MESSAGE_START messageId 'msg_001' never ended",
+    "eventIndex": 3,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#text-message-events",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI103-message-unterminated/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300011000}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300011100}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_001","delta":"never ends","timestamp":1755300011200}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300011300}

package/spec/fixtures/invalid/AGUI104-duplicate-message-id/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI104",
+    "severity": "error",
+    "message": "messageId 'msg_001' was already used by a completed message",
+    "eventIndex": 4,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#textmessagestart",
+    "eventType": "TEXT_MESSAGE_START",
+    "pointer": "/messageId",
+    "relatedEventIndex": 3
+  }
+]

package/spec/fixtures/invalid/AGUI104-duplicate-message-id/stream.jsonl

@@ -0,0 +1,6 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300011400}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300011500}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_001","delta":"first use","timestamp":1755300011600}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_001","timestamp":1755300011700}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300011800}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300011900}

package/spec/fixtures/invalid/AGUI105-empty-content-delta/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI105",
+    "severity": "warning",
+    "message": "TEXT_MESSAGE_CONTENT for messageId 'msg_001' has an empty delta",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#textmessagecontent",
+    "eventType": "TEXT_MESSAGE_CONTENT",
+    "pointer": "/delta",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI105-empty-content-delta/stream.jsonl

@@ -0,0 +1,5 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300012000}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300012100}
+{"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_001","delta":"","timestamp":1755300012200}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_001","timestamp":1755300012300}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300012400}

package/spec/fixtures/invalid/AGUI106-interleaved-same-message-id/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI106",
+    "severity": "error",
+    "message": "TEXT_MESSAGE_START for messageId 'msg_001', which is already open",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#implementation-considerations",
+    "eventType": "TEXT_MESSAGE_START",
+    "pointer": "/messageId",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI106-interleaved-same-message-id/stream.jsonl

@@ -0,0 +1,5 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300012500}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300012600}
+{"type":"TEXT_MESSAGE_START","messageId":"msg_001","role":"assistant","timestamp":1755300012700}
+{"type":"TEXT_MESSAGE_END","messageId":"msg_001","timestamp":1755300012800}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300012900}

package/spec/fixtures/invalid/AGUI201-args-without-start/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI201",
+    "severity": "error",
+    "message": "TOOL_CALL_ARGS for toolCallId 'call_ghost' with no open TOOL_CALL_START",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#tool-call-events",
+    "eventType": "TOOL_CALL_ARGS",
+    "pointer": "/toolCallId"
+  }
+]

package/spec/fixtures/invalid/AGUI201-args-without-start/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300013000}
+{"type":"TOOL_CALL_ARGS","toolCallId":"call_ghost","delta":"{}","timestamp":1755300013100}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300013200}

package/spec/fixtures/invalid/AGUI202-end-without-start/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI202",
+    "severity": "error",
+    "message": "TOOL_CALL_END for toolCallId 'call_ghost' with no open TOOL_CALL_START",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallend",
+    "eventType": "TOOL_CALL_END",
+    "pointer": "/toolCallId"
+  }
+]

package/spec/fixtures/invalid/AGUI202-end-without-start/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300013300}
+{"type":"TOOL_CALL_END","toolCallId":"call_ghost","timestamp":1755300013400}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300013500}

package/spec/fixtures/invalid/AGUI203-unterminated-tool-call/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI203",
+    "severity": "error",
+    "message": "TOOL_CALL_START id 'call_7' never terminated",
+    "eventIndex": 3,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#tool-call-events",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI203-unterminated-tool-call/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300013600}
+{"type":"TOOL_CALL_START","toolCallId":"call_7","toolCallName":"get_weather","timestamp":1755300013700}
+{"type":"TOOL_CALL_ARGS","toolCallId":"call_7","delta":"{\"city\":\"Berlin\"}","timestamp":1755300013800}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300013900}

package/spec/fixtures/invalid/AGUI204-args-not-json/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI204",
+    "severity": "error",
+    "message": "Concatenated TOOL_CALL_ARGS for toolCallId 'call_001' do not parse as JSON: Unexpected token 'o', \"{\"city\":oops}\" is not valid JSON",
+    "eventIndex": 4,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallargs",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI204-args-not-json/stream.jsonl

@@ -0,0 +1,6 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300014000}
+{"type":"TOOL_CALL_START","toolCallId":"call_001","toolCallName":"get_weather","timestamp":1755300014100}
+{"type":"TOOL_CALL_ARGS","toolCallId":"call_001","delta":"{\"city\":","timestamp":1755300014200}
+{"type":"TOOL_CALL_ARGS","toolCallId":"call_001","delta":"oops}","timestamp":1755300014300}
+{"type":"TOOL_CALL_END","toolCallId":"call_001","timestamp":1755300014400}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300014500}

package/spec/fixtures/invalid/AGUI205-duplicate-tool-call-id/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI205",
+    "severity": "error",
+    "message": "toolCallId 'call_001' was already used by a completed tool call",
+    "eventIndex": 3,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallstart",
+    "eventType": "TOOL_CALL_START",
+    "pointer": "/toolCallId",
+    "relatedEventIndex": 2
+  }
+]

package/spec/fixtures/invalid/AGUI205-duplicate-tool-call-id/stream.jsonl

@@ -0,0 +1,5 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300014600}
+{"type":"TOOL_CALL_START","toolCallId":"call_001","toolCallName":"get_weather","timestamp":1755300014700}
+{"type":"TOOL_CALL_END","toolCallId":"call_001","timestamp":1755300014800}
+{"type":"TOOL_CALL_START","toolCallId":"call_001","toolCallName":"get_weather","timestamp":1755300014900}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300015000}

package/spec/fixtures/invalid/AGUI206-result-before-end/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "rule": "AGUI206",
+    "severity": "warning",
+    "message": "TOOL_CALL_RESULT for toolCallId 'call_001' arrived while the call is still open",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallresult",
+    "eventType": "TOOL_CALL_RESULT",
+    "pointer": "/toolCallId",
+    "relatedEventIndex": 1
+  }
+]

package/spec/fixtures/invalid/AGUI206-result-before-end/stream.jsonl

@@ -0,0 +1,5 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300015100}
+{"type":"TOOL_CALL_START","toolCallId":"call_001","toolCallName":"get_weather","timestamp":1755300015200}
+{"type":"TOOL_CALL_RESULT","messageId":"msg_001","toolCallId":"call_001","content":"early","timestamp":1755300015300}
+{"type":"TOOL_CALL_END","toolCallId":"call_001","timestamp":1755300015400}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300015500}

package/spec/fixtures/invalid/AGUI207-result-unknown-id/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI207",
+    "severity": "error",
+    "message": "TOOL_CALL_RESULT references toolCallId 'call_ghost', which was never started",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallresult",
+    "eventType": "TOOL_CALL_RESULT",
+    "pointer": "/toolCallId"
+  }
+]

package/spec/fixtures/invalid/AGUI207-result-unknown-id/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300015600}
+{"type":"TOOL_CALL_RESULT","messageId":"msg_001","toolCallId":"call_ghost","content":"orphan","timestamp":1755300015700}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300015800}

package/spec/fixtures/invalid/AGUI208-unknown-parent-message-id/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI208",
+    "severity": "info",
+    "message": "TOOL_CALL_START parentMessageId 'msg_ghost' matches no message observed in this stream",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#toolcallstart",
+    "eventType": "TOOL_CALL_START",
+    "pointer": "/parentMessageId"
+  }
+]

package/spec/fixtures/invalid/AGUI208-unknown-parent-message-id/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300015900}
+{"type":"TOOL_CALL_START","toolCallId":"call_001","toolCallName":"get_weather","parentMessageId":"msg_ghost","timestamp":1755300016000}
+{"type":"TOOL_CALL_END","toolCallId":"call_001","timestamp":1755300016100}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300016200}

package/spec/fixtures/invalid/AGUI301-delta-before-snapshot/expected.json

@@ -0,0 +1,10 @@
+[
+  {
+    "rule": "AGUI301",
+    "severity": "info",
+    "message": "STATE_DELTA precedes any STATE_SNAPSHOT; the base it applies to is not observable on this stream",
+    "eventIndex": 1,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#statesnapshot",
+    "eventType": "STATE_DELTA"
+  }
+]

package/spec/fixtures/invalid/AGUI301-delta-before-snapshot/stream.jsonl

@@ -0,0 +1,3 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300016300}
+{"type":"STATE_DELTA","delta":[{"op":"add","path":"/a","value":1}],"timestamp":1755300016400}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300016500}

package/spec/fixtures/invalid/AGUI302-delta-failed-to-apply/expected.json

@@ -0,0 +1,11 @@
+[
+  {
+    "rule": "AGUI302",
+    "severity": "error",
+    "message": "STATE_DELTA failed to apply: /items/3: '3' is not a valid index for an array of length 0",
+    "eventIndex": 2,
+    "specUrl": "https://docs.ag-ui.com/concepts/events#statedelta",
+    "eventType": "STATE_DELTA",
+    "pointer": "/delta/0"
+  }
+]

package/spec/fixtures/invalid/AGUI302-delta-failed-to-apply/stream.jsonl

@@ -0,0 +1,4 @@
+{"type":"RUN_STARTED","threadId":"thread_001","runId":"run_001","timestamp":1755300016600}
+{"type":"STATE_SNAPSHOT","snapshot":{"items":[]},"timestamp":1755300016700}
+{"type":"STATE_DELTA","delta":[{"op":"replace","path":"/items/3","value":"x"}],"timestamp":1755300016800}
+{"type":"RUN_FINISHED","threadId":"thread_001","runId":"run_001","outcome":{"type":"success"},"timestamp":1755300016900}