@elie-laloum/outpost 3.0.0 → 4.1.0

package/dist/domain/workflow/workflow-scheduler.js

@@ -1,54 +1,87 @@
+import { applyDecisions, pauseGate, prepareDecisions } from "./gates.js";
+import { openCheckpoint } from "./checkpoint.js";
 import { WorkflowFailure } from "./failure.js";
 import { runTask } from "./task-runner.js";
 import { positive } from "./validation.js";
 import { workflowState } from "./workflow-state.js";
 export async function schedule(name, tasks, options) {
+    if (!options.checkpoint &&
+        (tasks.some((item) => item.gate) || options.decisions?.length))
+        throw new Error("Workflow gates and decisions require a checkpoint");
+    if (options.decisions && !options.decisions.length)
+        throw new Error("Workflow decisions cannot be empty");
+    const checkpoint = options.checkpoint
+        ? await openCheckpoint(name, tasks, options.checkpoint)
+        : undefined;
+    try {
+        return await scheduleRun(name, tasks, options, checkpoint);
+    }
+    finally {
+        await checkpoint?.release();
+    }
+}
+async function scheduleRun(name, tasks, options, checkpoint) {
     const concurrency = options.concurrency ?? 1;
     positive(concurrency, "concurrency");
-    const state = workflowState(name, tasks, options);
+    const state = workflowState(name, tasks, options, checkpoint);
     const { executionId, signal, values, records, errors, observerErrors, record, emit, finish, } = state;
     const active = new Map();
     const started = Date.now();
+    const decisions = prepareDecisions(state);
     emit({ type: "start" });
-    while (true) {
-        let changed = false;
-        for (const item of tasks) {
-            if (record(item).status !== "waiting")
-                continue;
-            if (signal.aborted || state.accounting.exhausted) {
-                finish(item, "cancelled");
+    applyDecisions(state, decisions);
+    await state.persist();
+    try {
+        while (true) {
+            let changed = false;
+            for (const item of tasks) {
+                if (record(item).status !== "waiting")
+                    continue;
+                if (signal.aborted || state.accounting.exhausted) {
+                    finish(item, "cancelled");
+                    changed = true;
+                    continue;
+                }
+                const dependencies = item.after.map((dependency) => record(dependency).status);
+                if (dependencies.some((status) => ["failed", "skipped", "cancelled", "rejected"].includes(status))) {
+                    finish(item, "skipped");
+                    changed = true;
+                    continue;
+                }
+                if (active.size >= concurrency ||
+                    item.after.some((dependency) => active.has(dependency)) ||
+                    !dependencies.every((status) => status === "done"))
+                    continue;
+                const running = (item.gate ? pauseGate(item, state) : runTask(item, state)).finally(() => {
+                    active.delete(item);
+                });
+                active.set(item, running);
                 changed = true;
-                continue;
             }
-            const dependencies = item.after.map((dependency) => record(dependency).status);
-            if (dependencies.some((status) => ["failed", "skipped", "cancelled"].includes(status))) {
-                finish(item, "skipped");
-                changed = true;
+            if (active.size) {
+                await Promise.race(active.values());
                 continue;
             }
-            if (active.size >= concurrency ||
-                !dependencies.every((status) => status === "done"))
-                continue;
-            const running = runTask(item, state).finally(() => {
-                active.delete(item);
-            });
-            active.set(item, running);
-            changed = true;
-        }
-        if (active.size) {
-            await Promise.race(active.values());
-            continue;
+            if (!changed)
+                break;
         }
-        if (!changed)
-            break;
     }
+    catch (error) {
+        state.stop.abort(error);
+        await Promise.allSettled(active.values());
+        throw error;
+    }
+    await state.persist();
     if (options.signal?.aborted)
         errors.push(options.signal.reason);
-    const status = options.signal?.aborted
-        ? "cancelled"
-        : errors.length
-            ? "failed"
-            : "done";
+    const paused = [...records.values()].some((entry) => entry.status === "paused");
+    let status = "done";
+    if (paused)
+        status = "paused";
+    if (errors.length)
+        status = "failed";
+    if (options.signal?.aborted)
+        status = "cancelled";
     emit({ type: "finish", status, durationMs: Date.now() - started });
     const result = Object.freeze({
         executionId,

package/dist/domain/workflow/workflow-scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-scheduler.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-scheduler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,KAAsB,EACtB,OAAwB;IAExB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,EACJ,WAAW,EACX,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,cAAc,EACd,MAAM,EACN,IAAI,EACJ,MAAM,GACP,GAAG,KAAK,CAAC;IACV,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACxB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS;YAChD,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC1B,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS;YACX,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CACjC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAC1C,CAAC;YACF,IACE,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3B,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpD,EACD,CAAC;gBACD,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IACE,MAAM,CAAC,IAAI,IAAI,WAAW;gBAC1B,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC;gBAElD,SAAS;YACX,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,MAAM;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO;QACpC,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,CAAC,MAAM;YACb,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAmB,MAAM,CAAC,MAAM,CAAC;QAC3C,WAAW;QACX,IAAI;QACJ,MAAM;QACN,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE;QAClC,KAAK,EAAE,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAClE;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,KAAK,CAAI,IAAa;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,GAAG,4CAA4C,CACxD,CAAC;YACJ,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAM,CAAC;QAC/B,CAAC;QACD,MAAM;YACJ,IAAI,MAAM,KAAK,MAAM;gBAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type {\n  Task,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"../workflow.types.ts\";\nimport { WorkflowFailure } from \"./failure.ts\";\nimport { runTask } from \"./task-runner.ts\";\nimport { positive } from \"./validation.ts\";\nimport { workflowState } from \"./workflow-state.ts\";\n\nexport async function schedule(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n): Promise<WorkflowResult> {\n  const concurrency = options.concurrency ?? 1;\n  positive(concurrency, \"concurrency\");\n  const state = workflowState(name, tasks, options);\n  const {\n    executionId,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n  } = state;\n  const active = new Map<Task, Promise<void>>();\n  const started = Date.now();\n  emit({ type: \"start\" });\n  while (true) {\n    let changed = false;\n    for (const item of tasks) {\n      if (record(item).status !== \"waiting\") continue;\n      if (signal.aborted || state.accounting.exhausted) {\n        finish(item, \"cancelled\");\n        changed = true;\n        continue;\n      }\n      const dependencies = item.after.map(\n        (dependency) => record(dependency).status,\n      );\n      if (\n        dependencies.some((status) =>\n          [\"failed\", \"skipped\", \"cancelled\"].includes(status),\n        )\n      ) {\n        finish(item, \"skipped\");\n        changed = true;\n        continue;\n      }\n      if (\n        active.size >= concurrency ||\n        !dependencies.every((status) => status === \"done\")\n      )\n        continue;\n      const running = runTask(item, state).finally(() => {\n        active.delete(item);\n      });\n      active.set(item, running);\n      changed = true;\n    }\n    if (active.size) {\n      await Promise.race(active.values());\n      continue;\n    }\n    if (!changed) break;\n  }\n  if (options.signal?.aborted) errors.push(options.signal.reason);\n  const status = options.signal?.aborted\n    ? \"cancelled\"\n    : errors.length\n      ? \"failed\"\n      : \"done\";\n  emit({ type: \"finish\", status, durationMs: Date.now() - started });\n  const result: WorkflowResult = Object.freeze({\n    executionId,\n    name,\n    status,\n    usage: state.accounting.snapshot(),\n    tasks: Object.freeze(\n      [...records.values()].map((value) => Object.freeze({ ...value })),\n    ),\n    errors: Object.freeze(errors),\n    observerErrors: Object.freeze(observerErrors),\n    value<T>(item: Task<T>): T {\n      if (!values.has(item))\n        throw new Error(\n          `${item.key} has no successful value in this execution`,\n        );\n      return values.get(item) as T;\n    },\n    unwrap() {\n      if (status !== \"done\") throw new WorkflowFailure(result);\n    },\n  });\n  return result;\n}\n"]}
+{"version":3,"file":"workflow-scheduler.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import { applyDecisions, pauseGate, prepareDecisions } from \"./gates.ts\";\nimport { openCheckpoint } from \"./checkpoint.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport type {\n  Task,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"../workflow.types.ts\";\nimport { WorkflowFailure } from \"./failure.ts\";\nimport { runTask } from \"./task-runner.ts\";\nimport { positive } from \"./validation.ts\";\nimport { workflowState } from \"./workflow-state.ts\";\n\nexport async function schedule(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n): Promise<WorkflowResult> {\n  if (\n    !options.checkpoint &&\n    (tasks.some((item) => item.gate) || options.decisions?.length)\n  )\n    throw new Error(\"Workflow gates and decisions require a checkpoint\");\n  if (options.decisions && !options.decisions.length)\n    throw new Error(\"Workflow decisions cannot be empty\");\n  const checkpoint = options.checkpoint\n    ? await openCheckpoint(name, tasks, options.checkpoint)\n    : undefined;\n  try {\n    return await scheduleRun(name, tasks, options, checkpoint);\n  } finally {\n    await checkpoint?.release();\n  }\n}\n\nasync function scheduleRun(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint?: WorkflowCheckpointSession,\n): Promise<WorkflowResult> {\n  const concurrency = options.concurrency ?? 1;\n  positive(concurrency, \"concurrency\");\n  const state = workflowState(name, tasks, options, checkpoint);\n  const {\n    executionId,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n  } = state;\n  const active = new Map<Task, Promise<void>>();\n  const started = Date.now();\n  const decisions = prepareDecisions(state);\n  emit({ type: \"start\" });\n  applyDecisions(state, decisions);\n  await state.persist();\n  try {\n    while (true) {\n      let changed = false;\n      for (const item of tasks) {\n        if (record(item).status !== \"waiting\") continue;\n        if (signal.aborted || state.accounting.exhausted) {\n          finish(item, \"cancelled\");\n          changed = true;\n          continue;\n        }\n        const dependencies = item.after.map(\n          (dependency) => record(dependency).status,\n        );\n        if (\n          dependencies.some((status) =>\n            [\"failed\", \"skipped\", \"cancelled\", \"rejected\"].includes(status),\n          )\n        ) {\n          finish(item, \"skipped\");\n          changed = true;\n          continue;\n        }\n        if (\n          active.size >= concurrency ||\n          item.after.some((dependency) => active.has(dependency)) ||\n          !dependencies.every((status) => status === \"done\")\n        )\n          continue;\n        const running = (\n          item.gate ? pauseGate(item, state) : runTask(item, state)\n        ).finally(() => {\n          active.delete(item);\n        });\n        active.set(item, running);\n        changed = true;\n      }\n      if (active.size) {\n        await Promise.race(active.values());\n        continue;\n      }\n      if (!changed) break;\n    }\n  } catch (error) {\n    state.stop.abort(error);\n    await Promise.allSettled(active.values());\n    throw error;\n  }\n  await state.persist();\n  if (options.signal?.aborted) errors.push(options.signal.reason);\n  const paused = [...records.values()].some(\n    (entry) => entry.status === \"paused\",\n  );\n  let status: WorkflowResult[\"status\"] = \"done\";\n  if (paused) status = \"paused\";\n  if (errors.length) status = \"failed\";\n  if (options.signal?.aborted) status = \"cancelled\";\n  emit({ type: \"finish\", status, durationMs: Date.now() - started });\n  const result: WorkflowResult = Object.freeze({\n    executionId,\n    name,\n    status,\n    usage: state.accounting.snapshot(),\n    tasks: Object.freeze(\n      [...records.values()].map((value) => Object.freeze({ ...value })),\n    ),\n    errors: Object.freeze(errors),\n    observerErrors: Object.freeze(observerErrors),\n    value<T>(item: Task<T>): T {\n      if (!values.has(item))\n        throw new Error(\n          `${item.key} has no successful value in this execution`,\n        );\n      return values.get(item) as T;\n    },\n    unwrap() {\n      if (status !== \"done\") throw new WorkflowFailure(result);\n    },\n  });\n  return result;\n}\n"]}

package/dist/domain/workflow/workflow-state.d.ts

@@ -1,2 +1,3 @@
+import type { WorkflowCheckpointSession } from "./checkpoint.types.ts";
 import type { Task, WorkflowExecutionState, WorkflowOptions } from "../workflow.types.ts";
-export declare function workflowState(name: string, tasks: readonly Task[], options: WorkflowOptions): WorkflowExecutionState;
+export declare function workflowState(name: string, tasks: readonly Task[], options: WorkflowOptions, checkpoint?: WorkflowCheckpointSession): WorkflowExecutionState;

package/dist/domain/workflow/workflow-state.js

@@ -1,7 +1,9 @@
+import { maxUsageReceiptsPerTask } from "./usage-receipt.constants.js";
+import { validateUsageReceipt } from "./usage-receipt.js";
 import { workflowAccounting } from "./budget.js";
 import { randomUUID } from "node:crypto";
-export function workflowState(name, tasks, options) {
-    const executionId = randomUUID();
+export function workflowState(name, tasks, options, checkpoint) {
+    const executionId = checkpoint?.initial?.executionId ?? randomUUID();
     const stop = new AbortController();
     const signal = options.signal
         ? AbortSignal.any([options.signal, stop.signal])
@@ -12,12 +14,51 @@ export function workflowState(name, tasks, options) {
         item,
         { key: item.key, status: "waiting", attempts: 0 },
     ]));
+    const saved = checkpoint?.initial;
+    if (saved) {
+        const complete = saved.records.every((entry) => ["done", "skipped"].includes(entry.status));
+        const settledPause = saved.records.some((entry) => ["paused", "rejected"].includes(entry.status)) &&
+            saved.records.every((entry) => ["done", "skipped", "paused", "rejected"].includes(entry.status) ||
+                (entry.status === "waiting" && entry.attempts === 0));
+        for (const item of tasks) {
+            const entry = saved.records.find((entry) => entry.key === item.key);
+            records.set(item, {
+                ...entry,
+                ...(entry.usageReceipts
+                    ? { usageReceipts: Object.freeze([...entry.usageReceipts]) }
+                    : {}),
+                ...(entry.pause
+                    ? {
+                        pause: Object.freeze({
+                            ...entry.pause,
+                            actors: Object.freeze([...entry.pause.actors]),
+                        }),
+                    }
+                    : {}),
+                ...(entry.decision
+                    ? { decision: Object.freeze({ ...entry.decision }) }
+                    : {}),
+                status: ["done", "paused", "rejected"].includes(entry.status) ||
+                    complete ||
+                    (settledPause && entry.status === "skipped")
+                    ? entry.status
+                    : "waiting",
+            });
+            if (entry.status === "done") {
+                const output = saved.values[item.key];
+                values.set(item, output.kind === "json" ? output.value : undefined);
+            }
+        }
+    }
     const errors = [], observerErrors = [];
+    for (const entry of records.values())
+        if (entry.status === "rejected")
+            errors.push(new Error(entry.error));
     const accounting = workflowAccounting(options.budget, (error) => {
         errors.push(error);
         if (error.dimension !== "attempts")
             stop.abort(error);
-    });
+    }, saved?.usage);
     const record = (item) => records.get(item);
     function emit(event) {
         try {
@@ -50,22 +91,52 @@ export function workflowState(name, tasks, options) {
     function context(item, attempt, taskSignal) {
         if (attempt > 0)
             activeAttempts.set(item, attempt);
+        function report(usage, receipt) {
+            const current = record(item);
+            if (attempt === 0 ||
+                current.status !== "active" ||
+                activeAttempts.get(item) !== attempt)
+                throw new Error("Usage must be reported during its active task attempt");
+            if (receipt !== undefined) {
+                validateUsageReceipt(receipt);
+                if (current.usageReceipts?.includes(receipt))
+                    return;
+                if ((current.usageReceipts?.length ?? 0) >= maxUsageReceiptsPerTask)
+                    throw new Error("Workflow usage receipt limit exceeded");
+            }
+            const previousReceipts = current.usageReceipts;
+            if (receipt !== undefined)
+                current.usageReceipts = Object.freeze([
+                    ...(previousReceipts ?? []),
+                    receipt,
+                ]);
+            try {
+                accounting.report(usage);
+            }
+            catch (error) {
+                if (previousReceipts)
+                    current.usageReceipts = previousReceipts;
+                else
+                    delete current.usageReceipts;
+                throw error;
+            }
+            void runtime.persist().catch((error) => stop.abort(error));
+            emit({
+                type: "usage",
+                key: item.key,
+                attempt,
+                usage: Object.freeze({ ...usage }),
+            });
+        }
         return {
             signal: taskSignal,
             attempt,
             executionId,
-            reportUsage(usage) {
-                if (attempt === 0 ||
-                    record(item).status !== "active" ||
-                    activeAttempts.get(item) !== attempt)
-                    throw new Error("Usage must be reported during its active task attempt");
-                accounting.report(usage);
-                emit({
-                    type: "usage",
-                    key: item.key,
-                    attempt,
-                    usage: Object.freeze({ ...usage }),
-                });
+            checkpoint: () => runtime.persist(),
+            reportUsage: (usage) => report(usage),
+            reportUsageOnce: (receipt, usage) => {
+                validateUsageReceipt(receipt);
+                report(usage, receipt);
             },
             value(dependency) {
                 if (!item.after.includes(dependency))
@@ -76,7 +147,10 @@ export function workflowState(name, tasks, options) {
             },
         };
     }
-    return {
+    const runtime = {
+        async persist() {
+            await checkpoint?.save(runtime);
+        },
         executionId,
         accounting,
         closeAttempt(item) {
@@ -94,5 +168,6 @@ export function workflowState(name, tasks, options) {
         context,
         options,
     };
+    return runtime;
 }
 //# sourceMappingURL=workflow-state.js.map

package/dist/domain/workflow/workflow-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { workflowAccounting } from \"./budget.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Task,\n  TaskContext,\n  TaskRecord,\n  TaskStatus,\n  WorkflowEvent,\n  WorkflowExecutionState,\n  WorkflowOptions,\n} from \"../workflow.types.ts\";\n\nexport function workflowState(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n): WorkflowExecutionState {\n  const executionId = randomUUID();\n  const stop = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  const values = new Map<Task, unknown>();\n  const activeAttempts = new Map<Task, number>();\n  const records = new Map<Task, TaskRecord>(\n    tasks.map((item) => [\n      item,\n      { key: item.key, status: \"waiting\", attempts: 0 },\n    ]),\n  );\n  const errors: unknown[] = [],\n    observerErrors: unknown[] = [];\n  const accounting = workflowAccounting(options.budget, (error) => {\n    errors.push(error);\n    if (error.dimension !== \"attempts\") stop.abort(error);\n  });\n  const record = (item: Task) => records.get(item)!;\n  function emit(\n    event: Omit<WorkflowEvent, \"executionId\" | \"workflow\" | \"timestamp\">,\n  ): void {\n    try {\n      options.observe?.({\n        ...event,\n        executionId,\n        workflow: name,\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      observerErrors.push(error);\n    }\n  }\n  function finish(item: Task, status: TaskStatus): void {\n    Object.assign(record(item), {\n      status,\n      finishedAt: new Date().toISOString(),\n    });\n    emit({\n      type: \"task\",\n      key: item.key,\n      status,\n      attempt: record(item).attempts,\n      ...(record(item).startedAt\n        ? { durationMs: Date.now() - Date.parse(record(item).startedAt!) }\n        : {}),\n    });\n  }\n  function context(\n    item: Task,\n    attempt: number,\n    taskSignal: AbortSignal,\n  ): TaskContext {\n    if (attempt > 0) activeAttempts.set(item, attempt);\n    return {\n      signal: taskSignal,\n      attempt,\n      executionId,\n      reportUsage(usage) {\n        if (\n          attempt === 0 ||\n          record(item).status !== \"active\" ||\n          activeAttempts.get(item) !== attempt\n        )\n          throw new Error(\n            \"Usage must be reported during its active task attempt\",\n          );\n        accounting.report(usage);\n        emit({\n          type: \"usage\",\n          key: item.key,\n          attempt,\n          usage: Object.freeze({ ...usage }),\n        });\n      },\n      value<T>(dependency: Task<T>): T {\n        if (!item.after.includes(dependency))\n          throw new Error(\n            `${item.key}: undeclared dependency ${dependency.key}`,\n          );\n        if (!values.has(dependency))\n          throw new Error(`${dependency.key} has no successful value`);\n        return values.get(dependency) as T;\n      },\n    };\n  }\n\n  return {\n    executionId,\n    accounting,\n    closeAttempt(item) {\n      activeAttempts.delete(item);\n    },\n    stop,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n    context,\n    options,\n  };\n}\n"]}
+{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../../src/domain/workflow/workflow-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { maxUsageReceiptsPerTask } from \"./usage-receipt.constants.ts\";\nimport { validateUsageReceipt } from \"./usage-receipt.ts\";\nimport type { Usage } from \"../agent.types.ts\";\nimport type { WorkflowCheckpointSession } from \"./checkpoint.types.ts\";\nimport { workflowAccounting } from \"./budget.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Task,\n  TaskContext,\n  TaskRecord,\n  TaskStatus,\n  WorkflowEvent,\n  WorkflowExecutionState,\n  WorkflowOptions,\n} from \"../workflow.types.ts\";\n\nexport function workflowState(\n  name: string,\n  tasks: readonly Task[],\n  options: WorkflowOptions,\n  checkpoint?: WorkflowCheckpointSession,\n): WorkflowExecutionState {\n  const executionId = checkpoint?.initial?.executionId ?? randomUUID();\n  const stop = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, stop.signal])\n    : stop.signal;\n  const values = new Map<Task, unknown>();\n  const activeAttempts = new Map<Task, number>();\n  const records = new Map<Task, TaskRecord>(\n    tasks.map((item) => [\n      item,\n      { key: item.key, status: \"waiting\", attempts: 0 },\n    ]),\n  );\n  const saved = checkpoint?.initial;\n  if (saved) {\n    const complete = saved.records.every((entry) =>\n      [\"done\", \"skipped\"].includes(entry.status),\n    );\n    const settledPause =\n      saved.records.some((entry) =>\n        [\"paused\", \"rejected\"].includes(entry.status),\n      ) &&\n      saved.records.every(\n        (entry) =>\n          [\"done\", \"skipped\", \"paused\", \"rejected\"].includes(entry.status) ||\n          (entry.status === \"waiting\" && entry.attempts === 0),\n      );\n    for (const item of tasks) {\n      const entry = saved.records.find((entry) => entry.key === item.key)!;\n      records.set(item, {\n        ...entry,\n        ...(entry.usageReceipts\n          ? { usageReceipts: Object.freeze([...entry.usageReceipts]) }\n          : {}),\n        ...(entry.pause\n          ? {\n              pause: Object.freeze({\n                ...entry.pause,\n                actors: Object.freeze([...entry.pause.actors]),\n              }),\n            }\n          : {}),\n        ...(entry.decision\n          ? { decision: Object.freeze({ ...entry.decision }) }\n          : {}),\n        status:\n          [\"done\", \"paused\", \"rejected\"].includes(entry.status) ||\n          complete ||\n          (settledPause && entry.status === \"skipped\")\n            ? entry.status\n            : \"waiting\",\n      });\n      if (entry.status === \"done\") {\n        const output = saved.values[item.key]!;\n        values.set(item, output.kind === \"json\" ? output.value : undefined);\n      }\n    }\n  }\n  const errors: unknown[] = [],\n    observerErrors: unknown[] = [];\n  for (const entry of records.values())\n    if (entry.status === \"rejected\") errors.push(new Error(entry.error));\n  const accounting = workflowAccounting(\n    options.budget,\n    (error) => {\n      errors.push(error);\n      if (error.dimension !== \"attempts\") stop.abort(error);\n    },\n    saved?.usage,\n  );\n  const record = (item: Task) => records.get(item)!;\n  function emit(\n    event: Omit<WorkflowEvent, \"executionId\" | \"workflow\" | \"timestamp\">,\n  ): void {\n    try {\n      options.observe?.({\n        ...event,\n        executionId,\n        workflow: name,\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      observerErrors.push(error);\n    }\n  }\n  function finish(item: Task, status: TaskStatus): void {\n    Object.assign(record(item), {\n      status,\n      finishedAt: new Date().toISOString(),\n    });\n    emit({\n      type: \"task\",\n      key: item.key,\n      status,\n      attempt: record(item).attempts,\n      ...(record(item).startedAt\n        ? { durationMs: Date.now() - Date.parse(record(item).startedAt!) }\n        : {}),\n    });\n  }\n  function context(\n    item: Task,\n    attempt: number,\n    taskSignal: AbortSignal,\n  ): TaskContext {\n    if (attempt > 0) activeAttempts.set(item, attempt);\n    function report(usage: Usage, receipt?: string): void {\n      const current = record(item);\n      if (\n        attempt === 0 ||\n        current.status !== \"active\" ||\n        activeAttempts.get(item) !== attempt\n      )\n        throw new Error(\n          \"Usage must be reported during its active task attempt\",\n        );\n      if (receipt !== undefined) {\n        validateUsageReceipt(receipt);\n        if (current.usageReceipts?.includes(receipt)) return;\n        if ((current.usageReceipts?.length ?? 0) >= maxUsageReceiptsPerTask)\n          throw new Error(\"Workflow usage receipt limit exceeded\");\n      }\n      const previousReceipts = current.usageReceipts;\n      if (receipt !== undefined)\n        current.usageReceipts = Object.freeze([\n          ...(previousReceipts ?? []),\n          receipt,\n        ]);\n      try {\n        accounting.report(usage);\n      } catch (error) {\n        if (previousReceipts) current.usageReceipts = previousReceipts;\n        else delete current.usageReceipts;\n        throw error;\n      }\n      void runtime.persist().catch((error: unknown) => stop.abort(error));\n      emit({\n        type: \"usage\",\n        key: item.key,\n        attempt,\n        usage: Object.freeze({ ...usage }),\n      });\n    }\n\n    return {\n      signal: taskSignal,\n      attempt,\n      executionId,\n      checkpoint: () => runtime.persist(),\n      reportUsage: (usage) => report(usage),\n      reportUsageOnce: (receipt, usage) => {\n        validateUsageReceipt(receipt);\n        report(usage, receipt);\n      },\n      value<T>(dependency: Task<T>): T {\n        if (!item.after.includes(dependency))\n          throw new Error(\n            `${item.key}: undeclared dependency ${dependency.key}`,\n          );\n        if (!values.has(dependency))\n          throw new Error(`${dependency.key} has no successful value`);\n        return values.get(dependency) as T;\n      },\n    };\n  }\n\n  const runtime: WorkflowExecutionState = {\n    async persist() {\n      await checkpoint?.save(runtime);\n    },\n    executionId,\n    accounting,\n    closeAttempt(item) {\n      activeAttempts.delete(item);\n    },\n    stop,\n    signal,\n    values,\n    records,\n    errors,\n    observerErrors,\n    record,\n    emit,\n    finish,\n    context,\n    options,\n  };\n  return runtime;\n}\n"]}

package/dist/domain/workflow.types.d.ts

@@ -1,3 +1,5 @@
+import type { WorkflowDecision, WorkflowDecisionRecord, WorkflowGate, WorkflowPauseRequest } from "./workflow/gates.types.ts";
+import type { WorkflowCheckpointOptions } from "./workflow/checkpoint.types.ts";
 import type { Usage } from "./agent.types.ts";
 import type { WorkflowAccounting, WorkflowBudget, WorkflowUsage } from "./workflow/budget.types.ts";
 export interface TaskContext {
@@ -5,6 +7,8 @@ export interface TaskContext {
     readonly attempt: number;
     readonly executionId: string;
     reportUsage(usage: Usage): void;
+    reportUsageOnce?(receipt: string, usage: Usage): void;
+    checkpoint?(): Promise<void>;
     value<T>(dependency: Task<T>): T;
 }
 export interface Retry {
@@ -14,6 +18,7 @@ export interface Retry {
 }
 export interface Task<T = unknown> {
     readonly key: string;
+    readonly gate?: WorkflowGate;
     readonly after: readonly Task[];
     readonly perform: (context: TaskContext) => T | Promise<T>;
     readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;
@@ -23,8 +28,11 @@ export interface Task<T = unknown> {
 export type TaskOptions<T> = Omit<Task<T>, "after"> & {
     readonly after?: readonly Task[];
 };
-export type TaskStatus = "waiting" | "active" | "done" | "failed" | "skipped" | "cancelled";
+export type TaskStatus = "waiting" | "active" | "done" | "failed" | "skipped" | "cancelled" | "paused" | "rejected";
 export interface TaskRecord {
+    usageReceipts?: readonly string[];
+    pause?: WorkflowPauseRequest;
+    decision?: WorkflowDecisionRecord;
     readonly key: string;
     status: TaskStatus;
     attempts: number;
@@ -44,6 +52,8 @@ export interface WorkflowEvent {
     readonly durationMs?: number;
 }
 export interface WorkflowOptions {
+    readonly decisions?: readonly WorkflowDecision[];
+    readonly checkpoint?: WorkflowCheckpointOptions;
     readonly signal?: AbortSignal;
     readonly concurrency?: number;
     readonly budget?: WorkflowBudget;
@@ -53,7 +63,7 @@ export interface WorkflowOptions {
 export interface WorkflowResult {
     readonly executionId: string;
     readonly name: string;
-    readonly status: "done" | "failed" | "cancelled";
+    readonly status: "done" | "failed" | "cancelled" | "paused";
     readonly tasks: readonly Readonly<TaskRecord>[];
     readonly errors: readonly unknown[];
     readonly observerErrors: readonly unknown[];
@@ -78,6 +88,7 @@ export interface WorkflowExecutionState {
     readonly observerErrors: unknown[];
     readonly options: WorkflowOptions;
     readonly accounting: WorkflowAccounting;
+    persist(): Promise<void>;
     closeAttempt(task: Task): void;
     record(task: Task): TaskRecord;
     emit(event: WorkflowNotification): void;

package/dist/domain/workflow.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.types.js","sourceRoot":"","sources":["../../src/domain/workflow.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\nimport type {\n  WorkflowAccounting,\n  WorkflowBudget,\n  WorkflowUsage,\n} from \"./workflow/budget.types.ts\";\n\nexport interface TaskContext {\n  readonly signal: AbortSignal;\n  readonly attempt: number;\n  readonly executionId: string;\n  reportUsage(usage: Usage): void;\n  value<T>(dependency: Task<T>): T;\n}\n\nexport interface Retry {\n  readonly attempts: number;\n  readonly delayMs?: number;\n  readonly accepts?: (error: unknown, attempt: number) => boolean;\n}\n\nexport interface Task<T = unknown> {\n  readonly key: string;\n  readonly after: readonly Task[];\n  readonly perform: (context: TaskContext) => T | Promise<T>;\n  readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;\n  readonly retry?: Retry;\n  readonly timeoutMs?: number;\n}\n\nexport type TaskOptions<T> = Omit<Task<T>, \"after\"> & {\n  readonly after?: readonly Task[];\n};\n\nexport type TaskStatus =\n  \"waiting\" | \"active\" | \"done\" | \"failed\" | \"skipped\" | \"cancelled\";\n\nexport interface TaskRecord {\n  readonly key: string;\n  status: TaskStatus;\n  attempts: number;\n  startedAt?: string;\n  finishedAt?: string;\n  error?: string;\n}\n\nexport interface WorkflowEvent {\n  readonly executionId: string;\n  readonly workflow: string;\n  readonly timestamp: string;\n  readonly type: \"start\" | \"task\" | \"attempt\" | \"retry\" | \"usage\" | \"finish\";\n  readonly key?: string;\n  readonly status?: TaskStatus;\n  readonly attempt?: number;\n  readonly usage?: Usage;\n  readonly durationMs?: number;\n}\n\nexport interface WorkflowOptions {\n  readonly signal?: AbortSignal;\n  readonly concurrency?: number;\n  readonly budget?: WorkflowBudget;\n  readonly stopOnError?: boolean;\n  readonly observe?: (event: WorkflowEvent) => void;\n}\n\nexport interface WorkflowResult {\n  readonly executionId: string;\n  readonly name: string;\n  readonly status: \"done\" | \"failed\" | \"cancelled\";\n  readonly tasks: readonly Readonly<TaskRecord>[];\n  readonly errors: readonly unknown[];\n  readonly observerErrors: readonly unknown[];\n  readonly usage: WorkflowUsage;\n  value<T>(task: Task<T>): T;\n  unwrap(): void;\n}\n\nexport interface Workflow {\n  readonly name: string;\n  readonly tasks: readonly Task[];\n  start(options?: WorkflowOptions): Promise<WorkflowResult>;\n  diagram(): string;\n}\n\nexport type WorkflowNotification = Omit<\n  WorkflowEvent,\n  \"executionId\" | \"workflow\" | \"timestamp\"\n>;\nexport interface WorkflowExecutionState {\n  readonly executionId: string;\n  readonly stop: AbortController;\n  readonly signal: AbortSignal;\n  readonly values: Map<Task, unknown>;\n  readonly records: Map<Task, TaskRecord>;\n  readonly errors: unknown[];\n  readonly observerErrors: unknown[];\n  readonly options: WorkflowOptions;\n  readonly accounting: WorkflowAccounting;\n  closeAttempt(task: Task): void;\n  record(task: Task): TaskRecord;\n  emit(event: WorkflowNotification): void;\n  finish(task: Task, status: TaskStatus): void;\n  context(task: Task, attempt: number, signal: AbortSignal): TaskContext;\n}\n"]}
+{"version":3,"file":"workflow.types.js","sourceRoot":"","sources":["../../src/domain/workflow.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  WorkflowDecision,\n  WorkflowDecisionRecord,\n  WorkflowGate,\n  WorkflowPauseRequest,\n} from \"./workflow/gates.types.ts\";\nimport type { WorkflowCheckpointOptions } from \"./workflow/checkpoint.types.ts\";\nimport type { Usage } from \"./agent.types.ts\";\nimport type {\n  WorkflowAccounting,\n  WorkflowBudget,\n  WorkflowUsage,\n} from \"./workflow/budget.types.ts\";\n\nexport interface TaskContext {\n  readonly signal: AbortSignal;\n  readonly attempt: number;\n  readonly executionId: string;\n  reportUsage(usage: Usage): void;\n  reportUsageOnce?(receipt: string, usage: Usage): void;\n  checkpoint?(): Promise<void>;\n  value<T>(dependency: Task<T>): T;\n}\n\nexport interface Retry {\n  readonly attempts: number;\n  readonly delayMs?: number;\n  readonly accepts?: (error: unknown, attempt: number) => boolean;\n}\n\nexport interface Task<T = unknown> {\n  readonly key: string;\n  readonly gate?: WorkflowGate;\n  readonly after: readonly Task[];\n  readonly perform: (context: TaskContext) => T | Promise<T>;\n  readonly condition?: (context: TaskContext) => boolean | Promise<boolean>;\n  readonly retry?: Retry;\n  readonly timeoutMs?: number;\n}\n\nexport type TaskOptions<T> = Omit<Task<T>, \"after\"> & {\n  readonly after?: readonly Task[];\n};\n\nexport type TaskStatus =\n  | \"waiting\"\n  | \"active\"\n  | \"done\"\n  | \"failed\"\n  | \"skipped\"\n  | \"cancelled\"\n  | \"paused\"\n  | \"rejected\";\n\nexport interface TaskRecord {\n  usageReceipts?: readonly string[];\n  pause?: WorkflowPauseRequest;\n  decision?: WorkflowDecisionRecord;\n  readonly key: string;\n  status: TaskStatus;\n  attempts: number;\n  startedAt?: string;\n  finishedAt?: string;\n  error?: string;\n}\n\nexport interface WorkflowEvent {\n  readonly executionId: string;\n  readonly workflow: string;\n  readonly timestamp: string;\n  readonly type: \"start\" | \"task\" | \"attempt\" | \"retry\" | \"usage\" | \"finish\";\n  readonly key?: string;\n  readonly status?: TaskStatus;\n  readonly attempt?: number;\n  readonly usage?: Usage;\n  readonly durationMs?: number;\n}\n\nexport interface WorkflowOptions {\n  readonly decisions?: readonly WorkflowDecision[];\n  readonly checkpoint?: WorkflowCheckpointOptions;\n  readonly signal?: AbortSignal;\n  readonly concurrency?: number;\n  readonly budget?: WorkflowBudget;\n  readonly stopOnError?: boolean;\n  readonly observe?: (event: WorkflowEvent) => void;\n}\n\nexport interface WorkflowResult {\n  readonly executionId: string;\n  readonly name: string;\n  readonly status: \"done\" | \"failed\" | \"cancelled\" | \"paused\";\n  readonly tasks: readonly Readonly<TaskRecord>[];\n  readonly errors: readonly unknown[];\n  readonly observerErrors: readonly unknown[];\n  readonly usage: WorkflowUsage;\n  value<T>(task: Task<T>): T;\n  unwrap(): void;\n}\n\nexport interface Workflow {\n  readonly name: string;\n  readonly tasks: readonly Task[];\n  start(options?: WorkflowOptions): Promise<WorkflowResult>;\n  diagram(): string;\n}\n\nexport type WorkflowNotification = Omit<\n  WorkflowEvent,\n  \"executionId\" | \"workflow\" | \"timestamp\"\n>;\nexport interface WorkflowExecutionState {\n  readonly executionId: string;\n  readonly stop: AbortController;\n  readonly signal: AbortSignal;\n  readonly values: Map<Task, unknown>;\n  readonly records: Map<Task, TaskRecord>;\n  readonly errors: unknown[];\n  readonly observerErrors: unknown[];\n  readonly options: WorkflowOptions;\n  readonly accounting: WorkflowAccounting;\n  persist(): Promise<void>;\n  closeAttempt(task: Task): void;\n  record(task: Task): TaskRecord;\n  emit(event: WorkflowNotification): void;\n  finish(task: Task, status: TaskStatus): void;\n  context(task: Task, attempt: number, signal: AbortSignal): TaskContext;\n}\n"]}

package/dist/index.d.ts

@@ -4,11 +4,11 @@ export type { DispatchOptions, Execution, Turn, } from "./application/execution.
 export { WorkflowFailure, WorkflowBudgetExceeded, task, workflow, } from "./domain/workflow.ts";
 export type { Retry, Task, TaskContext, TaskOptions, TaskRecord, TaskStatus, Workflow, WorkflowEvent, WorkflowOptions, WorkflowBudget, WorkflowUsage, WorkflowResult, } from "./domain/workflow.ts";
 export { agentTask, commandTask, isolatedTask } from "./application/tasks.ts";
-export { claude, codex } from "./providers/agents.ts";
+export { claude, codex, gemini } from "./providers/agents.ts";
 export { agentVersions } from "./providers/versions.ts";
 export { conversations } from "./infrastructure/conversations.ts";
 export type { ConversationFormat, ConversationLocation, } from "./infrastructure/conversations.ts";
-export type { ClaudeSettings, CodexSettings } from "./providers/agents.ts";
+export type { ClaudeSettings, CodexSettings, CodexModelProvider, GeminiSettings, } from "./providers/agents.ts";
 export { mountedProvider, remoteProvider } from "./providers/factories.ts";
 export { ResponseError, response } from "./domain/response.ts";
 export type { ResponseSpec, StandardValidator } from "./domain/response.ts";
@@ -29,3 +29,33 @@ export type { SandboxDiagnosticOptions, SandboxDiagnosticReport, DiagnosticCapab
 export type { DiagnosticCheck, DiagnosticStatus, DoctorAgent, } from "./application/doctor.types.ts";
 export { diagnoseAgentProtocol } from "./application/doctor-protocol.ts";
 export type { AgentProtocolReport } from "./application/doctor-protocol.types.ts";
+export { reserveRecoveryStorage } from "./application/storage-reservation.ts";
+export type { RecoveryStorageReservationOptions } from "./application/storage-reservation.types.ts";
+export type { StorageReservation, StorageReservationOptions, } from "./infrastructure/storage-reservations.types.ts";
+export { planRecoveryRestore, restoreRecoveryTransfer, } from "./application/recovery-restore.ts";
+export type { RecoveryRestoreOptions, RecoveryRestorePlan, RecoveryRestoreResult, } from "./application/recovery-restore.types.ts";
+export { fileWorkflowCheckpointStore } from "./infrastructure/workflow-checkpoint.ts";
+export type { FileWorkflowCheckpointOptions } from "./infrastructure/workflow-checkpoint.types.ts";
+export type { WorkflowCheckpoint, WorkflowCheckpointOptions, WorkflowCheckpointStore, WorkflowCheckpointLease, WorkflowCheckpointValue, WorkflowJson, } from "./domain/workflow/checkpoint.types.ts";
+export { approvalTask, pauseTask } from "./domain/workflow/gates.ts";
+export type { WorkflowGate, WorkflowGateOptions, WorkflowPauseRequest, WorkflowDecision, WorkflowDecisionRecord, } from "./domain/workflow/gates.types.ts";
+export { inspectRecovery } from "./application/recovery-inspection.ts";
+export type { RecoveryInspection, RecoveryInspectionOptions, } from "./application/recovery-inspection.types.ts";
+export type { ResourceActivityRecord, ResourceInspection, ResourceInspectionEntry, ResourceOperation, ResourceOperationKind, ResourceOperationResult, ResourcePhase, } from "./infrastructure/resource-activity.types.ts";
+export { artifact, publishArtifact, readStoredArtifact, } from "./domain/artifact.ts";
+export { artifactTask, readArtifact } from "./application/artifact-tasks.ts";
+export { fileArtifactStore } from "./infrastructure/artifact-store.ts";
+export type { ArtifactContract, ArtifactContractOptions, ArtifactIdentity, ArtifactProducer, ArtifactReference, ArtifactStore, JsonArtifactOptions, PublishArtifactOptions, ReadArtifactOptions, } from "./domain/artifact.types.ts";
+export type { ArtifactTaskOptions } from "./application/artifact-tasks.types.ts";
+export type { FileArtifactStoreOptions } from "./infrastructure/artifact-store.types.ts";
+export { sqliteTaskQueue } from "./infrastructure/task-queue.ts";
+export { serveTaskQueue, httpTaskQueue, } from "./infrastructure/task-queue-http.ts";
+export { runQueueWorker } from "./application/queue-worker.ts";
+export { queuedTask } from "./application/queued-task.ts";
+export type { QueueRequest, QueueResult, QueueJob, QueueClaim, QueueLease, TaskQueue, DurableTaskQueue, } from "./domain/task-queue.types.ts";
+export type { QueueServerOptions, QueueServer, QueueClientOptions, } from "./infrastructure/task-queue-http.types.ts";
+export type { QueueHandlerContext, QueueHandler, QueueWorkerOptions, } from "./application/queue-worker.types.ts";
+export type { QueuedTaskOptions } from "./application/queued-task.types.ts";
+export type { EgressPolicy } from "./domain/egress.types.ts";
+export { speculate } from "./application/speculation.ts";
+export type { SpeculationOptions, SpeculationResult, SpeculativeCandidate, SpeculativeCandidateResult, SpeculativeOutput, SpeculativeHostSnapshot, SpeculativeValidation, } from "./application/speculation.types.ts";

package/dist/index.js

@@ -1,7 +1,7 @@
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.js";
 export { WorkflowFailure, WorkflowBudgetExceeded, task, workflow, } from "./domain/workflow.js";
 export { agentTask, commandTask, isolatedTask } from "./application/tasks.js";
-export { claude, codex } from "./providers/agents.js";
+export { claude, codex, gemini } from "./providers/agents.js";
 export { agentVersions } from "./providers/versions.js";
 export { conversations } from "./infrastructure/conversations.js";
 export { mountedProvider, remoteProvider } from "./providers/factories.js";
@@ -12,4 +12,17 @@ export { planRecoveryRetention, pruneRecoveryRetention, assertRecoveryQuota, } f
 export { verifyRecoveryTransfer } from "./application/recovery-verification.js";
 export { diagnoseSandbox } from "./application/doctor-sandbox.js";
 export { diagnoseAgentProtocol } from "./application/doctor-protocol.js";
+export { reserveRecoveryStorage } from "./application/storage-reservation.js";
+export { planRecoveryRestore, restoreRecoveryTransfer, } from "./application/recovery-restore.js";
+export { fileWorkflowCheckpointStore } from "./infrastructure/workflow-checkpoint.js";
+export { approvalTask, pauseTask } from "./domain/workflow/gates.js";
+export { inspectRecovery } from "./application/recovery-inspection.js";
+export { artifact, publishArtifact, readStoredArtifact, } from "./domain/artifact.js";
+export { artifactTask, readArtifact } from "./application/artifact-tasks.js";
+export { fileArtifactStore } from "./infrastructure/artifact-store.js";
+export { sqliteTaskQueue } from "./infrastructure/task-queue.js";
+export { serveTaskQueue, httpTaskQueue, } from "./infrastructure/task-queue-http.js";
+export { runQueueWorker } from "./application/queue-worker.js";
+export { queuedTask } from "./application/queued-task.js";
+export { speculate } from "./application/speculation.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,aAAa,EACb,QAAQ,EACR,aAAa,GACd,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,IAAI,EACJ,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAiB9B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AASlE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoCnE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAMxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAS7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAMhF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAWlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC","sourcesContent":["export {\n  attach,\n  createSandbox,\n  dispatch,\n  openWorkspace,\n} from \"./application/outpost.ts\";\n\nexport type {\n  AttachOptions,\n  AttachResult,\n  ContinuationOptions,\n  DispatchResult,\n  Sandbox,\n  SandboxOptions,\n  WarmDispatchResult,\n  Workspace,\n  WorkspaceOptions,\n} from \"./application/outpost.ts\";\n\nexport type {\n  DispatchOptions,\n  Execution,\n  Turn,\n} from \"./application/execution.ts\";\n\nexport {\n  WorkflowFailure,\n  WorkflowBudgetExceeded,\n  task,\n  workflow,\n} from \"./domain/workflow.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowBudget,\n  WorkflowUsage,\n  WorkflowResult,\n} from \"./domain/workflow.ts\";\n\nexport { agentTask, commandTask, isolatedTask } from \"./application/tasks.ts\";\n\nexport { claude, codex } from \"./providers/agents.ts\";\n\nexport { agentVersions } from \"./providers/versions.ts\";\n\nexport { conversations } from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./infrastructure/conversations.ts\";\n\nexport type { ClaudeSettings, CodexSettings } from \"./providers/agents.ts\";\n\nexport { mountedProvider, remoteProvider } from \"./providers/factories.ts\";\n\nexport { ResponseError, response } from \"./domain/response.ts\";\n\nexport type { ResponseSpec, StandardValidator } from \"./domain/response.ts\";\n\nexport { OutpostError, recoveryDetails } from \"./domain/errors.ts\";\n\nexport type { FaultCode } from \"./domain/errors.ts\";\n\nexport type {\n  AgentAdapter,\n  AgentEvent,\n  AgentInput,\n  AgentObservation,\n  BranchPolicy,\n  Channel,\n  Command,\n  CommandResult,\n  Commit,\n  ConversationContext,\n  ConversationRecord,\n  ConversationStore,\n  Disposal,\n  LifecycleHooks,\n  FileManifestEntry,\n  FileTransfers,\n  SandboxContext,\n  SandboxLease,\n  SandboxProvider,\n  StageLimits,\n  TransferOptions,\n  Usage,\n  Variables,\n  Volume,\n  WorkspaceRecord,\n} from \"./domain/ports.ts\";\n\nexport type { Brief, PromptVariables } from \"./domain/prompts.ts\";\n\nexport type { Logging } from \"./infrastructure/journal.ts\";\n\nexport { reporter } from \"./infrastructure/reporter.ts\";\n\nexport type { ReporterOptions } from \"./infrastructure/reporter.ts\";\n\nexport type { VariableQuestion } from \"./application/interactive-brief.ts\";\n\nexport {\n  planRecoveryRetention,\n  pruneRecoveryRetention,\n  assertRecoveryQuota,\n} from \"./application/recovery-retention.ts\";\nexport type {\n  RecoveryRetentionPolicy,\n  RecoveryRetentionOptions,\n  RecoveryRetentionPlan,\n  RecoveryRetentionEntry,\n  RecoveryPruneResult,\n  RecoveryQuotaOptions,\n} from \"./application/recovery-retention.types.ts\";\nexport { verifyRecoveryTransfer } from \"./application/recovery-verification.ts\";\nexport type {\n  RecoveryVerification,\n  RecoveryVerificationOptions,\n} from \"./application/recovery-verification.types.ts\";\n\nexport { diagnoseSandbox } from \"./application/doctor-sandbox.ts\";\nexport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n  DiagnosticCapability,\n} from \"./application/doctor-sandbox.types.ts\";\nexport type {\n  DiagnosticCheck,\n  DiagnosticStatus,\n  DoctorAgent,\n} from \"./application/doctor.types.ts\";\nexport { diagnoseAgentProtocol } from \"./application/doctor-protocol.ts\";\nexport type { AgentProtocolReport } from \"./application/doctor-protocol.types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,aAAa,EACb,QAAQ,EACR,aAAa,GACd,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,IAAI,EACJ,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAiB9B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAclE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoCnE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAMxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAS7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAMhF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAWlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAO9E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAWtF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAevE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAevE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAwB1D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC","sourcesContent":["export {\n  attach,\n  createSandbox,\n  dispatch,\n  openWorkspace,\n} from \"./application/outpost.ts\";\n\nexport type {\n  AttachOptions,\n  AttachResult,\n  ContinuationOptions,\n  DispatchResult,\n  Sandbox,\n  SandboxOptions,\n  WarmDispatchResult,\n  Workspace,\n  WorkspaceOptions,\n} from \"./application/outpost.ts\";\n\nexport type {\n  DispatchOptions,\n  Execution,\n  Turn,\n} from \"./application/execution.ts\";\n\nexport {\n  WorkflowFailure,\n  WorkflowBudgetExceeded,\n  task,\n  workflow,\n} from \"./domain/workflow.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowBudget,\n  WorkflowUsage,\n  WorkflowResult,\n} from \"./domain/workflow.ts\";\n\nexport { agentTask, commandTask, isolatedTask } from \"./application/tasks.ts\";\n\nexport { claude, codex, gemini } from \"./providers/agents.ts\";\n\nexport { agentVersions } from \"./providers/versions.ts\";\n\nexport { conversations } from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ClaudeSettings,\n  CodexSettings,\n  CodexModelProvider,\n  GeminiSettings,\n} from \"./providers/agents.ts\";\n\nexport { mountedProvider, remoteProvider } from \"./providers/factories.ts\";\n\nexport { ResponseError, response } from \"./domain/response.ts\";\n\nexport type { ResponseSpec, StandardValidator } from \"./domain/response.ts\";\n\nexport { OutpostError, recoveryDetails } from \"./domain/errors.ts\";\n\nexport type { FaultCode } from \"./domain/errors.ts\";\n\nexport type {\n  AgentAdapter,\n  AgentEvent,\n  AgentInput,\n  AgentObservation,\n  BranchPolicy,\n  Channel,\n  Command,\n  CommandResult,\n  Commit,\n  ConversationContext,\n  ConversationRecord,\n  ConversationStore,\n  Disposal,\n  LifecycleHooks,\n  FileManifestEntry,\n  FileTransfers,\n  SandboxContext,\n  SandboxLease,\n  SandboxProvider,\n  StageLimits,\n  TransferOptions,\n  Usage,\n  Variables,\n  Volume,\n  WorkspaceRecord,\n} from \"./domain/ports.ts\";\n\nexport type { Brief, PromptVariables } from \"./domain/prompts.ts\";\n\nexport type { Logging } from \"./infrastructure/journal.ts\";\n\nexport { reporter } from \"./infrastructure/reporter.ts\";\n\nexport type { ReporterOptions } from \"./infrastructure/reporter.ts\";\n\nexport type { VariableQuestion } from \"./application/interactive-brief.ts\";\n\nexport {\n  planRecoveryRetention,\n  pruneRecoveryRetention,\n  assertRecoveryQuota,\n} from \"./application/recovery-retention.ts\";\nexport type {\n  RecoveryRetentionPolicy,\n  RecoveryRetentionOptions,\n  RecoveryRetentionPlan,\n  RecoveryRetentionEntry,\n  RecoveryPruneResult,\n  RecoveryQuotaOptions,\n} from \"./application/recovery-retention.types.ts\";\nexport { verifyRecoveryTransfer } from \"./application/recovery-verification.ts\";\nexport type {\n  RecoveryVerification,\n  RecoveryVerificationOptions,\n} from \"./application/recovery-verification.types.ts\";\n\nexport { diagnoseSandbox } from \"./application/doctor-sandbox.ts\";\nexport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n  DiagnosticCapability,\n} from \"./application/doctor-sandbox.types.ts\";\nexport type {\n  DiagnosticCheck,\n  DiagnosticStatus,\n  DoctorAgent,\n} from \"./application/doctor.types.ts\";\nexport { diagnoseAgentProtocol } from \"./application/doctor-protocol.ts\";\nexport type { AgentProtocolReport } from \"./application/doctor-protocol.types.ts\";\n\nexport { reserveRecoveryStorage } from \"./application/storage-reservation.ts\";\nexport type { RecoveryStorageReservationOptions } from \"./application/storage-reservation.types.ts\";\nexport type {\n  StorageReservation,\n  StorageReservationOptions,\n} from \"./infrastructure/storage-reservations.types.ts\";\n\nexport {\n  planRecoveryRestore,\n  restoreRecoveryTransfer,\n} from \"./application/recovery-restore.ts\";\nexport type {\n  RecoveryRestoreOptions,\n  RecoveryRestorePlan,\n  RecoveryRestoreResult,\n} from \"./application/recovery-restore.types.ts\";\n\nexport { fileWorkflowCheckpointStore } from \"./infrastructure/workflow-checkpoint.ts\";\nexport type { FileWorkflowCheckpointOptions } from \"./infrastructure/workflow-checkpoint.types.ts\";\nexport type {\n  WorkflowCheckpoint,\n  WorkflowCheckpointOptions,\n  WorkflowCheckpointStore,\n  WorkflowCheckpointLease,\n  WorkflowCheckpointValue,\n  WorkflowJson,\n} from \"./domain/workflow/checkpoint.types.ts\";\n\nexport { approvalTask, pauseTask } from \"./domain/workflow/gates.ts\";\nexport type {\n  WorkflowGate,\n  WorkflowGateOptions,\n  WorkflowPauseRequest,\n  WorkflowDecision,\n  WorkflowDecisionRecord,\n} from \"./domain/workflow/gates.types.ts\";\n\nexport { inspectRecovery } from \"./application/recovery-inspection.ts\";\nexport type {\n  RecoveryInspection,\n  RecoveryInspectionOptions,\n} from \"./application/recovery-inspection.types.ts\";\nexport type {\n  ResourceActivityRecord,\n  ResourceInspection,\n  ResourceInspectionEntry,\n  ResourceOperation,\n  ResourceOperationKind,\n  ResourceOperationResult,\n  ResourcePhase,\n} from \"./infrastructure/resource-activity.types.ts\";\n\nexport {\n  artifact,\n  publishArtifact,\n  readStoredArtifact,\n} from \"./domain/artifact.ts\";\nexport { artifactTask, readArtifact } from \"./application/artifact-tasks.ts\";\nexport { fileArtifactStore } from \"./infrastructure/artifact-store.ts\";\nexport type {\n  ArtifactContract,\n  ArtifactContractOptions,\n  ArtifactIdentity,\n  ArtifactProducer,\n  ArtifactReference,\n  ArtifactStore,\n  JsonArtifactOptions,\n  PublishArtifactOptions,\n  ReadArtifactOptions,\n} from \"./domain/artifact.types.ts\";\nexport type { ArtifactTaskOptions } from \"./application/artifact-tasks.types.ts\";\nexport type { FileArtifactStoreOptions } from \"./infrastructure/artifact-store.types.ts\";\n\nexport { sqliteTaskQueue } from \"./infrastructure/task-queue.ts\";\nexport {\n  serveTaskQueue,\n  httpTaskQueue,\n} from \"./infrastructure/task-queue-http.ts\";\nexport { runQueueWorker } from \"./application/queue-worker.ts\";\nexport { queuedTask } from \"./application/queued-task.ts\";\nexport type {\n  QueueRequest,\n  QueueResult,\n  QueueJob,\n  QueueClaim,\n  QueueLease,\n  TaskQueue,\n  DurableTaskQueue,\n} from \"./domain/task-queue.types.ts\";\nexport type {\n  QueueServerOptions,\n  QueueServer,\n  QueueClientOptions,\n} from \"./infrastructure/task-queue-http.types.ts\";\nexport type {\n  QueueHandlerContext,\n  QueueHandler,\n  QueueWorkerOptions,\n} from \"./application/queue-worker.types.ts\";\nexport type { QueuedTaskOptions } from \"./application/queued-task.types.ts\";\n\nexport type { EgressPolicy } from \"./domain/egress.types.ts\";\n\nexport { speculate } from \"./application/speculation.ts\";\nexport type {\n  SpeculationOptions,\n  SpeculationResult,\n  SpeculativeCandidate,\n  SpeculativeCandidateResult,\n  SpeculativeOutput,\n  SpeculativeHostSnapshot,\n  SpeculativeValidation,\n} from \"./application/speculation.types.ts\";\n"]}

package/dist/infrastructure/artifact-store.constants.d.ts

@@ -0,0 +1 @@
+export declare const artifactMaxBytes: number;

package/dist/infrastructure/artifact-store.constants.js

@@ -0,0 +1,2 @@
+export const artifactMaxBytes = 16 * 1024 * 1024;
+//# sourceMappingURL=artifact-store.constants.js.map

package/dist/infrastructure/artifact-store.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.constants.js","sourceRoot":"","sources":["../../src/infrastructure/artifact-store.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC","sourcesContent":["export const artifactMaxBytes = 16 * 1024 * 1024;\n"]}

package/dist/infrastructure/artifact-store.d.ts

@@ -0,0 +1,3 @@
+import type { ArtifactStore } from "../domain/artifact.types.ts";
+import type { FileArtifactStoreOptions } from "./artifact-store.types.ts";
+export declare function fileArtifactStore(options: FileArtifactStoreOptions): ArtifactStore;