@elie-laloum/outpost 11.1.2 → 11.2.0

package/dist/application/harness-subagent.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness-subagent.js","sourceRoot":"","sources":["../../src/application/harness-subagent.ts"],"names":[],"mappings":"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","sourcesContent":["import { profilePermissions } from \"../domain/agent-profile-permissions.ts\";\nimport { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { OutpostError, recordRecovery } from \"../domain/errors.ts\";\nimport { MAX_DELEGATION_DEPTH } from \"../domain/subagent.constants.ts\";\nimport type { HarnessSubagent } from \"../domain/subagent.types.ts\";\nimport type { HarnessToolContext } from \"../domain/tool.types.ts\";\nimport { openTranscript } from \"../infrastructure/conversations/harness-transcript.ts\";\nimport type { TranscriptHandle } from \"../infrastructure/conversations/harness-transcript.types.ts\";\nimport { storageFor } from \"./agent-storage.ts\";\nimport { harnessBudget } from \"./harness-budget.ts\";\nimport { harnessHistory } from \"./harness-history.ts\";\nimport { harnessLoop } from \"./harness-loop.ts\";\nimport { withMcpTools } from \"./harness-mcp.ts\";\nimport { harnessModelProvider } from \"./harness-model-provider.ts\";\nimport type { HarnessRuntime } from \"./harness.types.ts\";\n\nexport async function runSubagent(\n  runtime: HarnessRuntime,\n  tool: HarnessSubagent,\n  input: unknown,\n  context: HarnessToolContext,\n): Promise<string> {\n  const validated = await tool.validate(input);\n  if (\"issues\" in validated)\n    throw new OutpostError(\"configuration\", validated.issues);\n  if (runtime.depth >= runtime.maxDepth)\n    throw new OutpostError(\n      \"limit\",\n      \"Harness reached its delegation depth limit\",\n      { limit: \"maxDelegationDepth\" },\n    );\n  runtime.budget.check();\n  const agent = tool.subagent;\n  const budget = harnessBudget(agent.harness.limits, runtime.budget);\n  const id = randomUUID();\n  const depth = runtime.depth + 1;\n  const store = storageFor(agent);\n  let transcript: TranscriptHandle | undefined;\n  let failure: unknown;\n  let text = \"\";\n  const lifecycle = (status: \"started\" | \"finished\" | \"failed\") =>\n    runtime.emit({\n      kind: \"subagent\",\n      id,\n      callId: context.callId,\n      name: tool.name,\n      status,\n      ...(transcript ? { conversation: transcript.id } : {}),\n    });\n  try {\n    transcript = store\n      ? await openTranscript({\n          repository: runtime.repository,\n          ...(runtime.runtimeDirectory\n            ? { runtimeDirectory: runtime.runtimeDirectory }\n            : {}),\n          ...(runtime.observation ? { observation: runtime.observation } : {}),\n          store,\n          model: agent.model.name,\n          routed: Boolean(agent.harness.routing),\n          ...(runtime.conversation\n            ? { parentConversation: runtime.conversation }\n            : {}),\n          parentCallId: context.callId,\n        })\n      : undefined;\n    lifecycle(\"started\");\n    text = await withMcpTools(\n      agent.harness,\n      context.sandbox,\n      context.signal,\n      agent.harness.tools,\n      (tools, mcp) =>\n        harnessLoop(\n          {\n            ...runtime,\n            agent,\n            observation: runtime.observation?.child({ subagentId: id }),\n            mcp,\n            budget,\n            depth,\n            maxDepth: Math.min(\n              runtime.maxDepth,\n              depth +\n                (agent.harness.limits.maxDelegationDepth ??\n                  MAX_DELEGATION_DEPTH),\n            ),\n            conversation: transcript?.id,\n            subagentId: id,\n            tools,\n            permissions: [\n              ...runtime.permissions,\n              ...profilePermissions(\n                agent.harness.profile,\n                agent.harness.mcpServers,\n              ),\n              ...(agent.harness.permissions ? [agent.harness.permissions] : []),\n            ],\n            sandbox: context.sandbox,\n            signal: context.signal,\n            modelProvider: harnessModelProvider({\n              agent,\n              signal: context.signal,\n              budget,\n              ...runtime.modelScope,\n              account: (result) => runtime.modelScope.account(result, id),\n            }),\n            emit: (event) => {\n              context.signal.throwIfAborted();\n              runtime.emit({ ...event, subagentId: event.subagentId ?? id });\n            },\n          },\n          validated.value.prompt,\n          harnessHistory(transcript),\n        ),\n    );\n    context.signal.throwIfAborted();\n  } catch (error) {\n    failure = error;\n  }\n  runtime.steering?.finish(id);\n  try {\n    if (transcript && store)\n      await store.capture(transcript.id, {\n        repository: runtime.repository,\n        ...(runtime.runtimeDirectory\n          ? { runtimeDirectory: runtime.runtimeDirectory }\n          : {}),\n        sandbox: context.sandbox,\n        staging: join(\n          runtime.runtimeDirectory ?? join(runtime.repository, \".outpost\"),\n          \"conversations\",\n          \"harness\",\n        ),\n      });\n  } catch (error) {\n    if (failure)\n      recordRecovery(failure, {\n        subagentCaptureError: error,\n        conversation: transcript?.id,\n      });\n    failure ??= error;\n  } finally {\n    await transcript?.close();\n  }\n  if (failure) {\n    if (!runtime.signal.aborted) lifecycle(\"failed\");\n    throw failure;\n  }\n  context.signal.throwIfAborted();\n  lifecycle(\"finished\");\n  return JSON.stringify({\n    text,\n    ...(transcript ? { conversation: transcript.id } : {}),\n  });\n}\n"]}
+{"version":3,"file":"harness-subagent.js","sourceRoot":"","sources":["../../src/application/harness-subagent.ts"],"names":[],"mappings":"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","sourcesContent":["import { profilePermissions } from \"../domain/agent-profile-permissions.ts\";\nimport { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { invariant, OutpostError, recordRecovery } from \"../domain/errors.ts\";\nimport { hooks, runHook } from \"./harness-hooks.ts\";\nimport { MAX_DELEGATION_DEPTH } from \"../domain/subagent.constants.ts\";\nimport type { HarnessSubagent } from \"../domain/subagent.types.ts\";\nimport type { HarnessToolContext } from \"../domain/tool.types.ts\";\nimport { openTranscript } from \"../infrastructure/conversations/harness-transcript.ts\";\nimport type { TranscriptHandle } from \"../infrastructure/conversations/harness-transcript.types.ts\";\nimport { storageFor } from \"./agent-storage.ts\";\nimport { harnessBudget } from \"./harness-budget.ts\";\nimport { harnessHistory } from \"./harness-history.ts\";\nimport { harnessLoop } from \"./harness-loop.ts\";\nimport { withMcpTools } from \"./harness-mcp.ts\";\nimport { harnessModelProvider } from \"./harness-model-provider.ts\";\nimport type { HarnessRuntime } from \"./harness.types.ts\";\n\nexport async function runSubagent(\n  runtime: HarnessRuntime,\n  tool: HarnessSubagent,\n  input: unknown,\n  context: HarnessToolContext,\n  step = 0,\n): Promise<string> {\n  const validated = await tool.validate(input);\n  if (\"issues\" in validated)\n    throw new OutpostError(\"configuration\", validated.issues);\n  if (runtime.depth >= runtime.maxDepth)\n    throw new OutpostError(\n      \"limit\",\n      \"Harness reached its delegation depth limit\",\n      { limit: \"maxDelegationDepth\" },\n    );\n  runtime.budget.check();\n  const agent = tool.subagent;\n  const budget = harnessBudget(agent.harness.limits, runtime.budget);\n  const id = randomUUID();\n  let prompt = validated.value.prompt;\n  const hookRuntime = {\n    ...runtime,\n    signal: context.signal,\n    sandbox: context.sandbox,\n  };\n  for (const hook of hooks(runtime, \"before-subagent\")) {\n    const decision = await runHook(\n      hookRuntime,\n      hook,\n      { id, name: tool.name, callId: context.callId, prompt },\n      step,\n    );\n    if (decision === undefined) continue;\n    invariant(\n      !(\"deny\" in decision),\n      \"deny\" in decision ? decision.deny : \"Subagent denied\",\n    );\n    prompt = decision.prompt;\n  }\n  const depth = runtime.depth + 1;\n  const store = storageFor(agent);\n  let transcript: TranscriptHandle | undefined;\n  let failure: unknown;\n  let text = \"\";\n  let lifecycleSettled = false;\n  const lifecycle = (status: \"started\" | \"finished\" | \"failed\") => {\n    if (lifecycleSettled) return;\n    if (status !== \"started\") lifecycleSettled = true;\n    runtime.emit({\n      kind: \"subagent\",\n      id,\n      callId: context.callId,\n      name: tool.name,\n      status,\n      ...(transcript ? { conversation: transcript.id } : {}),\n    });\n  };\n  const aborted = () => {\n    if (!runtime.signal.aborted) lifecycle(\"failed\");\n  };\n  try {\n    transcript = store\n      ? await openTranscript({\n          repository: runtime.repository,\n          ...(runtime.runtimeDirectory\n            ? { runtimeDirectory: runtime.runtimeDirectory }\n            : {}),\n          ...(runtime.observation ? { observation: runtime.observation } : {}),\n          store,\n          model: agent.model.name,\n          routed: Boolean(agent.harness.routing),\n          ...(runtime.conversation\n            ? { parentConversation: runtime.conversation }\n            : {}),\n          parentCallId: context.callId,\n        })\n      : undefined;\n    lifecycle(\"started\");\n    context.signal.addEventListener(\"abort\", aborted, { once: true });\n    if (context.signal.aborted) aborted();\n    text = await withMcpTools(\n      agent.harness,\n      context.sandbox,\n      context.signal,\n      agent.harness.tools,\n      (tools, mcp) =>\n        harnessLoop(\n          {\n            ...runtime,\n            startSource: \"start\",\n            responseInstructions: undefined,\n            agent,\n            observation: runtime.observation?.child({ subagentId: id }),\n            mcp,\n            budget,\n            depth,\n            maxDepth: Math.min(\n              runtime.maxDepth,\n              depth +\n                (agent.harness.limits.maxDelegationDepth ??\n                  MAX_DELEGATION_DEPTH),\n            ),\n            conversation: transcript?.id,\n            subagentId: id,\n            tools,\n            permissions: [\n              ...runtime.permissions,\n              ...profilePermissions(\n                agent.harness.profile,\n                agent.harness.mcpServers,\n              ),\n              ...(agent.harness.permissions ? [agent.harness.permissions] : []),\n            ],\n            sandbox: context.sandbox,\n            signal: context.signal,\n            modelProvider: harnessModelProvider({\n              agent,\n              signal: context.signal,\n              budget,\n              ...runtime.modelScope,\n              account: (result) => runtime.modelScope.account(result, id),\n            }),\n            emit: (event) => {\n              context.signal.throwIfAborted();\n              runtime.emit({ ...event, subagentId: event.subagentId ?? id });\n            },\n          },\n          prompt,\n          harnessHistory(transcript),\n        ),\n    );\n    context.signal.throwIfAborted();\n  } catch (error) {\n    failure = error;\n  }\n  runtime.steering?.finish(id);\n  try {\n    if (transcript && store)\n      await store.capture(transcript.id, {\n        repository: runtime.repository,\n        ...(runtime.runtimeDirectory\n          ? { runtimeDirectory: runtime.runtimeDirectory }\n          : {}),\n        sandbox: context.sandbox,\n        staging: join(\n          runtime.runtimeDirectory ?? join(runtime.repository, \".outpost\"),\n          \"conversations\",\n          \"harness\",\n        ),\n      });\n  } catch (error) {\n    if (failure)\n      recordRecovery(failure, {\n        subagentCaptureError: error,\n        conversation: transcript?.id,\n      });\n    failure ??= error;\n  } finally {\n    context.signal.removeEventListener(\"abort\", aborted);\n    await transcript?.close();\n  }\n  try {\n    for (const hook of hooks(runtime, \"after-subagent\")) {\n      const decision = await runHook(\n        hookRuntime,\n        hook,\n        {\n          id,\n          name: tool.name,\n          callId: context.callId,\n          ...(failure ? { error: failure } : { text }),\n          ...(transcript ? { conversation: transcript.id } : {}),\n        },\n        step,\n      );\n      if (decision === undefined) continue;\n      invariant(\n        !failure,\n        \"after-subagent cannot replace a failed subagent result\",\n      );\n      text = decision.text;\n    }\n  } catch (error) {\n    if (failure) recordRecovery(failure, { afterSubagentHookError: error });\n    failure ??= error;\n  }\n  if (failure) {\n    if (!runtime.signal.aborted && !context.signal.aborted) lifecycle(\"failed\");\n    throw failure;\n  }\n  context.signal.throwIfAborted();\n  lifecycle(\"finished\");\n  return JSON.stringify({\n    text,\n    ...(transcript ? { conversation: transcript.id } : {}),\n  });\n}\n"]}

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

@@ -10,6 +10,8 @@ import type { SandboxLease } from "../domain/sandbox.types.ts";
 import type { HarnessTool } from "../domain/tool.types.ts";
 import type { DispatchOptions, TurnContext } from "./execution.types.ts";
 export interface HarnessRuntime {
+    readonly responseInstructions?: string | undefined;
+    readonly startSource?: "start" | "resume" | "repair";
     readonly runtimeDirectory?: string;
     readonly observation?: ObservationHub | undefined;
     readonly verbose?: boolean;
@@ -49,6 +51,7 @@ export type ValidatedInput = {
     readonly outcome: ToolOutcome;
 };
 export interface ToolOutcome {
+    readonly status?: "success" | "denied" | "error";
     readonly content: string;
     readonly isError: boolean;
 }

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 { HarnessMcpContext } from \"../domain/harness.types.ts\";\nimport type { ObservationHub } from \"../domain/observation.types.ts\";\nimport type { ModelRouteEvent } from \"../domain/harness-routing.types.ts\";\nimport 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 runtimeDirectory?: string;\n  readonly observation?: ObservationHub | undefined;\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<\n    HarnessModelScope,\n    \"track\" | \"account\" | \"trackModels\"\n  >;\n  readonly agent: CustomAgent;\n  readonly tools: readonly HarnessTool[];\n  readonly modelProvider: ModelProvider;\n  readonly sandbox: SandboxLease;\n  readonly mcp?: HarnessMcpContext | undefined;\n  readonly signal: AbortSignal;\n  /** Run id of the built-in subagent this loop runs, absent for the main loop. */\n  readonly subagentId?: string | undefined;\n  /** Steering intake shared with subagents so the active loop receives instructions. */\n  readonly steering?: HarnessSteering | undefined;\n  emit(event: AgentEvent): void;\n  hold(): () => void;\n}\n\nexport interface HarnessSteering {\n  /** Delivers and returns the instructions for the main loop or the given subagent. */\n  take(subagent: string | undefined): readonly string[];\n  /** Rejects instructions still addressed to a subagent run that ended. */\n  finish(subagent: string): 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  recordRoute?(event: ModelRouteEvent): Promise<void>;\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 { HarnessMcpContext } from \"../domain/harness.types.ts\";\nimport type { ObservationHub } from \"../domain/observation.types.ts\";\nimport type { ModelRouteEvent } from \"../domain/harness-routing.types.ts\";\nimport 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 responseInstructions?: string | undefined;\n  readonly startSource?: \"start\" | \"resume\" | \"repair\";\n  readonly runtimeDirectory?: string;\n  readonly observation?: ObservationHub | undefined;\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<\n    HarnessModelScope,\n    \"track\" | \"account\" | \"trackModels\"\n  >;\n  readonly agent: CustomAgent;\n  readonly tools: readonly HarnessTool[];\n  readonly modelProvider: ModelProvider;\n  readonly sandbox: SandboxLease;\n  readonly mcp?: HarnessMcpContext | undefined;\n  readonly signal: AbortSignal;\n  /** Run id of the built-in subagent this loop runs, absent for the main loop. */\n  readonly subagentId?: string | undefined;\n  /** Steering intake shared with subagents so the active loop receives instructions. */\n  readonly steering?: HarnessSteering | undefined;\n  emit(event: AgentEvent): void;\n  hold(): () => void;\n}\n\nexport interface HarnessSteering {\n  /** Delivers and returns the instructions for the main loop or the given subagent. */\n  take(subagent: string | undefined): readonly string[];\n  /** Rejects instructions still addressed to a subagent run that ended. */\n  finish(subagent: string): 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 status?: \"success\" | \"denied\" | \"error\";\n  readonly content: string;\n  readonly isError: boolean;\n}\n\nexport interface HarnessHistory {\n  recordRoute?(event: ModelRouteEvent): Promise<void>;\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/hook-invocation.d.ts

@@ -0,0 +1,4 @@
+import type { SandboxLease } from "../domain/sandbox.types.ts";
+export declare function hookSnapshot<T>(value: T): T;
+export declare function invokeHook<T>(name: string, timeoutMs: number, parent: AbortSignal, run: (signal: AbortSignal) => T | Promise<T>): Promise<T>;
+export declare function hookSandbox(lease: SandboxLease, signal: AbortSignal): SandboxLease;

package/dist/application/hook-invocation.js

@@ -0,0 +1,59 @@
+import { OutpostError } from "../domain/errors.js";
+export function hookSnapshot(value) {
+    const copy = structuredClone(value);
+    const freeze = (entry) => {
+        if (entry === null || typeof entry !== "object" || Object.isFrozen(entry))
+            return;
+        Object.freeze(entry);
+        for (const child of Object.values(entry))
+            freeze(child);
+    };
+    freeze(copy);
+    return copy;
+}
+export async function invokeHook(name, timeoutMs, parent, run) {
+    parent.throwIfAborted();
+    const controller = new AbortController();
+    const signal = AbortSignal.any([parent, controller.signal]);
+    const timer = setTimeout(() => controller.abort(new OutpostError("timeout", `Hook ${name} exceeded ${timeoutMs} ms`)), timeoutMs);
+    let cancel = () => undefined;
+    const aborted = new Promise((_, reject) => {
+        cancel = () => reject(signal.reason);
+        signal.addEventListener("abort", cancel, { once: true });
+    });
+    try {
+        return await Promise.race([
+            Promise.resolve().then(() => run(signal)),
+            aborted,
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+        signal.removeEventListener("abort", cancel);
+        controller.abort(new OutpostError("aborted", `Hook ${name} ended`));
+    }
+}
+export function hookSandbox(lease, signal) {
+    const combine = (own) => {
+        signal.throwIfAborted();
+        return own ? AbortSignal.any([signal, own]) : signal;
+    };
+    return {
+        root: lease.root,
+        home: lease.home,
+        ...(lease.liveInput ? { liveInput: true } : {}),
+        invoke: (command) => lease.invoke({ ...command, signal: combine(command.signal) }),
+        upload: (source, destination, options = {}) => lease.upload(source, destination, {
+            ...options,
+            signal: combine(options.signal),
+        }),
+        download: (source, destination, options = {}) => lease.download(source, destination, {
+            ...options,
+            signal: combine(options.signal),
+        }),
+        release: async () => {
+            throw new OutpostError("configuration", "A hook does not own its sandbox lease");
+        },
+    };
+}
+//# sourceMappingURL=hook-invocation.js.map

package/dist/application/hook-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-invocation.js","sourceRoot":"","sources":["../../src/application/hook-invocation.ts"],"names":[],"mappings":"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","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\n\nexport function hookSnapshot<T>(value: T): T {\n  const copy = structuredClone(value);\n  const freeze = (entry: unknown): void => {\n    if (entry === null || typeof entry !== \"object\" || Object.isFrozen(entry))\n      return;\n    Object.freeze(entry);\n    for (const child of Object.values(entry)) freeze(child);\n  };\n  freeze(copy);\n  return copy;\n}\n\nexport async function invokeHook<T>(\n  name: string,\n  timeoutMs: number,\n  parent: AbortSignal,\n  run: (signal: AbortSignal) => T | Promise<T>,\n): Promise<T> {\n  parent.throwIfAborted();\n  const controller = new AbortController();\n  const signal = AbortSignal.any([parent, controller.signal]);\n  const timer = setTimeout(\n    () =>\n      controller.abort(\n        new OutpostError(\"timeout\", `Hook ${name} exceeded ${timeoutMs} ms`),\n      ),\n    timeoutMs,\n  );\n  let cancel: () => void = () => undefined;\n  const aborted = new Promise<never>((_, reject) => {\n    cancel = () => reject(signal.reason);\n    signal.addEventListener(\"abort\", cancel, { once: true });\n  });\n  try {\n    return await Promise.race([\n      Promise.resolve().then(() => run(signal)),\n      aborted,\n    ]);\n  } finally {\n    clearTimeout(timer);\n    signal.removeEventListener(\"abort\", cancel);\n    controller.abort(new OutpostError(\"aborted\", `Hook ${name} ended`));\n  }\n}\n\nexport function hookSandbox(\n  lease: SandboxLease,\n  signal: AbortSignal,\n): SandboxLease {\n  const combine = (own?: AbortSignal) => {\n    signal.throwIfAborted();\n    return own ? AbortSignal.any([signal, own]) : signal;\n  };\n  return {\n    root: lease.root,\n    home: lease.home,\n    ...(lease.liveInput ? { liveInput: true } : {}),\n    invoke: (command) =>\n      lease.invoke({ ...command, signal: combine(command.signal) }),\n    upload: (source, destination, options = {}) =>\n      lease.upload(source, destination, {\n        ...options,\n        signal: combine(options.signal),\n      }),\n    download: (source, destination, options = {}) =>\n      lease.download(source, destination, {\n        ...options,\n        signal: combine(options.signal),\n      }),\n    release: async () => {\n      throw new OutpostError(\n        \"configuration\",\n        \"A hook does not own its sandbox lease\",\n      );\n    },\n  };\n}\n"]}

package/dist/application/queue-worker.js

@@ -1,6 +1,6 @@
 import { setTimeout as delay } from "node:timers/promises";
 import { queueMaxStringLength, queueDefaultLeaseMs, queueDefaultPollMs, } from "../domain/task-queue.constants.js";
-import { queueLeaseMs, queueNumber, queueString, queueResult, } from "../domain/task-queue.js";
+import { queueLeaseMs, queueNumber, queueClaim, queueResult, } from "../domain/task-queue.js";
 import { recoveryDetails } from "../domain/errors.js";
 import { quotaFault } from "../domain/quota.js";
 export async function runQueueWorker(options) {
@@ -8,11 +8,24 @@ export async function runQueueWorker(options) {
     const pollMs = queueNumber(options.pollMs ?? queueDefaultPollMs);
     if (!pollMs)
         throw new Error("Worker poll interval must be positive");
+    if (options.onError !== undefined && typeof options.onError !== "function")
+        throw new Error("Worker onError must be a function");
     const handlers = new Map(Object.entries(options.handlers));
     if (!handlers.size ||
         [...handlers.values()].some((handler) => typeof handler !== "function"))
         throw new Error("Worker requires trusted handlers");
-    const worker = queueString(options.worker);
+    const claim = queueClaim({
+        worker: options.worker,
+        handlers: [...handlers.keys()],
+        leaseMs,
+    });
+    const worker = claim.worker;
+    function report(error) {
+        try {
+            options.onError?.(error);
+        }
+        catch { }
+    }
     async function execute(job) {
         if (options.signal.aborted)
             return;
@@ -29,8 +42,10 @@ export async function runQueueWorker(options) {
                 }
             }
             catch (error) {
-                if (!signal.aborted)
+                if (!signal.aborted) {
+                    report(error);
                     stop.abort(error);
+                }
             }
         })();
         try {
@@ -63,8 +78,32 @@ export async function runQueueWorker(options) {
                         : {}),
                 };
             }
+            while (!signal.aborted) {
+                try {
+                    await options.queue.complete(lease, result);
+                    return;
+                }
+                catch (error) {
+                    report(error);
+                    try {
+                        const current = await options.queue.get(job.id);
+                        if (!current ||
+                            current.status !== "active" ||
+                            current.worker !== worker ||
+                            current.fence !== job.fence ||
+                            (current.expires ?? 0) <= Date.now())
+                            return;
+                    }
+                    catch (error) {
+                        report(error);
+                    }
+                    await delay(pollMs, undefined, { signal });
+                }
+            }
+        }
+        catch (error) {
             if (!signal.aborted)
-                await options.queue.complete(lease, result);
+                throw error;
         }
         finally {
             stop.abort();
@@ -73,11 +112,14 @@ export async function runQueueWorker(options) {
     }
     try {
         while (!options.signal.aborted) {
-            const job = await options.queue.claim({
-                worker,
-                handlers: [...handlers.keys()],
-                leaseMs,
-            });
+            let job;
+            try {
+                job = await options.queue.claim(claim);
+            }
+            catch (error) {
+                if (!options.signal.aborted)
+                    report(error);
+            }
             if (job) {
                 await execute(job);
                 continue;

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\";\nimport { recoveryDetails } from \"../domain/errors.ts\";\nimport { quotaFault } from \"../domain/quota.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, {\n            signal,\n            job,\n            idempotencyKey: job.idempotencyKey ?? job.id,\n          }),\n        );\n      } catch (error) {\n        const quota = quotaFault(error);\n        const captured =\n          typeof recoveryDetails(error)?.transcript === \"string\" &&\n          quota?.conversation !== undefined &&\n          quota.conversation.length <= queueMaxStringLength;\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          ...(quota\n            ? {\n                quota: {\n                  ...(quota.resetAt ? { resetAt: quota.resetAt } : {}),\n                  ...(captured ? { conversation: quota.conversation } : {}),\n                },\n              }\n            : {}),\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":"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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  queueClaim,\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\";\nimport { recoveryDetails } from \"../domain/errors.ts\";\nimport { quotaFault } from \"../domain/quota.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  if (options.onError !== undefined && typeof options.onError !== \"function\")\n    throw new Error(\"Worker onError must be a function\");\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 claim = queueClaim({\n    worker: options.worker,\n    handlers: [...handlers.keys()],\n    leaseMs,\n  });\n  const worker = claim.worker;\n  function report(error: unknown) {\n    try {\n      options.onError?.(error);\n    } catch {}\n  }\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) {\n          report(error);\n          stop.abort(error);\n        }\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, {\n            signal,\n            job,\n            idempotencyKey: job.idempotencyKey ?? job.id,\n          }),\n        );\n      } catch (error) {\n        const quota = quotaFault(error);\n        const captured =\n          typeof recoveryDetails(error)?.transcript === \"string\" &&\n          quota?.conversation !== undefined &&\n          quota.conversation.length <= queueMaxStringLength;\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          ...(quota\n            ? {\n                quota: {\n                  ...(quota.resetAt ? { resetAt: quota.resetAt } : {}),\n                  ...(captured ? { conversation: quota.conversation } : {}),\n                },\n              }\n            : {}),\n        };\n      }\n      while (!signal.aborted) {\n        try {\n          await options.queue.complete(lease, result);\n          return;\n        } catch (error) {\n          report(error);\n          try {\n            const current = await options.queue.get(job.id);\n            if (\n              !current ||\n              current.status !== \"active\" ||\n              current.worker !== worker ||\n              current.fence !== job.fence ||\n              (current.expires ?? 0) <= Date.now()\n            )\n              return;\n          } catch (error) {\n            report(error);\n          }\n          await delay(pollMs, undefined, { signal });\n        }\n      }\n    } catch (error) {\n      if (!signal.aborted) throw error;\n    } finally {\n      stop.abort();\n      await heartbeat;\n    }\n  }\n  try {\n    while (!options.signal.aborted) {\n      let job: QueueJob | undefined;\n      try {\n        job = await options.queue.claim(claim);\n      } catch (error) {\n        if (!options.signal.aborted) report(error);\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

@@ -13,4 +13,5 @@ export interface QueueWorkerOptions {
     readonly signal: AbortSignal;
     readonly leaseMs?: number;
     readonly pollMs?: number;
+    readonly onError?: (error: unknown) => void;
 }

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 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"]}
+{"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  readonly onError?: (error: unknown) => void;\n}\n"]}