@elie-laloum/outpost 2.0.0 → 3.0.0

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

@@ -1,3 +1,4 @@
+import { workflowAccounting } from "./budget.js";
 import { randomUUID } from "node:crypto";
 export function workflowState(name, tasks, options) {
     const executionId = randomUUID();
@@ -6,11 +7,17 @@ export function workflowState(name, tasks, options) {
         ? AbortSignal.any([options.signal, stop.signal])
         : stop.signal;
     const values = new Map();
+    const activeAttempts = new Map();
     const records = new Map(tasks.map((item) => [
         item,
         { key: item.key, status: "waiting", attempts: 0 },
     ]));
     const errors = [], observerErrors = [];
+    const accounting = workflowAccounting(options.budget, (error) => {
+        errors.push(error);
+        if (error.dimension !== "attempts")
+            stop.abort(error);
+    });
     const record = (item) => records.get(item);
     function emit(event) {
         try {
@@ -35,13 +42,31 @@ export function workflowState(name, tasks, options) {
             key: item.key,
             status,
             attempt: record(item).attempts,
+            ...(record(item).startedAt
+                ? { durationMs: Date.now() - Date.parse(record(item).startedAt) }
+                : {}),
         });
     }
     function context(item, attempt, taskSignal) {
+        if (attempt > 0)
+            activeAttempts.set(item, attempt);
         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 }),
+                });
+            },
             value(dependency) {
                 if (!item.after.includes(dependency))
                     throw new Error(`${item.key}: undeclared dependency ${dependency.key}`);
@@ -53,6 +78,10 @@ export function workflowState(name, tasks, options) {
     }
     return {
         executionId,
+        accounting,
+        closeAttempt(item) {
+            activeAttempts.delete(item);
+        },
         stop,
         signal,
         values,

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,KAAsB,EACtB,OAAwB;IAExB,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;QAC3B,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,IAAI;QACJ,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;KAClD,CAAC,CACH,CAAC;IACF,MAAM,MAAM,GAAc,EAAE,EAC1B,cAAc,GAAc,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IAClD,SAAS,IAAI,CACX,KAAoE;QAEpE,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,CAAC;gBAChB,GAAG,KAAK;gBACR,WAAW;gBACX,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,SAAS,MAAM,CAAC,IAAU,EAAE,MAAkB;QAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM;YACN,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,SAAS,OAAO,CACd,IAAU,EACV,OAAe,EACf,UAAuB;QAEvB,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,WAAW;YACX,KAAK,CAAI,UAAmB;gBAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAClC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,GAAG,2BAA2B,UAAU,CAAC,GAAG,EAAE,CACvD,CAAC;gBACJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,GAAG,0BAA0B,CAAC,CAAC;gBAC/D,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,CAAM,CAAC;YACrC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW;QACX,IAAI;QACJ,MAAM;QACN,MAAM;QACN,OAAO;QACP,MAAM;QACN,cAAc;QACd,MAAM;QACN,IAAI;QACJ,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["import { 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 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 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    });\n  }\n  function context(\n    item: Task,\n    attempt: number,\n    taskSignal: AbortSignal,\n  ): TaskContext {\n    return {\n      signal: taskSignal,\n      attempt,\n      executionId,\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    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 { 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"]}

package/dist/domain/workflow.d.ts

@@ -3,3 +3,5 @@ export type { Retry, Task, TaskContext, TaskOptions, TaskRecord, TaskStatus, Wor
 export { WorkflowFailure } from "./workflow/failure.ts";
 export { task } from "./workflow/task.ts";
 export declare function workflow(name: string, tasks: readonly Task[]): Workflow;
+export { WorkflowBudgetExceeded } from "./workflow/budget.ts";
+export type { WorkflowBudget, WorkflowUsage } from "./workflow/budget.types.ts";

package/dist/domain/workflow.js

@@ -23,4 +23,5 @@ export function workflow(name, tasks) {
         },
     });
 }
+export { WorkflowBudgetExceeded } from "./workflow/budget.js";
 //# sourceMappingURL=workflow.js.map

package/dist/domain/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/domain/workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAc5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAsB;IAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,UAA2B,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QACxE,OAAO;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO;gBACL,cAAc;gBACd,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzB,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI;oBACnC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CACf,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChE;iBACF,CAAC;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Task, Workflow, WorkflowOptions } from \"./workflow.types.ts\";\nimport { validate } from \"./workflow/validation.ts\";\nimport { schedule } from \"./workflow/workflow-scheduler.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"./workflow.types.ts\";\nexport { WorkflowFailure } from \"./workflow/failure.ts\";\nexport { task } from \"./workflow/task.ts\";\n\nexport function workflow(name: string, tasks: readonly Task[]): Workflow {\n  if (!name.trim()) throw new Error(\"Workflow name cannot be empty\");\n  const graph = Object.freeze([...tasks]);\n  validate(graph);\n  return Object.freeze({\n    name,\n    tasks: graph,\n    start: (options: WorkflowOptions = {}) => schedule(name, graph, options),\n    diagram() {\n      const ids = new Map(graph.map((item, index) => [item, `n${index}`]));\n      return [\n        \"flowchart LR\",\n        ...graph.flatMap((item) => [\n          `  ${ids.get(item)}[\"${item.key}\"]`,\n          ...item.after.map(\n            (dependency) => `  ${ids.get(dependency)} --> ${ids.get(item)}`,\n          ),\n        ]),\n      ].join(\"\\n\");\n    },\n  });\n}\n"]}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/domain/workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAc5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAsB;IAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,UAA2B,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QACxE,OAAO;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO;gBACL,cAAc;gBACd,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzB,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI;oBACnC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CACf,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChE;iBACF,CAAC;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["import type { Task, Workflow, WorkflowOptions } from \"./workflow.types.ts\";\nimport { validate } from \"./workflow/validation.ts\";\nimport { schedule } from \"./workflow/workflow-scheduler.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowResult,\n} from \"./workflow.types.ts\";\nexport { WorkflowFailure } from \"./workflow/failure.ts\";\nexport { task } from \"./workflow/task.ts\";\n\nexport function workflow(name: string, tasks: readonly Task[]): Workflow {\n  if (!name.trim()) throw new Error(\"Workflow name cannot be empty\");\n  const graph = Object.freeze([...tasks]);\n  validate(graph);\n  return Object.freeze({\n    name,\n    tasks: graph,\n    start: (options: WorkflowOptions = {}) => schedule(name, graph, options),\n    diagram() {\n      const ids = new Map(graph.map((item, index) => [item, `n${index}`]));\n      return [\n        \"flowchart LR\",\n        ...graph.flatMap((item) => [\n          `  ${ids.get(item)}[\"${item.key}\"]`,\n          ...item.after.map(\n            (dependency) => `  ${ids.get(dependency)} --> ${ids.get(item)}`,\n          ),\n        ]),\n      ].join(\"\\n\");\n    },\n  });\n}\n\nexport { WorkflowBudgetExceeded } from \"./workflow/budget.ts\";\nexport type { WorkflowBudget, WorkflowUsage } from \"./workflow/budget.types.ts\";\n"]}

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

@@ -1,7 +1,10 @@
+import type { Usage } from "./agent.types.ts";
+import type { WorkflowAccounting, WorkflowBudget, WorkflowUsage } from "./workflow/budget.types.ts";
 export interface TaskContext {
     readonly signal: AbortSignal;
     readonly attempt: number;
     readonly executionId: string;
+    reportUsage(usage: Usage): void;
     value<T>(dependency: Task<T>): T;
 }
 export interface Retry {
@@ -33,14 +36,17 @@ export interface WorkflowEvent {
     readonly executionId: string;
     readonly workflow: string;
     readonly timestamp: string;
-    readonly type: "start" | "task" | "retry" | "finish";
+    readonly type: "start" | "task" | "attempt" | "retry" | "usage" | "finish";
     readonly key?: string;
     readonly status?: TaskStatus;
     readonly attempt?: number;
+    readonly usage?: Usage;
+    readonly durationMs?: number;
 }
 export interface WorkflowOptions {
     readonly signal?: AbortSignal;
     readonly concurrency?: number;
+    readonly budget?: WorkflowBudget;
     readonly stopOnError?: boolean;
     readonly observe?: (event: WorkflowEvent) => void;
 }
@@ -51,6 +57,7 @@ export interface WorkflowResult {
     readonly tasks: readonly Readonly<TaskRecord>[];
     readonly errors: readonly unknown[];
     readonly observerErrors: readonly unknown[];
+    readonly usage: WorkflowUsage;
     value<T>(task: Task<T>): T;
     unwrap(): void;
 }
@@ -70,6 +77,8 @@ export interface WorkflowExecutionState {
     readonly errors: unknown[];
     readonly observerErrors: unknown[];
     readonly options: WorkflowOptions;
+    readonly accounting: WorkflowAccounting;
+    closeAttempt(task: Task): void;
     record(task: Task): TaskRecord;
     emit(event: WorkflowNotification): void;
     finish(task: Task, status: TaskStatus): 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":["export interface TaskContext {\n  readonly signal: AbortSignal;\n  readonly attempt: number;\n  readonly executionId: string;\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\" | \"retry\" | \"finish\";\n  readonly key?: string;\n  readonly status?: TaskStatus;\n  readonly attempt?: number;\n}\n\nexport interface WorkflowOptions {\n  readonly signal?: AbortSignal;\n  readonly concurrency?: number;\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  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  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 { 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"]}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.ts";
 export type { AttachOptions, AttachResult, ContinuationOptions, DispatchResult, Sandbox, SandboxOptions, WarmDispatchResult, Workspace, WorkspaceOptions, } from "./application/outpost.ts";
 export type { DispatchOptions, Execution, Turn, } from "./application/execution.ts";
-export { WorkflowFailure, task, workflow } from "./domain/workflow.ts";
-export type { Retry, Task, TaskContext, TaskOptions, TaskRecord, TaskStatus, Workflow, WorkflowEvent, WorkflowOptions, WorkflowResult, } from "./domain/workflow.ts";
+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 { agentVersions } from "./providers/versions.ts";
@@ -14,9 +14,18 @@ export { ResponseError, response } from "./domain/response.ts";
 export type { ResponseSpec, StandardValidator } from "./domain/response.ts";
 export { OutpostError, recoveryDetails } from "./domain/errors.ts";
 export type { FaultCode } from "./domain/errors.ts";
-export type { AgentAdapter, AgentEvent, AgentInput, AgentObservation, BranchPolicy, Channel, Command, CommandResult, Commit, ConversationContext, ConversationRecord, ConversationStore, Disposal, LifecycleHooks, SandboxContext, SandboxLease, SandboxProvider, StageLimits, TransferOptions, Usage, Variables, Volume, WorkspaceRecord, } from "./domain/ports.ts";
+export type { AgentAdapter, AgentEvent, AgentInput, AgentObservation, BranchPolicy, Channel, Command, CommandResult, Commit, ConversationContext, ConversationRecord, ConversationStore, Disposal, LifecycleHooks, FileManifestEntry, FileTransfers, SandboxContext, SandboxLease, SandboxProvider, StageLimits, TransferOptions, Usage, Variables, Volume, WorkspaceRecord, } from "./domain/ports.ts";
 export type { Brief, PromptVariables } from "./domain/prompts.ts";
 export type { Logging } from "./infrastructure/journal.ts";
 export { reporter } from "./infrastructure/reporter.ts";
 export type { ReporterOptions } from "./infrastructure/reporter.ts";
 export type { VariableQuestion } from "./application/interactive-brief.ts";
+export { planRecoveryRetention, pruneRecoveryRetention, assertRecoveryQuota, } from "./application/recovery-retention.ts";
+export type { RecoveryRetentionPolicy, RecoveryRetentionOptions, RecoveryRetentionPlan, RecoveryRetentionEntry, RecoveryPruneResult, RecoveryQuotaOptions, } from "./application/recovery-retention.types.ts";
+export { verifyRecoveryTransfer } from "./application/recovery-verification.ts";
+export type { RecoveryVerification, RecoveryVerificationOptions, } from "./application/recovery-verification.types.ts";
+export { diagnoseSandbox } from "./application/doctor-sandbox.ts";
+export type { SandboxDiagnosticOptions, SandboxDiagnosticReport, DiagnosticCapability, } from "./application/doctor-sandbox.types.ts";
+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";

package/dist/index.js

@@ -1,5 +1,5 @@
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.js";
-export { WorkflowFailure, task, workflow } from "./domain/workflow.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 { agentVersions } from "./providers/versions.js";
@@ -8,4 +8,8 @@ export { mountedProvider, remoteProvider } from "./providers/factories.js";
 export { ResponseError, response } from "./domain/response.js";
 export { OutpostError, recoveryDetails } from "./domain/errors.js";
 export { reporter } from "./infrastructure/reporter.js";
+export { planRecoveryRetention, pruneRecoveryRetention, assertRecoveryQuota, } from "./application/recovery-retention.js";
+export { verifyRecoveryTransfer } from "./application/recovery-verification.js";
+export { diagnoseSandbox } from "./application/doctor-sandbox.js";
+export { diagnoseAgentProtocol } from "./application/doctor-protocol.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,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAevE,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;AAkCnE,OAAO,EAAE,QAAQ,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 { WorkflowFailure, task, workflow } 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  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  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"]}
+{"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"]}

package/dist/infrastructure/file-manifest.d.ts

@@ -0,0 +1,6 @@
+import type { FileManifestEntry } from "../domain/sandbox.types.ts";
+export declare function fileManifest(root: string, path: string): Promise<FileManifestEntry>;
+export declare function sameFile(left: FileManifestEntry, right: FileManifestEntry): boolean;
+export declare function sameLocalFile(remote: FileManifestEntry, local: FileManifestEntry): boolean;
+export declare function validateFilePaths(paths: readonly string[]): void;
+export declare function parseManifest(value: unknown, paths: readonly string[]): FileManifestEntry[];

package/dist/infrastructure/file-manifest.js

@@ -0,0 +1,91 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { lstat, readlink } from "node:fs/promises";
+import { OutpostError } from "../domain/errors.js";
+import { safeDestination } from "./files.js";
+export async function fileManifest(root, path) {
+    const target = await safeDestination(root, path);
+    const info = await lstat(target);
+    if (!info.isFile() && !info.isSymbolicLink())
+        throw new OutpostError("provider", "Unsupported manifest file type", {
+            path,
+        });
+    const hash = createHash("sha256");
+    let size = info.size;
+    if (info.isSymbolicLink()) {
+        const value = Buffer.from(await readlink(target));
+        size = value.length;
+        hash.update(value);
+    }
+    else {
+        for await (const chunk of createReadStream(target))
+            hash.update(chunk);
+    }
+    return {
+        path,
+        kind: info.isSymbolicLink() ? "link" : "file",
+        mode: info.mode & 0o777,
+        size,
+        sha256: hash.digest("hex"),
+    };
+}
+export function sameFile(left, right) {
+    return (left.path === right.path &&
+        left.kind === right.kind &&
+        left.mode === right.mode &&
+        left.size === right.size &&
+        left.sha256 === right.sha256);
+}
+export function sameLocalFile(remote, local) {
+    if (process.platform !== "win32")
+        return sameFile(remote, local);
+    return sameFile({ ...remote, mode: remote.mode & 0o200 }, { ...local, mode: local.mode & 0o200 });
+}
+export function validateFilePaths(paths) {
+    if (new Set(paths).size !== paths.length ||
+        paths.some((path) => !path ||
+            path.includes("\\") ||
+            path.includes("\0") ||
+            path
+                .split("/")
+                .some((part) => !part ||
+                part === "." ||
+                part === ".." ||
+                part.toLowerCase() === ".git")))
+        throw new OutpostError("provider", "Unsafe or duplicate manifest path");
+}
+export function parseManifest(value, paths) {
+    validateFilePaths(paths);
+    if (!Array.isArray(value) || value.length !== paths.length)
+        throw new OutpostError("provider", "Invalid file manifest");
+    return value.map((entry, index) => {
+        if (!entry ||
+            typeof entry !== "object" ||
+            !("path" in entry) ||
+            typeof entry.path !== "string" ||
+            entry.path !== paths[index] ||
+            !("kind" in entry) ||
+            (entry.kind !== "file" && entry.kind !== "link") ||
+            !("mode" in entry) ||
+            typeof entry.mode !== "number" ||
+            !Number.isInteger(entry.mode) ||
+            entry.mode < 0 ||
+            entry.mode > 0o777 ||
+            !("size" in entry) ||
+            typeof entry.size !== "number" ||
+            !Number.isSafeInteger(entry.size) ||
+            entry.size < 0 ||
+            !("sha256" in entry) ||
+            typeof entry.sha256 !== "string" ||
+            !/^[a-f0-9]{64}$/.test(entry.sha256))
+            throw new OutpostError("provider", "Invalid file manifest entry");
+        return {
+            path: entry.path,
+            kind: entry.kind,
+            mode: entry.mode,
+            size: entry.size,
+            sha256: entry.sha256,
+        };
+    });
+}
+//# sourceMappingURL=file-manifest.js.map

package/dist/infrastructure/file-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manifest.js","sourceRoot":"","sources":["../../src/infrastructure/file-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { createReadStream } from \"node:fs\";\nimport { lstat, readlink } from \"node:fs/promises\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { FileManifestEntry } from \"../domain/sandbox.types.ts\";\nimport { safeDestination } from \"./files.ts\";\n\nexport async function fileManifest(\n  root: string,\n  path: string,\n): Promise<FileManifestEntry> {\n  const target = await safeDestination(root, path);\n  const info = await lstat(target);\n  if (!info.isFile() && !info.isSymbolicLink())\n    throw new OutpostError(\"provider\", \"Unsupported manifest file type\", {\n      path,\n    });\n  const hash = createHash(\"sha256\");\n  let size = info.size;\n  if (info.isSymbolicLink()) {\n    const value = Buffer.from(await readlink(target));\n    size = value.length;\n    hash.update(value);\n  } else {\n    for await (const chunk of createReadStream(target)) hash.update(chunk);\n  }\n  return {\n    path,\n    kind: info.isSymbolicLink() ? \"link\" : \"file\",\n    mode: info.mode & 0o777,\n    size,\n    sha256: hash.digest(\"hex\"),\n  };\n}\n\nexport function sameFile(\n  left: FileManifestEntry,\n  right: FileManifestEntry,\n): boolean {\n  return (\n    left.path === right.path &&\n    left.kind === right.kind &&\n    left.mode === right.mode &&\n    left.size === right.size &&\n    left.sha256 === right.sha256\n  );\n}\n\nexport function sameLocalFile(\n  remote: FileManifestEntry,\n  local: FileManifestEntry,\n): boolean {\n  if (process.platform !== \"win32\") return sameFile(remote, local);\n  return sameFile(\n    { ...remote, mode: remote.mode & 0o200 },\n    { ...local, mode: local.mode & 0o200 },\n  );\n}\n\nexport function validateFilePaths(paths: readonly string[]): void {\n  if (\n    new Set(paths).size !== paths.length ||\n    paths.some(\n      (path) =>\n        !path ||\n        path.includes(\"\\\\\") ||\n        path.includes(\"\\0\") ||\n        path\n          .split(\"/\")\n          .some(\n            (part) =>\n              !part ||\n              part === \".\" ||\n              part === \"..\" ||\n              part.toLowerCase() === \".git\",\n          ),\n    )\n  )\n    throw new OutpostError(\"provider\", \"Unsafe or duplicate manifest path\");\n}\n\nexport function parseManifest(\n  value: unknown,\n  paths: readonly string[],\n): FileManifestEntry[] {\n  validateFilePaths(paths);\n  if (!Array.isArray(value) || value.length !== paths.length)\n    throw new OutpostError(\"provider\", \"Invalid file manifest\");\n  return value.map((entry: unknown, index) => {\n    if (\n      !entry ||\n      typeof entry !== \"object\" ||\n      !(\"path\" in entry) ||\n      typeof entry.path !== \"string\" ||\n      entry.path !== paths[index] ||\n      !(\"kind\" in entry) ||\n      (entry.kind !== \"file\" && entry.kind !== \"link\") ||\n      !(\"mode\" in entry) ||\n      typeof entry.mode !== \"number\" ||\n      !Number.isInteger(entry.mode) ||\n      entry.mode < 0 ||\n      entry.mode > 0o777 ||\n      !(\"size\" in entry) ||\n      typeof entry.size !== \"number\" ||\n      !Number.isSafeInteger(entry.size) ||\n      entry.size < 0 ||\n      !(\"sha256\" in entry) ||\n      typeof entry.sha256 !== \"string\" ||\n      !/^[a-f0-9]{64}$/.test(entry.sha256)\n    )\n      throw new OutpostError(\"provider\", \"Invalid file manifest entry\");\n    return {\n      path: entry.path,\n      kind: entry.kind,\n      mode: entry.mode,\n      size: entry.size,\n      sha256: entry.sha256,\n    };\n  });\n}\n"]}

package/dist/infrastructure/git/lock-inspection.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const lockInspectionDefaults: {
+    readonly maxBytes: 4096;
+    readonly maxPid: 2147483647;
+};

package/dist/infrastructure/git/lock-inspection.constants.js

@@ -0,0 +1,5 @@
+export const lockInspectionDefaults = {
+    maxBytes: 4096,
+    maxPid: 2_147_483_647,
+};
+//# sourceMappingURL=lock-inspection.constants.js.map

package/dist/infrastructure/git/lock-inspection.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-inspection.constants.js","sourceRoot":"","sources":["../../../src/infrastructure/git/lock-inspection.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,aAAa;CACb,CAAC","sourcesContent":["export const lockInspectionDefaults = {\n  maxBytes: 4096,\n  maxPid: 2_147_483_647,\n} as const;\n"]}

package/dist/infrastructure/git/lock-inspection.d.ts

@@ -0,0 +1,3 @@
+import type { StorageEntry } from "../storage-inventory.types.ts";
+import type { LockInspection, LockPidProbe } from "./lock-inspection.types.ts";
+export declare function inspectLocks(entries: readonly StorageEntry[], probe?: LockPidProbe): Promise<LockInspection>;

package/dist/infrastructure/git/lock-inspection.js

@@ -0,0 +1,64 @@
+import { observeOwnership } from "./process-identity.js";
+import { readInspectionFile } from "../inspection-file.js";
+import { lockInspectionDefaults } from "./lock-inspection.constants.js";
+async function readPid(path) {
+    const record = JSON.parse((await readInspectionFile(path, lockInspectionDefaults.maxBytes)).toString("utf8"));
+    if (!record || typeof record !== "object" || !("pid" in record))
+        return undefined;
+    const pid = record.pid;
+    if (typeof pid !== "number" ||
+        !Number.isInteger(pid) ||
+        pid <= 0 ||
+        pid > lockInspectionDefaults.maxPid)
+        return undefined;
+    return {
+        pid,
+        ...("identity" in record ? { identity: record.identity } : {}),
+    };
+}
+async function inspectEntry(entry, probe) {
+    if (entry.kind !== "file")
+        return { state: "skipped", reason: "NOT_FILE" };
+    let record;
+    try {
+        record = await readPid(entry.path);
+    }
+    catch {
+        return { state: "unknown", reason: "LOCK_READ_FAILED" };
+    }
+    if (record === undefined)
+        return { state: "unknown", reason: "INVALID_PID" };
+    const { pid, identity } = record;
+    const ownership = await observeOwnership(pid, identity);
+    try {
+        probe(pid);
+        return { state: "present", pid, ownership };
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ESRCH")
+            return { state: "absent", pid, ownership };
+        return { state: "unknown", pid, reason: "PID_PROBE_FAILED", ownership };
+    }
+}
+export async function inspectLocks(entries, probe = (pid) => {
+    process.kill(pid, 0);
+}) {
+    const locks = [];
+    const issues = [];
+    for (const entry of entries) {
+        const state = await inspectEntry(entry, probe);
+        locks.push({ name: entry.name, path: entry.path, ...state });
+        if (state.state === "unknown")
+            issues.push({ path: entry.path, code: state.reason });
+    }
+    return {
+        scope: "local-pid",
+        complete: issues.length === 0,
+        entries: locks,
+        issues,
+    };
+}
+//# sourceMappingURL=lock-inspection.js.map

package/dist/infrastructure/git/lock-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-inspection.js","sourceRoot":"","sources":["../../../src/infrastructure/git/lock-inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { observeOwnership } from \"./process-identity.ts\";\nimport { readInspectionFile } from \"../inspection-file.ts\";\nimport type { StorageEntry, StorageIssue } from \"../storage-inventory.types.ts\";\nimport { lockInspectionDefaults } from \"./lock-inspection.constants.ts\";\nimport type {\n  LockIdentityRecord,\n  LockInspection,\n  LockInspectionEntry,\n  LockInspectionState,\n  LockPidProbe,\n} from \"./lock-inspection.types.ts\";\n\nasync function readPid(path: string): Promise<LockIdentityRecord | undefined> {\n  const record: unknown = JSON.parse(\n    (await readInspectionFile(path, lockInspectionDefaults.maxBytes)).toString(\n      \"utf8\",\n    ),\n  );\n  if (!record || typeof record !== \"object\" || !(\"pid\" in record))\n    return undefined;\n  const pid = record.pid;\n  if (\n    typeof pid !== \"number\" ||\n    !Number.isInteger(pid) ||\n    pid <= 0 ||\n    pid > lockInspectionDefaults.maxPid\n  )\n    return undefined;\n  return {\n    pid,\n    ...(\"identity\" in record ? { identity: record.identity } : {}),\n  };\n}\n\nasync function inspectEntry(\n  entry: StorageEntry,\n  probe: LockPidProbe,\n): Promise<LockInspectionState> {\n  if (entry.kind !== \"file\") return { state: \"skipped\", reason: \"NOT_FILE\" };\n  let record: LockIdentityRecord | undefined;\n  try {\n    record = await readPid(entry.path);\n  } catch {\n    return { state: \"unknown\", reason: \"LOCK_READ_FAILED\" };\n  }\n  if (record === undefined) return { state: \"unknown\", reason: \"INVALID_PID\" };\n  const { pid, identity } = record;\n  const ownership = await observeOwnership(pid, identity);\n  try {\n    probe(pid);\n    return { state: \"present\", pid, ownership };\n  } catch (error) {\n    if (\n      error &&\n      typeof error === \"object\" &&\n      \"code\" in error &&\n      error.code === \"ESRCH\"\n    )\n      return { state: \"absent\", pid, ownership };\n    return { state: \"unknown\", pid, reason: \"PID_PROBE_FAILED\", ownership };\n  }\n}\n\nexport async function inspectLocks(\n  entries: readonly StorageEntry[],\n  probe: LockPidProbe = (pid) => {\n    process.kill(pid, 0);\n  },\n): Promise<LockInspection> {\n  const locks: LockInspectionEntry[] = [];\n  const issues: StorageIssue[] = [];\n  for (const entry of entries) {\n    const state = await inspectEntry(entry, probe);\n    locks.push({ name: entry.name, path: entry.path, ...state });\n    if (state.state === \"unknown\")\n      issues.push({ path: entry.path, code: state.reason });\n  }\n  return {\n    scope: \"local-pid\",\n    complete: issues.length === 0,\n    entries: locks,\n    issues,\n  };\n}\n"]}

package/dist/infrastructure/git/lock-inspection.types.d.ts

@@ -0,0 +1,27 @@
+import type { LockOwnership } from "./process-identity.types.ts";
+import type { StorageEntry, StorageIssue } from "../storage-inventory.types.ts";
+export type LockPidProbe = (pid: number) => void;
+export interface LockIdentityRecord {
+    readonly pid: number;
+    readonly identity?: unknown;
+}
+export type LockInspectionState = {
+    readonly ownership?: LockOwnership;
+} & ({
+    readonly state: "present" | "absent";
+    readonly pid: number;
+} | {
+    readonly state: "unknown";
+    readonly reason: string;
+    readonly pid?: number;
+} | {
+    readonly state: "skipped";
+    readonly reason: "NOT_FILE";
+});
+export type LockInspectionEntry = Pick<StorageEntry, "name" | "path"> & LockInspectionState;
+export interface LockInspection {
+    readonly complete: boolean;
+    readonly scope: "local-pid";
+    readonly entries: readonly LockInspectionEntry[];
+    readonly issues: readonly StorageIssue[];
+}

package/dist/infrastructure/git/lock-inspection.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lock-inspection.types.js.map

package/dist/infrastructure/git/lock-inspection.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-inspection.types.js","sourceRoot":"","sources":["../../../src/infrastructure/git/lock-inspection.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { LockOwnership } from \"./process-identity.types.ts\";\nimport type { StorageEntry, StorageIssue } from \"../storage-inventory.types.ts\";\n\nexport type LockPidProbe = (pid: number) => void;\n\nexport interface LockIdentityRecord {\n  readonly pid: number;\n  readonly identity?: unknown;\n}\n\nexport type LockInspectionState = { readonly ownership?: LockOwnership } & (\n  | { readonly state: \"present\" | \"absent\"; readonly pid: number }\n  | {\n      readonly state: \"unknown\";\n      readonly reason: string;\n      readonly pid?: number;\n    }\n  | { readonly state: \"skipped\"; readonly reason: \"NOT_FILE\" }\n);\n\nexport type LockInspectionEntry = Pick<StorageEntry, \"name\" | \"path\"> &\n  LockInspectionState;\n\nexport interface LockInspection {\n  readonly complete: boolean;\n  readonly scope: \"local-pid\";\n  readonly entries: readonly LockInspectionEntry[];\n  readonly issues: readonly StorageIssue[];\n}\n"]}

package/dist/infrastructure/git/lock.d.ts

@@ -1 +1,2 @@
+export declare function lockPath(root: string, key: string): string;
 export declare function lock(root: string, key: string): Promise<() => Promise<void>>;