agentskeptic 0.1.1

package/dist/actionableFailure.remediationExhaustive.test.js

@@ -0,0 +1,297 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { fileURLToPath } from "node:url";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { deriveActionableFailureWorkflow, EVENT_SEQUENCE_CODE_TO_REMEDIATION, productionStepReasonCodeToRemediation, RUN_CONTEXT_CODE_TO_REMEDIATION, RUN_LEVEL_CODE_TO_REMEDIATION, } from "./actionableFailure.js";
+import { CLI_OPERATIONAL_CODES } from "./cliOperationalCodes.js";
+import { cliErrorEnvelope } from "./failureCatalog.js";
+import { OPERATIONAL_CODE_TO_SUMMARY, PRODUCTION_STEP_REASON_CODES } from "./failureOriginCatalog.js";
+import { OPERATIONAL_DISPOSITION } from "./operationalDisposition.js";
+import { buildRunComparisonReport } from "./runComparison.js";
+import { loadSchemaValidator } from "./schemaLoad.js";
+import { createEmptyVerificationRunContext } from "./verificationRunContext.js";
+import { finalizeEmittedWorkflowResult } from "./workflowTruthReport.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, "..");
+const strongPolicy = {
+    consistencyMode: "strong",
+    verificationWindowMs: 0,
+    pollIntervalMs: 0,
+};
+function baseEngine(partial) {
+    return {
+        schemaVersion: 8,
+        workflowId: "w",
+        status: "inconsistent",
+        runLevelReasons: [],
+        verificationPolicy: strongPolicy,
+        eventSequenceIntegrity: { kind: "normal" },
+        verificationRunContext: createEmptyVerificationRunContext(),
+        steps: [],
+        ...partial,
+    };
+}
+function minimalFailureAnalysisForPrimaryStepCode(code) {
+    return {
+        summary: "s",
+        primaryOrigin: "downstream_system_state",
+        confidence: "high",
+        unknownReasonCodes: [],
+        evidence: [{ scope: "step", seq: 0, toolId: "t", codes: [code] }],
+    };
+}
+function minimalFailureAnalysisForRunLevelCodes(codes) {
+    return {
+        summary: "s",
+        primaryOrigin: "inputs",
+        confidence: "high",
+        unknownReasonCodes: [],
+        evidence: [{ scope: "run_level", codes }],
+    };
+}
+function minimalFailureAnalysisForEventSequenceCodes(codes) {
+    return {
+        summary: "s",
+        primaryOrigin: "workflow_flow",
+        confidence: "high",
+        unknownReasonCodes: [],
+        evidence: [{ scope: "event_sequence", codes }],
+    };
+}
+function minimalFailureAnalysisForRunContextCodes(codes) {
+    return {
+        summary: "s",
+        primaryOrigin: "workflow_flow",
+        confidence: "high",
+        unknownReasonCodes: [],
+        evidence: [{ scope: "run_context", codes }],
+    };
+}
+function sqlRowStep(seq, toolId, keyValue, verified) {
+    return {
+        seq,
+        toolId,
+        intendedEffect: { narrative: "" },
+        observedExecution: { paramsCanonical: "{}" },
+        verificationRequest: {
+            kind: "sql_row",
+            table: "contacts",
+            identityEq: [{ column: "id", value: keyValue }],
+            requiredFields: {},
+        },
+        status: verified ? "verified" : "missing",
+        reasons: verified ? [] : [{ code: "ROW_ABSENT", message: "absent" }],
+        evidenceSummary: {},
+        repeatObservationCount: 1,
+        evaluatedObservationOrdinal: 1,
+        ...(verified ? {} : { failureDiagnostic: "workflow_execution" }),
+    };
+}
+function wfComplete() {
+    const engine = {
+        schemaVersion: 8,
+        workflowId: "w",
+        status: "complete",
+        runLevelReasons: [],
+        verificationPolicy: strongPolicy,
+        eventSequenceIntegrity: { kind: "normal" },
+        verificationRunContext: createEmptyVerificationRunContext(),
+        steps: [sqlRowStep(0, "t", "a", true)],
+    };
+    return finalizeEmittedWorkflowResult(engine);
+}
+function engMalformed() {
+    return {
+        schemaVersion: 8,
+        workflowId: "w",
+        status: "incomplete",
+        runLevelReasons: [{ code: "MALFORMED_EVENT_LINE", message: "bad" }],
+        verificationPolicy: strongPolicy,
+        eventSequenceIntegrity: { kind: "normal" },
+        verificationRunContext: createEmptyVerificationRunContext(),
+        steps: [],
+    };
+}
+function engDuplicateRows() {
+    return {
+        schemaVersion: 8,
+        workflowId: "w",
+        status: "inconsistent",
+        runLevelReasons: [],
+        verificationPolicy: strongPolicy,
+        eventSequenceIntegrity: { kind: "normal" },
+        verificationRunContext: createEmptyVerificationRunContext(),
+        steps: [
+            {
+                seq: 0,
+                toolId: "t",
+                intendedEffect: { narrative: "" },
+                observedExecution: { paramsCanonical: "{}" },
+                verificationRequest: {
+                    kind: "sql_row",
+                    table: "c",
+                    identityEq: [{ column: "id", value: "1" }],
+                    requiredFields: {},
+                },
+                status: "inconsistent",
+                reasons: [{ code: "DUPLICATE_ROWS", message: "d" }],
+                evidenceSummary: {},
+                repeatObservationCount: 1,
+                evaluatedObservationOrdinal: 1,
+                failureDiagnostic: "workflow_execution",
+            },
+        ],
+    };
+}
+describe("remediation exhaustive (Module A)", () => {
+    it("deriveActionableFailureWorkflow matches productionStepReasonCodeToRemediation for every production step code", () => {
+        const engine = baseEngine({});
+        for (const code of PRODUCTION_STEP_REASON_CODES) {
+            const fa = minimalFailureAnalysisForPrimaryStepCode(code);
+            const row = productionStepReasonCodeToRemediation(code);
+            const af = deriveActionableFailureWorkflow(engine, fa);
+            expect(af.recommendedAction, code).toBe(row.recommendedAction);
+            expect(af.automationSafe, code).toBe(row.automationSafe);
+        }
+    });
+    it("deriveActionableFailureWorkflow matches RUN_LEVEL_CODE_TO_REMEDIATION for each run-level map key", () => {
+        const engine = baseEngine({});
+        for (const key of Object.keys(RUN_LEVEL_CODE_TO_REMEDIATION)) {
+            const expected = RUN_LEVEL_CODE_TO_REMEDIATION[key];
+            const fa = minimalFailureAnalysisForRunLevelCodes([key]);
+            const af = deriveActionableFailureWorkflow(engine, fa);
+            expect(af.recommendedAction, key).toBe(expected.recommendedAction);
+            expect(af.automationSafe, key).toBe(expected.automationSafe);
+        }
+    });
+    it("deriveActionableFailureWorkflow matches EVENT_SEQUENCE_CODE_TO_REMEDIATION for each event-sequence map key", () => {
+        const engine = baseEngine({
+            eventSequenceIntegrity: {
+                kind: "irregular",
+                reasons: [{ code: "CAPTURE_ORDER_NOT_MONOTONIC_IN_SEQ", message: "m" }],
+            },
+        });
+        for (const key of Object.keys(EVENT_SEQUENCE_CODE_TO_REMEDIATION)) {
+            const expected = EVENT_SEQUENCE_CODE_TO_REMEDIATION[key];
+            const fa = minimalFailureAnalysisForEventSequenceCodes([key]);
+            const af = deriveActionableFailureWorkflow(engine, fa);
+            expect(af.recommendedAction, key).toBe(expected.recommendedAction);
+            expect(af.automationSafe, key).toBe(expected.automationSafe);
+        }
+    });
+    it("deriveActionableFailureWorkflow matches RUN_CONTEXT_CODE_TO_REMEDIATION for each run-context map key", () => {
+        const engine = baseEngine({});
+        for (const key of Object.keys(RUN_CONTEXT_CODE_TO_REMEDIATION)) {
+            const expected = RUN_CONTEXT_CODE_TO_REMEDIATION[key];
+            const fa = minimalFailureAnalysisForRunContextCodes([key]);
+            const af = deriveActionableFailureWorkflow(engine, fa);
+            expect(af.recommendedAction, key).toBe(expected.recommendedAction);
+            expect(af.automationSafe, key).toBe(expected.automationSafe);
+        }
+    });
+    it("finalizeEmittedWorkflowResult DUPLICATE_ROWS integrates deduplicate remediation (AJV workflow-result)", () => {
+        const out = finalizeEmittedWorkflowResult(engDuplicateRows());
+        const v = loadSchemaValidator("workflow-result");
+        expect(v(out)).toBe(true);
+        expect(out.workflowTruthReport.failureAnalysis).not.toBeNull();
+        expect(out.workflowTruthReport.failureAnalysis?.actionableFailure).toMatchObject({
+            recommendedAction: "deduplicate",
+            automationSafe: false,
+        });
+    });
+    it("cliErrorEnvelope + OPERATIONAL_CODE_TO_SUMMARY: actionableFailure matches OPERATIONAL_DISPOSITION per code", () => {
+        const v = loadSchemaValidator("cli-error-envelope");
+        for (const code of Object.values(CLI_OPERATIONAL_CODES)) {
+            const raw = cliErrorEnvelope(code, OPERATIONAL_CODE_TO_SUMMARY[code]);
+            const parsed = JSON.parse(raw);
+            expect(v(parsed)).toBe(true);
+            const row = OPERATIONAL_DISPOSITION[code];
+            expect(parsed.failureDiagnosis.actionableFailure).toMatchObject({
+                category: row.actionableCategory,
+                severity: row.actionableSeverity,
+                recommendedAction: row.recommendedAction,
+                automationSafe: row.automationSafe,
+            });
+        }
+    });
+    it("unknown operational code yields fixed actionableFailure (cliErrorEnvelope only)", () => {
+        const v = loadSchemaValidator("cli-error-envelope");
+        const parsed = JSON.parse(cliErrorEnvelope("NOT_A_REAL_OPERATIONAL_CODE", "operational failure"));
+        expect(v(parsed)).toBe(true);
+        expect(parsed.failureDiagnosis.actionableFailure).toEqual({
+            category: "unclassified",
+            severity: "medium",
+            recommendedAction: "manual_review",
+            automationSafe: false,
+        });
+    });
+    it("buildRunComparisonReport perRunActionableFailures: two failing runs + trusted complete sentinel", () => {
+        const r0 = finalizeEmittedWorkflowResult(engMalformed());
+        const r1 = finalizeEmittedWorkflowResult(engDuplicateRows());
+        const r2 = wfComplete();
+        const report = buildRunComparisonReport([r0, r1, r2], ["a", "b", "c"]);
+        const v = loadSchemaValidator("run-comparison-report");
+        expect(report.schemaVersion).toBe(4);
+        expect(v(report)).toBe(true);
+        const p0 = report.perRunActionableFailures.find((p) => p.runIndex === 0);
+        const p1 = report.perRunActionableFailures.find((p) => p.runIndex === 1);
+        const p2 = report.perRunActionableFailures.find((p) => p.runIndex === 2);
+        expect(p0.category).toBe("bad_input");
+        expect(p0.recommendedAction).toBe("fix_event_ingest_and_steps");
+        expect(p0.automationSafe).toBe(false);
+        expect(p1.category).toBe("state_inconsistency");
+        expect(p1.recommendedAction).toBe("deduplicate");
+        expect(p1.automationSafe).toBe(false);
+        expect(p2).toMatchObject({
+            category: "complete",
+            severity: "low",
+            recommendedAction: "none",
+            automationSafe: true,
+        });
+    });
+});
+describe("operational success: no stderr envelope (Module A negative)", () => {
+    let dir;
+    let dbPath;
+    beforeAll(() => {
+        dir = mkdtempSync(join(tmpdir(), "etl-remediation-cli-"));
+        dbPath = join(dir, "test.db");
+        const sql = readFileSync(join(root, "examples", "seed.sql"), "utf8");
+        const db = new DatabaseSync(dbPath);
+        db.exec(sql);
+        db.close();
+    });
+    afterAll(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it("wf_complete --no-truth-report: stdout valid, failureAnalysis null, no execution_truth_layer_error", () => {
+        const cliJs = join(root, "dist", "cli.js");
+        const eventsPath = join(root, "examples", "events.ndjson");
+        const registryPath = join(root, "examples", "tools.json");
+        const r = spawnSync(process.execPath, [
+            "--no-warnings",
+            cliJs,
+            "--workflow-id",
+            "wf_complete",
+            "--events",
+            eventsPath,
+            "--registry",
+            registryPath,
+            "--db",
+            dbPath,
+            "--no-truth-report",
+        ], { encoding: "utf8", cwd: root });
+        expect(r.status).toBe(0);
+        expect(r.stderr).toBe("");
+        const parsed = JSON.parse(r.stdout.trim());
+        const validateResult = loadSchemaValidator("workflow-result");
+        expect(validateResult(parsed)).toBe(true);
+        expect(parsed.workflowId).toBe("wf_complete");
+        expect(parsed.workflowTruthReport.failureAnalysis).toBeNull();
+        expect(r.stdout).not.toContain("execution_truth_layer_error");
+    });
+});
+//# sourceMappingURL=actionableFailure.remediationExhaustive.test.js.map

package/dist/actionableFailure.remediationExhaustive.test.js.map

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

package/dist/actionableFailure.test.d.ts

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

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

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

package/dist/actionableFailure.test.js

@@ -0,0 +1,211 @@
+import { describe, expect, it } from "vitest";
+import { ACTIONABLE_FAILURE_CATEGORIES, ACTIONABLE_FAILURE_SEVERITIES, buildActionableCategoryRecurrence, deriveActionableCategory, deriveActionableFailureOperational, deriveActionableFailureWorkflow, deriveSeverityWorkflow, maxConsecutiveStreak, productionStepReasonCodeToActionableCategory, } from "./actionableFailure.js";
+import { buildFailureAnalysis } from "./failureAnalysis.js";
+import { CLI_OPERATIONAL_CODES } from "./cliOperationalCodes.js";
+import { createEmptyVerificationRunContext } from "./verificationRunContext.js";
+const strongPolicy = {
+    consistencyMode: "strong",
+    verificationWindowMs: 0,
+    pollIntervalMs: 0,
+};
+function baseEngine(partial) {
+    return {
+        schemaVersion: 8,
+        workflowId: "w",
+        status: "incomplete",
+        runLevelReasons: [],
+        verificationPolicy: strongPolicy,
+        eventSequenceIntegrity: { kind: "normal" },
+        verificationRunContext: createEmptyVerificationRunContext(),
+        steps: [],
+        ...partial,
+    };
+}
+describe("deriveSeverityWorkflow", () => {
+    it("inconsistent status yields high", () => {
+        expect(deriveSeverityWorkflow(baseEngine({ status: "inconsistent" }))).toBe("high");
+    });
+    it("missing step yields high even when status incomplete", () => {
+        expect(deriveSeverityWorkflow(baseEngine({
+            status: "incomplete",
+            steps: [
+                {
+                    seq: 0,
+                    toolId: "t",
+                    intendedEffect: { narrative: "" },
+                    observedExecution: { paramsCanonical: "{}" },
+                    verificationRequest: null,
+                    status: "missing",
+                    reasons: [{ code: "ROW_ABSENT", message: "m" }],
+                    evidenceSummary: {},
+                    repeatObservationCount: 1,
+                    evaluatedObservationOrdinal: 1,
+                },
+            ],
+        }))).toBe("high");
+    });
+    it("uncertain-only incomplete yields medium", () => {
+        expect(deriveSeverityWorkflow(baseEngine({
+            status: "incomplete",
+            steps: [
+                {
+                    seq: 0,
+                    toolId: "t",
+                    intendedEffect: { narrative: "" },
+                    observedExecution: { paramsCanonical: "{}" },
+                    verificationRequest: {
+                        kind: "sql_row",
+                        table: "t",
+                        identityEq: [{ column: "id", value: "1" }],
+                        requiredFields: {},
+                    },
+                    status: "uncertain",
+                    reasons: [{ code: "ROW_NOT_OBSERVED_WITHIN_WINDOW", message: "w" }],
+                    evidenceSummary: {},
+                    repeatObservationCount: 1,
+                    evaluatedObservationOrdinal: 1,
+                },
+            ],
+        }))).toBe("medium");
+    });
+});
+describe("deriveActionableCategory", () => {
+    it("unclassified when unknownReasonCodes non-empty", () => {
+        const fa = {
+            summary: "s",
+            primaryOrigin: "workflow_flow",
+            confidence: "high",
+            unknownReasonCodes: ["FUTURE_UNKNOWN_RL"],
+            evidence: [{ scope: "run_level", codes: ["FUTURE_UNKNOWN_RL"] }],
+        };
+        expect(deriveActionableCategory(fa)).toBe("unclassified");
+    });
+    it("ambiguous when alternativeHypotheses present", () => {
+        const fa = {
+            summary: "s",
+            primaryOrigin: "downstream_system_state",
+            confidence: "medium",
+            unknownReasonCodes: [],
+            evidence: [{ scope: "step", seq: 0, toolId: "t", codes: ["ROW_ABSENT"] }],
+            alternativeHypotheses: [
+                { primaryOrigin: "downstream_system_state", rationale: "a" },
+                { primaryOrigin: "tool_use", rationale: "b" },
+            ],
+        };
+        expect(deriveActionableCategory(fa)).toBe("ambiguous");
+    });
+    it("retrieval_failure from run_context RETRIEVAL_ERROR", () => {
+        const fa = {
+            summary: "s",
+            primaryOrigin: "retrieval",
+            confidence: "high",
+            unknownReasonCodes: [],
+            evidence: [{ scope: "run_context", ingestIndex: 0, codes: ["RETRIEVAL_ERROR"] }],
+        };
+        expect(deriveActionableCategory(fa)).toBe("retrieval_failure");
+    });
+    it("decision_error from RETRY_OBSERVATIONS_DIVERGE step code", () => {
+        const fa = {
+            summary: "s",
+            primaryOrigin: "tool_use",
+            confidence: "high",
+            unknownReasonCodes: [],
+            evidence: [{ scope: "step", seq: 0, toolId: "t", codes: ["RETRY_OBSERVATIONS_DIVERGE"] }],
+        };
+        expect(deriveActionableCategory(fa)).toBe("decision_error");
+    });
+    it("run-level NO_STEPS_FOR_WORKFLOW in step-shaped evidence still maps like run_level", () => {
+        const fa = {
+            summary: "s",
+            primaryOrigin: "workflow_flow",
+            confidence: "high",
+            unknownReasonCodes: [],
+            evidence: [{ scope: "step", codes: ["NO_STEPS_FOR_WORKFLOW"] }],
+        };
+        expect(deriveActionableCategory(fa)).toBe("control_flow_problem");
+    });
+});
+describe("productionStepReasonCodeToActionableCategory", () => {
+    it("maps representative six-class codes", () => {
+        expect(productionStepReasonCodeToActionableCategory("UNKNOWN_TOOL")).toBe("bad_input");
+        expect(productionStepReasonCodeToActionableCategory("ROW_ABSENT")).toBe("state_inconsistency");
+        expect(productionStepReasonCodeToActionableCategory("CONNECTOR_ERROR")).toBe("downstream_execution_failure");
+        expect(productionStepReasonCodeToActionableCategory("MULTI_EFFECT_INCOMPLETE")).toBe("bad_input");
+    });
+    it("does not accept run-level-only codes (NO_STEPS_FOR_WORKFLOW, MALFORMED_EVENT_LINE)", () => {
+        expect(() => productionStepReasonCodeToActionableCategory("NO_STEPS_FOR_WORKFLOW")).toThrow(/run-level-only code/);
+        expect(() => productionStepReasonCodeToActionableCategory("MALFORMED_EVENT_LINE")).toThrow(/run-level-only code/);
+    });
+});
+describe("deriveActionableFailureOperational", () => {
+    it("unknown code is unclassified medium", () => {
+        expect(deriveActionableFailureOperational("NOT_A_REAL_OPERATIONAL_CODE")).toEqual({
+            category: "unclassified",
+            severity: "medium",
+            recommendedAction: "manual_review",
+            automationSafe: false,
+        });
+    });
+    it("CLI_USAGE is bad_input low", () => {
+        expect(deriveActionableFailureOperational(CLI_OPERATIONAL_CODES.CLI_USAGE)).toEqual({
+            category: "bad_input",
+            severity: "low",
+            recommendedAction: "fix_cli_usage",
+            automationSafe: false,
+        });
+    });
+});
+describe("maxConsecutiveStreak and buildActionableCategoryRecurrence", () => {
+    it("computes longest consecutive runIndex block", () => {
+        expect(maxConsecutiveStreak([0, 1, 3])).toBe(2);
+        expect(maxConsecutiveStreak([2])).toBe(1);
+        expect(maxConsecutiveStreak([0, 1, 2, 5, 6])).toBe(3);
+    });
+    it("buildActionableCategoryRecurrence sorts categories", () => {
+        const rows = buildActionableCategoryRecurrence([
+            { runIndex: 0, category: "zebra", severity: "low", recommendedAction: "none", automationSafe: true },
+            { runIndex: 1, category: "apple", severity: "low", recommendedAction: "none", automationSafe: true },
+        ]);
+        expect(rows.map((r) => r.category)).toEqual(["apple", "zebra"]);
+    });
+});
+describe("ACTIONABLE_FAILURE_CATEGORIES / SEVERITIES parity", () => {
+    it("has eight categories and three severities", () => {
+        expect(ACTIONABLE_FAILURE_CATEGORIES).toHaveLength(8);
+        expect(ACTIONABLE_FAILURE_SEVERITIES).toHaveLength(3);
+    });
+});
+describe("ambiguous category with high severity (workflow)", () => {
+    it("ROW_ABSENT alternatives keep ambiguous category while severity follows engine", () => {
+        const engine = baseEngine({
+            status: "inconsistent",
+            steps: [
+                {
+                    seq: 0,
+                    toolId: "t",
+                    intendedEffect: { narrative: "" },
+                    observedExecution: { paramsCanonical: "{}" },
+                    verificationRequest: {
+                        kind: "sql_row",
+                        table: "t",
+                        identityEq: [{ column: "id", value: "1" }],
+                        requiredFields: {},
+                    },
+                    status: "missing",
+                    reasons: [{ code: "ROW_ABSENT", message: "m" }],
+                    evidenceSummary: {},
+                    repeatObservationCount: 1,
+                    evaluatedObservationOrdinal: 1,
+                },
+            ],
+        });
+        const base = buildFailureAnalysis(engine);
+        expect(base).not.toBeNull();
+        const af = deriveActionableFailureWorkflow(engine, base);
+        expect(af.category).toBe("ambiguous");
+        expect(af.severity).toBe("high");
+        expect(af.recommendedAction).toBe("manual_review");
+        expect(af.automationSafe).toBe(false);
+    });
+});
+//# sourceMappingURL=actionableFailure.test.js.map

package/dist/actionableFailure.test.js.map

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

package/dist/agentRunBundle.d.ts

@@ -0,0 +1,24 @@
+import type { WorkflowResult } from "./types.js";
+export type WriteAgentRunBundleOptions = {
+    outDir: string;
+    eventsNdjson: Buffer;
+    workflowResult: WorkflowResult;
+    /** Defaults to `name` / `version` from package.json next to built `dist`. */
+    producer?: {
+        name: string;
+        version: string;
+    };
+    /** Defaults to `new Date().toISOString()`. */
+    verifiedAt?: string;
+    /**
+     * PKCS#8 PEM Ed25519 private key path. When set, writes `workflow-result.sig.json` and manifest schemaVersion 2.
+     */
+    ed25519PrivateKeyPemPath?: string;
+};
+/**
+ * Writes canonical run bundle: `events.ndjson`, `workflow-result.json`, optional `workflow-result.sig.json`, `agent-run.json`.
+ * Rename order: events → workflow-result → [sig] → manifest (last).
+ * Signed path: on failure after some renames, best-effort reverse unlink of completed finals.
+ */
+export declare function writeAgentRunBundle(options: WriteAgentRunBundleOptions): void;
+//# sourceMappingURL=agentRunBundle.d.ts.map

package/dist/agentRunBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRunBundle.d.ts","sourceRoot":"","sources":["../src/agentRunBundle.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAwDF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAiD7E"}