@humain/humain-code-contracts 0.3.2

package/dist/testing.d.ts

@@ -0,0 +1,390 @@
+import type { SubagentProgressSnapshot } from "./subagent-progress.ts";
+export interface HumainAgentExecutionContractVector {
+    readonly name: string;
+    readonly request: unknown;
+    readonly response?: unknown;
+}
+export declare const HUMAIN_AGENT_EXECUTION_VALID_VECTORS: ({
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+    response?: undefined;
+} | {
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+    response: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        termination: string;
+        outcomes: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            kind: string;
+            output: {
+                summary: string;
+                artifacts: never[];
+            };
+            usage: {
+                status: string;
+                totalTokens: number;
+                costMicrocents: number;
+            };
+        }[];
+    };
+} | {
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        invocationId: string;
+        mode: string;
+        batchId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+    response: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        batchId: string;
+        termination: string;
+        outcomes: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            kind: string;
+            failureCode: string;
+            usage: {
+                status: string;
+            };
+        }[];
+    };
+} | {
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+        }[];
+    };
+    response: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        termination: string;
+        outcomes: {
+            workUnitId: string;
+            nodeId: string;
+            kind: string;
+            output: {
+                summary: string;
+                artifacts: never[];
+            };
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            usage: {
+                status: string;
+                totalCalls: number;
+                totalTurns: number;
+                totalTokens: number;
+                costMicrocents: number;
+            };
+        }[];
+    };
+})[];
+export declare const HUMAIN_AGENT_EXECUTION_INVALID_VECTORS: ({
+    response?: undefined;
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+        provider: string;
+    };
+} | {
+    response?: undefined;
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    digest: string;
+                    reference: string;
+                }[];
+            };
+        }[];
+    };
+} | {
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+    response: {
+        schemaVersion: number;
+        kind: string;
+        mode: string;
+        invocationId: string;
+        termination: string;
+        outcomes: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            kind: string;
+            usage: {
+                status: string;
+                totalTokens: number;
+                costMicrocents: number;
+            };
+            output: {
+                summary: string;
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+} | {
+    response?: undefined;
+    name: string;
+    request: {
+        schemaVersion: number;
+        kind: string;
+        invocationId: string;
+        mode: string;
+        batchId: string;
+        claims: {
+            workUnitId: string;
+            nodeId: string;
+            attemptNumber: number;
+            attemptFence: number;
+            segmentFence: number;
+            routeRef: string;
+            task: string;
+            controls: {
+                maxConcurrency: number;
+                maxDepth: number;
+                depth: number;
+                timeoutMs: number;
+            };
+            input: {
+                artifacts: {
+                    id: string;
+                    kind: string;
+                    reference: string;
+                    digest: string;
+                }[];
+            };
+        }[];
+    };
+})[];
+/**
+ * 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 declare const subagentProgressFixtures: {
+    parallelRunningWorkers: SubagentProgressSnapshot;
+    retryAttempt2: SubagentProgressSnapshot;
+    failedWorker: SubagentProgressSnapshot;
+    cancelledNotStarted: SubagentProgressSnapshot;
+    cancelledDirectWorkerTerminated: SubagentProgressSnapshot;
+    cancelledUnconfirmedUnresolved: SubagentProgressSnapshot;
+    skippedWorker: SubagentProgressSnapshot;
+    incomplete: SubagentProgressSnapshot;
+    finalRun: SubagentProgressSnapshot;
+    sequenceN: SubagentProgressSnapshot;
+    sequenceNPlus1: SubagentProgressSnapshot;
+    sessionEpochA: SubagentProgressSnapshot;
+    sessionEpochB: SubagentProgressSnapshot;
+};
+/**
+ * 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 declare const invalidSubagentProgressFixtures: Readonly<Record<string, unknown>>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAA+C,MAAM,wBAAwB,CAAC;AAEpH,MAAM,WAAW,kCAAkC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC5B;AA0ED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;gBA/DpC,cAAc;gBAAK,QAAQ;gBAAK,KAAK;gBAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAiCnD,OAAO;gBAAmC,SAAS;;;gBACpD,MAAM;gBAAc,WAAW;gBAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAyBpD,MAAM;;;;;;;;;;;;;;;;;gBA3DJ,cAAc;gBAAK,QAAQ;gBAAK,KAAK;gBAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;gBAiCnD,OAAO;gBAAmC,SAAS;;;;;;gBA4D1D,MAAM;gBACN,UAAU;gBACV,UAAU;gBACV,WAAW;gBACX,cAAc;;;;IAMsC,CAAC;AAE3D,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;gBAzGtC,cAAc;gBAAK,QAAQ;gBAAK,KAAK;gBAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAAnD,cAAc;gBAAK,QAAQ;gBAAK,KAAK;gBAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAkCpD,MAAM;gBAAc,WAAW;gBAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoJL,CAAC;AAsE3D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;CAmJnC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe5E,CAAC"}