@elie-laloum/outpost 5.0.0 → 7.0.0

package/dist/application/harness.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/application/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentEvent, CustomAgent } from \"../domain/agent.types.ts\";\nimport type {\n  ModelContentBlock,\n  ModelMessage,\n  ModelProvider,\n  ModelResult,\n  ModelToolCallBlock,\n} from \"../domain/model.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { HarnessTool } from \"../domain/tool.types.ts\";\nimport type { DispatchOptions, TurnContext } from \"./execution.types.ts\";\n\nexport interface HarnessRuntime {\n  readonly agent: CustomAgent;\n  readonly tools: readonly HarnessTool[];\n  readonly modelProvider: ModelProvider;\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  emit(event: AgentEvent): void;\n  hold(): () => void;\n}\n\nexport interface ToolCallBatch {\n  readonly concurrent: boolean;\n  readonly calls: readonly PreparedCall[];\n}\n\nexport type ValidatedInput =\n  { readonly value: unknown } | { readonly outcome: ToolOutcome };\n\nexport interface ToolOutcome {\n  readonly content: string;\n  readonly isError: boolean;\n}\n\nexport interface HarnessHistory {\n  readonly messages: readonly ModelMessage[];\n  append(message: ModelMessage): Promise<void>;\n  replace(messages: readonly ModelMessage[]): Promise<void>;\n}\n\nexport interface CustomTurnContext extends TurnContext {\n  readonly continuation?: DispatchOptions[\"continuation\"];\n}\n\nexport interface LoopState {\n  readonly history: HarnessHistory;\n  readonly step: number;\n  toolCalls: number;\n}\n\nexport type StopHandler = (\n  runtime: HarnessRuntime,\n  state: LoopState,\n  result: ModelResult,\n  content: readonly ModelContentBlock[],\n) => Promise<string | undefined>;\n\nexport interface PreparedCall {\n  readonly call: ModelToolCallBlock;\n  readonly tool?: HarnessTool;\n  readonly input?: unknown;\n  readonly outcome?: ToolOutcome;\n}\n\nexport interface ToolDenial {\n  readonly deny: string;\n}\n\nexport type BlockRenderers = {\n  readonly [Type in ModelContentBlock[\"type\"]]: (\n    block: Extract<ModelContentBlock, { type: Type }>,\n  ) => string;\n};\n"]}
+{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/application/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HarnessBudget } from \"./harness-budget.types.ts\";\nimport type { HarnessPermissions } from \"../domain/permissions.types.ts\";\nimport type { HarnessModelScope } from \"./harness-model-provider.types.ts\";\nimport type { AgentEvent, CustomAgent } from \"../domain/agent.types.ts\";\nimport type {\n  ModelContentBlock,\n  ModelMessage,\n  ModelProvider,\n  ModelResult,\n  ModelToolCallBlock,\n} from \"../domain/model.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { HarnessTool } from \"../domain/tool.types.ts\";\nimport type { DispatchOptions, TurnContext } from \"./execution.types.ts\";\n\nexport interface HarnessRuntime {\n  readonly verbose?: boolean;\n  readonly repository: string;\n  readonly conversation?: string | undefined;\n  readonly budget: HarnessBudget;\n  readonly permissions: readonly HarnessPermissions[];\n  readonly depth: number;\n  readonly maxDepth: number;\n  readonly modelScope: Pick<HarnessModelScope, \"track\" | \"account\">;\n  readonly agent: CustomAgent;\n  readonly tools: readonly HarnessTool[];\n  readonly modelProvider: ModelProvider;\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  emit(event: AgentEvent): void;\n  hold(): () => void;\n}\n\nexport interface ToolCallBatch {\n  readonly concurrent: boolean;\n  readonly calls: readonly PreparedCall[];\n}\n\nexport type ValidatedInput =\n  { readonly value: unknown } | { readonly outcome: ToolOutcome };\n\nexport interface ToolOutcome {\n  readonly content: string;\n  readonly isError: boolean;\n}\n\nexport interface HarnessHistory {\n  readonly messages: readonly ModelMessage[];\n  append(message: ModelMessage): Promise<void>;\n  replace(messages: readonly ModelMessage[]): Promise<void>;\n}\n\nexport interface CustomTurnContext extends TurnContext {\n  readonly continuation?: DispatchOptions[\"continuation\"];\n}\n\nexport interface LoopState {\n  readonly history: HarnessHistory;\n  readonly step: number;\n  toolCalls: number;\n}\n\nexport type StopHandler = (\n  runtime: HarnessRuntime,\n  state: LoopState,\n  result: ModelResult,\n  content: readonly ModelContentBlock[],\n) => Promise<string | undefined>;\n\nexport interface PreparedCall {\n  readonly call: ModelToolCallBlock;\n  readonly tool?: HarnessTool;\n  readonly input?: unknown;\n  readonly outcome?: ToolOutcome;\n}\n\nexport interface ToolDenial {\n  readonly deny: string;\n}\n\nexport type BlockRenderers = {\n  readonly [Type in ModelContentBlock[\"type\"]]: (\n    block: Extract<ModelContentBlock, { type: Type }>,\n  ) => string;\n};\n"]}

package/dist/application/lifecycle-hooks.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "../domain/command.types.ts";
 import type { SandboxLease } from "../domain/sandbox.types.ts";
-export declare function hooks(commands: readonly Command[], directory: string, invoke: SandboxLease["invoke"], signal?: AbortSignal, parallel?: boolean): Promise<void>;
+export declare function hooks(commands: readonly Command[], directory: string, invoke: SandboxLease["invoke"], signal?: AbortSignal, parallel?: boolean, observation?: import("../domain/observation.types.ts").ObservationHub): Promise<void>;

package/dist/application/lifecycle-hooks.js

@@ -1,12 +1,13 @@
+import { observedOperation } from "../domain/observed-operation.js";
 import { requireSuccess } from "../infrastructure/process.js";
 import { hookDeadlineMs } from "./lifecycle.constants.js";
-export async function hooks(commands, directory, invoke, signal, parallel = false) {
+export async function hooks(commands, directory, invoke, signal, parallel = false, observation) {
     if (parallel) {
         const controller = new AbortController();
         const combined = signal
             ? AbortSignal.any([signal, controller.signal])
             : controller.signal;
-        const outcomes = await Promise.allSettled(commands.map((command) => hooks([command], directory, invoke, combined).catch((cause) => {
+        const outcomes = await Promise.allSettled(commands.map((command) => hooks([command], directory, invoke, combined, false, observation).catch((cause) => {
             controller.abort(cause);
             throw cause;
         })));
@@ -16,11 +17,11 @@ export async function hooks(commands, directory, invoke, signal, parallel = fals
         return;
     }
     for (const command of commands)
-        await requireSuccess({
+        await observedOperation(observation, "hooks", "lifecycle.command", async () => requireSuccess({
             ...command,
             directory: command.directory ?? directory,
             deadlineMs: command.deadlineMs ?? hookDeadlineMs,
             ...(signal ? { signal } : {}),
-        }, invoke);
+        }, invoke));
 }
 //# sourceMappingURL=lifecycle-hooks.js.map

package/dist/application/lifecycle-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../src/application/lifecycle-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,QAA4B,EAC5B,SAAiB,EACjB,MAA8B,EAC9B,MAAoB,EACpB,QAAQ,GAAG,KAAK;IAEhB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5D,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CACH,CACF,CAAC;QACF,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAC1E,IAAI,OAAO,EAAE,MAAM,KAAK,UAAU;YAAE,MAAM,OAAO,CAAC,MAAM,CAAC;QACzD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ;QAC5B,MAAM,cAAc,CAClB;YACE,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;YACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,cAAc;YAChD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,EACD,MAAM,CACP,CAAC;AACN,CAAC","sourcesContent":["import type { Command } from \"../domain/command.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { requireSuccess } from \"../infrastructure/process.ts\";\nimport { hookDeadlineMs } from \"./lifecycle.constants.ts\";\n\nexport async function hooks(\n  commands: readonly Command[],\n  directory: string,\n  invoke: SandboxLease[\"invoke\"],\n  signal?: AbortSignal,\n  parallel = false,\n): Promise<void> {\n  if (parallel) {\n    const controller = new AbortController();\n    const combined = signal\n      ? AbortSignal.any([signal, controller.signal])\n      : controller.signal;\n    const outcomes = await Promise.allSettled(\n      commands.map((command) =>\n        hooks([command], directory, invoke, combined).catch((cause) => {\n          controller.abort(cause);\n          throw cause;\n        }),\n      ),\n    );\n    const failure = outcomes.find((outcome) => outcome.status === \"rejected\");\n    if (failure?.status === \"rejected\") throw failure.reason;\n    return;\n  }\n  for (const command of commands)\n    await requireSuccess(\n      {\n        ...command,\n        directory: command.directory ?? directory,\n        deadlineMs: command.deadlineMs ?? hookDeadlineMs,\n        ...(signal ? { signal } : {}),\n      },\n      invoke,\n    );\n}\n"]}
+{"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../src/application/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,QAA4B,EAC5B,SAAiB,EACjB,MAA8B,EAC9B,MAAoB,EACpB,QAAQ,GAAG,KAAK,EAChB,WAAqE;IAErE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,KAAK,CACrE,CAAC,KAAK,EAAE,EAAE;YACR,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC,CACF,CACF,CACF,CAAC;QACF,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAC1E,IAAI,OAAO,EAAE,MAAM,KAAK,UAAU;YAAE,MAAM,OAAO,CAAC,MAAM,CAAC;QACzD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ;QAC5B,MAAM,iBAAiB,CACrB,WAAW,EACX,OAAO,EACP,mBAAmB,EACnB,KAAK,IAAI,EAAE,CACT,cAAc,CACZ;YACE,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;YACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,cAAc;YAChD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,EACD,MAAM,CACP,CACJ,CAAC;AACN,CAAC","sourcesContent":["import { observedOperation } from \"../domain/observed-operation.ts\";\nimport type { Command } from \"../domain/command.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { requireSuccess } from \"../infrastructure/process.ts\";\nimport { hookDeadlineMs } from \"./lifecycle.constants.ts\";\n\nexport async function hooks(\n  commands: readonly Command[],\n  directory: string,\n  invoke: SandboxLease[\"invoke\"],\n  signal?: AbortSignal,\n  parallel = false,\n  observation?: import(\"../domain/observation.types.ts\").ObservationHub,\n): Promise<void> {\n  if (parallel) {\n    const controller = new AbortController();\n    const combined = signal\n      ? AbortSignal.any([signal, controller.signal])\n      : controller.signal;\n    const outcomes = await Promise.allSettled(\n      commands.map((command) =>\n        hooks([command], directory, invoke, combined, false, observation).catch(\n          (cause) => {\n            controller.abort(cause);\n            throw cause;\n          },\n        ),\n      ),\n    );\n    const failure = outcomes.find((outcome) => outcome.status === \"rejected\");\n    if (failure?.status === \"rejected\") throw failure.reason;\n    return;\n  }\n  for (const command of commands)\n    await observedOperation(\n      observation,\n      \"hooks\",\n      \"lifecycle.command\",\n      async () =>\n        requireSuccess(\n          {\n            ...command,\n            directory: command.directory ?? directory,\n            deadlineMs: command.deadlineMs ?? hookDeadlineMs,\n            ...(signal ? { signal } : {}),\n          },\n          invoke,\n        ),\n    );\n}\n"]}

package/dist/application/observed-lease.d.ts

@@ -0,0 +1,3 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
+import type { SandboxLease } from "../domain/sandbox.types.ts";
+export declare function observedLease(lease: SandboxLease, observation?: ObservationHub): SandboxLease;

package/dist/application/observed-lease.js

@@ -0,0 +1,26 @@
+import { observedOperation } from "../domain/observed-operation.js";
+export function observedLease(lease, observation) {
+    if (!observation)
+        return lease;
+    return {
+        ...lease,
+        invoke: lease.invoke.bind(lease),
+        ...(lease.fileTransfers
+            ? {
+                fileTransfers: {
+                    manifest: (source, paths, options) => observedOperation(observation, "transfer", "files.manifest", () => lease.fileTransfers.manifest(source, paths, options)),
+                    downloadBatch: (source, entries, destination, options) => observedOperation(observation, "transfer", "files.download", () => lease.fileTransfers.downloadBatch(source, entries, destination, options)),
+                    ...(lease.fileTransfers.uploadBatch
+                        ? {
+                            uploadBatch: (source, entries, destination, options) => observedOperation(observation, "transfer", "files.upload", () => lease.fileTransfers.uploadBatch(source, entries, destination, options)),
+                        }
+                        : {}),
+                },
+            }
+            : {}),
+        upload: (source, destination, settings) => observedOperation(observation, "transfer", "file.upload", () => lease.upload(source, destination, settings)),
+        download: (source, destination, settings) => observedOperation(observation, "transfer", "file.download", () => lease.download(source, destination, settings)),
+        release: () => observedOperation(observation, "sandbox", "sandbox.release", () => lease.release()),
+    };
+}
+//# sourceMappingURL=observed-lease.js.map

package/dist/application/observed-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-lease.js","sourceRoot":"","sources":["../../src/application/observed-lease.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,WAA4B;IAE5B,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO;QACL,GAAG,KAAK;QACR,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,GAAG,CAAC,KAAK,CAAC,aAAa;YACrB,CAAC,CAAC;gBACE,aAAa,EAAE;oBACb,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACnC,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAChE,KAAK,CAAC,aAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CACtD;oBACH,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CACvD,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAChE,KAAK,CAAC,aAAc,CAAC,aAAa,CAChC,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,CACR,CACF;oBACH,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW;wBACjC,CAAC,CAAC;4BACE,WAAW,EAAE,CACX,MAAc,EACd,OAA0E,EAC1E,WAAmB,EACnB,OAA8D,EAC9D,EAAE,CACF,iBAAiB,CACf,WAAW,EACX,UAAU,EACV,cAAc,EACd,GAAG,EAAE,CACH,KAAK,CAAC,aAAc,CAAC,WAAY,CAC/B,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,CACR,CACJ;yBACJ;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CACxC,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,CAC7D,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAC5C;QACH,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAC1C,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,CAC/D,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAC9C;QACH,OAAO,EAAE,GAAG,EAAE,CACZ,iBAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAChE,KAAK,CAAC,OAAO,EAAE,CAChB;KACJ,CAAC;AACJ,CAAC","sourcesContent":["import type { ObservationHub } from \"../domain/observation.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { observedOperation } from \"../domain/observed-operation.ts\";\n\nexport function observedLease(\n  lease: SandboxLease,\n  observation?: ObservationHub,\n): SandboxLease {\n  if (!observation) return lease;\n  return {\n    ...lease,\n    invoke: lease.invoke.bind(lease),\n    ...(lease.fileTransfers\n      ? {\n          fileTransfers: {\n            manifest: (source, paths, options) =>\n              observedOperation(observation, \"transfer\", \"files.manifest\", () =>\n                lease.fileTransfers!.manifest(source, paths, options),\n              ),\n            downloadBatch: (source, entries, destination, options) =>\n              observedOperation(observation, \"transfer\", \"files.download\", () =>\n                lease.fileTransfers!.downloadBatch(\n                  source,\n                  entries,\n                  destination,\n                  options,\n                ),\n              ),\n            ...(lease.fileTransfers.uploadBatch\n              ? {\n                  uploadBatch: (\n                    source: string,\n                    entries: readonly import(\"../domain/sandbox.types.ts\").FileManifestEntry[],\n                    destination: string,\n                    options?: import(\"../domain/sandbox.types.ts\").TransferOptions,\n                  ) =>\n                    observedOperation(\n                      observation,\n                      \"transfer\",\n                      \"files.upload\",\n                      () =>\n                        lease.fileTransfers!.uploadBatch!(\n                          source,\n                          entries,\n                          destination,\n                          options,\n                        ),\n                    ),\n                }\n              : {}),\n          },\n        }\n      : {}),\n    upload: (source, destination, settings) =>\n      observedOperation(observation, \"transfer\", \"file.upload\", () =>\n        lease.upload(source, destination, settings),\n      ),\n    download: (source, destination, settings) =>\n      observedOperation(observation, \"transfer\", \"file.download\", () =>\n        lease.download(source, destination, settings),\n      ),\n    release: () =>\n      observedOperation(observation, \"sandbox\", \"sandbox.release\", () =>\n        lease.release(),\n      ),\n  };\n}\n"]}

package/dist/application/outpost.types.d.ts

@@ -1,3 +1,4 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
 import type { Transport, TransportReference } from "../domain/transport.types.ts";
 import type { Agent } from "../domain/agent.types.ts";
 import type { Command, CommandResult } from "../domain/command.types.ts";
@@ -10,6 +11,7 @@ import type { SandboxDiagnosticOptions, SandboxDiagnosticReport } from "./doctor
 import type { DispatchOptions, Execution } from "./execution.types.ts";
 import type { VariableQuestion } from "./interactive-brief.types.ts";
 export interface WorkspaceOptions {
+    readonly observation?: ObservationHub;
     readonly storageQuota?: Omit<StorageReservationOptions, "signal">;
     readonly signal?: AbortSignal;
     readonly repository?: string;
@@ -63,13 +65,13 @@ export interface AttachResult extends CommandResult, Disposal {
     readonly directory: string;
 }
 export interface DispatchResult<T> extends Execution<T> {
+    readonly observerErrors?: readonly unknown[];
     readonly branch: string;
     readonly directory: string;
     readonly commits: readonly Commit[];
     readonly transcript?: string;
     readonly transcriptReference?: TransportReference;
     readonly logReference?: TransportReference;
-    readonly log?: string;
     readonly retainedDirectory?: string;
     resume<U = undefined>(options: ContinuationOptions<U>): Promise<DispatchResult<U>>;
     fork<U = undefined>(options: ContinuationOptions<U>): Promise<DispatchResult<U>>;

package/dist/application/outpost.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"outpost.types.js","sourceRoot":"","sources":["../../src/application/outpost.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport type { Command, CommandResult } from \"../domain/command.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type {\n  BranchPolicy,\n  Commit,\n  Disposal,\n  LifecycleHooks,\n  StageLimits,\n  WorkspaceRecord,\n} from \"../domain/workspace.types.ts\";\nimport type { StorageReservationOptions } from \"../infrastructure/storage-reservations.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { DispatchOptions, Execution } from \"./execution.types.ts\";\nimport type { VariableQuestion } from \"./interactive-brief.types.ts\";\n\nexport interface WorkspaceOptions {\n  readonly storageQuota?: Omit<StorageReservationOptions, \"signal\">;\n  readonly signal?: AbortSignal;\n  readonly repository?: string;\n  readonly branch?: BranchPolicy;\n  readonly copies?: readonly string[];\n  readonly limits?: StageLimits;\n  readonly label?: string;\n  readonly hooks?: LifecycleHooks;\n}\n\nexport interface Workspace extends WorkspaceRecord {\n  dispatch<T = undefined>(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      DispatchOptions<T> & { readonly agent: Agent },\n  ): Promise<DispatchResult<T>>;\n  sandbox(\n    options?: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    >,\n  ): Promise<Sandbox>;\n  attach(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      AttachOptions & { readonly agent: Agent },\n  ): Promise<AttachResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  integrate(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SandboxOptions extends WorkspaceOptions {\n  readonly includeUncommitted?: boolean;\n  readonly agent?: Agent;\n  readonly sandboxProvider?: SandboxProvider;\n  readonly workspace?: Workspace;\n  readonly hooks?: LifecycleHooks;\n  readonly signal?: AbortSignal;\n  readonly logging?: Logging;\n  readonly bootstrap?: boolean;\n  readonly conversationHome?: string;\n  readonly recoveryTransport?: Transport;\n  readonly activityTransport?: Transport;\n}\n\nexport interface AttachOptions {\n  readonly ask?: VariableQuestion;\n  readonly agent?: Agent;\n  readonly brief?: Brief;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly signal?: AbortSignal;\n  readonly terminal?: Command[\"terminal\"];\n}\n\nexport interface AttachResult extends CommandResult, Disposal {\n  readonly commits: readonly Commit[];\n  readonly branch: string;\n  readonly directory: string;\n}\n\nexport interface DispatchResult<T> extends Execution<T> {\n  readonly branch: string;\n  readonly directory: string;\n  readonly commits: readonly Commit[];\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly logReference?: TransportReference;\n  readonly log?: string;\n  readonly retainedDirectory?: string;\n  resume<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n  fork<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n}\n\nexport type ContinuationOptions<T = undefined> = DispatchOptions<T> &\n  Omit<SandboxOptions, \"agent\">;\n\nexport interface WarmDispatchResult<T> extends Omit<\n  DispatchResult<T>,\n  \"resume\" | \"fork\"\n> {\n  resume<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n  fork<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n}\n\nexport interface Sandbox {\n  diagnose(\n    options?: SandboxDiagnosticOptions,\n  ): Promise<SandboxDiagnosticReport>;\n  readonly workspace: Workspace;\n  readonly root: string;\n  dispatch<T = undefined>(\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  resume<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  fork<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  attach(options?: AttachOptions): Promise<AttachResult>;\n  command(command: Command): Promise<CommandResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n"]}
+{"version":3,"file":"outpost.types.js","sourceRoot":"","sources":["../../src/application/outpost.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ObservationHub } from \"../domain/observation.types.ts\";\nimport type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport type { Command, CommandResult } from \"../domain/command.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type {\n  BranchPolicy,\n  Commit,\n  Disposal,\n  LifecycleHooks,\n  StageLimits,\n  WorkspaceRecord,\n} from \"../domain/workspace.types.ts\";\nimport type { StorageReservationOptions } from \"../infrastructure/storage-reservations.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { DispatchOptions, Execution } from \"./execution.types.ts\";\nimport type { VariableQuestion } from \"./interactive-brief.types.ts\";\n\nexport interface WorkspaceOptions {\n  readonly observation?: ObservationHub;\n  readonly storageQuota?: Omit<StorageReservationOptions, \"signal\">;\n  readonly signal?: AbortSignal;\n  readonly repository?: string;\n  readonly branch?: BranchPolicy;\n  readonly copies?: readonly string[];\n  readonly limits?: StageLimits;\n  readonly label?: string;\n  readonly hooks?: LifecycleHooks;\n}\n\nexport interface Workspace extends WorkspaceRecord {\n  dispatch<T = undefined>(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      DispatchOptions<T> & { readonly agent: Agent },\n  ): Promise<DispatchResult<T>>;\n  sandbox(\n    options?: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    >,\n  ): Promise<Sandbox>;\n  attach(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      AttachOptions & { readonly agent: Agent },\n  ): Promise<AttachResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  integrate(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SandboxOptions extends WorkspaceOptions {\n  readonly includeUncommitted?: boolean;\n  readonly agent?: Agent;\n  readonly sandboxProvider?: SandboxProvider;\n  readonly workspace?: Workspace;\n  readonly hooks?: LifecycleHooks;\n  readonly signal?: AbortSignal;\n  readonly logging?: Logging;\n  readonly bootstrap?: boolean;\n  readonly conversationHome?: string;\n  readonly recoveryTransport?: Transport;\n  readonly activityTransport?: Transport;\n}\n\nexport interface AttachOptions {\n  readonly ask?: VariableQuestion;\n  readonly agent?: Agent;\n  readonly brief?: Brief;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly signal?: AbortSignal;\n  readonly terminal?: Command[\"terminal\"];\n}\n\nexport interface AttachResult extends CommandResult, Disposal {\n  readonly commits: readonly Commit[];\n  readonly branch: string;\n  readonly directory: string;\n}\n\nexport interface DispatchResult<T> extends Execution<T> {\n  readonly observerErrors?: readonly unknown[];\n  readonly branch: string;\n  readonly directory: string;\n  readonly commits: readonly Commit[];\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly logReference?: TransportReference;\n  readonly retainedDirectory?: string;\n  resume<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n  fork<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n}\n\nexport type ContinuationOptions<T = undefined> = DispatchOptions<T> &\n  Omit<SandboxOptions, \"agent\">;\n\nexport interface WarmDispatchResult<T> extends Omit<\n  DispatchResult<T>,\n  \"resume\" | \"fork\"\n> {\n  resume<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n  fork<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n}\n\nexport interface Sandbox {\n  diagnose(\n    options?: SandboxDiagnosticOptions,\n  ): Promise<SandboxDiagnosticReport>;\n  readonly workspace: Workspace;\n  readonly root: string;\n  dispatch<T = undefined>(\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  resume<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  fork<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  attach(options?: AttachOptions): Promise<AttachResult>;\n  command(command: Command): Promise<CommandResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n"]}

package/dist/application/output-lines.d.ts

@@ -0,0 +1,4 @@
+export declare function boundedLines(emit: (text: string, truncated: boolean) => void): {
+    append(chunk: string): void;
+    flush(): void;
+};

package/dist/application/output-lines.js

@@ -0,0 +1,28 @@
+import { observationDefaults } from "../domain/observation.constants.js";
+export function boundedLines(emit) {
+    let pending = "";
+    const limit = observationDefaults.outputCharacters;
+    return {
+        append(chunk) {
+            for (let offset = 0; offset < chunk.length; offset += limit) {
+                pending += chunk.slice(offset, offset + limit);
+                let end;
+                while ((end = pending.indexOf("\n")) >= 0) {
+                    const line = pending.slice(0, end);
+                    emit(line.slice(0, limit), line.length > limit);
+                    pending = pending.slice(end + 1);
+                }
+                if (pending.length >= limit) {
+                    emit(pending.slice(0, limit), true);
+                    pending = pending.slice(limit);
+                }
+            }
+        },
+        flush() {
+            if (pending)
+                emit(pending, false);
+            pending = "";
+        },
+    };
+}
+//# sourceMappingURL=output-lines.js.map

package/dist/application/output-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-lines.js","sourceRoot":"","sources":["../../src/application/output-lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,UAAU,YAAY,CAAC,IAAgD;IAC3E,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,mBAAmB,CAAC,gBAAgB,CAAC;IACnD,OAAO;QACL,MAAM,CAAC,KAAa;YAClB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC5D,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;gBAC/C,IAAI,GAAW,CAAC;gBAChB,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACnC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;oBAChD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;oBACpC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK;YACH,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAClC,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { observationDefaults } from \"../domain/observation.constants.ts\";\n\nexport function boundedLines(emit: (text: string, truncated: boolean) => void) {\n  let pending = \"\";\n  const limit = observationDefaults.outputCharacters;\n  return {\n    append(chunk: string) {\n      for (let offset = 0; offset < chunk.length; offset += limit) {\n        pending += chunk.slice(offset, offset + limit);\n        let end: number;\n        while ((end = pending.indexOf(\"\\n\")) >= 0) {\n          const line = pending.slice(0, end);\n          emit(line.slice(0, limit), line.length > limit);\n          pending = pending.slice(end + 1);\n        }\n        if (pending.length >= limit) {\n          emit(pending.slice(0, limit), true);\n          pending = pending.slice(limit);\n        }\n      }\n    },\n    flush() {\n      if (pending) emit(pending, false);\n      pending = \"\";\n    },\n  };\n}\n"]}

package/dist/application/queue-worker.js

@@ -37,7 +37,7 @@ export async function runQueueWorker(options) {
                 throw new Error("Worker handler unavailable");
             let result;
             try {
-                result = queueResult(await handler(job.input, { signal, job }));
+                result = queueResult(await handler(job.input, { signal, job, idempotencyKey: job.id }));
             }
             catch (error) {
                 result = {

package/dist/application/queue-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-worker.js","sourceRoot":"","sources":["../../src/application/queue-worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { setTimeout as delay } from \"node:timers/promises\";\nimport {\n  queueMaxStringLength,\n  queueDefaultLeaseMs,\n  queueDefaultPollMs,\n} from \"../domain/task-queue.constants.ts\";\nimport {\n  queueLeaseMs,\n  queueNumber,\n  queueString,\n  queueResult,\n} from \"../domain/task-queue.ts\";\nimport type { QueueWorkerOptions } from \"./queue-worker.types.ts\";\nimport type { QueueJob, QueueResult } from \"../domain/task-queue.types.ts\";\n\nexport async function runQueueWorker(\n  options: QueueWorkerOptions,\n): Promise<void> {\n  const leaseMs = queueLeaseMs(options.leaseMs ?? queueDefaultLeaseMs);\n  const pollMs = queueNumber(options.pollMs ?? queueDefaultPollMs);\n  if (!pollMs) throw new Error(\"Worker poll interval must be positive\");\n  const handlers = new Map(Object.entries(options.handlers));\n  if (\n    !handlers.size ||\n    [...handlers.values()].some((handler) => typeof handler !== \"function\")\n  )\n    throw new Error(\"Worker requires trusted handlers\");\n  const worker = queueString(options.worker);\n  async function execute(job: QueueJob) {\n    if (options.signal.aborted) return;\n    const stop = new AbortController();\n    const signal = AbortSignal.any([options.signal, stop.signal]);\n    const lease = { id: job.id, worker, fence: job.fence };\n    const heartbeat = (async () => {\n      try {\n        while (!signal.aborted) {\n          await delay(Math.max(10, Math.floor(leaseMs / 3)), undefined, {\n            signal,\n          });\n          await options.queue.renew(lease, leaseMs);\n        }\n      } catch (error) {\n        if (!signal.aborted) stop.abort(error);\n      }\n    })();\n    try {\n      const handler = handlers.get(job.handler);\n      if (!handler) throw new Error(\"Worker handler unavailable\");\n      let result: QueueResult;\n      try {\n        result = queueResult(await handler(job.input, { signal, job }));\n      } catch (error) {\n        result = {\n          value: null,\n          error:\n            (error instanceof Error ? error.message : String(error)).slice(\n              0,\n              queueMaxStringLength,\n            ) || \"Queue handler failed\",\n        };\n      }\n      if (!signal.aborted) await options.queue.complete(lease, result);\n    } finally {\n      stop.abort();\n      await heartbeat;\n    }\n  }\n  try {\n    while (!options.signal.aborted) {\n      const job = await options.queue.claim({\n        worker,\n        handlers: [...handlers.keys()],\n        leaseMs,\n      });\n      if (job) {\n        await execute(job);\n        continue;\n      }\n      await delay(pollMs, undefined, { signal: options.signal });\n    }\n  } catch (error) {\n    if (!options.signal.aborted) throw error;\n  }\n}\n"]}
+{"version":3,"file":"queue-worker.js","sourceRoot":"","sources":["../../src/application/queue-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAIjC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B;IAE3B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,IACE,CAAC,QAAQ,CAAC,IAAI;QACd,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC;QAEvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,UAAU,OAAO,CAAC,GAAa;QAClC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACnC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACvB,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE;wBAC5D,MAAM;qBACP,CAAC,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5D,IAAI,MAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,WAAW,CAClB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAClE,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG;oBACP,KAAK,EAAE,IAAI;oBACX,KAAK,EACH,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAC5D,CAAC,EACD,oBAAoB,CACrB,IAAI,sBAAsB;iBAC9B,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,SAAS,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpC,MAAM;gBACN,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC9B,OAAO;aACR,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC;IAC3C,CAAC;AACH,CAAC","sourcesContent":["import { setTimeout as delay } from \"node:timers/promises\";\nimport {\n  queueMaxStringLength,\n  queueDefaultLeaseMs,\n  queueDefaultPollMs,\n} from \"../domain/task-queue.constants.ts\";\nimport {\n  queueLeaseMs,\n  queueNumber,\n  queueString,\n  queueResult,\n} from \"../domain/task-queue.ts\";\nimport type { QueueWorkerOptions } from \"./queue-worker.types.ts\";\nimport type { QueueJob, QueueResult } from \"../domain/task-queue.types.ts\";\n\nexport async function runQueueWorker(\n  options: QueueWorkerOptions,\n): Promise<void> {\n  const leaseMs = queueLeaseMs(options.leaseMs ?? queueDefaultLeaseMs);\n  const pollMs = queueNumber(options.pollMs ?? queueDefaultPollMs);\n  if (!pollMs) throw new Error(\"Worker poll interval must be positive\");\n  const handlers = new Map(Object.entries(options.handlers));\n  if (\n    !handlers.size ||\n    [...handlers.values()].some((handler) => typeof handler !== \"function\")\n  )\n    throw new Error(\"Worker requires trusted handlers\");\n  const worker = queueString(options.worker);\n  async function execute(job: QueueJob) {\n    if (options.signal.aborted) return;\n    const stop = new AbortController();\n    const signal = AbortSignal.any([options.signal, stop.signal]);\n    const lease = { id: job.id, worker, fence: job.fence };\n    const heartbeat = (async () => {\n      try {\n        while (!signal.aborted) {\n          await delay(Math.max(10, Math.floor(leaseMs / 3)), undefined, {\n            signal,\n          });\n          await options.queue.renew(lease, leaseMs);\n        }\n      } catch (error) {\n        if (!signal.aborted) stop.abort(error);\n      }\n    })();\n    try {\n      const handler = handlers.get(job.handler);\n      if (!handler) throw new Error(\"Worker handler unavailable\");\n      let result: QueueResult;\n      try {\n        result = queueResult(\n          await handler(job.input, { signal, job, idempotencyKey: job.id }),\n        );\n      } catch (error) {\n        result = {\n          value: null,\n          error:\n            (error instanceof Error ? error.message : String(error)).slice(\n              0,\n              queueMaxStringLength,\n            ) || \"Queue handler failed\",\n        };\n      }\n      if (!signal.aborted) await options.queue.complete(lease, result);\n    } finally {\n      stop.abort();\n      await heartbeat;\n    }\n  }\n  try {\n    while (!options.signal.aborted) {\n      const job = await options.queue.claim({\n        worker,\n        handlers: [...handlers.keys()],\n        leaseMs,\n      });\n      if (job) {\n        await execute(job);\n        continue;\n      }\n      await delay(pollMs, undefined, { signal: options.signal });\n    }\n  } catch (error) {\n    if (!options.signal.aborted) throw error;\n  }\n}\n"]}

package/dist/application/queue-worker.types.d.ts

@@ -1,6 +1,7 @@
 import type { QueueJob, QueueResult, TaskQueue } from "../domain/task-queue.types.ts";
 import type { WorkflowJson } from "../domain/workflow/checkpoint.types.ts";
 export interface QueueHandlerContext {
+    readonly idempotencyKey: string;
     readonly signal: AbortSignal;
     readonly job: QueueJob;
 }

package/dist/application/queue-worker.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-worker.types.js","sourceRoot":"","sources":["../../src/application/queue-worker.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  QueueJob,\n  QueueResult,\n  TaskQueue,\n} from \"../domain/task-queue.types.ts\";\nimport type { WorkflowJson } from \"../domain/workflow/checkpoint.types.ts\";\nexport interface QueueHandlerContext {\n  readonly signal: AbortSignal;\n  readonly job: QueueJob;\n}\nexport type QueueHandler = (\n  input: WorkflowJson,\n  context: QueueHandlerContext,\n) => Promise<QueueResult> | QueueResult;\nexport interface QueueWorkerOptions {\n  readonly queue: TaskQueue;\n  readonly worker: string;\n  readonly handlers: Readonly<Record<string, QueueHandler>>;\n  readonly signal: AbortSignal;\n  readonly leaseMs?: number;\n  readonly pollMs?: number;\n}\n"]}
+{"version":3,"file":"queue-worker.types.js","sourceRoot":"","sources":["../../src/application/queue-worker.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  QueueJob,\n  QueueResult,\n  TaskQueue,\n} from \"../domain/task-queue.types.ts\";\nimport type { WorkflowJson } from \"../domain/workflow/checkpoint.types.ts\";\nexport interface QueueHandlerContext {\n  readonly idempotencyKey: string;\n  readonly signal: AbortSignal;\n  readonly job: QueueJob;\n}\nexport type QueueHandler = (\n  input: WorkflowJson,\n  context: QueueHandlerContext,\n) => Promise<QueueResult> | QueueResult;\nexport interface QueueWorkerOptions {\n  readonly queue: TaskQueue;\n  readonly worker: string;\n  readonly handlers: Readonly<Record<string, QueueHandler>>;\n  readonly signal: AbortSignal;\n  readonly leaseMs?: number;\n  readonly pollMs?: number;\n}\n"]}

package/dist/application/queued-task.js

@@ -1,4 +1,4 @@
-import { createHash } from "node:crypto";
+import { taskIdempotencyKey } from "../domain/workflow/idempotency.js";
 import { setTimeout as delay } from "node:timers/promises";
 import { task } from "../domain/workflow.js";
 import { queueDefaultPollMs } from "../domain/task-queue.constants.js";
@@ -14,15 +14,18 @@ export function queuedTask(options) {
         ...definition,
         async perform(context) {
             context.signal.throwIfAborted();
-            const id = createHash("sha256")
-                .update(JSON.stringify([context.executionId, definition.key]))
-                .digest("hex");
+            const id = taskIdempotencyKey(context.executionId, definition.key);
             let job = await queue.enqueue({
                 id,
                 handler,
                 input: input(context),
                 ...(deadline === undefined ? {} : { deadline }),
             });
+            context.observation?.emit("workflow", {
+                kind: "queue",
+                id,
+                status: "enqueued",
+            });
             try {
                 while (job.status === "pending" || job.status === "active") {
                     await delay(pollMs, undefined, { signal: context.signal });
@@ -30,6 +33,11 @@ export function queuedTask(options) {
                     if (!latest)
                         throw new Error("Queued workflow job disappeared");
                     job = latest;
+                    context.observation?.emit("workflow", {
+                        kind: "queue",
+                        id,
+                        status: "polled",
+                    });
                 }
                 if (job.result?.usage) {
                     if (context.reportUsageOnce)
@@ -40,9 +48,20 @@ export function queuedTask(options) {
                 if (job.status !== "done" || !job.result)
                     throw new Error(job.result?.error ?? "Queued workflow job cancelled");
                 context.signal.throwIfAborted();
-                return decode(job.result.value);
+                const value = decode(job.result.value);
+                context.observation?.emit("workflow", {
+                    kind: "queue",
+                    id,
+                    status: "completed",
+                });
+                return value;
             }
             catch (error) {
+                context.observation?.emit("workflow", {
+                    kind: "queue",
+                    id,
+                    status: "failed",
+                });
                 if (context.signal.aborted) {
                     const latest = await queue.get(id);
                     if (latest)

package/dist/application/queued-task.js.map

@@ -1 +1 @@
-{"version":3,"file":"queued-task.js","sourceRoot":"","sources":["../../src/application/queued-task.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { task } from \"../domain/workflow.ts\";\nimport { queueDefaultPollMs } from \"../domain/task-queue.constants.ts\";\nimport { queueNumber, queueString } from \"../domain/task-queue.ts\";\nimport type { Task } from \"../domain/workflow.types.ts\";\nimport type { QueuedTaskOptions } from \"./queued-task.types.ts\";\n\nexport function queuedTask<T>(options: QueuedTaskOptions<T>): Task<T> {\n  const {\n    queue,\n    handler,\n    input,\n    decode,\n    deadline,\n    pollMs = queueDefaultPollMs,\n    ...definition\n  } = options;\n  queueString(handler);\n  if (!queueNumber(pollMs))\n    throw new Error(\"Queue poll interval must be positive\");\n  if (deadline !== undefined) queueNumber(deadline);\n  return task({\n    ...definition,\n    async perform(context) {\n      context.signal.throwIfAborted();\n      const id = createHash(\"sha256\")\n        .update(JSON.stringify([context.executionId, definition.key]))\n        .digest(\"hex\");\n      let job = await queue.enqueue({\n        id,\n        handler,\n        input: input(context),\n        ...(deadline === undefined ? {} : { deadline }),\n      });\n      try {\n        while (job.status === \"pending\" || job.status === \"active\") {\n          await delay(pollMs, undefined, { signal: context.signal });\n          const latest = await queue.get(id);\n          if (!latest) throw new Error(\"Queued workflow job disappeared\");\n          job = latest;\n        }\n        if (job.result?.usage) {\n          if (context.reportUsageOnce)\n            context.reportUsageOnce(`queue:${id}`, job.result.usage);\n          else context.reportUsage(job.result.usage);\n        }\n        if (job.status !== \"done\" || !job.result)\n          throw new Error(job.result?.error ?? \"Queued workflow job cancelled\");\n        context.signal.throwIfAborted();\n        return decode(job.result.value);\n      } catch (error) {\n        if (context.signal.aborted) {\n          const latest = await queue.get(id);\n          if (latest) await queue.cancel(id, latest.fence);\n        }\n        throw error;\n      }\n    },\n  });\n}\n"]}
+{"version":3,"file":"queued-task.js","sourceRoot":"","sources":["../../src/application/queued-task.ts"],"names":[],"mappings":"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","sourcesContent":["import { taskIdempotencyKey } from \"../domain/workflow/idempotency.ts\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { task } from \"../domain/workflow.ts\";\nimport { queueDefaultPollMs } from \"../domain/task-queue.constants.ts\";\nimport { queueNumber, queueString } from \"../domain/task-queue.ts\";\nimport type { Task } from \"../domain/workflow.types.ts\";\nimport type { QueuedTaskOptions } from \"./queued-task.types.ts\";\n\nexport function queuedTask<T>(options: QueuedTaskOptions<T>): Task<T> {\n  const {\n    queue,\n    handler,\n    input,\n    decode,\n    deadline,\n    pollMs = queueDefaultPollMs,\n    ...definition\n  } = options;\n  queueString(handler);\n  if (!queueNumber(pollMs))\n    throw new Error(\"Queue poll interval must be positive\");\n  if (deadline !== undefined) queueNumber(deadline);\n  return task({\n    ...definition,\n    async perform(context) {\n      context.signal.throwIfAborted();\n      const id = taskIdempotencyKey(context.executionId, definition.key);\n      let job = await queue.enqueue({\n        id,\n        handler,\n        input: input(context),\n        ...(deadline === undefined ? {} : { deadline }),\n      });\n      context.observation?.emit(\"workflow\", {\n        kind: \"queue\",\n        id,\n        status: \"enqueued\",\n      });\n      try {\n        while (job.status === \"pending\" || job.status === \"active\") {\n          await delay(pollMs, undefined, { signal: context.signal });\n          const latest = await queue.get(id);\n          if (!latest) throw new Error(\"Queued workflow job disappeared\");\n          job = latest;\n          context.observation?.emit(\"workflow\", {\n            kind: \"queue\",\n            id,\n            status: \"polled\",\n          });\n        }\n        if (job.result?.usage) {\n          if (context.reportUsageOnce)\n            context.reportUsageOnce(`queue:${id}`, job.result.usage);\n          else context.reportUsage(job.result.usage);\n        }\n        if (job.status !== \"done\" || !job.result)\n          throw new Error(job.result?.error ?? \"Queued workflow job cancelled\");\n        context.signal.throwIfAborted();\n        const value = decode(job.result.value);\n        context.observation?.emit(\"workflow\", {\n          kind: \"queue\",\n          id,\n          status: \"completed\",\n        });\n        return value;\n      } catch (error) {\n        context.observation?.emit(\"workflow\", {\n          kind: \"queue\",\n          id,\n          status: \"failed\",\n        });\n        if (context.signal.aborted) {\n          const latest = await queue.get(id);\n          if (latest) await queue.cancel(id, latest.fence);\n        }\n        throw error;\n      }\n    },\n  });\n}\n"]}

package/dist/application/recovery-archive.d.ts

@@ -1,4 +1,5 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
 import type { TransportReference } from "../domain/transport.types.ts";
 import type { RecoveryArchiveOptions, RecoveryArchiveRestoreOptions } from "./recovery-archive.types.ts";
-export declare function archiveRecovery(options: RecoveryArchiveOptions): Promise<TransportReference>;
-export declare function materializeRecoveryArchive(options: RecoveryArchiveRestoreOptions): Promise<string>;
+export declare function archiveRecovery(options: RecoveryArchiveOptions, observation?: ObservationHub): Promise<TransportReference>;
+export declare function materializeRecoveryArchive(options: RecoveryArchiveRestoreOptions, observation?: ObservationHub): Promise<string>;

package/dist/application/recovery-archive.js

@@ -1,3 +1,4 @@
+import { observedOperation } from "../domain/observed-operation.js";
 import { randomUUID } from "node:crypto";
 import { archiveFiles, restoreArchiveFiles, } from "../infrastructure/transport-archive.js";
 import { snapshotRecoveryTransfer } from "./recovery-restore-snapshot.js";
@@ -5,7 +6,7 @@ import { recoveryChecksumPaths } from "./recovery-checksum-paths.js";
 import { recoveryChecksumDefaults } from "./recovery-checksums.constants.js";
 import { verifyRecoveryTransfer } from "./recovery-verification.js";
 import { invariant } from "../domain/errors.js";
-export async function archiveRecovery(options) {
+async function archiveRecoveryOperation(options) {
     const snapshot = await snapshotRecoveryTransfer(options.directory, options.maxBytes);
     try {
         return await archiveFiles(options.transporter, snapshot.directory, [
@@ -17,7 +18,7 @@ export async function archiveRecovery(options) {
         await snapshot.dispose();
     }
 }
-export async function materializeRecoveryArchive(options) {
+async function materializeRecoveryOperation(options) {
     await restoreArchiveFiles(options.transporter, options.reference, options.destination, options.maxBytes);
     const verified = await verifyRecoveryTransfer(options.destination, {
         checksums: true,
@@ -26,4 +27,10 @@ export async function materializeRecoveryArchive(options) {
     invariant(verified.complete && verified.integrity === "checksums-match", "Recovery archive integrity verification failed; destination retained");
     return options.destination;
 }
+export function archiveRecovery(options, observation) {
+    return observedOperation(observation, "transfer", "recovery.archive", () => archiveRecoveryOperation(options));
+}
+export function materializeRecoveryArchive(options, observation) {
+    return observedOperation(observation, "transfer", "recovery.materialize", () => materializeRecoveryOperation(options));
+}
 //# sourceMappingURL=recovery-archive.js.map

package/dist/application/recovery-archive.js.map

@@ -1 +1 @@
-{"version":3,"file":"recovery-archive.js","sourceRoot":"","sources":["../../src/application/recovery-archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMhD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CACvB,OAAO,CAAC,WAAW,EACnB,QAAQ,CAAC,SAAS,EAClB;YACE,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,wBAAwB,CAAC,QAAQ;SAClC,EACD,YAAY,UAAU,EAAE,EAAE,EAC1B,OAAO,CAAC,QAAQ,CACjB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAsC;IAEtC,MAAM,mBAAmB,CACvB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,WAAW,EAAE;QACjE,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KAC1E,CAAC,CAAC;IACH,SAAS,CACP,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,iBAAiB,EAC7D,sEAAsE,CACvE,CAAC;IACF,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { TransportReference } from \"../domain/transport.types.ts\";\nimport {\n  archiveFiles,\n  restoreArchiveFiles,\n} from \"../infrastructure/transport-archive.ts\";\nimport { snapshotRecoveryTransfer } from \"./recovery-restore-snapshot.ts\";\nimport { recoveryChecksumPaths } from \"./recovery-checksum-paths.ts\";\nimport { recoveryChecksumDefaults } from \"./recovery-checksums.constants.ts\";\nimport { verifyRecoveryTransfer } from \"./recovery-verification.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type {\n  RecoveryArchiveOptions,\n  RecoveryArchiveRestoreOptions,\n} from \"./recovery-archive.types.ts\";\n\nexport async function archiveRecovery(\n  options: RecoveryArchiveOptions,\n): Promise<TransportReference> {\n  const snapshot = await snapshotRecoveryTransfer(\n    options.directory,\n    options.maxBytes,\n  );\n  try {\n    return await archiveFiles(\n      options.transporter,\n      snapshot.directory,\n      [\n        ...recoveryChecksumPaths(snapshot.state),\n        recoveryChecksumDefaults.filename,\n      ],\n      `recovery/${randomUUID()}`,\n      options.maxBytes,\n    );\n  } finally {\n    await snapshot.dispose();\n  }\n}\n\nexport async function materializeRecoveryArchive(\n  options: RecoveryArchiveRestoreOptions,\n): Promise<string> {\n  await restoreArchiveFiles(\n    options.transporter,\n    options.reference,\n    options.destination,\n    options.maxBytes,\n  );\n  const verified = await verifyRecoveryTransfer(options.destination, {\n    checksums: true,\n    ...(options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),\n  });\n  invariant(\n    verified.complete && verified.integrity === \"checksums-match\",\n    \"Recovery archive integrity verification failed; destination retained\",\n  );\n  return options.destination;\n}\n"]}
+{"version":3,"file":"recovery-archive.js","sourceRoot":"","sources":["../../src/application/recovery-archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMhD,KAAK,UAAU,wBAAwB,CACrC,OAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CACvB,OAAO,CAAC,WAAW,EACnB,QAAQ,CAAC,SAAS,EAClB;YACE,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,wBAAwB,CAAC,QAAQ;SAClC,EACD,YAAY,UAAU,EAAE,EAAE,EAC1B,OAAO,CAAC,QAAQ,CACjB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,OAAsC;IAEtC,MAAM,mBAAmB,CACvB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,WAAW,EAAE;QACjE,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KAC1E,CAAC,CAAC;IACH,SAAS,CACP,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,iBAAiB,EAC7D,sEAAsE,CACvE,CAAC;IACF,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAA+B,EAC/B,WAA4B;IAE5B,OAAO,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,EAAE,CACzE,wBAAwB,CAAC,OAAO,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAsC,EACtC,WAA4B;IAE5B,OAAO,iBAAiB,CACtB,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,GAAG,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAC5C,CAAC;AACJ,CAAC","sourcesContent":["import { observedOperation } from \"../domain/observed-operation.ts\";\nimport type { ObservationHub } from \"../domain/observation.types.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type { TransportReference } from \"../domain/transport.types.ts\";\nimport {\n  archiveFiles,\n  restoreArchiveFiles,\n} from \"../infrastructure/transport-archive.ts\";\nimport { snapshotRecoveryTransfer } from \"./recovery-restore-snapshot.ts\";\nimport { recoveryChecksumPaths } from \"./recovery-checksum-paths.ts\";\nimport { recoveryChecksumDefaults } from \"./recovery-checksums.constants.ts\";\nimport { verifyRecoveryTransfer } from \"./recovery-verification.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type {\n  RecoveryArchiveOptions,\n  RecoveryArchiveRestoreOptions,\n} from \"./recovery-archive.types.ts\";\n\nasync function archiveRecoveryOperation(\n  options: RecoveryArchiveOptions,\n): Promise<TransportReference> {\n  const snapshot = await snapshotRecoveryTransfer(\n    options.directory,\n    options.maxBytes,\n  );\n  try {\n    return await archiveFiles(\n      options.transporter,\n      snapshot.directory,\n      [\n        ...recoveryChecksumPaths(snapshot.state),\n        recoveryChecksumDefaults.filename,\n      ],\n      `recovery/${randomUUID()}`,\n      options.maxBytes,\n    );\n  } finally {\n    await snapshot.dispose();\n  }\n}\n\nasync function materializeRecoveryOperation(\n  options: RecoveryArchiveRestoreOptions,\n): Promise<string> {\n  await restoreArchiveFiles(\n    options.transporter,\n    options.reference,\n    options.destination,\n    options.maxBytes,\n  );\n  const verified = await verifyRecoveryTransfer(options.destination, {\n    checksums: true,\n    ...(options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),\n  });\n  invariant(\n    verified.complete && verified.integrity === \"checksums-match\",\n    \"Recovery archive integrity verification failed; destination retained\",\n  );\n  return options.destination;\n}\n\nexport function archiveRecovery(\n  options: RecoveryArchiveOptions,\n  observation?: ObservationHub,\n): Promise<TransportReference> {\n  return observedOperation(observation, \"transfer\", \"recovery.archive\", () =>\n    archiveRecoveryOperation(options),\n  );\n}\n\nexport function materializeRecoveryArchive(\n  options: RecoveryArchiveRestoreOptions,\n  observation?: ObservationHub,\n): Promise<string> {\n  return observedOperation(\n    observation,\n    \"transfer\",\n    \"recovery.materialize\",\n    () => materializeRecoveryOperation(options),\n  );\n}\n"]}

package/dist/application/recovery-restore.d.ts

@@ -1,3 +1,4 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
 import type { RecoveryRestoreOptions, RecoveryRestorePlan, RecoveryRestoreResult } from "./recovery-restore.types.ts";
-export declare function planRecoveryRestore(options: RecoveryRestoreOptions): Promise<RecoveryRestorePlan>;
-export declare function restoreRecoveryTransfer(plan: RecoveryRestorePlan): Promise<RecoveryRestoreResult>;
+export declare function planRecoveryRestore(options: RecoveryRestoreOptions, observation?: ObservationHub): Promise<RecoveryRestorePlan>;
+export declare function restoreRecoveryTransfer(plan: RecoveryRestorePlan, observation?: ObservationHub): Promise<RecoveryRestoreResult>;

package/dist/application/recovery-restore.js

@@ -1,3 +1,4 @@
+import { observedOperation } from "../domain/observed-operation.js";
 import { createHash } from "node:crypto";
 import { cp, lstat, mkdir } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
@@ -48,7 +49,7 @@ async function locations(options) {
     await absent(destination);
     return { repository, directory: transfer, destination };
 }
-export async function planRecoveryRestore(options) {
+async function planRecoveryRestoreOperation(options) {
     const paths = await locations(options);
     const snapshot = await snapshotRecoveryTransfer(paths.directory, options.maxBytes);
     try {
@@ -84,7 +85,7 @@ async function applyPatch(checkout, patch, cached = false) {
         patch,
     ]);
 }
-export async function restoreRecoveryTransfer(plan) {
+async function restoreRecoveryOperation(plan) {
     invariant(plan.fingerprint === planFingerprint(plan), "Recovery plan changed after planning");
     const paths = await locations(plan);
     invariant(paths.repository === plan.repository &&
@@ -158,4 +159,10 @@ export async function restoreRecoveryTransfer(plan) {
         await snapshot.dispose();
     }
 }
+export function planRecoveryRestore(options, observation) {
+    return observedOperation(observation, "recovery", "restore.plan", () => planRecoveryRestoreOperation(options));
+}
+export function restoreRecoveryTransfer(plan, observation) {
+    return observedOperation(observation, "recovery", "restore.apply", () => restoreRecoveryOperation(plan));
+}
 //# sourceMappingURL=recovery-restore.js.map

package/dist/application/recovery-restore.js.map

@@ -1 +1 @@
-{"version":3,"file":"recovery-restore.js","sourceRoot":"","sources":["../../src/application/recovery-restore.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { cp, lstat, mkdir } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { invariant, OutpostError } from \"../domain/errors.ts\";\nimport { directory, inside, safeDestination } from \"../infrastructure/files.ts\";\nimport { verificationGit as git } from \"../infrastructure/git/verification-command.ts\";\nimport { verifyRecoveryRestorability } from \"./recovery-restorability.ts\";\nimport { snapshotRecoveryTransfer } from \"./recovery-restore-snapshot.ts\";\nimport type {\n  RecoveryRestoreOptions,\n  RecoveryRestorePlan,\n  RecoveryRestoreResult,\n} from \"./recovery-restore.types.ts\";\n\nfunction planFingerprint(\n  plan: Omit<RecoveryRestorePlan, \"fingerprint\">,\n): string {\n  return createHash(\"sha256\")\n    .update(\n      JSON.stringify([\n        plan.directory,\n        plan.repository,\n        plan.destination,\n        plan.side,\n        plan.maxBytes ?? null,\n        plan.manifestSha256,\n        plan.commit,\n        plan.payloads,\n        plan.staging,\n      ]),\n    )\n    .digest(\"hex\");\n}\n\nasync function absent(path: string): Promise<void> {\n  const present = await lstat(path).then(\n    () => true,\n    (error: unknown) => {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      )\n        return false;\n      throw error;\n    },\n  );\n  invariant(!present, \"Recovery destination already exists\");\n}\n\nasync function locations(options: RecoveryRestoreOptions) {\n  invariant(\n    options.side === \"previous\" || options.side === \"incoming\",\n    \"Recovery side must be previous or incoming\",\n  );\n  const repository = await directory(options.repository);\n  const transfer = await directory(options.directory);\n  const destination = join(\n    await directory(dirname(resolve(options.destination))),\n    basename(resolve(options.destination)),\n  );\n  const common = await directory(\n    (\n      await git(repository, [\n        \"rev-parse\",\n        \"--path-format=absolute\",\n        \"--git-common-dir\",\n      ])\n    ).trim(),\n  );\n  invariant(\n    !inside(repository, destination) &&\n      !inside(transfer, destination) &&\n      !inside(common, destination),\n    \"Recovery destination must be outside the source repository, Git metadata and transfer\",\n  );\n  await absent(destination);\n  return { repository, directory: transfer, destination };\n}\n\nexport async function planRecoveryRestore(\n  options: RecoveryRestoreOptions,\n): Promise<RecoveryRestorePlan> {\n  const paths = await locations(options);\n  const snapshot = await snapshotRecoveryTransfer(\n    paths.directory,\n    options.maxBytes,\n  );\n  try {\n    const checks = await verifyRecoveryRestorability(\n      snapshot.directory,\n      snapshot.state,\n      paths.repository,\n    );\n    invariant(\n      checks.every((check) => check.status === \"pass\"),\n      \"Recovery Git restorability verification failed\",\n    );\n    const plan = {\n      ...options,\n      ...paths,\n      manifestSha256: snapshot.manifestSha256,\n      commit:\n        options.side === \"previous\"\n          ? snapshot.state.previous\n          : snapshot.state.next,\n      payloads:\n        options.side === \"previous\"\n          ? snapshot.state.previousExtras\n          : snapshot.state.incoming,\n      staging:\n        options.side === \"previous\"\n          ? (\"preserved\" as const)\n          : (\"unavailable\" as const),\n    };\n    return { ...plan, fingerprint: planFingerprint(plan) };\n  } finally {\n    await snapshot.dispose();\n  }\n}\n\nasync function applyPatch(\n  checkout: string,\n  patch: string,\n  cached = false,\n): Promise<void> {\n  if (!(await lstat(patch)).size) return;\n  await git(checkout, [\n    \"apply\",\n    \"--binary\",\n    ...(cached ? [\"--cached\"] : []),\n    patch,\n  ]);\n}\n\nexport async function restoreRecoveryTransfer(\n  plan: RecoveryRestorePlan,\n): Promise<RecoveryRestoreResult> {\n  invariant(\n    plan.fingerprint === planFingerprint(plan),\n    \"Recovery plan changed after planning\",\n  );\n  const paths = await locations(plan);\n  invariant(\n    paths.repository === plan.repository &&\n      paths.directory === plan.directory &&\n      paths.destination === plan.destination,\n    \"Recovery plan paths changed after planning\",\n  );\n  const snapshot = await snapshotRecoveryTransfer(\n    paths.directory,\n    plan.maxBytes,\n  );\n  let owned = false;\n  try {\n    invariant(\n      snapshot.manifestSha256 === plan.manifestSha256,\n      \"Recovery transfer changed since planning\",\n    );\n    const commit =\n      plan.side === \"previous\" ? snapshot.state.previous : snapshot.state.next;\n    invariant(commit === plan.commit, \"Recovery plan commit changed\");\n    const checks = await verifyRecoveryRestorability(\n      snapshot.directory,\n      snapshot.state,\n      paths.repository,\n    );\n    invariant(\n      checks.every((check) => check.status === \"pass\"),\n      \"Recovery Git restorability verification failed\",\n    );\n    await mkdir(paths.destination, { mode: 0o700 });\n    owned = true;\n    await git(dirname(paths.destination), [\n      \"clone\",\n      \"--local\",\n      \"--no-hardlinks\",\n      \"--no-checkout\",\n      \"--\",\n      paths.repository,\n      paths.destination,\n    ]);\n    await git(paths.destination, [\"remote\", \"remove\", \"origin\"]);\n    if (snapshot.state.previous !== snapshot.state.next) {\n      await git(paths.destination, [\n        \"bundle\",\n        \"verify\",\n        join(snapshot.directory, \"commits.bundle\"),\n      ]);\n      await git(paths.destination, [\n        \"bundle\",\n        \"unbundle\",\n        join(snapshot.directory, \"commits.bundle\"),\n      ]);\n    }\n    await git(paths.destination, [\"checkout\", \"--detach\", commit]);\n    await applyPatch(\n      paths.destination,\n      join(\n        snapshot.directory,\n        plan.side === \"previous\" ? \"previous.patch\" : \"remote.patch\",\n      ),\n    );\n    if (plan.side === \"previous\")\n      await applyPatch(\n        paths.destination,\n        join(snapshot.directory, \"previous-index.patch\"),\n        true,\n      );\n    const entries =\n      plan.side === \"previous\"\n        ? snapshot.state.previousExtras\n        : snapshot.state.incoming;\n    const prefix = plan.side === \"previous\" ? \"previous-files\" : \"incoming\";\n    for (const entry of entries) {\n      const to = await safeDestination(paths.destination, entry);\n      await absent(to);\n      await mkdir(dirname(to), { recursive: true, mode: 0o700 });\n      await cp(\n        await safeDestination(snapshot.directory, `${prefix}/${entry}`),\n        to,\n        {\n          dereference: false,\n          verbatimSymlinks: true,\n          force: false,\n          errorOnExist: true,\n        },\n      );\n    }\n    return {\n      directory: paths.destination,\n      commit,\n      side: plan.side,\n      staging: plan.side === \"previous\" ? \"preserved\" : \"unavailable\",\n      sourceRetained: true,\n    };\n  } catch (cause) {\n    if (!owned) throw cause;\n    throw new OutpostError(\n      \"workspace\",\n      \"Recovery restoration failed; source and partial destination retained\",\n      { destination: paths.destination, transfer: paths.directory },\n      cause,\n    );\n  } finally {\n    await snapshot.dispose();\n  }\n}\n"]}
+{"version":3,"file":"recovery-restore.js","sourceRoot":"","sources":["../../src/application/recovery-restore.ts"],"names":[],"mappings":"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","sourcesContent":["import { observedOperation } from \"../domain/observed-operation.ts\";\nimport type { ObservationHub } from \"../domain/observation.types.ts\";\nimport { createHash } from \"node:crypto\";\nimport { cp, lstat, mkdir } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { invariant, OutpostError } from \"../domain/errors.ts\";\nimport { directory, inside, safeDestination } from \"../infrastructure/files.ts\";\nimport { verificationGit as git } from \"../infrastructure/git/verification-command.ts\";\nimport { verifyRecoveryRestorability } from \"./recovery-restorability.ts\";\nimport { snapshotRecoveryTransfer } from \"./recovery-restore-snapshot.ts\";\nimport type {\n  RecoveryRestoreOptions,\n  RecoveryRestorePlan,\n  RecoveryRestoreResult,\n} from \"./recovery-restore.types.ts\";\n\nfunction planFingerprint(\n  plan: Omit<RecoveryRestorePlan, \"fingerprint\">,\n): string {\n  return createHash(\"sha256\")\n    .update(\n      JSON.stringify([\n        plan.directory,\n        plan.repository,\n        plan.destination,\n        plan.side,\n        plan.maxBytes ?? null,\n        plan.manifestSha256,\n        plan.commit,\n        plan.payloads,\n        plan.staging,\n      ]),\n    )\n    .digest(\"hex\");\n}\n\nasync function absent(path: string): Promise<void> {\n  const present = await lstat(path).then(\n    () => true,\n    (error: unknown) => {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      )\n        return false;\n      throw error;\n    },\n  );\n  invariant(!present, \"Recovery destination already exists\");\n}\n\nasync function locations(options: RecoveryRestoreOptions) {\n  invariant(\n    options.side === \"previous\" || options.side === \"incoming\",\n    \"Recovery side must be previous or incoming\",\n  );\n  const repository = await directory(options.repository);\n  const transfer = await directory(options.directory);\n  const destination = join(\n    await directory(dirname(resolve(options.destination))),\n    basename(resolve(options.destination)),\n  );\n  const common = await directory(\n    (\n      await git(repository, [\n        \"rev-parse\",\n        \"--path-format=absolute\",\n        \"--git-common-dir\",\n      ])\n    ).trim(),\n  );\n  invariant(\n    !inside(repository, destination) &&\n      !inside(transfer, destination) &&\n      !inside(common, destination),\n    \"Recovery destination must be outside the source repository, Git metadata and transfer\",\n  );\n  await absent(destination);\n  return { repository, directory: transfer, destination };\n}\n\nasync function planRecoveryRestoreOperation(\n  options: RecoveryRestoreOptions,\n): Promise<RecoveryRestorePlan> {\n  const paths = await locations(options);\n  const snapshot = await snapshotRecoveryTransfer(\n    paths.directory,\n    options.maxBytes,\n  );\n  try {\n    const checks = await verifyRecoveryRestorability(\n      snapshot.directory,\n      snapshot.state,\n      paths.repository,\n    );\n    invariant(\n      checks.every((check) => check.status === \"pass\"),\n      \"Recovery Git restorability verification failed\",\n    );\n    const plan = {\n      ...options,\n      ...paths,\n      manifestSha256: snapshot.manifestSha256,\n      commit:\n        options.side === \"previous\"\n          ? snapshot.state.previous\n          : snapshot.state.next,\n      payloads:\n        options.side === \"previous\"\n          ? snapshot.state.previousExtras\n          : snapshot.state.incoming,\n      staging:\n        options.side === \"previous\"\n          ? (\"preserved\" as const)\n          : (\"unavailable\" as const),\n    };\n    return { ...plan, fingerprint: planFingerprint(plan) };\n  } finally {\n    await snapshot.dispose();\n  }\n}\n\nasync function applyPatch(\n  checkout: string,\n  patch: string,\n  cached = false,\n): Promise<void> {\n  if (!(await lstat(patch)).size) return;\n  await git(checkout, [\n    \"apply\",\n    \"--binary\",\n    ...(cached ? [\"--cached\"] : []),\n    patch,\n  ]);\n}\n\nasync function restoreRecoveryOperation(\n  plan: RecoveryRestorePlan,\n): Promise<RecoveryRestoreResult> {\n  invariant(\n    plan.fingerprint === planFingerprint(plan),\n    \"Recovery plan changed after planning\",\n  );\n  const paths = await locations(plan);\n  invariant(\n    paths.repository === plan.repository &&\n      paths.directory === plan.directory &&\n      paths.destination === plan.destination,\n    \"Recovery plan paths changed after planning\",\n  );\n  const snapshot = await snapshotRecoveryTransfer(\n    paths.directory,\n    plan.maxBytes,\n  );\n  let owned = false;\n  try {\n    invariant(\n      snapshot.manifestSha256 === plan.manifestSha256,\n      \"Recovery transfer changed since planning\",\n    );\n    const commit =\n      plan.side === \"previous\" ? snapshot.state.previous : snapshot.state.next;\n    invariant(commit === plan.commit, \"Recovery plan commit changed\");\n    const checks = await verifyRecoveryRestorability(\n      snapshot.directory,\n      snapshot.state,\n      paths.repository,\n    );\n    invariant(\n      checks.every((check) => check.status === \"pass\"),\n      \"Recovery Git restorability verification failed\",\n    );\n    await mkdir(paths.destination, { mode: 0o700 });\n    owned = true;\n    await git(dirname(paths.destination), [\n      \"clone\",\n      \"--local\",\n      \"--no-hardlinks\",\n      \"--no-checkout\",\n      \"--\",\n      paths.repository,\n      paths.destination,\n    ]);\n    await git(paths.destination, [\"remote\", \"remove\", \"origin\"]);\n    if (snapshot.state.previous !== snapshot.state.next) {\n      await git(paths.destination, [\n        \"bundle\",\n        \"verify\",\n        join(snapshot.directory, \"commits.bundle\"),\n      ]);\n      await git(paths.destination, [\n        \"bundle\",\n        \"unbundle\",\n        join(snapshot.directory, \"commits.bundle\"),\n      ]);\n    }\n    await git(paths.destination, [\"checkout\", \"--detach\", commit]);\n    await applyPatch(\n      paths.destination,\n      join(\n        snapshot.directory,\n        plan.side === \"previous\" ? \"previous.patch\" : \"remote.patch\",\n      ),\n    );\n    if (plan.side === \"previous\")\n      await applyPatch(\n        paths.destination,\n        join(snapshot.directory, \"previous-index.patch\"),\n        true,\n      );\n    const entries =\n      plan.side === \"previous\"\n        ? snapshot.state.previousExtras\n        : snapshot.state.incoming;\n    const prefix = plan.side === \"previous\" ? \"previous-files\" : \"incoming\";\n    for (const entry of entries) {\n      const to = await safeDestination(paths.destination, entry);\n      await absent(to);\n      await mkdir(dirname(to), { recursive: true, mode: 0o700 });\n      await cp(\n        await safeDestination(snapshot.directory, `${prefix}/${entry}`),\n        to,\n        {\n          dereference: false,\n          verbatimSymlinks: true,\n          force: false,\n          errorOnExist: true,\n        },\n      );\n    }\n    return {\n      directory: paths.destination,\n      commit,\n      side: plan.side,\n      staging: plan.side === \"previous\" ? \"preserved\" : \"unavailable\",\n      sourceRetained: true,\n    };\n  } catch (cause) {\n    if (!owned) throw cause;\n    throw new OutpostError(\n      \"workspace\",\n      \"Recovery restoration failed; source and partial destination retained\",\n      { destination: paths.destination, transfer: paths.directory },\n      cause,\n    );\n  } finally {\n    await snapshot.dispose();\n  }\n}\n\nexport function planRecoveryRestore(\n  options: RecoveryRestoreOptions,\n  observation?: ObservationHub,\n): Promise<RecoveryRestorePlan> {\n  return observedOperation(observation, \"recovery\", \"restore.plan\", () =>\n    planRecoveryRestoreOperation(options),\n  );\n}\n\nexport function restoreRecoveryTransfer(\n  plan: RecoveryRestorePlan,\n  observation?: ObservationHub,\n): Promise<RecoveryRestoreResult> {\n  return observedOperation(observation, \"recovery\", \"restore.apply\", () =>\n    restoreRecoveryOperation(plan),\n  );\n}\n"]}

package/dist/application/recovery-retention.d.ts

@@ -1,5 +1,6 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
 import type { TransportStoreOptions } from "../domain/transport.types.ts";
 import type { RecoveryPruneResult, RecoveryQuotaOptions, RecoveryRetentionOptions, RecoveryRetentionPlan } from "./recovery-retention.types.ts";
-export declare function planRecoveryRetention(options: RecoveryRetentionOptions): Promise<RecoveryRetentionPlan>;
-export declare function pruneRecoveryRetention(plan: RecoveryRetentionPlan, options?: TransportStoreOptions): Promise<RecoveryPruneResult>;
 export declare function assertRecoveryQuota(options: RecoveryQuotaOptions): Promise<void>;
+export declare function planRecoveryRetention(options: RecoveryRetentionOptions, observation?: ObservationHub): Promise<RecoveryRetentionPlan>;
+export declare function pruneRecoveryRetention(plan: RecoveryRetentionPlan, options?: TransportStoreOptions, observation?: ObservationHub): Promise<RecoveryPruneResult>;