@peasant-labs/schema 0.17.0 → 0.19.0

package/README.md

@@ -1,5 +1,9 @@
 # @peasant-labs/schema
 
+Read contracts and validation boundaries:
+[grouped reads](../docs/grouped-read-contract.md) and
+[optional versus required public references](../docs/public-reference-validation.md).
+
 Use this package when a TypeScript application needs typed, always-in-sync
 access to the peasant-labs wire contract: the same domain types, closed-set
 enums, and runtime validation Go services already produce and enforce,

package/dist/fixtures/session-graph-capability.d.ts

@@ -0,0 +1,454 @@
+export declare function sessionGraphCapabilityFixtures(): {
+    readonly requiredNames: {
+        readonly derivation: readonly ["legacy-empty", "root-null", "usage-null", "model-only", "source-ref-only", "count-only-zero", "count-only-positive", "root-only", "purpose-only-interaction", "purpose-only-delegated", "purpose-only-helper", "purpose-only-unknown", "relationship-only", "main-deeper-provenance", "folded-call-provenance", "folded-result-provenance", "earlier-only", "earlier-nested-tool-native-usage-model", "navigation-only-read"];
+        readonly reader: readonly ["advertisement-omitted", "advertisement-empty", "advertisement-null", "advertisement-unknown-duplicate-unordered", "advertisement-future-suffix"];
+        readonly producer: readonly ["producer-canonical-four", "producer-unsorted-four", "producer-duplicate", "producer-unknown"];
+    };
+    readonly derivation: {
+        readonly cases: readonly [{
+            readonly name: "legacy-empty";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "omits optional evidence";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[]}";
+            };
+            readonly expected: {};
+        }, {
+            readonly name: "root-null";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "Go nil parity";
+            };
+            readonly mutation: {
+                readonly description: "decodes null root as absent";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"rootSessionId\":null,\"turns\":[]}";
+            };
+            readonly expected: {};
+        }, {
+            readonly name: "usage-null";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "Go nil parity";
+            };
+            readonly mutation: {
+                readonly description: "decodes null usage as absent";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\",\"usage\":null}]}";
+            };
+            readonly expected: {};
+        }, {
+            readonly name: "model-only";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds model seed";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"model\":\"seed/model\",\"turns\":[]}";
+            };
+            readonly expected: {};
+        }, {
+            readonly name: "source-ref-only";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds source ref";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"user\",\"sourceEntryRef\":\"e1\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {};
+        }, {
+            readonly name: "count-only-zero";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "measures zero submissions";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"inputSubmissionCount\":0,\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "count-only-positive";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "measures positive submissions";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"inputSubmissionCount\":1,\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "root-only";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds root";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"rootSessionId\":\"00000000-0000-4000-8000-000000000001\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "purpose-only-interaction";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds interaction purpose";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"purpose\":\"interaction\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "purpose-only-delegated";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds delegated purpose";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"purpose\":\"delegated_work\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "purpose-only-helper";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds helper purpose";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"purpose\":\"helper_review\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "purpose-only-unknown";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds unknown purpose";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"purpose\":\"unknown\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "relationship-only";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds relationship";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"relationships\":[{\"kind\":\"started_by\",\"targetState\":\"unknown\",\"evidence\":\"unknown\"}],\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "main-deeper-provenance";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-11";
+            };
+            readonly mutation: {
+                readonly description: "adds nonroot provenance";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":2,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"},{\"index\":1,\"role\":\"assistant\",\"depth\":1,\"parentIndex\":0,\"provenance\":{\"origin\":\"unknown\",\"actor\":\"unknown\",\"delivery\":\"unknown\",\"ownership\":\"uncertain\",\"evidence\":\"unknown\",\"inputModality\":\"unknown\"},\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "folded-call-provenance";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-11";
+            };
+            readonly mutation: {
+                readonly description: "adds call provenance";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"toolCalls\":[{\"id\":\"t1\",\"callProvenance\":{\"origin\":\"unknown\",\"actor\":\"unknown\",\"delivery\":\"unknown\",\"ownership\":\"uncertain\",\"evidence\":\"unknown\",\"inputModality\":\"unknown\"},\"name\":\"\",\"arguments\":\"\",\"result\":\"\"}],\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "folded-result-provenance";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-11";
+            };
+            readonly mutation: {
+                readonly description: "adds result provenance";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"toolCalls\":[{\"id\":\"t1\",\"resultProvenance\":{\"origin\":\"unknown\",\"actor\":\"unknown\",\"delivery\":\"unknown\",\"ownership\":\"uncertain\",\"evidence\":\"unknown\",\"inputModality\":\"unknown\"},\"name\":\"\",\"arguments\":\"\",\"result\":\"\"}],\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "earlier-only";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds empty retained section";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[],\"earlierHistory\":[{\"state\":\"uncertain_migrated\",\"turns\":[]}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "earlier-nested-tool-native-usage-model";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "combines valid Pi earlier evidence";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"pi\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[],\"earlierHistory\":[{\"state\":\"uncertain_migrated\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"},{\"index\":1,\"role\":\"assistant\",\"depth\":1,\"parentIndex\":0,\"observedModel\":\"provider/model\",\"provenance\":{\"origin\":\"unknown\",\"actor\":\"unknown\",\"delivery\":\"unknown\",\"ownership\":\"uncertain\",\"evidence\":\"unknown\",\"inputModality\":\"unknown\"},\"sourceEntryRef\":\"e_assistant\",\"usage\":{\"ownerId\":\"u_assistant\",\"sourceEntryRef\":\"e_assistant\",\"scope\":\"assistant\",\"completeness\":\"unknown\"},\"toolCalls\":[{\"id\":\"t1\",\"resultEntryRef\":\"e_result\",\"usage\":{\"ownerId\":\"u_tool\",\"sourceEntryRef\":\"e_result\",\"scope\":\"tool\",\"completeness\":\"unknown\"},\"name\":\"\",\"arguments\":\"\",\"result\":\"\"}],\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\"}],\"nativeMetadata\":[{\"id\":\"n1\",\"kind\":\"pi.toolresult.details\",\"source\":{\"entryRef\":\"e_result\",\"sourceType\":\"pi.message\",\"messageRole\":\"toolResult\"},\"attachment\":{\"turnIndex\":1,\"toolCallId\":\"t1\"},\"data\":{}}]}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "navigation-only-read";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "separates read metadata from durable detail";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[]}";
+                readonly readJSON: "{\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"id\":\"child\",\"harness\":\"claude-code\",\"turns\":[],\"relationshipNavigation\":[]}";
+                readonly rejectedDurableJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[],\"relationshipNavigation\":[]}";
+            };
+            readonly expected: {};
+        }];
+    };
+    readonly reader: {
+        readonly cases: readonly [{
+            readonly name: "advertisement-omitted";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "omits list";
+            };
+            readonly input: {
+                readonly json: "{}";
+            };
+            readonly expected: {
+                readonly missing: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "advertisement-empty";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "supplies empty list";
+            };
+            readonly input: {
+                readonly json: "{\"contentCapabilities\":[]}";
+            };
+            readonly expected: {
+                readonly missing: readonly ["session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "advertisement-null";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "supplies null list";
+            };
+            readonly input: {
+                readonly json: "{\"contentCapabilities\":null}";
+            };
+            readonly expected: {
+                readonly errorContains: "contentCapabilities is null";
+            };
+        }, {
+            readonly name: "advertisement-unknown-duplicate-unordered";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "combines tolerated reader forms";
+            };
+            readonly input: {
+                readonly json: "{\"contentCapabilities\":[\"session_graph_provenance_v1\",\"future_v9\",\"observed_model_v1\",\"session_graph_provenance_v1\"]}";
+            };
+            readonly expected: {
+                readonly known: readonly ["observed_model_v1", "session_graph_provenance_v1"];
+            };
+        }, {
+            readonly name: "advertisement-future-suffix";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "substitutes opaque v2 suffix";
+            };
+            readonly input: {
+                readonly json: "{\"contentCapabilities\":[\"session_graph_provenance_v2\"]}";
+            };
+            readonly expected: {
+                readonly missing: readonly ["session_graph_provenance_v1"];
+            };
+        }];
+    };
+    readonly producer: {
+        readonly cases: readonly [{
+            readonly name: "producer-canonical-four";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "emits sorted inventory";
+            };
+            readonly input: {
+                readonly tokens: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "session_graph_provenance_v1"];
+            };
+            readonly expected: {
+                readonly accepted: true;
+            };
+        }, {
+            readonly name: "producer-unsorted-four";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "swaps sorted tokens";
+            };
+            readonly input: {
+                readonly tokens: readonly ["native_metadata_v1", "detailed_usage_v1", "observed_model_v1", "session_graph_provenance_v1"];
+            };
+            readonly expected: {
+                readonly errorContains: "canonical lexicographic order";
+            };
+        }, {
+            readonly name: "producer-duplicate";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "duplicates graph token";
+            };
+            readonly input: {
+                readonly tokens: readonly ["session_graph_provenance_v1", "session_graph_provenance_v1"];
+            };
+            readonly expected: {
+                readonly errorContains: "duplicated";
+            };
+        }, {
+            readonly name: "producer-unknown";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "section-12.4";
+            };
+            readonly mutation: {
+                readonly description: "adds unknown token";
+            };
+            readonly input: {
+                readonly tokens: readonly ["future_v9"];
+            };
+            readonly expected: {
+                readonly errorContains: "unknown token";
+            };
+        }];
+    };
+};

package/dist/fixtures/session-graph-capability.js

@@ -0,0 +1,4 @@
+import { canonicalSessionGraphCapabilityFixtures } from "../internal/generated/session-graph-capability-fixtures.gen.js";
+export function sessionGraphCapabilityFixtures() {
+    return structuredClone(canonicalSessionGraphCapabilityFixtures);
+}