@osstack/protocol 0.10.0

package/dist/policy.d.ts

@@ -0,0 +1,284 @@
+import { z } from "zod";
+/** Cost tier of a candidate agent (mirrors core CostTier). */
+export declare const CostTier: z.ZodEnum<["low", "mid", "high"]>;
+export type CostTier = z.infer<typeof CostTier>;
+/** A rule's partial contribution to a candidate's total score. */
+export declare const PolicyScore: z.ZodObject<{
+    value: z.ZodNumber;
+    reason: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    value: number;
+    reason: string;
+}, {
+    value: number;
+    reason: string;
+}>;
+export type PolicyScore = z.infer<typeof PolicyScore>;
+export declare const PolicyCandidate: z.ZodObject<{
+    agent_id: z.ZodString;
+    cost_tier: z.ZodEnum<["low", "mid", "high"]>;
+    /** Opaque in v1 — core's Capability schema is not pre-imported. */
+    capabilities: z.ZodArray<z.ZodUnknown, "many">;
+}, "strict", z.ZodTypeAny, {
+    agent_id: string;
+    cost_tier: "low" | "high" | "mid";
+    capabilities: unknown[];
+}, {
+    agent_id: string;
+    cost_tier: "low" | "high" | "mid";
+    capabilities: unknown[];
+}>;
+export type PolicyCandidate = z.infer<typeof PolicyCandidate>;
+export declare const PolicyOutcome: z.ZodObject<{
+    candidate: z.ZodObject<{
+        agent_id: z.ZodString;
+        cost_tier: z.ZodEnum<["low", "mid", "high"]>;
+        /** Opaque in v1 — core's Capability schema is not pre-imported. */
+        capabilities: z.ZodArray<z.ZodUnknown, "many">;
+    }, "strict", z.ZodTypeAny, {
+        agent_id: string;
+        cost_tier: "low" | "high" | "mid";
+        capabilities: unknown[];
+    }, {
+        agent_id: string;
+        cost_tier: "low" | "high" | "mid";
+        capabilities: unknown[];
+    }>;
+    total: z.ZodNumber;
+    breakdown: z.ZodArray<z.ZodObject<{
+        rule_id: z.ZodString;
+        value: z.ZodNumber;
+        reason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        value: number;
+        reason: string;
+        rule_id: string;
+    }, {
+        value: number;
+        reason: string;
+        rule_id: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    candidate: {
+        agent_id: string;
+        cost_tier: "low" | "high" | "mid";
+        capabilities: unknown[];
+    };
+    total: number;
+    breakdown: {
+        value: number;
+        reason: string;
+        rule_id: string;
+    }[];
+}, {
+    candidate: {
+        agent_id: string;
+        cost_tier: "low" | "high" | "mid";
+        capabilities: unknown[];
+    };
+    total: number;
+    breakdown: {
+        value: number;
+        reason: string;
+        rule_id: string;
+    }[];
+}>;
+export type PolicyOutcome = z.infer<typeof PolicyOutcome>;
+/** Handoff gate: when triggered, dispatch pauses for human approval. */
+export declare const PolicyHandoff: z.ZodObject<{
+    triggered: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    triggered: boolean;
+    reason?: string | undefined;
+}, {
+    triggered: boolean;
+    reason?: string | undefined;
+}>;
+export type PolicyHandoff = z.infer<typeof PolicyHandoff>;
+export declare const PolicyDecision: z.ZodObject<{
+    /** Winning outcome, or null when no candidate qualified. */
+    winner: z.ZodNullable<z.ZodObject<{
+        candidate: z.ZodObject<{
+            agent_id: z.ZodString;
+            cost_tier: z.ZodEnum<["low", "mid", "high"]>;
+            /** Opaque in v1 — core's Capability schema is not pre-imported. */
+            capabilities: z.ZodArray<z.ZodUnknown, "many">;
+        }, "strict", z.ZodTypeAny, {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        }, {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        }>;
+        total: z.ZodNumber;
+        breakdown: z.ZodArray<z.ZodObject<{
+            rule_id: z.ZodString;
+            value: z.ZodNumber;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }, {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }, {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }>>;
+    /** All candidates, sorted desc by total score. */
+    ranked: z.ZodArray<z.ZodObject<{
+        candidate: z.ZodObject<{
+            agent_id: z.ZodString;
+            cost_tier: z.ZodEnum<["low", "mid", "high"]>;
+            /** Opaque in v1 — core's Capability schema is not pre-imported. */
+            capabilities: z.ZodArray<z.ZodUnknown, "many">;
+        }, "strict", z.ZodTypeAny, {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        }, {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        }>;
+        total: z.ZodNumber;
+        breakdown: z.ZodArray<z.ZodObject<{
+            rule_id: z.ZodString;
+            value: z.ZodNumber;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }, {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }, {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }>, "many">;
+    handoff: z.ZodObject<{
+        triggered: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        triggered: boolean;
+        reason?: string | undefined;
+    }, {
+        triggered: boolean;
+        reason?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    winner: {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    } | null;
+    ranked: {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }[];
+    handoff: {
+        triggered: boolean;
+        reason?: string | undefined;
+    };
+}, {
+    winner: {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    } | null;
+    ranked: {
+        candidate: {
+            agent_id: string;
+            cost_tier: "low" | "high" | "mid";
+            capabilities: unknown[];
+        };
+        total: number;
+        breakdown: {
+            value: number;
+            reason: string;
+            rule_id: string;
+        }[];
+    }[];
+    handoff: {
+        triggered: boolean;
+        reason?: string | undefined;
+    };
+}>;
+export type PolicyDecision = z.infer<typeof PolicyDecision>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,mCAAiC,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,kEAAkE;AAClE,eAAO,MAAM,WAAW;;;;;;;;;EAKb,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe;;;IAIxB,mEAAmE;;;;;;;;;;EAG5D,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAU9D,eAAO,MAAM,aAAa;;;;QAdtB,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB5D,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,wEAAwE;AACxE,eAAO,MAAM,aAAa;;;;;;;;;EAKf,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc;IAEvB,4DAA4D;;;;;YAlC5D,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoCnE,kDAAkD;;;;;YApClD,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC5D,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/policy.js

@@ -0,0 +1,58 @@
+// PolicyDecision — the router/policy engine decision, as a Zod schema.
+//
+// Extraction (architecture §1): core/policy/types.ts `PolicyDecision` is an
+// interface today; protocol makes it executable Zod (core re-exports later in
+// R1.2). Structure preserved verbatim: { winner, ranked, handoff }.
+//
+// Domain-neutrality: a PolicyCandidate's `capabilities` are kept OPAQUE
+// (z.unknown()) in v1 — the full @osstack/core Capability schema is deliberately
+// NOT pre-imported (owner constraint, same discipline as Task.evaluation).
+import { z } from "zod";
+/** Cost tier of a candidate agent (mirrors core CostTier). */
+export const CostTier = z.enum(["low", "mid", "high"]);
+/** A rule's partial contribution to a candidate's total score. */
+export const PolicyScore = z
+    .object({
+    value: z.number(),
+    reason: z.string(),
+})
+    .strict();
+export const PolicyCandidate = z
+    .object({
+    agent_id: z.string().min(1),
+    cost_tier: CostTier,
+    /** Opaque in v1 — core's Capability schema is not pre-imported. */
+    capabilities: z.array(z.unknown()),
+})
+    .strict();
+const PolicyBreakdownEntry = z
+    .object({
+    rule_id: z.string(),
+    value: z.number(),
+    reason: z.string(),
+})
+    .strict();
+export const PolicyOutcome = z
+    .object({
+    candidate: PolicyCandidate,
+    total: z.number(),
+    breakdown: z.array(PolicyBreakdownEntry),
+})
+    .strict();
+/** Handoff gate: when triggered, dispatch pauses for human approval. */
+export const PolicyHandoff = z
+    .object({
+    triggered: z.boolean(),
+    reason: z.string().optional(),
+})
+    .strict();
+export const PolicyDecision = z
+    .object({
+    /** Winning outcome, or null when no candidate qualified. */
+    winner: PolicyOutcome.nullable(),
+    /** All candidates, sorted desc by total score. */
+    ranked: z.array(PolicyOutcome),
+    handoff: PolicyHandoff,
+})
+    .strict();
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,iFAAiF;AACjF,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAGvD,kEAAkE;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,QAAQ;IACnB,mEAAmE;IACnE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACnC,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;CACzC,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,4DAA4D;IAC5D,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE;IAChC,kDAAkD;IAClD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAC9B,OAAO,EAAE,aAAa;CACvB,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.test.d.ts.map

package/dist/protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.d.ts","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":""}

package/dist/protocol.test.js

@@ -0,0 +1,251 @@
+// Protocol contract tests: fixture parsing, invalid rejection, backward-compat
+// corpus, consumer-lenient parsing, and the A-003 status<->code mapping.
+import { readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { AgentCommand, AgentCommandResult, ApprovalDecision, ApprovalRequest, EventEnvelope, EvidenceRef, parseInboundAgentCommand, parseInboundAgentCommandResult, PolicyDecision, RunSummary, Task, } from "./index.js";
+const VALID_DIR = fileURLToPath(new URL("../fixtures/valid", import.meta.url));
+const INVALID_DIR = fileURLToPath(new URL("../fixtures/invalid", import.meta.url));
+/** Maps a fixture's schema key to the strict schema that must validate it. */
+const SCHEMA_BY_KEY = {
+    task: Task,
+    "run-summary": RunSummary,
+    "event-envelope": EventEnvelope,
+    "evidence-ref": EvidenceRef,
+    "approval-request": ApprovalRequest,
+    "approval-decision": ApprovalDecision,
+    "policy-decision": PolicyDecision,
+    "agent-command": AgentCommand,
+    "agent-command-result": AgentCommandResult,
+};
+/** Fixture filename -> schema key: strip the .(valid|invalid).json suffix, then
+ *  drop any `__variant` discriminator (e.g. agent-command-result__blocked). */
+function schemaKeyOf(filename) {
+    const base = filename.replace(/\.(valid|invalid)\.json$/, "");
+    return base.split("__")[0];
+}
+function readJson(dir, filename) {
+    return JSON.parse(readFileSync(`${dir}/${filename}`, "utf-8"));
+}
+function schemaFor(filename) {
+    const key = schemaKeyOf(filename);
+    const schema = SCHEMA_BY_KEY[key];
+    if (!schema)
+        throw new Error(`no schema registered for key '${key}' (fixture ${filename})`);
+    return schema;
+}
+const validFiles = readdirSync(VALID_DIR).filter((f) => f.endsWith(".valid.json")).sort();
+const invalidFiles = readdirSync(INVALID_DIR).filter((f) => f.endsWith(".invalid.json")).sort();
+// ── Backward-compatibility corpus (A-007) ─────────────────────────────────
+// APPEND-ONLY. Every fixture published for protocol major 1 MUST parse against
+// all later minors, forever. Never delete or mutate an entry; a breaking change
+// is a new MAJOR with a new fixture directory. Adding a row is allowed.
+const FROZEN_V1_FIXTURES = [
+    "agent-command-result.valid.json",
+    "agent-command-result__blocked.valid.json",
+    "agent-command-result__error.valid.json",
+    "agent-command-result__needs-approval.valid.json",
+    "agent-command.valid.json",
+    "approval-decision.valid.json",
+    "approval-request.valid.json",
+    "event-envelope.valid.json",
+    "evidence-ref.valid.json",
+    "policy-decision.valid.json",
+    "run-summary.valid.json",
+    "task.valid.json",
+];
+describe("valid fixtures parse with their schema", () => {
+    it("covers at least one fixture per protocol type", () => {
+        const keys = new Set(validFiles.map(schemaKeyOf));
+        for (const key of Object.keys(SCHEMA_BY_KEY)) {
+            expect(keys, `missing a valid fixture for '${key}'`).toContain(key);
+        }
+    });
+    for (const filename of validFiles) {
+        it(`parses ${filename}`, () => {
+            const result = schemaFor(filename).safeParse(readJson(VALID_DIR, filename));
+            if (!result.success) {
+                throw new Error(`${filename} should parse but failed:\n${result.error.toString()}`);
+            }
+            expect(result.success).toBe(true);
+        });
+    }
+});
+describe("invalid fixtures are rejected and document why", () => {
+    it("covers at least one invalid fixture per protocol type", () => {
+        const keys = new Set(invalidFiles.map(schemaKeyOf));
+        for (const key of Object.keys(SCHEMA_BY_KEY)) {
+            expect(keys, `missing an invalid fixture for '${key}'`).toContain(key);
+        }
+    });
+    for (const filename of invalidFiles) {
+        it(`rejects ${filename}`, () => {
+            const fixture = readJson(INVALID_DIR, filename);
+            expect(typeof fixture.$reason, `${filename} must document a $reason`).toBe("string");
+            expect(fixture.$reason.length).toBeGreaterThan(0);
+            expect("value" in fixture, `${filename} must carry a value`).toBe(true);
+            const result = schemaFor(filename).safeParse(fixture.value);
+            expect(result.success, `${filename} should be rejected but parsed`).toBe(false);
+        });
+    }
+});
+describe("backward-compatibility corpus (A-007, append-only)", () => {
+    it("the on-disk valid corpus exactly matches FROZEN_V1_FIXTURES", () => {
+        // Two-way equality: nothing added without registering, nothing frozen removed.
+        expect(validFiles).toEqual([...FROZEN_V1_FIXTURES].sort());
+    });
+    it("every frozen fixture still parses under the current schemas", () => {
+        for (const filename of FROZEN_V1_FIXTURES) {
+            const result = schemaFor(filename).safeParse(readJson(VALID_DIR, filename));
+            expect(result.success, `${filename} broke backward compatibility`).toBe(true);
+        }
+    });
+});
+describe("consumer-lenient vs producer-strict (A-007)", () => {
+    it("an unknown extra field fails the strict schema but passes the lenient parser", () => {
+        const fixture = readJson(INVALID_DIR, "agent-command__unknown-field.invalid.json");
+        // Producer-strict rejects the unknown field.
+        expect(AgentCommand.safeParse(fixture.value).success).toBe(false);
+        // Consumer-lenient accepts it and preserves the passthrough field.
+        const parsed = parseInboundAgentCommand(fixture.value);
+        expect(parsed.command).toBe("portfolio.daily");
+        expect(parsed.debug).toBe(true);
+    });
+    it("the lenient result parser tolerates unknown fields but still enforces A-003", () => {
+        const okWithExtra = {
+            protocol_version: "1.0",
+            status: "ok",
+            result: {},
+            trace_id: "abc",
+        };
+        expect(AgentCommandResult.safeParse(okWithExtra).success).toBe(false); // strict rejects extra
+        expect(() => parseInboundAgentCommandResult(okWithExtra)).not.toThrow(); // lenient accepts
+        // Business rule still enforced by the lenient parser.
+        expect(() => parseInboundAgentCommandResult({ protocol_version: "1.0", status: "error", trace_id: "x" })).toThrow();
+    });
+});
+describe("deep consumer leniency (A-007 — unknown fields in NESTED objects)", () => {
+    it("v1.1-style unknown field inside actor: lenient accepts, strict rejects", () => {
+        const command = {
+            protocol_version: "1.1",
+            command: "portfolio.daily",
+            actor: { type: "human", id: "osborn", display_name: "Osborn" },
+            input: {},
+        };
+        expect(AgentCommand.safeParse(command).success).toBe(false);
+        const parsed = parseInboundAgentCommand(command);
+        expect(parsed.actor.id).toBe("osborn");
+        expect(parsed.actor.display_name).toBe("Osborn");
+    });
+    it("unknown field inside scope: lenient accepts, strict rejects", () => {
+        const command = {
+            protocol_version: "1.1",
+            command: "delivery.start",
+            actor: { type: "agent", id: "claude-code" },
+            scope: { repo_id: "osborn-pa", branch: "main" },
+            input: {},
+        };
+        expect(AgentCommand.safeParse(command).success).toBe(false);
+        expect(() => parseInboundAgentCommand(command)).not.toThrow();
+    });
+    it("unknown field inside an ApprovalRequest item: lenient accepts, strict rejects", () => {
+        const result = {
+            protocol_version: "1.1",
+            status: "needs_approval",
+            required_approvals: [
+                {
+                    approval_id: "appr_01",
+                    action: "Deploy to production",
+                    risk: "high",
+                    requested_at: "2026-07-11T09:05:00.000Z",
+                    expires_at: "2026-07-12T09:05:00.000Z",
+                },
+            ],
+        };
+        expect(AgentCommandResult.safeParse(result).success).toBe(false);
+        expect(() => parseInboundAgentCommandResult(result)).not.toThrow();
+    });
+    it("unknown field inside an EvidenceRef item: lenient accepts, strict rejects", () => {
+        const result = {
+            protocol_version: "1.1",
+            status: "ok",
+            evidence_refs: [{ kind: "proof", ref: "release/proof/", bytes: 1024 }],
+        };
+        expect(AgentCommandResult.safeParse(result).success).toBe(false);
+        expect(() => parseInboundAgentCommandResult(result)).not.toThrow();
+    });
+    it("unknown field inside the error object: lenient accepts, strict rejects", () => {
+        const result = {
+            protocol_version: "1.1",
+            status: "error",
+            error: { code: "internal", message: "boom", retryable: true, trace_id: "t_1" },
+        };
+        expect(AgentCommandResult.safeParse(result).success).toBe(false);
+        expect(() => parseInboundAgentCommandResult(result)).not.toThrow();
+    });
+    it("deep leniency does not weaken A-003: nested-lenient blocked result still needs a blocked code", () => {
+        const result = {
+            protocol_version: "1.1",
+            status: "blocked",
+            error: { code: "internal", message: "boom", retryable: true, trace_id: "t_1" },
+        };
+        expect(() => parseInboundAgentCommandResult(result)).toThrow();
+    });
+});
+describe("A-003 / A-006 status<->code mapping", () => {
+    it("accepts status ok without an error object", () => {
+        expect(AgentCommandResult.safeParse({ protocol_version: "1.0", status: "ok", result: {} }).success).toBe(true);
+    });
+    it("rejects status error without an error object", () => {
+        expect(AgentCommandResult.safeParse({ protocol_version: "1.0", status: "error" }).success).toBe(false);
+    });
+    it("rejects status blocked with an internal (non-blocked) error code", () => {
+        expect(AgentCommandResult.safeParse({
+            protocol_version: "1.0",
+            status: "blocked",
+            error: { code: "internal", message: "boom", retryable: true },
+        }).success).toBe(false);
+    });
+    it("accepts status blocked with policy_denied and budget_exceeded", () => {
+        for (const code of ["policy_denied", "budget_exceeded"]) {
+            expect(AgentCommandResult.safeParse({
+                protocol_version: "1.0",
+                status: "blocked",
+                error: { code, message: "denied", retryable: false },
+            }).success, `blocked+${code} should be accepted`).toBe(true);
+        }
+    });
+    it("rejects status error carrying a blocked-only code (A-006)", () => {
+        expect(AgentCommandResult.safeParse({
+            protocol_version: "1.0",
+            status: "error",
+            error: { code: "policy_denied", message: "denied", retryable: false },
+        }).success).toBe(false);
+    });
+    it("rejects status needs_approval with an empty required_approvals", () => {
+        expect(AgentCommandResult.safeParse({
+            protocol_version: "1.0",
+            status: "needs_approval",
+            required_approvals: [],
+        }).success).toBe(false);
+    });
+    it("rejects retryable:true on a non-transient code (A-006), strict and lenient", () => {
+        const result = {
+            protocol_version: "1.0",
+            status: "error",
+            error: { code: "not_found", message: "no such run", retryable: true },
+        };
+        expect(AgentCommandResult.safeParse(result).success).toBe(false);
+        expect(() => parseInboundAgentCommandResult(result)).toThrow();
+    });
+    it("accepts retryable:true for the transient codes internal and conflict (A-006)", () => {
+        for (const code of ["internal", "conflict"]) {
+            expect(AgentCommandResult.safeParse({
+                protocol_version: "1.0",
+                status: "error",
+                error: { code, message: "transient", retryable: true },
+            }).success, `error+${code}+retryable should be accepted`).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.js","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":"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"}

package/dist/run.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/** Terminal outcome of a run (common denominator of executor AgentRun outcomes). */
+export declare const RunOutcome: z.ZodEnum<["completed", "failed", "cancelled"]>;
+export type RunOutcome = z.infer<typeof RunOutcome>;
+export declare const RunSummary: z.ZodObject<{
+    run_id: z.ZodString;
+    task_id: z.ZodString;
+    agent_id: z.ZodString;
+    outcome: z.ZodEnum<["completed", "failed", "cancelled"]>;
+    started_at: z.ZodString;
+    completed_at: z.ZodOptional<z.ZodString>;
+    duration_ms: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    run_id: string;
+    agent_id: string;
+    task_id: string;
+    outcome: "completed" | "failed" | "cancelled";
+    started_at: string;
+    completed_at?: string | undefined;
+    duration_ms?: number | undefined;
+    summary?: string | undefined;
+}, {
+    run_id: string;
+    agent_id: string;
+    task_id: string;
+    outcome: "completed" | "failed" | "cancelled";
+    started_at: string;
+    completed_at?: string | undefined;
+    duration_ms?: number | undefined;
+    summary?: string | undefined;
+}>;
+export type RunSummary = z.infer<typeof RunSummary>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,eAAO,MAAM,UAAU,iDAA+C,CAAC;AACvE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWZ,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}