open-multi-agent-kit 0.98.4 → 0.99.0

package/dist/core/verified-run/process-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-projection.d.ts","sourceRoot":"","sources":["../../../src/core/verified-run/process-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAiB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAK/E,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;CAClC;AACD,KAAK,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,QAAQ,CAAA;CAAE,CAAC,CAAC;AAEzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAkFlH","sourcesContent":["import type { RunEvent, RunProjection, WriterReduction } from \"./run-types.ts\";\nimport { VerifiedRunError } from \"./storage.ts\";\nimport { endTaskExecution } from \"./task-execution.ts\";\nimport { acceptWriterDispatch } from \"./writer-projection.ts\";\n\n/** Replay-only mutable bookkeeping; active processes always share one role/phase. */\nexport interface ProcessReduction {\n\treadonly dispatched: Set<string>;\n\treadonly checked: Set<string>;\n\tactiveRole: \"writer\" | \"verifier\";\n}\ntype ProcessEvent = Extract<RunEvent, { kind: \"dispatch\" | \"process_ready\" | \"exited\" }>;\n\nexport function reduceProcessEvent(context: WriterReduction, event: ProcessEvent, progress: ProcessReduction): void {\n\tconst { contract, state } = context;\n\tswitch (event.kind) {\n\t\tcase \"dispatch\": {\n\t\t\tconst limit =\n\t\t\t\tevent.role === \"writer\" && contract.profile === \"linux-command-dag-v1\"\n\t\t\t\t\t? (contract.writer.maxConcurrentTasks ?? 1)\n\t\t\t\t\t: 1;\n\t\t\tif (\n\t\t\t\tstate.failure ||\n\t\t\t\tstate.execution === \"paused\" ||\n\t\t\t\tstate.activeExecutionIds.length >= limit ||\n\t\t\t\tprogress.dispatched.has(event.executionId)\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tif (event.role === \"writer\") {\n\t\t\t\tacceptWriterDispatch(context, event);\n\t\t\t} else {\n\t\t\t\tif (\n\t\t\t\t\tevent.taskId !== undefined ||\n\t\t\t\t\t!context.writerFinished ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\t!state.candidateDigest ||\n\t\t\t\t\tevent.claimId === null ||\n\t\t\t\t\t!contract.checks.some((check) => check.claimId === event.claimId) ||\n\t\t\t\t\tprogress.checked.has(event.claimId)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tprogress.checked.add(event.claimId);\n\t\t\t}\n\t\t\tprogress.dispatched.add(event.executionId);\n\t\t\tprogress.activeRole = event.role;\n\t\t\tcontext.state = {\n\t\t\t\t...context.state,\n\t\t\t\texecution: \"running\",\n\t\t\t\tsettlement: \"draining\",\n\t\t\t\tactiveExecutionIds: [...state.activeExecutionIds, event.executionId],\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tcase \"process_ready\":\n\t\t\tif (\n\t\t\t\t!state.budget ||\n\t\t\t\t!state.activeExecutionIds.includes(event.executionId) ||\n\t\t\t\tevent.identity.bootId !== state.budget.bootId ||\n\t\t\t\tstate.processes.some((item) => item.executionId === event.executionId)\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tcontext.state = {\n\t\t\t\t...state,\n\t\t\t\tprocesses: [...state.processes, { executionId: event.executionId, identity: event.identity }],\n\t\t\t};\n\t\t\treturn;\n\t\tcase \"exited\": {\n\t\t\tif (\n\t\t\t\t!state.activeExecutionIds.includes(event.executionId) ||\n\t\t\t\t(state.budget &&\n\t\t\t\t\tevent.failure === null &&\n\t\t\t\t\t!state.processes.some((item) => item.executionId === event.executionId))\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tconst taskWriter = progress.activeRole === \"writer\" && contract.profile === \"linux-command-dag-v1\";\n\t\t\tif (taskWriter) endTaskExecution(context, event);\n\t\t\telse if (progress.activeRole === \"writer\") context.writerFinished = event.failure === null;\n\t\t\tconst activeExecutionIds = state.activeExecutionIds.filter((id) => id !== event.executionId);\n\t\t\tlet settlement: RunProjection[\"settlement\"] = \"settled\";\n\t\t\tif (context.state.writerOpen || context.state.tasks.some((task) => task.status === \"running\"))\n\t\t\t\tsettlement = \"open\";\n\t\t\tif (activeExecutionIds.length) settlement = \"draining\";\n\t\t\tcontext.state = {\n\t\t\t\t...context.state,\n\t\t\t\tactiveExecutionIds,\n\t\t\t\tsettlement,\n\t\t\t\tfailure: taskWriter ? state.failure : event.failure,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tdefault: {\n\t\t\tconst exhaustive: never = event;\n\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t}\n\t}\n}\n"]}

package/dist/core/verified-run/process-projection.js

@@ -0,0 +1,82 @@
+import { VerifiedRunError } from "./storage.js";
+import { endTaskExecution } from "./task-execution.js";
+import { acceptWriterDispatch } from "./writer-projection.js";
+export function reduceProcessEvent(context, event, progress) {
+    const { contract, state } = context;
+    switch (event.kind) {
+        case "dispatch": {
+            const limit = event.role === "writer" && contract.profile === "linux-command-dag-v1"
+                ? (contract.writer.maxConcurrentTasks ?? 1)
+                : 1;
+            if (state.failure ||
+                state.execution === "paused" ||
+                state.activeExecutionIds.length >= limit ||
+                progress.dispatched.has(event.executionId))
+                throw new VerifiedRunError("integrity");
+            if (event.role === "writer") {
+                acceptWriterDispatch(context, event);
+            }
+            else {
+                if (event.taskId !== undefined ||
+                    !context.writerFinished ||
+                    state.writerOpen ||
+                    !state.candidateDigest ||
+                    event.claimId === null ||
+                    !contract.checks.some((check) => check.claimId === event.claimId) ||
+                    progress.checked.has(event.claimId))
+                    throw new VerifiedRunError("integrity");
+                progress.checked.add(event.claimId);
+            }
+            progress.dispatched.add(event.executionId);
+            progress.activeRole = event.role;
+            context.state = {
+                ...context.state,
+                execution: "running",
+                settlement: "draining",
+                activeExecutionIds: [...state.activeExecutionIds, event.executionId],
+            };
+            return;
+        }
+        case "process_ready":
+            if (!state.budget ||
+                !state.activeExecutionIds.includes(event.executionId) ||
+                event.identity.bootId !== state.budget.bootId ||
+                state.processes.some((item) => item.executionId === event.executionId))
+                throw new VerifiedRunError("integrity");
+            context.state = {
+                ...state,
+                processes: [...state.processes, { executionId: event.executionId, identity: event.identity }],
+            };
+            return;
+        case "exited": {
+            if (!state.activeExecutionIds.includes(event.executionId) ||
+                (state.budget &&
+                    event.failure === null &&
+                    !state.processes.some((item) => item.executionId === event.executionId)))
+                throw new VerifiedRunError("integrity");
+            const taskWriter = progress.activeRole === "writer" && contract.profile === "linux-command-dag-v1";
+            if (taskWriter)
+                endTaskExecution(context, event);
+            else if (progress.activeRole === "writer")
+                context.writerFinished = event.failure === null;
+            const activeExecutionIds = state.activeExecutionIds.filter((id) => id !== event.executionId);
+            let settlement = "settled";
+            if (context.state.writerOpen || context.state.tasks.some((task) => task.status === "running"))
+                settlement = "open";
+            if (activeExecutionIds.length)
+                settlement = "draining";
+            context.state = {
+                ...context.state,
+                activeExecutionIds,
+                settlement,
+                failure: taskWriter ? state.failure : event.failure,
+            };
+            return;
+        }
+        default: {
+            const exhaustive = event;
+            throw new VerifiedRunError(String(exhaustive));
+        }
+    }
+}
+//# sourceMappingURL=process-projection.js.map

package/dist/core/verified-run/process-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-projection.js","sourceRoot":"","sources":["../../../src/core/verified-run/process-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RunEvent, RunProjection, WriterReduction } from \"./run-types.ts\";\nimport { VerifiedRunError } from \"./storage.ts\";\nimport { endTaskExecution } from \"./task-execution.ts\";\nimport { acceptWriterDispatch } from \"./writer-projection.ts\";\n\n/** Replay-only mutable bookkeeping; active processes always share one role/phase. */\nexport interface ProcessReduction {\n\treadonly dispatched: Set<string>;\n\treadonly checked: Set<string>;\n\tactiveRole: \"writer\" | \"verifier\";\n}\ntype ProcessEvent = Extract<RunEvent, { kind: \"dispatch\" | \"process_ready\" | \"exited\" }>;\n\nexport function reduceProcessEvent(context: WriterReduction, event: ProcessEvent, progress: ProcessReduction): void {\n\tconst { contract, state } = context;\n\tswitch (event.kind) {\n\t\tcase \"dispatch\": {\n\t\t\tconst limit =\n\t\t\t\tevent.role === \"writer\" && contract.profile === \"linux-command-dag-v1\"\n\t\t\t\t\t? (contract.writer.maxConcurrentTasks ?? 1)\n\t\t\t\t\t: 1;\n\t\t\tif (\n\t\t\t\tstate.failure ||\n\t\t\t\tstate.execution === \"paused\" ||\n\t\t\t\tstate.activeExecutionIds.length >= limit ||\n\t\t\t\tprogress.dispatched.has(event.executionId)\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tif (event.role === \"writer\") {\n\t\t\t\tacceptWriterDispatch(context, event);\n\t\t\t} else {\n\t\t\t\tif (\n\t\t\t\t\tevent.taskId !== undefined ||\n\t\t\t\t\t!context.writerFinished ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\t!state.candidateDigest ||\n\t\t\t\t\tevent.claimId === null ||\n\t\t\t\t\t!contract.checks.some((check) => check.claimId === event.claimId) ||\n\t\t\t\t\tprogress.checked.has(event.claimId)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tprogress.checked.add(event.claimId);\n\t\t\t}\n\t\t\tprogress.dispatched.add(event.executionId);\n\t\t\tprogress.activeRole = event.role;\n\t\t\tcontext.state = {\n\t\t\t\t...context.state,\n\t\t\t\texecution: \"running\",\n\t\t\t\tsettlement: \"draining\",\n\t\t\t\tactiveExecutionIds: [...state.activeExecutionIds, event.executionId],\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tcase \"process_ready\":\n\t\t\tif (\n\t\t\t\t!state.budget ||\n\t\t\t\t!state.activeExecutionIds.includes(event.executionId) ||\n\t\t\t\tevent.identity.bootId !== state.budget.bootId ||\n\t\t\t\tstate.processes.some((item) => item.executionId === event.executionId)\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tcontext.state = {\n\t\t\t\t...state,\n\t\t\t\tprocesses: [...state.processes, { executionId: event.executionId, identity: event.identity }],\n\t\t\t};\n\t\t\treturn;\n\t\tcase \"exited\": {\n\t\t\tif (\n\t\t\t\t!state.activeExecutionIds.includes(event.executionId) ||\n\t\t\t\t(state.budget &&\n\t\t\t\t\tevent.failure === null &&\n\t\t\t\t\t!state.processes.some((item) => item.executionId === event.executionId))\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tconst taskWriter = progress.activeRole === \"writer\" && contract.profile === \"linux-command-dag-v1\";\n\t\t\tif (taskWriter) endTaskExecution(context, event);\n\t\t\telse if (progress.activeRole === \"writer\") context.writerFinished = event.failure === null;\n\t\t\tconst activeExecutionIds = state.activeExecutionIds.filter((id) => id !== event.executionId);\n\t\t\tlet settlement: RunProjection[\"settlement\"] = \"settled\";\n\t\t\tif (context.state.writerOpen || context.state.tasks.some((task) => task.status === \"running\"))\n\t\t\t\tsettlement = \"open\";\n\t\t\tif (activeExecutionIds.length) settlement = \"draining\";\n\t\t\tcontext.state = {\n\t\t\t\t...context.state,\n\t\t\t\tactiveExecutionIds,\n\t\t\t\tsettlement,\n\t\t\t\tfailure: taskWriter ? state.failure : event.failure,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tdefault: {\n\t\t\tconst exhaustive: never = event;\n\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t}\n\t}\n}\n"]}

package/dist/core/verified-run/projection.d.ts

@@ -0,0 +1,4 @@
+import type { RunEvent, RunProjection } from "./run-types.ts";
+/** Deterministic replay only. Recovery observations are supplied by the trusted host adapter. */
+export declare function projectRun(events: readonly RunEvent[]): RunProjection;
+//# sourceMappingURL=projection.d.ts.map

package/dist/core/verified-run/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/core/verified-run/projection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AAI/E,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,aAAa,CAkLrE","sourcesContent":["import { reduceDagEvent } from \"./dag-projection.ts\";\nimport type { RunTaskProjection } from \"./dag-types.ts\";\nimport { type ProcessReduction, reduceProcessEvent } from \"./process-projection.ts\";\nimport { reduceRecoveryEvent } from \"./recovery-projection.ts\";\nimport type { RunEvent, RunProjection, WriterReduction } from \"./run-types.ts\";\nimport { VerifiedRunError } from \"./storage.ts\";\nimport { reduceWriterEvent } from \"./writer-projection.ts\";\n\n/** Deterministic replay only. Recovery observations are supplied by the trusted host adapter. */\nexport function projectRun(events: readonly RunEvent[]): RunProjection {\n\tconst first = events[0];\n\tif (first?.kind !== \"created\" || first.contract.runId !== first.command.runId)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\tconst context: WriterReduction = {\n\t\tcontract: first.contract,\n\t\twriterFinished: false,\n\t\twriterStarted: false,\n\t\tproducerStarted: false,\n\t\twriterCommands: 0,\n\t\trequestBaseline: 0,\n\t\trequests: new Set(),\n\t\tstate: {\n\t\t\trunId: first.contract.runId,\n\t\t\trevision: 1,\n\t\t\tgeneration: 1,\n\t\t\texecution: \"ready\",\n\t\t\tsettlement: \"open\",\n\t\t\tverification: \"not_requested\",\n\t\t\tapplication: \"not_requested\",\n\t\t\tcandidateDigest: null,\n\t\t\tinputDigest: null,\n\t\t\treceiptDigest: null,\n\t\t\tfailure: null,\n\t\t\tactiveExecutionIds: [],\n\t\t\twriterOpen: false,\n\t\t\tmodelRequests: 0,\n\t\t\ttasks:\n\t\t\t\tfirst.contract.profile === \"linux-command-dag-v1\"\n\t\t\t\t\t? first.contract.writer.tasks.map(\n\t\t\t\t\t\t\t(task): RunTaskProjection => ({\n\t\t\t\t\t\t\t\ttaskId: task.id,\n\t\t\t\t\t\t\t\tattempt: 0,\n\t\t\t\t\t\t\t\tgeneration: 1,\n\t\t\t\t\t\t\t\tstatus: \"pending\",\n\t\t\t\t\t\t\t\tinputDigest: null,\n\t\t\t\t\t\t\t\toutputDigest: null,\n\t\t\t\t\t\t\t\tfailure: null,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t)\n\t\t\t\t\t: [],\n\t\t\tbudget: null,\n\t\t\tenvironmentDigest: null,\n\t\t\tverificationDeadlineMs: null,\n\t\t\tlastClockMs: null,\n\t\t\tprocesses: [],\n\t\t},\n\t};\n\tconst progress: ProcessReduction = { dispatched: new Set(), checked: new Set(), activeRole: \"writer\" };\n\tconst commands = new Set([first.command.commandId]);\n\tfor (const event of events.slice(1)) {\n\t\tconst state = context.state;\n\t\tif (state.execution === \"failed\" || state.receiptDigest) throw new VerifiedRunError(\"integrity\");\n\t\tswitch (event.kind) {\n\t\t\tcase \"created\":\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tcase \"budget_anchored\": {\n\t\t\t\tconst budget = event.budget;\n\t\t\t\tconst limits = first.contract.budget;\n\t\t\t\tif (\n\t\t\t\t\tstate.revision !== 1 ||\n\t\t\t\t\tstate.budget ||\n\t\t\t\t\tbudget.workDeadlineMs - budget.startedMs !== limits.workMs ||\n\t\t\t\t\tbudget.verifyCapMs - budget.workDeadlineMs !== limits.verifyMs ||\n\t\t\t\t\tbudget.cleanupDeadlineMs - budget.verifyCapMs !== limits.cleanupMs\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\tbudget,\n\t\t\t\t\tenvironmentDigest: event.environmentDigest,\n\t\t\t\t\tlastClockMs: budget.startedMs,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"input_checkpoint\":\n\t\t\t\tif (\n\t\t\t\t\tstate.revision !== 2 ||\n\t\t\t\t\t!state.budget ||\n\t\t\t\t\tstate.inputDigest ||\n\t\t\t\t\tevent.digest !== first.contract.workspace.baseDigest\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = { ...state, inputDigest: event.digest };\n\t\t\t\tbreak;\n\t\t\tcase \"task_started\":\n\t\t\tcase \"task_finished\":\n\t\t\tcase \"tasks_paused\":\n\t\t\t\treduceDagEvent(context, event);\n\t\t\t\tbreak;\n\t\t\tcase \"writer_opened\":\n\t\t\tcase \"model_request\":\n\t\t\tcase \"writer_closed\":\n\t\t\t\treduceWriterEvent(context, event);\n\t\t\t\tbreak;\n\t\t\tcase \"dispatch\":\n\t\t\tcase \"process_ready\":\n\t\t\tcase \"exited\":\n\t\t\t\treduceProcessEvent(context, event, progress);\n\t\t\t\tbreak;\n\t\t\tcase \"candidate\": {\n\t\t\t\tif (\n\t\t\t\t\t!context.writerFinished ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\tstate.failure ||\n\t\t\t\t\tstate.activeExecutionIds.length ||\n\t\t\t\t\tstate.candidateDigest ||\n\t\t\t\t\tstate.tasks.some((task) => task.status !== \"succeeded\" || task.generation !== state.generation)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tif (state.budget) {\n\t\t\t\t\tif (\n\t\t\t\t\t\tevent.observedMs === undefined ||\n\t\t\t\t\t\tevent.verificationDeadlineMs === undefined ||\n\t\t\t\t\t\tevent.observedMs < state.budget.startedMs ||\n\t\t\t\t\t\tevent.observedMs > state.budget.workDeadlineMs ||\n\t\t\t\t\t\tevent.verificationDeadlineMs !==\n\t\t\t\t\t\t\tMath.min(event.observedMs + first.contract.budget.verifyMs, state.budget.verifyCapMs)\n\t\t\t\t\t)\n\t\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\t} else if (event.observedMs !== undefined || event.verificationDeadlineMs !== undefined)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\tcandidateDigest: event.digest,\n\t\t\t\t\tverificationDeadlineMs: event.verificationDeadlineMs ?? null,\n\t\t\t\t\tlastClockMs: event.observedMs ?? null,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"resumed\":\n\t\t\tcase \"tasks_retried\":\n\t\t\tcase \"writer_restarted\":\n\t\t\t\treduceRecoveryEvent(context, event, {\n\t\t\t\t\tcommands,\n\t\t\t\t\tchecked: progress.checked,\n\t\t\t\t\tactiveRole: progress.activeRole,\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t\tcase \"evaluated\":\n\t\t\t\tif (\n\t\t\t\t\t!state.candidateDigest ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\tstate.activeExecutionIds.length ||\n\t\t\t\t\tprogress.checked.size !== first.contract.checks.length ||\n\t\t\t\t\t(event.verified && state.failure)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\treceiptDigest: event.receiptDigest,\n\t\t\t\t\texecution: \"succeeded\",\n\t\t\t\t\tverification: event.verified ? \"verified\" : \"violated\",\n\t\t\t\t\tapplication: event.verified ? \"candidate_ready\" : \"not_requested\",\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tcase \"failed\":\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\texecution: \"failed\",\n\t\t\t\t\tfailure: event.code,\n\t\t\t\t\tverification: \"inconclusive\",\n\t\t\t\t\tsettlement: state.activeExecutionIds.length || state.writerOpen ? \"quarantined\" : \"settled\",\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tdefault: {\n\t\t\t\tconst exhaustive: never = event;\n\t\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t\t}\n\t\t}\n\t\tcontext.state = { ...context.state, revision: state.revision + 1 };\n\t}\n\treturn Object.freeze({\n\t\t...context.state,\n\t\tactiveExecutionIds: Object.freeze([...context.state.activeExecutionIds]),\n\t\tprocesses: Object.freeze(context.state.processes.map((item) => Object.freeze(item))),\n\t\ttasks: Object.freeze(context.state.tasks.map((task) => Object.freeze(task))),\n\t});\n}\n"]}

package/dist/core/verified-run/projection.js

@@ -0,0 +1,175 @@
+import { reduceDagEvent } from "./dag-projection.js";
+import { reduceProcessEvent } from "./process-projection.js";
+import { reduceRecoveryEvent } from "./recovery-projection.js";
+import { VerifiedRunError } from "./storage.js";
+import { reduceWriterEvent } from "./writer-projection.js";
+/** Deterministic replay only. Recovery observations are supplied by the trusted host adapter. */
+export function projectRun(events) {
+    const first = events[0];
+    if (first?.kind !== "created" || first.contract.runId !== first.command.runId)
+        throw new VerifiedRunError("integrity");
+    const context = {
+        contract: first.contract,
+        writerFinished: false,
+        writerStarted: false,
+        producerStarted: false,
+        writerCommands: 0,
+        requestBaseline: 0,
+        requests: new Set(),
+        state: {
+            runId: first.contract.runId,
+            revision: 1,
+            generation: 1,
+            execution: "ready",
+            settlement: "open",
+            verification: "not_requested",
+            application: "not_requested",
+            candidateDigest: null,
+            inputDigest: null,
+            receiptDigest: null,
+            failure: null,
+            activeExecutionIds: [],
+            writerOpen: false,
+            modelRequests: 0,
+            tasks: first.contract.profile === "linux-command-dag-v1"
+                ? first.contract.writer.tasks.map((task) => ({
+                    taskId: task.id,
+                    attempt: 0,
+                    generation: 1,
+                    status: "pending",
+                    inputDigest: null,
+                    outputDigest: null,
+                    failure: null,
+                }))
+                : [],
+            budget: null,
+            environmentDigest: null,
+            verificationDeadlineMs: null,
+            lastClockMs: null,
+            processes: [],
+        },
+    };
+    const progress = { dispatched: new Set(), checked: new Set(), activeRole: "writer" };
+    const commands = new Set([first.command.commandId]);
+    for (const event of events.slice(1)) {
+        const state = context.state;
+        if (state.execution === "failed" || state.receiptDigest)
+            throw new VerifiedRunError("integrity");
+        switch (event.kind) {
+            case "created":
+                throw new VerifiedRunError("integrity");
+            case "budget_anchored": {
+                const budget = event.budget;
+                const limits = first.contract.budget;
+                if (state.revision !== 1 ||
+                    state.budget ||
+                    budget.workDeadlineMs - budget.startedMs !== limits.workMs ||
+                    budget.verifyCapMs - budget.workDeadlineMs !== limits.verifyMs ||
+                    budget.cleanupDeadlineMs - budget.verifyCapMs !== limits.cleanupMs)
+                    throw new VerifiedRunError("integrity");
+                context.state = {
+                    ...state,
+                    budget,
+                    environmentDigest: event.environmentDigest,
+                    lastClockMs: budget.startedMs,
+                };
+                break;
+            }
+            case "input_checkpoint":
+                if (state.revision !== 2 ||
+                    !state.budget ||
+                    state.inputDigest ||
+                    event.digest !== first.contract.workspace.baseDigest)
+                    throw new VerifiedRunError("integrity");
+                context.state = { ...state, inputDigest: event.digest };
+                break;
+            case "task_started":
+            case "task_finished":
+            case "tasks_paused":
+                reduceDagEvent(context, event);
+                break;
+            case "writer_opened":
+            case "model_request":
+            case "writer_closed":
+                reduceWriterEvent(context, event);
+                break;
+            case "dispatch":
+            case "process_ready":
+            case "exited":
+                reduceProcessEvent(context, event, progress);
+                break;
+            case "candidate": {
+                if (!context.writerFinished ||
+                    state.writerOpen ||
+                    state.failure ||
+                    state.activeExecutionIds.length ||
+                    state.candidateDigest ||
+                    state.tasks.some((task) => task.status !== "succeeded" || task.generation !== state.generation))
+                    throw new VerifiedRunError("integrity");
+                if (state.budget) {
+                    if (event.observedMs === undefined ||
+                        event.verificationDeadlineMs === undefined ||
+                        event.observedMs < state.budget.startedMs ||
+                        event.observedMs > state.budget.workDeadlineMs ||
+                        event.verificationDeadlineMs !==
+                            Math.min(event.observedMs + first.contract.budget.verifyMs, state.budget.verifyCapMs))
+                        throw new VerifiedRunError("integrity");
+                }
+                else if (event.observedMs !== undefined || event.verificationDeadlineMs !== undefined)
+                    throw new VerifiedRunError("integrity");
+                context.state = {
+                    ...state,
+                    candidateDigest: event.digest,
+                    verificationDeadlineMs: event.verificationDeadlineMs ?? null,
+                    lastClockMs: event.observedMs ?? null,
+                };
+                break;
+            }
+            case "resumed":
+            case "tasks_retried":
+            case "writer_restarted":
+                reduceRecoveryEvent(context, event, {
+                    commands,
+                    checked: progress.checked,
+                    activeRole: progress.activeRole,
+                });
+                break;
+            case "evaluated":
+                if (!state.candidateDigest ||
+                    state.writerOpen ||
+                    state.activeExecutionIds.length ||
+                    progress.checked.size !== first.contract.checks.length ||
+                    (event.verified && state.failure))
+                    throw new VerifiedRunError("integrity");
+                context.state = {
+                    ...state,
+                    receiptDigest: event.receiptDigest,
+                    execution: "succeeded",
+                    verification: event.verified ? "verified" : "violated",
+                    application: event.verified ? "candidate_ready" : "not_requested",
+                };
+                break;
+            case "failed":
+                context.state = {
+                    ...state,
+                    execution: "failed",
+                    failure: event.code,
+                    verification: "inconclusive",
+                    settlement: state.activeExecutionIds.length || state.writerOpen ? "quarantined" : "settled",
+                };
+                break;
+            default: {
+                const exhaustive = event;
+                throw new VerifiedRunError(String(exhaustive));
+            }
+        }
+        context.state = { ...context.state, revision: state.revision + 1 };
+    }
+    return Object.freeze({
+        ...context.state,
+        activeExecutionIds: Object.freeze([...context.state.activeExecutionIds]),
+        processes: Object.freeze(context.state.processes.map((item) => Object.freeze(item))),
+        tasks: Object.freeze(context.state.tasks.map((task) => Object.freeze(task))),
+    });
+}
+//# sourceMappingURL=projection.js.map

package/dist/core/verified-run/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../../src/core/verified-run/projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAyB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,iGAAiG;AACjG,MAAM,UAAU,UAAU,CAAC,MAA2B,EAAiB;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK;QAC5E,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,OAAO,GAAoB;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,KAAK,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;YAC3B,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,MAAM;YAClB,YAAY,EAAE,eAAe;YAC7B,WAAW,EAAE,eAAe;YAC5B,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,IAAI;YACb,kBAAkB,EAAE,EAAE;YACtB,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,CAAC;YAChB,KAAK,EACJ,KAAK,CAAC,QAAQ,CAAC,OAAO,KAAK,sBAAsB;gBAChD,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/B,CAAC,IAAI,EAAqB,EAAE,CAAC,CAAC;oBAC7B,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,OAAO,EAAE,CAAC;oBACV,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,IAAI;oBACjB,YAAY,EAAE,IAAI;oBAClB,OAAO,EAAE,IAAI;iBACb,CAAC,CACF;gBACF,CAAC,CAAC,EAAE;YACN,MAAM,EAAE,IAAI;YACZ,iBAAiB,EAAE,IAAI;YACvB,sBAAsB,EAAE,IAAI;YAC5B,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,EAAE;SACb;KACD,CAAC;IACF,MAAM,QAAQ,GAAqB,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa;YAAE,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACjG,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,SAAS;gBACb,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACzC,KAAK,iBAAiB,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACrC,IACC,KAAK,CAAC,QAAQ,KAAK,CAAC;oBACpB,KAAK,CAAC,MAAM;oBACZ,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM;oBAC1D,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,KAAK,MAAM,CAAC,QAAQ;oBAC9D,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,SAAS;oBAElE,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,GAAG;oBACf,GAAG,KAAK;oBACR,MAAM;oBACN,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;oBAC1C,WAAW,EAAE,MAAM,CAAC,SAAS;iBAC7B,CAAC;gBACF,MAAM;YACP,CAAC;YACD,KAAK,kBAAkB;gBACtB,IACC,KAAK,CAAC,QAAQ,KAAK,CAAC;oBACpB,CAAC,KAAK,CAAC,MAAM;oBACb,KAAK,CAAC,WAAW;oBACjB,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU;oBAEpD,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxD,MAAM;YACP,KAAK,cAAc,CAAC;YACpB,KAAK,eAAe,CAAC;YACrB,KAAK,cAAc;gBAClB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC/B,MAAM;YACP,KAAK,eAAe,CAAC;YACrB,KAAK,eAAe,CAAC;YACrB,KAAK,eAAe;gBACnB,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAClC,MAAM;YACP,KAAK,UAAU,CAAC;YAChB,KAAK,eAAe,CAAC;YACrB,KAAK,QAAQ;gBACZ,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM;YACP,KAAK,WAAW,EAAE,CAAC;gBAClB,IACC,CAAC,OAAO,CAAC,cAAc;oBACvB,KAAK,CAAC,UAAU;oBAChB,KAAK,CAAC,OAAO;oBACb,KAAK,CAAC,kBAAkB,CAAC,MAAM;oBAC/B,KAAK,CAAC,eAAe;oBACrB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC;oBAE/F,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClB,IACC,KAAK,CAAC,UAAU,KAAK,SAAS;wBAC9B,KAAK,CAAC,sBAAsB,KAAK,SAAS;wBAC1C,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS;wBACzC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc;wBAC9C,KAAK,CAAC,sBAAsB;4BAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;wBAEtF,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBAC1C,CAAC;qBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,sBAAsB,KAAK,SAAS;oBACtF,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,GAAG;oBACf,GAAG,KAAK;oBACR,eAAe,EAAE,KAAK,CAAC,MAAM;oBAC7B,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,IAAI,IAAI;oBAC5D,WAAW,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;iBACrC,CAAC;gBACF,MAAM;YACP,CAAC;YACD,KAAK,SAAS,CAAC;YACf,KAAK,eAAe,CAAC;YACrB,KAAK,kBAAkB;gBACtB,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE;oBACnC,QAAQ;oBACR,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;iBAC/B,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,WAAW;gBACf,IACC,CAAC,KAAK,CAAC,eAAe;oBACtB,KAAK,CAAC,UAAU;oBAChB,KAAK,CAAC,kBAAkB,CAAC,MAAM;oBAC/B,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM;oBACtD,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC;oBAEjC,MAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,GAAG;oBACf,GAAG,KAAK;oBACR,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,SAAS,EAAE,WAAW;oBACtB,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;oBACtD,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe;iBACjE,CAAC;gBACF,MAAM;YACP,KAAK,QAAQ;gBACZ,OAAO,CAAC,KAAK,GAAG;oBACf,GAAG,KAAK;oBACR,SAAS,EAAE,QAAQ;oBACnB,OAAO,EAAE,KAAK,CAAC,IAAI;oBACnB,YAAY,EAAE,cAAc;oBAC5B,UAAU,EAAE,KAAK,CAAC,kBAAkB,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;iBAC3F,CAAC;gBACF,MAAM;YACP,SAAS,CAAC;gBACT,MAAM,UAAU,GAAU,KAAK,CAAC;gBAChC,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAChD,CAAC;QACF,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,GAAG,OAAO,CAAC,KAAK;QAChB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACxE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;KAC5E,CAAC,CAAC;AAAA,CACH","sourcesContent":["import { reduceDagEvent } from \"./dag-projection.ts\";\nimport type { RunTaskProjection } from \"./dag-types.ts\";\nimport { type ProcessReduction, reduceProcessEvent } from \"./process-projection.ts\";\nimport { reduceRecoveryEvent } from \"./recovery-projection.ts\";\nimport type { RunEvent, RunProjection, WriterReduction } from \"./run-types.ts\";\nimport { VerifiedRunError } from \"./storage.ts\";\nimport { reduceWriterEvent } from \"./writer-projection.ts\";\n\n/** Deterministic replay only. Recovery observations are supplied by the trusted host adapter. */\nexport function projectRun(events: readonly RunEvent[]): RunProjection {\n\tconst first = events[0];\n\tif (first?.kind !== \"created\" || first.contract.runId !== first.command.runId)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\tconst context: WriterReduction = {\n\t\tcontract: first.contract,\n\t\twriterFinished: false,\n\t\twriterStarted: false,\n\t\tproducerStarted: false,\n\t\twriterCommands: 0,\n\t\trequestBaseline: 0,\n\t\trequests: new Set(),\n\t\tstate: {\n\t\t\trunId: first.contract.runId,\n\t\t\trevision: 1,\n\t\t\tgeneration: 1,\n\t\t\texecution: \"ready\",\n\t\t\tsettlement: \"open\",\n\t\t\tverification: \"not_requested\",\n\t\t\tapplication: \"not_requested\",\n\t\t\tcandidateDigest: null,\n\t\t\tinputDigest: null,\n\t\t\treceiptDigest: null,\n\t\t\tfailure: null,\n\t\t\tactiveExecutionIds: [],\n\t\t\twriterOpen: false,\n\t\t\tmodelRequests: 0,\n\t\t\ttasks:\n\t\t\t\tfirst.contract.profile === \"linux-command-dag-v1\"\n\t\t\t\t\t? first.contract.writer.tasks.map(\n\t\t\t\t\t\t\t(task): RunTaskProjection => ({\n\t\t\t\t\t\t\t\ttaskId: task.id,\n\t\t\t\t\t\t\t\tattempt: 0,\n\t\t\t\t\t\t\t\tgeneration: 1,\n\t\t\t\t\t\t\t\tstatus: \"pending\",\n\t\t\t\t\t\t\t\tinputDigest: null,\n\t\t\t\t\t\t\t\toutputDigest: null,\n\t\t\t\t\t\t\t\tfailure: null,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t)\n\t\t\t\t\t: [],\n\t\t\tbudget: null,\n\t\t\tenvironmentDigest: null,\n\t\t\tverificationDeadlineMs: null,\n\t\t\tlastClockMs: null,\n\t\t\tprocesses: [],\n\t\t},\n\t};\n\tconst progress: ProcessReduction = { dispatched: new Set(), checked: new Set(), activeRole: \"writer\" };\n\tconst commands = new Set([first.command.commandId]);\n\tfor (const event of events.slice(1)) {\n\t\tconst state = context.state;\n\t\tif (state.execution === \"failed\" || state.receiptDigest) throw new VerifiedRunError(\"integrity\");\n\t\tswitch (event.kind) {\n\t\t\tcase \"created\":\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tcase \"budget_anchored\": {\n\t\t\t\tconst budget = event.budget;\n\t\t\t\tconst limits = first.contract.budget;\n\t\t\t\tif (\n\t\t\t\t\tstate.revision !== 1 ||\n\t\t\t\t\tstate.budget ||\n\t\t\t\t\tbudget.workDeadlineMs - budget.startedMs !== limits.workMs ||\n\t\t\t\t\tbudget.verifyCapMs - budget.workDeadlineMs !== limits.verifyMs ||\n\t\t\t\t\tbudget.cleanupDeadlineMs - budget.verifyCapMs !== limits.cleanupMs\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\tbudget,\n\t\t\t\t\tenvironmentDigest: event.environmentDigest,\n\t\t\t\t\tlastClockMs: budget.startedMs,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"input_checkpoint\":\n\t\t\t\tif (\n\t\t\t\t\tstate.revision !== 2 ||\n\t\t\t\t\t!state.budget ||\n\t\t\t\t\tstate.inputDigest ||\n\t\t\t\t\tevent.digest !== first.contract.workspace.baseDigest\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = { ...state, inputDigest: event.digest };\n\t\t\t\tbreak;\n\t\t\tcase \"task_started\":\n\t\t\tcase \"task_finished\":\n\t\t\tcase \"tasks_paused\":\n\t\t\t\treduceDagEvent(context, event);\n\t\t\t\tbreak;\n\t\t\tcase \"writer_opened\":\n\t\t\tcase \"model_request\":\n\t\t\tcase \"writer_closed\":\n\t\t\t\treduceWriterEvent(context, event);\n\t\t\t\tbreak;\n\t\t\tcase \"dispatch\":\n\t\t\tcase \"process_ready\":\n\t\t\tcase \"exited\":\n\t\t\t\treduceProcessEvent(context, event, progress);\n\t\t\t\tbreak;\n\t\t\tcase \"candidate\": {\n\t\t\t\tif (\n\t\t\t\t\t!context.writerFinished ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\tstate.failure ||\n\t\t\t\t\tstate.activeExecutionIds.length ||\n\t\t\t\t\tstate.candidateDigest ||\n\t\t\t\t\tstate.tasks.some((task) => task.status !== \"succeeded\" || task.generation !== state.generation)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tif (state.budget) {\n\t\t\t\t\tif (\n\t\t\t\t\t\tevent.observedMs === undefined ||\n\t\t\t\t\t\tevent.verificationDeadlineMs === undefined ||\n\t\t\t\t\t\tevent.observedMs < state.budget.startedMs ||\n\t\t\t\t\t\tevent.observedMs > state.budget.workDeadlineMs ||\n\t\t\t\t\t\tevent.verificationDeadlineMs !==\n\t\t\t\t\t\t\tMath.min(event.observedMs + first.contract.budget.verifyMs, state.budget.verifyCapMs)\n\t\t\t\t\t)\n\t\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\t} else if (event.observedMs !== undefined || event.verificationDeadlineMs !== undefined)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\tcandidateDigest: event.digest,\n\t\t\t\t\tverificationDeadlineMs: event.verificationDeadlineMs ?? null,\n\t\t\t\t\tlastClockMs: event.observedMs ?? null,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"resumed\":\n\t\t\tcase \"tasks_retried\":\n\t\t\tcase \"writer_restarted\":\n\t\t\t\treduceRecoveryEvent(context, event, {\n\t\t\t\t\tcommands,\n\t\t\t\t\tchecked: progress.checked,\n\t\t\t\t\tactiveRole: progress.activeRole,\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t\tcase \"evaluated\":\n\t\t\t\tif (\n\t\t\t\t\t!state.candidateDigest ||\n\t\t\t\t\tstate.writerOpen ||\n\t\t\t\t\tstate.activeExecutionIds.length ||\n\t\t\t\t\tprogress.checked.size !== first.contract.checks.length ||\n\t\t\t\t\t(event.verified && state.failure)\n\t\t\t\t)\n\t\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\treceiptDigest: event.receiptDigest,\n\t\t\t\t\texecution: \"succeeded\",\n\t\t\t\t\tverification: event.verified ? \"verified\" : \"violated\",\n\t\t\t\t\tapplication: event.verified ? \"candidate_ready\" : \"not_requested\",\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tcase \"failed\":\n\t\t\t\tcontext.state = {\n\t\t\t\t\t...state,\n\t\t\t\t\texecution: \"failed\",\n\t\t\t\t\tfailure: event.code,\n\t\t\t\t\tverification: \"inconclusive\",\n\t\t\t\t\tsettlement: state.activeExecutionIds.length || state.writerOpen ? \"quarantined\" : \"settled\",\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tdefault: {\n\t\t\t\tconst exhaustive: never = event;\n\t\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t\t}\n\t\t}\n\t\tcontext.state = { ...context.state, revision: state.revision + 1 };\n\t}\n\treturn Object.freeze({\n\t\t...context.state,\n\t\tactiveExecutionIds: Object.freeze([...context.state.activeExecutionIds]),\n\t\tprocesses: Object.freeze(context.state.processes.map((item) => Object.freeze(item))),\n\t\ttasks: Object.freeze(context.state.tasks.map((task) => Object.freeze(task))),\n\t});\n}\n"]}

package/dist/core/verified-run/recovery-clock.d.ts

@@ -0,0 +1,19 @@
+import type { RunPhaseBudget } from "omk-protocol";
+export interface RunClock {
+    readonly bootId: string;
+    readonly nowMs: number;
+}
+export interface RecoveryBudget {
+    readonly bootId: string;
+    readonly startedMs: number;
+    readonly workDeadlineMs: number;
+    readonly verifyCapMs: number;
+    readonly cleanupDeadlineMs: number;
+}
+export declare function readRunClock(): RunClock;
+export declare function anchorRunBudget(limits: RunPhaseBudget, clock: RunClock): RecoveryBudget;
+export declare function parseRecoveryBudget(raw: unknown): RecoveryBudget;
+export declare function remainingRunTime(budget: RecoveryBudget, deadlineMs: number, clock?: RunClock): number;
+export declare const remainingVerification: typeof remainingRunTime;
+export declare function localVerificationDeadline(budget: RecoveryBudget, deadlineMs: number): number;
+//# sourceMappingURL=recovery-clock.d.ts.map

package/dist/core/verified-run/recovery-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-clock.d.ts","sourceRoot":"","sources":["../../../src/core/verified-run/recovery-clock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACnC;AAGD,wBAAgB,YAAY,IAAI,QAAQ,CAOvC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,GAAG,cAAc,CAQvF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgChE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,WAAiB,GAAG,MAAM,CAM3G;AAED,eAAO,MAAM,qBAAqB,yBAAmB,CAAC;AAEtD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI5F","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { uptime } from \"node:os\";\nimport { performance } from \"node:perf_hooks\";\nimport type { RunPhaseBudget } from \"omk-protocol\";\nimport { VerifiedRunError } from \"./storage.ts\";\n\nexport interface RunClock {\n\treadonly bootId: string;\n\treadonly nowMs: number;\n}\nexport interface RecoveryBudget {\n\treadonly bootId: string;\n\treadonly startedMs: number;\n\treadonly workDeadlineMs: number;\n\treadonly verifyCapMs: number;\n\treadonly cleanupDeadlineMs: number;\n}\nconst BOOT_ID = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/;\n\nexport function readRunClock(): RunClock {\n\tif (process.platform !== \"linux\") throw new VerifiedRunError(\"clock_unavailable\");\n\tconst bootId = readFileSync(\"/proc/sys/kernel/random/boot_id\", \"utf8\").trim();\n\tconst nowMs = Math.floor(uptime() * 1000);\n\tif (!BOOT_ID.test(bootId) || !Number.isSafeInteger(nowMs) || nowMs < 0)\n\t\tthrow new VerifiedRunError(\"clock_unavailable\");\n\treturn Object.freeze({ bootId, nowMs });\n}\n\nexport function anchorRunBudget(limits: RunPhaseBudget, clock: RunClock): RecoveryBudget {\n\treturn parseRecoveryBudget({\n\t\tbootId: clock.bootId,\n\t\tstartedMs: clock.nowMs,\n\t\tworkDeadlineMs: clock.nowMs + limits.workMs,\n\t\tverifyCapMs: clock.nowMs + limits.workMs + limits.verifyMs,\n\t\tcleanupDeadlineMs: clock.nowMs + limits.workMs + limits.verifyMs + limits.cleanupMs,\n\t});\n}\n\nexport function parseRecoveryBudget(raw: unknown): RecoveryBudget {\n\tif (\n\t\ttypeof raw !== \"object\" ||\n\t\traw === null ||\n\t\t!(\"bootId\" in raw) ||\n\t\ttypeof raw.bootId !== \"string\" ||\n\t\t!BOOT_ID.test(raw.bootId) ||\n\t\t!(\"startedMs\" in raw) ||\n\t\ttypeof raw.startedMs !== \"number\" ||\n\t\t!(\"workDeadlineMs\" in raw) ||\n\t\ttypeof raw.workDeadlineMs !== \"number\" ||\n\t\t!(\"verifyCapMs\" in raw) ||\n\t\ttypeof raw.verifyCapMs !== \"number\" ||\n\t\t!(\"cleanupDeadlineMs\" in raw) ||\n\t\ttypeof raw.cleanupDeadlineMs !== \"number\"\n\t)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\tconst values = [raw.startedMs, raw.workDeadlineMs, raw.verifyCapMs, raw.cleanupDeadlineMs];\n\tif (\n\t\tvalues.some((value) => !Number.isSafeInteger(value) || value < 0) ||\n\t\traw.workDeadlineMs <= raw.startedMs ||\n\t\traw.verifyCapMs <= raw.workDeadlineMs ||\n\t\traw.cleanupDeadlineMs <= raw.verifyCapMs\n\t)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\treturn Object.freeze({\n\t\tbootId: raw.bootId,\n\t\tstartedMs: raw.startedMs,\n\t\tworkDeadlineMs: raw.workDeadlineMs,\n\t\tverifyCapMs: raw.verifyCapMs,\n\t\tcleanupDeadlineMs: raw.cleanupDeadlineMs,\n\t});\n}\n\nexport function remainingRunTime(budget: RecoveryBudget, deadlineMs: number, clock = readRunClock()): number {\n\tif (clock.bootId !== budget.bootId) throw new VerifiedRunError(\"clock_changed\");\n\tif (clock.nowMs < budget.startedMs) throw new VerifiedRunError(\"clock_rollback\");\n\tif (!Number.isSafeInteger(deadlineMs) || deadlineMs <= budget.startedMs || deadlineMs > budget.verifyCapMs)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\treturn Math.max(0, deadlineMs - clock.nowMs);\n}\n\nexport const remainingVerification = remainingRunTime;\n\nexport function localVerificationDeadline(budget: RecoveryBudget, deadlineMs: number): number {\n\tconst remaining = remainingVerification(budget, deadlineMs);\n\tif (remaining <= 0) throw new VerifiedRunError(\"deadline\");\n\treturn performance.now() + remaining;\n}\n"]}

package/dist/core/verified-run/recovery-clock.js

@@ -0,0 +1,69 @@
+import { readFileSync } from "node:fs";
+import { uptime } from "node:os";
+import { performance } from "node:perf_hooks";
+import { VerifiedRunError } from "./storage.js";
+const BOOT_ID = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/;
+export function readRunClock() {
+    if (process.platform !== "linux")
+        throw new VerifiedRunError("clock_unavailable");
+    const bootId = readFileSync("/proc/sys/kernel/random/boot_id", "utf8").trim();
+    const nowMs = Math.floor(uptime() * 1000);
+    if (!BOOT_ID.test(bootId) || !Number.isSafeInteger(nowMs) || nowMs < 0)
+        throw new VerifiedRunError("clock_unavailable");
+    return Object.freeze({ bootId, nowMs });
+}
+export function anchorRunBudget(limits, clock) {
+    return parseRecoveryBudget({
+        bootId: clock.bootId,
+        startedMs: clock.nowMs,
+        workDeadlineMs: clock.nowMs + limits.workMs,
+        verifyCapMs: clock.nowMs + limits.workMs + limits.verifyMs,
+        cleanupDeadlineMs: clock.nowMs + limits.workMs + limits.verifyMs + limits.cleanupMs,
+    });
+}
+export function parseRecoveryBudget(raw) {
+    if (typeof raw !== "object" ||
+        raw === null ||
+        !("bootId" in raw) ||
+        typeof raw.bootId !== "string" ||
+        !BOOT_ID.test(raw.bootId) ||
+        !("startedMs" in raw) ||
+        typeof raw.startedMs !== "number" ||
+        !("workDeadlineMs" in raw) ||
+        typeof raw.workDeadlineMs !== "number" ||
+        !("verifyCapMs" in raw) ||
+        typeof raw.verifyCapMs !== "number" ||
+        !("cleanupDeadlineMs" in raw) ||
+        typeof raw.cleanupDeadlineMs !== "number")
+        throw new VerifiedRunError("integrity");
+    const values = [raw.startedMs, raw.workDeadlineMs, raw.verifyCapMs, raw.cleanupDeadlineMs];
+    if (values.some((value) => !Number.isSafeInteger(value) || value < 0) ||
+        raw.workDeadlineMs <= raw.startedMs ||
+        raw.verifyCapMs <= raw.workDeadlineMs ||
+        raw.cleanupDeadlineMs <= raw.verifyCapMs)
+        throw new VerifiedRunError("integrity");
+    return Object.freeze({
+        bootId: raw.bootId,
+        startedMs: raw.startedMs,
+        workDeadlineMs: raw.workDeadlineMs,
+        verifyCapMs: raw.verifyCapMs,
+        cleanupDeadlineMs: raw.cleanupDeadlineMs,
+    });
+}
+export function remainingRunTime(budget, deadlineMs, clock = readRunClock()) {
+    if (clock.bootId !== budget.bootId)
+        throw new VerifiedRunError("clock_changed");
+    if (clock.nowMs < budget.startedMs)
+        throw new VerifiedRunError("clock_rollback");
+    if (!Number.isSafeInteger(deadlineMs) || deadlineMs <= budget.startedMs || deadlineMs > budget.verifyCapMs)
+        throw new VerifiedRunError("integrity");
+    return Math.max(0, deadlineMs - clock.nowMs);
+}
+export const remainingVerification = remainingRunTime;
+export function localVerificationDeadline(budget, deadlineMs) {
+    const remaining = remainingVerification(budget, deadlineMs);
+    if (remaining <= 0)
+        throw new VerifiedRunError("deadline");
+    return performance.now() + remaining;
+}
+//# sourceMappingURL=recovery-clock.js.map

package/dist/core/verified-run/recovery-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-clock.js","sourceRoot":"","sources":["../../../src/core/verified-run/recovery-clock.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { uptime } from \"node:os\";\nimport { performance } from \"node:perf_hooks\";\nimport type { RunPhaseBudget } from \"omk-protocol\";\nimport { VerifiedRunError } from \"./storage.ts\";\n\nexport interface RunClock {\n\treadonly bootId: string;\n\treadonly nowMs: number;\n}\nexport interface RecoveryBudget {\n\treadonly bootId: string;\n\treadonly startedMs: number;\n\treadonly workDeadlineMs: number;\n\treadonly verifyCapMs: number;\n\treadonly cleanupDeadlineMs: number;\n}\nconst BOOT_ID = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/;\n\nexport function readRunClock(): RunClock {\n\tif (process.platform !== \"linux\") throw new VerifiedRunError(\"clock_unavailable\");\n\tconst bootId = readFileSync(\"/proc/sys/kernel/random/boot_id\", \"utf8\").trim();\n\tconst nowMs = Math.floor(uptime() * 1000);\n\tif (!BOOT_ID.test(bootId) || !Number.isSafeInteger(nowMs) || nowMs < 0)\n\t\tthrow new VerifiedRunError(\"clock_unavailable\");\n\treturn Object.freeze({ bootId, nowMs });\n}\n\nexport function anchorRunBudget(limits: RunPhaseBudget, clock: RunClock): RecoveryBudget {\n\treturn parseRecoveryBudget({\n\t\tbootId: clock.bootId,\n\t\tstartedMs: clock.nowMs,\n\t\tworkDeadlineMs: clock.nowMs + limits.workMs,\n\t\tverifyCapMs: clock.nowMs + limits.workMs + limits.verifyMs,\n\t\tcleanupDeadlineMs: clock.nowMs + limits.workMs + limits.verifyMs + limits.cleanupMs,\n\t});\n}\n\nexport function parseRecoveryBudget(raw: unknown): RecoveryBudget {\n\tif (\n\t\ttypeof raw !== \"object\" ||\n\t\traw === null ||\n\t\t!(\"bootId\" in raw) ||\n\t\ttypeof raw.bootId !== \"string\" ||\n\t\t!BOOT_ID.test(raw.bootId) ||\n\t\t!(\"startedMs\" in raw) ||\n\t\ttypeof raw.startedMs !== \"number\" ||\n\t\t!(\"workDeadlineMs\" in raw) ||\n\t\ttypeof raw.workDeadlineMs !== \"number\" ||\n\t\t!(\"verifyCapMs\" in raw) ||\n\t\ttypeof raw.verifyCapMs !== \"number\" ||\n\t\t!(\"cleanupDeadlineMs\" in raw) ||\n\t\ttypeof raw.cleanupDeadlineMs !== \"number\"\n\t)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\tconst values = [raw.startedMs, raw.workDeadlineMs, raw.verifyCapMs, raw.cleanupDeadlineMs];\n\tif (\n\t\tvalues.some((value) => !Number.isSafeInteger(value) || value < 0) ||\n\t\traw.workDeadlineMs <= raw.startedMs ||\n\t\traw.verifyCapMs <= raw.workDeadlineMs ||\n\t\traw.cleanupDeadlineMs <= raw.verifyCapMs\n\t)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\treturn Object.freeze({\n\t\tbootId: raw.bootId,\n\t\tstartedMs: raw.startedMs,\n\t\tworkDeadlineMs: raw.workDeadlineMs,\n\t\tverifyCapMs: raw.verifyCapMs,\n\t\tcleanupDeadlineMs: raw.cleanupDeadlineMs,\n\t});\n}\n\nexport function remainingRunTime(budget: RecoveryBudget, deadlineMs: number, clock = readRunClock()): number {\n\tif (clock.bootId !== budget.bootId) throw new VerifiedRunError(\"clock_changed\");\n\tif (clock.nowMs < budget.startedMs) throw new VerifiedRunError(\"clock_rollback\");\n\tif (!Number.isSafeInteger(deadlineMs) || deadlineMs <= budget.startedMs || deadlineMs > budget.verifyCapMs)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\treturn Math.max(0, deadlineMs - clock.nowMs);\n}\n\nexport const remainingVerification = remainingRunTime;\n\nexport function localVerificationDeadline(budget: RecoveryBudget, deadlineMs: number): number {\n\tconst remaining = remainingVerification(budget, deadlineMs);\n\tif (remaining <= 0) throw new VerifiedRunError(\"deadline\");\n\treturn performance.now() + remaining;\n}\n"]}

package/dist/core/verified-run/recovery-command.d.ts

@@ -0,0 +1,11 @@
+import type { RunResumeCommand, RunTaskRetryCommand, RunWriterRestartCommand } from "omk-protocol";
+import { type JournalSnapshot, VerifiedRunJournal } from "./journal.ts";
+import type { RunProjection } from "./run-types.ts";
+export type RecoveryCommand = RunResumeCommand | RunWriterRestartCommand | RunTaskRetryCommand;
+export declare function requireRunJournal(runPath: string): JournalSnapshot;
+/** One lease/CAS/idempotency boundary for all explicit recovery actions. */
+export declare function withRecoveryLease(runPath: string, command: RecoveryCommand, execute: (input: {
+    readonly snapshot: JournalSnapshot;
+    readonly journal: VerifiedRunJournal;
+}) => Promise<RunProjection>): Promise<RunProjection>;
+//# sourceMappingURL=recovery-command.d.ts.map

package/dist/core/verified-run/recovery-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-command.d.ts","sourceRoot":"","sources":["../../../src/core/verified-run/recovery-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEnG,OAAO,EAAE,KAAK,eAAe,EAA+B,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;AAC/F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAIlE;AA4CD,4EAA4E;AAC5E,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE;IAChB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACrC,KAAK,OAAO,CAAC,aAAa,CAAC,GAC1B,OAAO,CAAC,aAAa,CAAC,CAsBxB","sourcesContent":["import type { RunResumeCommand, RunTaskRetryCommand, RunWriterRestartCommand } from \"omk-protocol\";\nimport { acquireSessionOwnerLeaseSync } from \"../session-owner-lease.ts\";\nimport { type JournalSnapshot, journalPath, readRunJournal, VerifiedRunJournal } from \"./journal.ts\";\nimport type { RunProjection } from \"./run-types.ts\";\nimport { digestObject, VerifiedRunError } from \"./storage.ts\";\n\nexport type RecoveryCommand = RunResumeCommand | RunWriterRestartCommand | RunTaskRetryCommand;\nexport function requireRunJournal(runPath: string): JournalSnapshot {\n\tconst journal = readRunJournal(runPath);\n\tif (!journal) throw new VerifiedRunError(\"missing_run\");\n\treturn journal;\n}\n\nfunction commandDisposition(journal: JournalSnapshot, command: RecoveryCommand): \"new\" | \"duplicate\" {\n\tconst first = journal.records[0]?.event;\n\tif (\n\t\tfirst?.kind !== \"created\" ||\n\t\tfirst.contract.runId !== command.runId ||\n\t\tdigestObject(first.contract) !== command.contractDigest\n\t)\n\t\tthrow new VerifiedRunError(\"command_conflict\");\n\tif (first.command.commandId === command.commandId) throw new VerifiedRunError(\"command_conflict\");\n\tconst previous = journal.records.find(\n\t\t({ event }) =>\n\t\t\t(event.kind === \"resumed\" || event.kind === \"writer_restarted\" || event.kind === \"tasks_retried\") &&\n\t\t\tevent.command.commandId === command.commandId,\n\t)?.event;\n\tif (previous?.kind === \"resumed\" || previous?.kind === \"writer_restarted\" || previous?.kind === \"tasks_retried\") {\n\t\tif (digestObject(previous.command) !== digestObject(command)) throw new VerifiedRunError(\"command_conflict\");\n\t\treturn \"duplicate\";\n\t}\n\tif (command.expectedRevision !== journal.state.revision || command.expectedGeneration !== journal.state.generation)\n\t\tthrow new VerifiedRunError(\"stale_revision\");\n\tswitch (command.kind) {\n\t\tcase \"resume\":\n\t\t\tif (command.candidateDigest !== journal.state.candidateDigest)\n\t\t\t\tthrow new VerifiedRunError(\"candidate_mismatch\");\n\t\t\tbreak;\n\t\tcase \"retry_tasks\":\n\t\tcase \"restart_writer\":\n\t\t\tif (!journal.state.inputDigest) throw new VerifiedRunError(\"input_checkpoint_missing\");\n\t\t\tif (\n\t\t\t\tcommand.baseDigest !== journal.state.inputDigest ||\n\t\t\t\tcommand.baseDigest !== first.contract.workspace.baseDigest\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"input_mismatch\");\n\t\t\tbreak;\n\t\tdefault: {\n\t\t\tconst exhaustive: never = command;\n\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t}\n\t}\n\treturn \"new\";\n}\n\n/** One lease/CAS/idempotency boundary for all explicit recovery actions. */\nexport async function withRecoveryLease(\n\trunPath: string,\n\tcommand: RecoveryCommand,\n\texecute: (input: {\n\t\treadonly snapshot: JournalSnapshot;\n\t\treadonly journal: VerifiedRunJournal;\n\t}) => Promise<RunProjection>,\n): Promise<RunProjection> {\n\tconst initial = requireRunJournal(runPath);\n\tif (commandDisposition(initial, command) === \"duplicate\") return initial.state;\n\tconst owner = acquireSessionOwnerLeaseSync(journalPath(runPath));\n\ttry {\n\t\tconst snapshot = requireRunJournal(runPath);\n\t\tif (commandDisposition(snapshot, command) === \"duplicate\") return snapshot.state;\n\t\tconst journal = new VerifiedRunJournal(runPath, owner);\n\t\ttry {\n\t\t\treturn await execute({ snapshot, journal });\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\terror instanceof VerifiedRunError &&\n\t\t\t\tjournal.state.generation > snapshot.state.generation &&\n\t\t\t\t!journal.state.receiptDigest\n\t\t\t)\n\t\t\t\treturn journal.append({ kind: \"failed\", code: error.code });\n\t\t\tthrow error;\n\t\t}\n\t} finally {\n\t\towner.release();\n\t}\n}\n"]}

package/dist/core/verified-run/recovery-command.js

@@ -0,0 +1,73 @@
+import { acquireSessionOwnerLeaseSync } from "../session-owner-lease.js";
+import { journalPath, readRunJournal, VerifiedRunJournal } from "./journal.js";
+import { digestObject, VerifiedRunError } from "./storage.js";
+export function requireRunJournal(runPath) {
+    const journal = readRunJournal(runPath);
+    if (!journal)
+        throw new VerifiedRunError("missing_run");
+    return journal;
+}
+function commandDisposition(journal, command) {
+    const first = journal.records[0]?.event;
+    if (first?.kind !== "created" ||
+        first.contract.runId !== command.runId ||
+        digestObject(first.contract) !== command.contractDigest)
+        throw new VerifiedRunError("command_conflict");
+    if (first.command.commandId === command.commandId)
+        throw new VerifiedRunError("command_conflict");
+    const previous = journal.records.find(({ event }) => (event.kind === "resumed" || event.kind === "writer_restarted" || event.kind === "tasks_retried") &&
+        event.command.commandId === command.commandId)?.event;
+    if (previous?.kind === "resumed" || previous?.kind === "writer_restarted" || previous?.kind === "tasks_retried") {
+        if (digestObject(previous.command) !== digestObject(command))
+            throw new VerifiedRunError("command_conflict");
+        return "duplicate";
+    }
+    if (command.expectedRevision !== journal.state.revision || command.expectedGeneration !== journal.state.generation)
+        throw new VerifiedRunError("stale_revision");
+    switch (command.kind) {
+        case "resume":
+            if (command.candidateDigest !== journal.state.candidateDigest)
+                throw new VerifiedRunError("candidate_mismatch");
+            break;
+        case "retry_tasks":
+        case "restart_writer":
+            if (!journal.state.inputDigest)
+                throw new VerifiedRunError("input_checkpoint_missing");
+            if (command.baseDigest !== journal.state.inputDigest ||
+                command.baseDigest !== first.contract.workspace.baseDigest)
+                throw new VerifiedRunError("input_mismatch");
+            break;
+        default: {
+            const exhaustive = command;
+            throw new VerifiedRunError(String(exhaustive));
+        }
+    }
+    return "new";
+}
+/** One lease/CAS/idempotency boundary for all explicit recovery actions. */
+export async function withRecoveryLease(runPath, command, execute) {
+    const initial = requireRunJournal(runPath);
+    if (commandDisposition(initial, command) === "duplicate")
+        return initial.state;
+    const owner = acquireSessionOwnerLeaseSync(journalPath(runPath));
+    try {
+        const snapshot = requireRunJournal(runPath);
+        if (commandDisposition(snapshot, command) === "duplicate")
+            return snapshot.state;
+        const journal = new VerifiedRunJournal(runPath, owner);
+        try {
+            return await execute({ snapshot, journal });
+        }
+        catch (error) {
+            if (error instanceof VerifiedRunError &&
+                journal.state.generation > snapshot.state.generation &&
+                !journal.state.receiptDigest)
+                return journal.append({ kind: "failed", code: error.code });
+            throw error;
+        }
+    }
+    finally {
+        owner.release();
+    }
+}
+//# sourceMappingURL=recovery-command.js.map

package/dist/core/verified-run/recovery-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-command.js","sourceRoot":"","sources":["../../../src/core/verified-run/recovery-command.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RunResumeCommand, RunTaskRetryCommand, RunWriterRestartCommand } from \"omk-protocol\";\nimport { acquireSessionOwnerLeaseSync } from \"../session-owner-lease.ts\";\nimport { type JournalSnapshot, journalPath, readRunJournal, VerifiedRunJournal } from \"./journal.ts\";\nimport type { RunProjection } from \"./run-types.ts\";\nimport { digestObject, VerifiedRunError } from \"./storage.ts\";\n\nexport type RecoveryCommand = RunResumeCommand | RunWriterRestartCommand | RunTaskRetryCommand;\nexport function requireRunJournal(runPath: string): JournalSnapshot {\n\tconst journal = readRunJournal(runPath);\n\tif (!journal) throw new VerifiedRunError(\"missing_run\");\n\treturn journal;\n}\n\nfunction commandDisposition(journal: JournalSnapshot, command: RecoveryCommand): \"new\" | \"duplicate\" {\n\tconst first = journal.records[0]?.event;\n\tif (\n\t\tfirst?.kind !== \"created\" ||\n\t\tfirst.contract.runId !== command.runId ||\n\t\tdigestObject(first.contract) !== command.contractDigest\n\t)\n\t\tthrow new VerifiedRunError(\"command_conflict\");\n\tif (first.command.commandId === command.commandId) throw new VerifiedRunError(\"command_conflict\");\n\tconst previous = journal.records.find(\n\t\t({ event }) =>\n\t\t\t(event.kind === \"resumed\" || event.kind === \"writer_restarted\" || event.kind === \"tasks_retried\") &&\n\t\t\tevent.command.commandId === command.commandId,\n\t)?.event;\n\tif (previous?.kind === \"resumed\" || previous?.kind === \"writer_restarted\" || previous?.kind === \"tasks_retried\") {\n\t\tif (digestObject(previous.command) !== digestObject(command)) throw new VerifiedRunError(\"command_conflict\");\n\t\treturn \"duplicate\";\n\t}\n\tif (command.expectedRevision !== journal.state.revision || command.expectedGeneration !== journal.state.generation)\n\t\tthrow new VerifiedRunError(\"stale_revision\");\n\tswitch (command.kind) {\n\t\tcase \"resume\":\n\t\t\tif (command.candidateDigest !== journal.state.candidateDigest)\n\t\t\t\tthrow new VerifiedRunError(\"candidate_mismatch\");\n\t\t\tbreak;\n\t\tcase \"retry_tasks\":\n\t\tcase \"restart_writer\":\n\t\t\tif (!journal.state.inputDigest) throw new VerifiedRunError(\"input_checkpoint_missing\");\n\t\t\tif (\n\t\t\t\tcommand.baseDigest !== journal.state.inputDigest ||\n\t\t\t\tcommand.baseDigest !== first.contract.workspace.baseDigest\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"input_mismatch\");\n\t\t\tbreak;\n\t\tdefault: {\n\t\t\tconst exhaustive: never = command;\n\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t}\n\t}\n\treturn \"new\";\n}\n\n/** One lease/CAS/idempotency boundary for all explicit recovery actions. */\nexport async function withRecoveryLease(\n\trunPath: string,\n\tcommand: RecoveryCommand,\n\texecute: (input: {\n\t\treadonly snapshot: JournalSnapshot;\n\t\treadonly journal: VerifiedRunJournal;\n\t}) => Promise<RunProjection>,\n): Promise<RunProjection> {\n\tconst initial = requireRunJournal(runPath);\n\tif (commandDisposition(initial, command) === \"duplicate\") return initial.state;\n\tconst owner = acquireSessionOwnerLeaseSync(journalPath(runPath));\n\ttry {\n\t\tconst snapshot = requireRunJournal(runPath);\n\t\tif (commandDisposition(snapshot, command) === \"duplicate\") return snapshot.state;\n\t\tconst journal = new VerifiedRunJournal(runPath, owner);\n\t\ttry {\n\t\t\treturn await execute({ snapshot, journal });\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\terror instanceof VerifiedRunError &&\n\t\t\t\tjournal.state.generation > snapshot.state.generation &&\n\t\t\t\t!journal.state.receiptDigest\n\t\t\t)\n\t\t\t\treturn journal.append({ kind: \"failed\", code: error.code });\n\t\t\tthrow error;\n\t\t}\n\t} finally {\n\t\towner.release();\n\t}\n}\n"]}

package/dist/core/verified-run/recovery-projection.d.ts

@@ -0,0 +1,12 @@
+import type { RunEvent, WriterReduction } from "./run-types.ts";
+type RecoveryEvent = Extract<RunEvent, {
+    kind: "resumed" | "writer_restarted" | "tasks_retried";
+}>;
+/** Shared generation/command fence; only the writer variant resets attempt-local progress. */
+export declare function reduceRecoveryEvent(context: WriterReduction, event: RecoveryEvent, progress: {
+    readonly commands: Set<string>;
+    readonly checked: Set<string>;
+    readonly activeRole: "writer" | "verifier";
+}): void;
+export {};
+//# sourceMappingURL=recovery-projection.d.ts.map

package/dist/core/verified-run/recovery-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-projection.d.ts","sourceRoot":"","sources":["../../../src/core/verified-run/recovery-projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGhE,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAA;CAAE,CAAC,CAAC;AAEnG,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE;IACT,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC3C,GACC,IAAI,CAyFN","sourcesContent":["import { MAX_VERIFIED_RUN_GENERATIONS } from \"omk-protocol\";\nimport { retryTaskProjection } from \"./dag-retry-projection.ts\";\nimport type { RunEvent, WriterReduction } from \"./run-types.ts\";\nimport { digestObject, VerifiedRunError } from \"./storage.ts\";\n\ntype RecoveryEvent = Extract<RunEvent, { kind: \"resumed\" | \"writer_restarted\" | \"tasks_retried\" }>;\n\n/** Shared generation/command fence; only the writer variant resets attempt-local progress. */\nexport function reduceRecoveryEvent(\n\tcontext: WriterReduction,\n\tevent: RecoveryEvent,\n\tprogress: {\n\t\treadonly commands: Set<string>;\n\t\treadonly checked: Set<string>;\n\t\treadonly activeRole: \"writer\" | \"verifier\";\n\t},\n): void {\n\tconst state = context.state;\n\tconst command = event.command;\n\tif (!state.budget) throw new VerifiedRunError(\"resume_unavailable\");\n\tif (state.generation >= MAX_VERIFIED_RUN_GENERATIONS) throw new VerifiedRunError(\"recovery_limit\");\n\tif (command.expectedRevision !== state.revision || command.expectedGeneration !== state.generation)\n\t\tthrow new VerifiedRunError(\"stale_revision\");\n\tif (\n\t\tcommand.runId !== state.runId ||\n\t\tcommand.contractDigest !== digestObject(context.contract) ||\n\t\tprogress.commands.has(command.commandId)\n\t)\n\t\tthrow new VerifiedRunError(\"command_conflict\");\n\tif (\n\t\tevent.reconciledExecutionIds.length !== state.activeExecutionIds.length ||\n\t\tevent.reconciledExecutionIds.some((id, index) => id !== state.activeExecutionIds[index])\n\t)\n\t\tthrow new VerifiedRunError(\"integrity\");\n\tlet deadline: number;\n\tlet tasks = state.tasks;\n\tswitch (event.kind) {\n\t\tcase \"resumed\":\n\t\t\tif (\n\t\t\t\t!state.candidateDigest ||\n\t\t\t\tstate.writerOpen ||\n\t\t\t\tstate.verificationDeadlineMs === null ||\n\t\t\t\tevent.command.candidateDigest !== state.candidateDigest\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"resume_unavailable\");\n\t\t\tif (state.activeExecutionIds.length && progress.activeRole !== \"verifier\")\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tdeadline = state.verificationDeadlineMs;\n\t\t\tbreak;\n\t\tcase \"tasks_retried\":\n\t\t\tif (state.activeExecutionIds.length && progress.activeRole !== \"writer\")\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\ttasks = retryTaskProjection(context, event);\n\t\t\tdeadline = state.budget.workDeadlineMs;\n\t\t\tcontext.writerStarted = false;\n\t\t\tcontext.writerFinished = tasks.every((task) => task.status === \"succeeded\");\n\t\t\tcontext.producerStarted = false;\n\t\t\tcontext.writerCommands = 0;\n\t\t\tcontext.requestBaseline = state.modelRequests;\n\t\t\tbreak;\n\t\tcase \"writer_restarted\":\n\t\t\tif (context.contract.profile === \"linux-command-dag-v1\") throw new VerifiedRunError(\"task_recovery_required\");\n\t\t\tif (\n\t\t\t\t!state.inputDigest ||\n\t\t\t\tstate.candidateDigest ||\n\t\t\t\tevent.command.baseDigest !== state.inputDigest ||\n\t\t\t\tstate.inputDigest !== context.contract.workspace.baseDigest\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"input_checkpoint_missing\");\n\t\t\tif (state.activeExecutionIds.length && progress.activeRole !== \"writer\")\n\t\t\t\tthrow new VerifiedRunError(\"integrity\");\n\t\t\tif (\n\t\t\t\tcontext.contract.profile === \"linux-scripted-agent-v1\" &&\n\t\t\t\tcontext.contract.writer.maxRequests - state.modelRequests < context.contract.writer.steps.length + 1\n\t\t\t)\n\t\t\t\tthrow new VerifiedRunError(\"model_request_limit\");\n\t\t\tdeadline = state.budget.workDeadlineMs;\n\t\t\tcontext.writerStarted = false;\n\t\t\tcontext.writerFinished = false;\n\t\t\tcontext.producerStarted = false;\n\t\t\tcontext.writerCommands = 0;\n\t\t\tcontext.requestBaseline = state.modelRequests;\n\t\t\tbreak;\n\t\tdefault: {\n\t\t\tconst exhaustive: never = event;\n\t\t\tthrow new VerifiedRunError(String(exhaustive));\n\t\t}\n\t}\n\tif (event.observedMs < (state.lastClockMs ?? state.budget.startedMs) || event.observedMs >= deadline)\n\t\tthrow new VerifiedRunError(\"deadline\");\n\tprogress.commands.add(command.commandId);\n\tprogress.checked.clear();\n\tcontext.state = {\n\t\t...state,\n\t\tgeneration: state.generation + 1,\n\t\ttasks,\n\t\texecution: \"running\",\n\t\tsettlement: \"settled\",\n\t\tverification: \"not_requested\",\n\t\twriterOpen: false,\n\t\tactiveExecutionIds: [],\n\t\tprocesses: [],\n\t\tfailure: null,\n\t\tlastClockMs: event.observedMs,\n\t};\n}\n"]}