@humain/humain-code-contracts 0.3.2

package/dist/testing.js

@@ -0,0 +1,431 @@
+const digest = (digit) => digit.repeat(64);
+const claim = {
+    workUnitId: "work-unit:implementation-a",
+    nodeId: "implementation-a",
+    attemptNumber: 1,
+    attemptFence: 4,
+    segmentFence: 7,
+    routeRef: "route:balanced",
+    task: "Inspect and update the requested source.",
+    controls: { maxConcurrency: 1, maxDepth: 4, depth: 0, timeoutMs: 30_000 },
+    input: {
+        artifacts: [
+            {
+                id: "source:1",
+                kind: "source-observation",
+                reference: "workspace/src/app.ts",
+                digest: digest("a"),
+            },
+        ],
+    },
+};
+const request = {
+    schemaVersion: 1,
+    kind: "execute",
+    mode: "node",
+    invocationId: "invocation:01",
+    claims: [claim],
+};
+const success = {
+    schemaVersion: 1,
+    kind: "result",
+    mode: "node",
+    invocationId: request.invocationId,
+    termination: "not-requested",
+    outcomes: [
+        {
+            workUnitId: claim.workUnitId,
+            nodeId: claim.nodeId,
+            attemptNumber: claim.attemptNumber,
+            attemptFence: claim.attemptFence,
+            segmentFence: claim.segmentFence,
+            kind: "succeeded",
+            output: { summary: "Updated the requested source.", artifacts: [] },
+            usage: { status: "measured", totalTokens: 12, costMicrocents: 25 },
+        },
+    ],
+};
+const workflowRequest = {
+    ...request,
+    mode: "workflow",
+    batchId: "batch:1",
+    claims: [claim, { ...claim, workUnitId: "work-unit:validation-b", nodeId: "validation-b" }],
+};
+const workflowUnsupported = {
+    schemaVersion: 1,
+    kind: "result",
+    mode: "workflow",
+    invocationId: workflowRequest.invocationId,
+    batchId: workflowRequest.batchId,
+    termination: "not-requested",
+    outcomes: workflowRequest.claims.map((workflowClaim) => ({
+        workUnitId: workflowClaim.workUnitId,
+        nodeId: workflowClaim.nodeId,
+        attemptNumber: workflowClaim.attemptNumber,
+        attemptFence: workflowClaim.attemptFence,
+        segmentFence: workflowClaim.segmentFence,
+        kind: "failed",
+        failureCode: "incompatible_adapter_capability",
+        usage: { status: "unknown" },
+    })),
+};
+export const HUMAIN_AGENT_EXECUTION_VALID_VECTORS = deepFreeze([
+    { name: "node request", request },
+    { name: "correlated success", request, response: success },
+    {
+        name: "unsupported workflow response",
+        request: workflowRequest,
+        response: workflowUnsupported,
+    },
+    {
+        name: "maximum safe integer boundaries",
+        request: {
+            ...request,
+            claims: [
+                {
+                    ...claim,
+                    attemptNumber: Number.MAX_SAFE_INTEGER,
+                    attemptFence: Number.MAX_SAFE_INTEGER,
+                    segmentFence: Number.MAX_SAFE_INTEGER,
+                },
+            ],
+        },
+        response: {
+            ...success,
+            outcomes: [
+                {
+                    ...success.outcomes[0],
+                    attemptNumber: Number.MAX_SAFE_INTEGER,
+                    attemptFence: Number.MAX_SAFE_INTEGER,
+                    segmentFence: Number.MAX_SAFE_INTEGER,
+                    usage: {
+                        status: "measured",
+                        totalCalls: Number.MAX_SAFE_INTEGER,
+                        totalTurns: Number.MAX_SAFE_INTEGER,
+                        totalTokens: Number.MAX_SAFE_INTEGER,
+                        costMicrocents: Number.MAX_SAFE_INTEGER,
+                    },
+                },
+            ],
+        },
+    },
+]);
+export const HUMAIN_AGENT_EXECUTION_INVALID_VECTORS = deepFreeze([
+    { name: "unknown request field", request: { ...request, provider: "bedrock" } },
+    {
+        name: "artifact traversal",
+        request: {
+            ...request,
+            claims: [
+                {
+                    ...claim,
+                    input: { artifacts: [{ ...claim.input.artifacts[0], reference: "../secrets.txt" }] },
+                },
+            ],
+        },
+    },
+    {
+        name: "unsafe absolute result artifact",
+        request,
+        response: {
+            ...success,
+            outcomes: [
+                {
+                    ...success.outcomes[0],
+                    output: {
+                        summary: "Updated the requested source.",
+                        artifacts: [
+                            {
+                                id: "patch:1",
+                                kind: "candidate-patch",
+                                reference: "/workspace/patch.diff",
+                                digest: digest("b"),
+                            },
+                        ],
+                    },
+                },
+            ],
+        },
+    },
+    {
+        name: "unsafe command summary",
+        request,
+        response: {
+            ...success,
+            outcomes: [{ ...success.outcomes[0], output: { summary: "rm -rf workspace", artifacts: [] } }],
+        },
+    },
+    {
+        name: "integer beyond exact representation",
+        request: { ...request, claims: [{ ...claim, attemptFence: Number.MAX_SAFE_INTEGER + 1 }] },
+    },
+    {
+        name: "duplicate claim identities",
+        request: {
+            ...request,
+            mode: "workflow",
+            batchId: "batch:1",
+            claims: [claim, { ...claim }],
+        },
+    },
+    {
+        name: "exhausted delegation depth",
+        request: { ...request, claims: [{ ...claim, controls: { ...claim.controls, depth: 4 } }] },
+    },
+    {
+        name: "result identity ordering mismatch",
+        request,
+        response: { ...success, outcomes: [{ ...success.outcomes[0], nodeId: "implementation-b" }] },
+    },
+    {
+        name: "result cardinality mismatch",
+        request,
+        response: { ...success, outcomes: [success.outcomes[0], { ...success.outcomes[0] }] },
+    },
+    {
+        name: "termination evidence contradiction",
+        request,
+        response: { ...success, termination: "confirmed" },
+    },
+]);
+const PROGRESS_T0 = 1_760_000_000_000;
+const PROGRESS_RUNTIME_ID = "bbbbbbbb-bbbb-4bbb-8bbb-000000000001";
+const PROGRESS_EPOCH_A = "cccccccc-cccc-4ccc-8ccc-000000000001";
+const PROGRESS_EPOCH_B = "cccccccc-cccc-4ccc-8ccc-000000000002";
+const progressUuid = (n) => `aaaaaaaa-aaaa-4aaa-8aaa-${n.toString(16).padStart(12, "0")}`;
+function progressWorker(n, overrides = {}) {
+    return {
+        workerId: progressUuid(0x1000 + n),
+        attempt: 1,
+        status: "running",
+        cancelRequested: false,
+        cancellationOutcome: "none",
+        agent: "scout",
+        label: `task-${n}`,
+        task: `Inspect module ${n} and summarise its public surface`,
+        model: "anthropic/claude-sonnet-5",
+        startedAt: PROGRESS_T0 + 100,
+        endedAt: null,
+        turns: 1,
+        toolCalls: 2,
+        failureKind: null,
+        resultPreview: null,
+        ...overrides,
+    };
+}
+function progressRun(n, overrides = {}) {
+    return {
+        runId: progressUuid(n),
+        seq: 1,
+        final: false,
+        workers: [progressWorker(n)],
+        toolCallId: `call_${n}`,
+        mode: "single",
+        startedAt: PROGRESS_T0,
+        endedAt: null,
+        ...overrides,
+    };
+}
+function progressEnvelope(runs, overrides = {}) {
+    return {
+        schemaVersion: 1,
+        runtimeId: PROGRESS_RUNTIME_ID,
+        sessionEpoch: PROGRESS_EPOCH_A,
+        complete: true,
+        runs,
+        ...overrides,
+    };
+}
+const completedWorker = (n, overrides = {}) => progressWorker(n, {
+    status: "completed",
+    endedAt: PROGRESS_T0 + 900,
+    turns: 3,
+    toolCalls: 5,
+    resultPreview: "Found two exported entry points",
+    ...overrides,
+});
+const sequenceRunId = progressUuid(0x50);
+/**
+ * Valid C1 (schemaVersion 1) subagent progress envelopes with fixed UUIDs and timestamps, for Forge
+ * lead and consumer tests. `sequenceN` / `sequenceNPlus1` share a runId and model stale-ordering checks
+ * (a consumer must ignore `sequenceN` after `sequenceNPlus1`). `sessionEpochA` / `sessionEpochB` share a
+ * runtimeId but differ in sessionEpoch (session change).
+ */
+export const subagentProgressFixtures = deepFreeze({
+    parallelRunningWorkers: progressEnvelope([
+        progressRun(1, {
+            mode: "parallel",
+            seq: 3,
+            workers: [
+                progressWorker(1, { agent: "scout", label: "scan-api", startedAt: PROGRESS_T0 + 100 }),
+                progressWorker(2, {
+                    agent: "reviewer",
+                    label: "scan-ui",
+                    model: "openai/gpt-5",
+                    startedAt: PROGRESS_T0 + 120,
+                    turns: 0,
+                    toolCalls: 0,
+                }),
+            ],
+        }),
+    ]),
+    retryAttempt2: progressEnvelope([
+        progressRun(2, {
+            seq: 4,
+            workers: [
+                progressWorker(3, {
+                    attempt: 2,
+                    model: "anthropic/claude-opus-5",
+                    startedAt: PROGRESS_T0 + 500,
+                    turns: 0,
+                    toolCalls: 0,
+                }),
+            ],
+        }),
+    ]),
+    failedWorker: progressEnvelope([
+        progressRun(3, {
+            seq: 5,
+            final: true,
+            endedAt: PROGRESS_T0 + 700,
+            workers: [
+                progressWorker(4, {
+                    status: "failed",
+                    failureKind: "process_error",
+                    endedAt: PROGRESS_T0 + 700,
+                    resultPreview: "Worker exited with code 1",
+                }),
+            ],
+        }),
+    ]),
+    cancelledNotStarted: progressEnvelope([
+        progressRun(4, {
+            seq: 6,
+            final: true,
+            mode: "parallel",
+            endedAt: PROGRESS_T0 + 800,
+            workers: [
+                completedWorker(5, { endedAt: PROGRESS_T0 + 600 }),
+                progressWorker(6, {
+                    status: "cancelled",
+                    attempt: 0,
+                    cancelRequested: true,
+                    cancellationOutcome: "not_started",
+                    startedAt: null,
+                    turns: 0,
+                    toolCalls: 0,
+                }),
+            ],
+        }),
+    ]),
+    cancelledDirectWorkerTerminated: progressEnvelope([
+        progressRun(5, {
+            seq: 7,
+            final: true,
+            endedAt: PROGRESS_T0 + 800,
+            workers: [
+                progressWorker(7, {
+                    status: "cancelled",
+                    cancelRequested: true,
+                    cancellationOutcome: "direct_worker_terminated",
+                    endedAt: PROGRESS_T0 + 750,
+                }),
+            ],
+        }),
+    ]),
+    cancelledUnconfirmedUnresolved: progressEnvelope([
+        progressRun(6, {
+            seq: 8,
+            final: true,
+            endedAt: PROGRESS_T0 + 900,
+            workers: [
+                progressWorker(8, {
+                    status: "unresolved",
+                    cancelRequested: true,
+                    cancellationOutcome: "unconfirmed",
+                }),
+            ],
+        }),
+    ]),
+    skippedWorker: progressEnvelope([
+        progressRun(7, {
+            seq: 9,
+            final: true,
+            mode: "chain",
+            endedAt: PROGRESS_T0 + 650,
+            workers: [
+                progressWorker(9, {
+                    status: "failed",
+                    failureKind: "model_error",
+                    endedAt: PROGRESS_T0 + 650,
+                    resultPreview: "Model request failed",
+                }),
+                progressWorker(10, {
+                    status: "skipped",
+                    attempt: 0,
+                    startedAt: null,
+                    turns: 0,
+                    toolCalls: 0,
+                    model: null,
+                }),
+            ],
+        }),
+    ]),
+    incomplete: progressEnvelope([progressRun(8)], { complete: false }),
+    finalRun: progressEnvelope([
+        progressRun(9, {
+            seq: 12,
+            final: true,
+            endedAt: PROGRESS_T0 + 950,
+            workers: [completedWorker(11, { endedAt: PROGRESS_T0 + 940 })],
+        }),
+    ]),
+    sequenceN: progressEnvelope([
+        progressRun(0x50, {
+            runId: sequenceRunId,
+            seq: 10,
+            mode: "parallel",
+            workers: [progressWorker(12), progressWorker(13)],
+        }),
+    ]),
+    sequenceNPlus1: progressEnvelope([
+        progressRun(0x50, {
+            runId: sequenceRunId,
+            seq: 11,
+            mode: "parallel",
+            workers: [completedWorker(12), progressWorker(13)],
+        }),
+    ]),
+    sessionEpochA: progressEnvelope([progressRun(0x60)], { sessionEpoch: PROGRESS_EPOCH_A }),
+    sessionEpochB: progressEnvelope([progressRun(0x61)], { sessionEpoch: PROGRESS_EPOCH_B }),
+});
+/**
+ * Envelopes every C1 parser must reject. `extraKey`, `controlCharInTask` and `overLengthTask` are also
+ * rejected by the structural TypeBox schemas; the other entries violate cross-field or text rules that
+ * only the parsers enforce.
+ */
+export const invalidSubagentProgressFixtures = deepFreeze({
+    extraKey: { ...progressEnvelope([progressRun(1)]), transcript: "SECRET" },
+    controlCharInTask: progressEnvelope([
+        progressRun(1, { workers: [progressWorker(1, { task: "Inspect\u0007 module" })] }),
+    ]),
+    overLengthTask: progressEnvelope([progressRun(1, { workers: [progressWorker(1, { task: "x".repeat(121) })] })]),
+    loneSurrogateInTask: progressEnvelope([
+        progressRun(1, { workers: [progressWorker(1, { task: "Inspect \ud800 module" })] }),
+    ]),
+    failureKindOnCompletedWorker: progressEnvelope([
+        progressRun(1, { workers: [completedWorker(1, { failureKind: "process_error" })] }),
+    ]),
+    finalRunWithRunningWorker: progressEnvelope([
+        progressRun(1, { final: true, endedAt: PROGRESS_T0 + 500, workers: [progressWorker(1)] }),
+    ]),
+});
+function deepFreeze(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return value;
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SubagentProgressSnapshot, SubagentRunSnapshot, SubagentWorkerSnapshot } from \"./subagent-progress.ts\";\n\nexport interface HumainAgentExecutionContractVector {\n\treadonly name: string;\n\treadonly request: unknown;\n\treadonly response?: unknown;\n}\n\nconst digest = (digit: string) => digit.repeat(64);\nconst claim = {\n\tworkUnitId: \"work-unit:implementation-a\",\n\tnodeId: \"implementation-a\",\n\tattemptNumber: 1,\n\tattemptFence: 4,\n\tsegmentFence: 7,\n\trouteRef: \"route:balanced\",\n\ttask: \"Inspect and update the requested source.\",\n\tcontrols: { maxConcurrency: 1, maxDepth: 4, depth: 0, timeoutMs: 30_000 },\n\tinput: {\n\t\tartifacts: [\n\t\t\t{\n\t\t\t\tid: \"source:1\",\n\t\t\t\tkind: \"source-observation\",\n\t\t\t\treference: \"workspace/src/app.ts\",\n\t\t\t\tdigest: digest(\"a\"),\n\t\t\t},\n\t\t],\n\t},\n};\nconst request = {\n\tschemaVersion: 1,\n\tkind: \"execute\",\n\tmode: \"node\",\n\tinvocationId: \"invocation:01\",\n\tclaims: [claim],\n};\nconst success = {\n\tschemaVersion: 1,\n\tkind: \"result\",\n\tmode: \"node\",\n\tinvocationId: request.invocationId,\n\ttermination: \"not-requested\",\n\toutcomes: [\n\t\t{\n\t\t\tworkUnitId: claim.workUnitId,\n\t\t\tnodeId: claim.nodeId,\n\t\t\tattemptNumber: claim.attemptNumber,\n\t\t\tattemptFence: claim.attemptFence,\n\t\t\tsegmentFence: claim.segmentFence,\n\t\t\tkind: \"succeeded\",\n\t\t\toutput: { summary: \"Updated the requested source.\", artifacts: [] },\n\t\t\tusage: { status: \"measured\", totalTokens: 12, costMicrocents: 25 },\n\t\t},\n\t],\n};\nconst workflowRequest = {\n\t...request,\n\tmode: \"workflow\",\n\tbatchId: \"batch:1\",\n\tclaims: [claim, { ...claim, workUnitId: \"work-unit:validation-b\", nodeId: \"validation-b\" }],\n};\nconst workflowUnsupported = {\n\tschemaVersion: 1,\n\tkind: \"result\",\n\tmode: \"workflow\",\n\tinvocationId: workflowRequest.invocationId,\n\tbatchId: workflowRequest.batchId,\n\ttermination: \"not-requested\",\n\toutcomes: workflowRequest.claims.map((workflowClaim) => ({\n\t\tworkUnitId: workflowClaim.workUnitId,\n\t\tnodeId: workflowClaim.nodeId,\n\t\tattemptNumber: workflowClaim.attemptNumber,\n\t\tattemptFence: workflowClaim.attemptFence,\n\t\tsegmentFence: workflowClaim.segmentFence,\n\t\tkind: \"failed\",\n\t\tfailureCode: \"incompatible_adapter_capability\",\n\t\tusage: { status: \"unknown\" },\n\t})),\n};\n\nexport const HUMAIN_AGENT_EXECUTION_VALID_VECTORS = deepFreeze([\n\t{ name: \"node request\", request },\n\t{ name: \"correlated success\", request, response: success },\n\t{\n\t\tname: \"unsupported workflow response\",\n\t\trequest: workflowRequest,\n\t\tresponse: workflowUnsupported,\n\t},\n\t{\n\t\tname: \"maximum safe integer boundaries\",\n\t\trequest: {\n\t\t\t...request,\n\t\t\tclaims: [\n\t\t\t\t{\n\t\t\t\t\t...claim,\n\t\t\t\t\tattemptNumber: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\tattemptFence: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\tsegmentFence: Number.MAX_SAFE_INTEGER,\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tresponse: {\n\t\t\t...success,\n\t\t\toutcomes: [\n\t\t\t\t{\n\t\t\t\t\t...success.outcomes[0],\n\t\t\t\t\tattemptNumber: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\tattemptFence: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\tsegmentFence: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\tusage: {\n\t\t\t\t\t\tstatus: \"measured\",\n\t\t\t\t\t\ttotalCalls: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\t\ttotalTurns: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\t\ttotalTokens: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\t\tcostMicrocents: Number.MAX_SAFE_INTEGER,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t},\n] satisfies readonly HumainAgentExecutionContractVector[]);\n\nexport const HUMAIN_AGENT_EXECUTION_INVALID_VECTORS = deepFreeze([\n\t{ name: \"unknown request field\", request: { ...request, provider: \"bedrock\" } },\n\t{\n\t\tname: \"artifact traversal\",\n\t\trequest: {\n\t\t\t...request,\n\t\t\tclaims: [\n\t\t\t\t{\n\t\t\t\t\t...claim,\n\t\t\t\t\tinput: { artifacts: [{ ...claim.input.artifacts[0], reference: \"../secrets.txt\" }] },\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t},\n\t{\n\t\tname: \"unsafe absolute result artifact\",\n\t\trequest,\n\t\tresponse: {\n\t\t\t...success,\n\t\t\toutcomes: [\n\t\t\t\t{\n\t\t\t\t\t...success.outcomes[0],\n\t\t\t\t\toutput: {\n\t\t\t\t\t\tsummary: \"Updated the requested source.\",\n\t\t\t\t\t\tartifacts: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"patch:1\",\n\t\t\t\t\t\t\t\tkind: \"candidate-patch\",\n\t\t\t\t\t\t\t\treference: \"/workspace/patch.diff\",\n\t\t\t\t\t\t\t\tdigest: digest(\"b\"),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t},\n\t{\n\t\tname: \"unsafe command summary\",\n\t\trequest,\n\t\tresponse: {\n\t\t\t...success,\n\t\t\toutcomes: [{ ...success.outcomes[0], output: { summary: \"rm -rf workspace\", artifacts: [] } }],\n\t\t},\n\t},\n\t{\n\t\tname: \"integer beyond exact representation\",\n\t\trequest: { ...request, claims: [{ ...claim, attemptFence: Number.MAX_SAFE_INTEGER + 1 }] },\n\t},\n\t{\n\t\tname: \"duplicate claim identities\",\n\t\trequest: {\n\t\t\t...request,\n\t\t\tmode: \"workflow\",\n\t\t\tbatchId: \"batch:1\",\n\t\t\tclaims: [claim, { ...claim }],\n\t\t},\n\t},\n\t{\n\t\tname: \"exhausted delegation depth\",\n\t\trequest: { ...request, claims: [{ ...claim, controls: { ...claim.controls, depth: 4 } }] },\n\t},\n\t{\n\t\tname: \"result identity ordering mismatch\",\n\t\trequest,\n\t\tresponse: { ...success, outcomes: [{ ...success.outcomes[0], nodeId: \"implementation-b\" }] },\n\t},\n\t{\n\t\tname: \"result cardinality mismatch\",\n\t\trequest,\n\t\tresponse: { ...success, outcomes: [success.outcomes[0], { ...success.outcomes[0] }] },\n\t},\n\t{\n\t\tname: \"termination evidence contradiction\",\n\t\trequest,\n\t\tresponse: { ...success, termination: \"confirmed\" },\n\t},\n] satisfies readonly HumainAgentExecutionContractVector[]);\n\nconst PROGRESS_T0 = 1_760_000_000_000;\nconst PROGRESS_RUNTIME_ID = \"bbbbbbbb-bbbb-4bbb-8bbb-000000000001\";\nconst PROGRESS_EPOCH_A = \"cccccccc-cccc-4ccc-8ccc-000000000001\";\nconst PROGRESS_EPOCH_B = \"cccccccc-cccc-4ccc-8ccc-000000000002\";\n\nconst progressUuid = (n: number): string => `aaaaaaaa-aaaa-4aaa-8aaa-${n.toString(16).padStart(12, \"0\")}`;\n\nfunction progressWorker(n: number, overrides: Partial<SubagentWorkerSnapshot> = {}): SubagentWorkerSnapshot {\n\treturn {\n\t\tworkerId: progressUuid(0x1000 + n),\n\t\tattempt: 1,\n\t\tstatus: \"running\",\n\t\tcancelRequested: false,\n\t\tcancellationOutcome: \"none\",\n\t\tagent: \"scout\",\n\t\tlabel: `task-${n}`,\n\t\ttask: `Inspect module ${n} and summarise its public surface`,\n\t\tmodel: \"anthropic/claude-sonnet-5\",\n\t\tstartedAt: PROGRESS_T0 + 100,\n\t\tendedAt: null,\n\t\tturns: 1,\n\t\ttoolCalls: 2,\n\t\tfailureKind: null,\n\t\tresultPreview: null,\n\t\t...overrides,\n\t};\n}\n\nfunction progressRun(n: number, overrides: Partial<SubagentRunSnapshot> = {}): SubagentRunSnapshot {\n\treturn {\n\t\trunId: progressUuid(n),\n\t\tseq: 1,\n\t\tfinal: false,\n\t\tworkers: [progressWorker(n)],\n\t\ttoolCallId: `call_${n}`,\n\t\tmode: \"single\",\n\t\tstartedAt: PROGRESS_T0,\n\t\tendedAt: null,\n\t\t...overrides,\n\t};\n}\n\nfunction progressEnvelope(\n\truns: SubagentRunSnapshot[],\n\toverrides: Partial<SubagentProgressSnapshot> = {},\n): SubagentProgressSnapshot {\n\treturn {\n\t\tschemaVersion: 1,\n\t\truntimeId: PROGRESS_RUNTIME_ID,\n\t\tsessionEpoch: PROGRESS_EPOCH_A,\n\t\tcomplete: true,\n\t\truns,\n\t\t...overrides,\n\t};\n}\n\nconst completedWorker = (n: number, overrides: Partial<SubagentWorkerSnapshot> = {}): SubagentWorkerSnapshot =>\n\tprogressWorker(n, {\n\t\tstatus: \"completed\",\n\t\tendedAt: PROGRESS_T0 + 900,\n\t\tturns: 3,\n\t\ttoolCalls: 5,\n\t\tresultPreview: \"Found two exported entry points\",\n\t\t...overrides,\n\t});\n\nconst sequenceRunId = progressUuid(0x50);\n\n/**\n * Valid C1 (schemaVersion 1) subagent progress envelopes with fixed UUIDs and timestamps, for Forge\n * lead and consumer tests. `sequenceN` / `sequenceNPlus1` share a runId and model stale-ordering checks\n * (a consumer must ignore `sequenceN` after `sequenceNPlus1`). `sessionEpochA` / `sessionEpochB` share a\n * runtimeId but differ in sessionEpoch (session change).\n */\nexport const subagentProgressFixtures = deepFreeze({\n\tparallelRunningWorkers: progressEnvelope([\n\t\tprogressRun(1, {\n\t\t\tmode: \"parallel\",\n\t\t\tseq: 3,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(1, { agent: \"scout\", label: \"scan-api\", startedAt: PROGRESS_T0 + 100 }),\n\t\t\t\tprogressWorker(2, {\n\t\t\t\t\tagent: \"reviewer\",\n\t\t\t\t\tlabel: \"scan-ui\",\n\t\t\t\t\tmodel: \"openai/gpt-5\",\n\t\t\t\t\tstartedAt: PROGRESS_T0 + 120,\n\t\t\t\t\tturns: 0,\n\t\t\t\t\ttoolCalls: 0,\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tretryAttempt2: progressEnvelope([\n\t\tprogressRun(2, {\n\t\t\tseq: 4,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(3, {\n\t\t\t\t\tattempt: 2,\n\t\t\t\t\tmodel: \"anthropic/claude-opus-5\",\n\t\t\t\t\tstartedAt: PROGRESS_T0 + 500,\n\t\t\t\t\tturns: 0,\n\t\t\t\t\ttoolCalls: 0,\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tfailedWorker: progressEnvelope([\n\t\tprogressRun(3, {\n\t\t\tseq: 5,\n\t\t\tfinal: true,\n\t\t\tendedAt: PROGRESS_T0 + 700,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(4, {\n\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\tfailureKind: \"process_error\",\n\t\t\t\t\tendedAt: PROGRESS_T0 + 700,\n\t\t\t\t\tresultPreview: \"Worker exited with code 1\",\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tcancelledNotStarted: progressEnvelope([\n\t\tprogressRun(4, {\n\t\t\tseq: 6,\n\t\t\tfinal: true,\n\t\t\tmode: \"parallel\",\n\t\t\tendedAt: PROGRESS_T0 + 800,\n\t\t\tworkers: [\n\t\t\t\tcompletedWorker(5, { endedAt: PROGRESS_T0 + 600 }),\n\t\t\t\tprogressWorker(6, {\n\t\t\t\t\tstatus: \"cancelled\",\n\t\t\t\t\tattempt: 0,\n\t\t\t\t\tcancelRequested: true,\n\t\t\t\t\tcancellationOutcome: \"not_started\",\n\t\t\t\t\tstartedAt: null,\n\t\t\t\t\tturns: 0,\n\t\t\t\t\ttoolCalls: 0,\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tcancelledDirectWorkerTerminated: progressEnvelope([\n\t\tprogressRun(5, {\n\t\t\tseq: 7,\n\t\t\tfinal: true,\n\t\t\tendedAt: PROGRESS_T0 + 800,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(7, {\n\t\t\t\t\tstatus: \"cancelled\",\n\t\t\t\t\tcancelRequested: true,\n\t\t\t\t\tcancellationOutcome: \"direct_worker_terminated\",\n\t\t\t\t\tendedAt: PROGRESS_T0 + 750,\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tcancelledUnconfirmedUnresolved: progressEnvelope([\n\t\tprogressRun(6, {\n\t\t\tseq: 8,\n\t\t\tfinal: true,\n\t\t\tendedAt: PROGRESS_T0 + 900,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(8, {\n\t\t\t\t\tstatus: \"unresolved\",\n\t\t\t\t\tcancelRequested: true,\n\t\t\t\t\tcancellationOutcome: \"unconfirmed\",\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tskippedWorker: progressEnvelope([\n\t\tprogressRun(7, {\n\t\t\tseq: 9,\n\t\t\tfinal: true,\n\t\t\tmode: \"chain\",\n\t\t\tendedAt: PROGRESS_T0 + 650,\n\t\t\tworkers: [\n\t\t\t\tprogressWorker(9, {\n\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\tfailureKind: \"model_error\",\n\t\t\t\t\tendedAt: PROGRESS_T0 + 650,\n\t\t\t\t\tresultPreview: \"Model request failed\",\n\t\t\t\t}),\n\t\t\t\tprogressWorker(10, {\n\t\t\t\t\tstatus: \"skipped\",\n\t\t\t\t\tattempt: 0,\n\t\t\t\t\tstartedAt: null,\n\t\t\t\t\tturns: 0,\n\t\t\t\t\ttoolCalls: 0,\n\t\t\t\t\tmodel: null,\n\t\t\t\t}),\n\t\t\t],\n\t\t}),\n\t]),\n\tincomplete: progressEnvelope([progressRun(8)], { complete: false }),\n\tfinalRun: progressEnvelope([\n\t\tprogressRun(9, {\n\t\t\tseq: 12,\n\t\t\tfinal: true,\n\t\t\tendedAt: PROGRESS_T0 + 950,\n\t\t\tworkers: [completedWorker(11, { endedAt: PROGRESS_T0 + 940 })],\n\t\t}),\n\t]),\n\tsequenceN: progressEnvelope([\n\t\tprogressRun(0x50, {\n\t\t\trunId: sequenceRunId,\n\t\t\tseq: 10,\n\t\t\tmode: \"parallel\",\n\t\t\tworkers: [progressWorker(12), progressWorker(13)],\n\t\t}),\n\t]),\n\tsequenceNPlus1: progressEnvelope([\n\t\tprogressRun(0x50, {\n\t\t\trunId: sequenceRunId,\n\t\t\tseq: 11,\n\t\t\tmode: \"parallel\",\n\t\t\tworkers: [completedWorker(12), progressWorker(13)],\n\t\t}),\n\t]),\n\tsessionEpochA: progressEnvelope([progressRun(0x60)], { sessionEpoch: PROGRESS_EPOCH_A }),\n\tsessionEpochB: progressEnvelope([progressRun(0x61)], { sessionEpoch: PROGRESS_EPOCH_B }),\n});\n\n/**\n * Envelopes every C1 parser must reject. `extraKey`, `controlCharInTask` and `overLengthTask` are also\n * rejected by the structural TypeBox schemas; the other entries violate cross-field or text rules that\n * only the parsers enforce.\n */\nexport const invalidSubagentProgressFixtures: Readonly<Record<string, unknown>> = deepFreeze({\n\textraKey: { ...progressEnvelope([progressRun(1)]), transcript: \"SECRET\" },\n\tcontrolCharInTask: progressEnvelope([\n\t\tprogressRun(1, { workers: [progressWorker(1, { task: \"Inspect\\u0007 module\" })] }),\n\t]),\n\toverLengthTask: progressEnvelope([progressRun(1, { workers: [progressWorker(1, { task: \"x\".repeat(121) })] })]),\n\tloneSurrogateInTask: progressEnvelope([\n\t\tprogressRun(1, { workers: [progressWorker(1, { task: \"Inspect \\ud800 module\" })] }),\n\t]),\n\tfailureKindOnCompletedWorker: progressEnvelope([\n\t\tprogressRun(1, { workers: [completedWorker(1, { failureKind: \"process_error\" })] }),\n\t]),\n\tfinalRunWithRunningWorker: progressEnvelope([\n\t\tprogressRun(1, { final: true, endedAt: PROGRESS_T0 + 500, workers: [progressWorker(1)] }),\n\t]),\n});\n\nfunction deepFreeze<T>(value: T): T {\n\tif (value === null || typeof value !== \"object\" || Object.isFrozen(value)) return value;\n\tObject.freeze(value);\n\tfor (const child of Object.values(value)) deepFreeze(child);\n\treturn value;\n}\n"]}