@elie-laloum/outpost 4.2.0 → 5.0.0

package/dist/adapters/tools/tools.types.d.ts

@@ -0,0 +1,41 @@
+import type { GIT_READ_COMMANDS } from "./tools.constants.ts";
+export interface ReadFileInput {
+    readonly path: string;
+    readonly offset?: number;
+    readonly limit?: number;
+}
+export interface ListFilesInput {
+    readonly path?: string;
+    readonly pattern?: string;
+}
+export interface WriteFileInput {
+    readonly path: string;
+    readonly content: string;
+}
+export interface EditFileInput {
+    readonly path: string;
+    readonly old_text: string;
+    readonly new_text: string;
+    readonly replace_all?: boolean;
+}
+export interface SearchInput {
+    readonly pattern: string;
+    readonly path?: string;
+    readonly glob?: string;
+    readonly ignore_case?: boolean;
+    readonly max_results?: number;
+}
+export interface ShellInput {
+    readonly command: string;
+}
+export interface GitInput {
+    readonly command: (typeof GIT_READ_COMMANDS)[number];
+    readonly arguments?: readonly string[];
+}
+export interface ShellToolsOptions {
+    readonly deadlineMs?: number;
+}
+export interface SandboxFile {
+    readonly staged: string;
+    readonly bytes: Buffer;
+}

package/dist/adapters/tools/tools.types.js

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

package/dist/adapters/tools/tools.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.types.js","sourceRoot":"","sources":["../../../src/adapters/tools/tools.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { GIT_READ_COMMANDS } from \"./tools.constants.ts\";\n\nexport interface ReadFileInput {\n  readonly path: string;\n  readonly offset?: number;\n  readonly limit?: number;\n}\n\nexport interface ListFilesInput {\n  readonly path?: string;\n  readonly pattern?: string;\n}\n\nexport interface WriteFileInput {\n  readonly path: string;\n  readonly content: string;\n}\n\nexport interface EditFileInput {\n  readonly path: string;\n  readonly old_text: string;\n  readonly new_text: string;\n  readonly replace_all?: boolean;\n}\n\nexport interface SearchInput {\n  readonly pattern: string;\n  readonly path?: string;\n  readonly glob?: string;\n  readonly ignore_case?: boolean;\n  readonly max_results?: number;\n}\n\nexport interface ShellInput {\n  readonly command: string;\n}\n\nexport interface GitInput {\n  readonly command: (typeof GIT_READ_COMMANDS)[number];\n  readonly arguments?: readonly string[];\n}\n\nexport interface ShellToolsOptions {\n  readonly deadlineMs?: number;\n}\n\nexport interface SandboxFile {\n  readonly staged: string;\n  readonly bytes: Buffer;\n}\n"]}

package/dist/application/activity-watchdog.js

@@ -4,18 +4,19 @@ import { notify } from "./observation.js";
 export function activityWatchdog(controller, options, pass) {
     let idle, settle;
     let lastActivity = Date.now();
+    let holds = 0;
     const refresh = (completed) => {
         lastActivity = Date.now();
         clearTimeout(idle);
         clearTimeout(settle);
-        if (!completed)
+        if (!completed && holds === 0)
             idle = setTimeout(() => controller.abort(new OutpostError("timeout", "Agent produced no output before the idle deadline")), options.idleMs ?? executionDefaults.idleMs);
         if (completed)
             settle = setTimeout(() => controller.abort("completion"), options.settleMs ?? executionDefaults.settleMs);
     };
     const warningInterval = options.idleWarningMs ?? executionDefaults.idleWarningMs;
     const warnings = setInterval(() => {
-        if (Date.now() - lastActivity >= warningInterval) {
+        if (holds === 0 && Date.now() - lastActivity >= warningInterval) {
             const message = `Agent has been idle for ${Math.floor((Date.now() - lastActivity) / 1000)} seconds`;
             notify(options.warn, message);
             notify(options.observe, {
@@ -28,6 +29,18 @@ export function activityWatchdog(controller, options, pass) {
     }, warningInterval);
     return {
         refresh,
+        hold() {
+            holds++;
+            refresh(false);
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                holds--;
+                refresh(false);
+            };
+        },
         close() {
             clearTimeout(idle);
             clearTimeout(settle);

package/dist/application/activity-watchdog.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity-watchdog.js","sourceRoot":"","sources":["../../src/application/activity-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAC9B,UAA2B,EAC3B,OAAiC,EACjC,IAAY;IAEZ,IAAI,IAAgC,EAAE,MAAkC,CAAC;IACzE,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,SAAkB,EAAE,EAAE;QACrC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS;YACZ,IAAI,GAAG,UAAU,CACf,GAAG,EAAE,CACH,UAAU,CAAC,KAAK,CACd,IAAI,YAAY,CACd,SAAS,EACT,mDAAmD,CACpD,CACF,EACH,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAC3C,CAAC;QACJ,IAAI,SAAS;YACX,MAAM,GAAG,UAAU,CACjB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,EACpC,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAC/C,CAAC;IACN,CAAC,CAAC;IAEF,MAAM,eAAe,GACnB,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC,aAAa,CAAC;IAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,IAAI,eAAe,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,2BAA2B,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YACpG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE;gBACtB,IAAI,EAAE,SAAS;gBACf,OAAO;gBACP,IAAI;gBACJ,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,eAAe,CAAC,CAAC;IAEpB,OAAO;QACL,OAAO;QACP,KAAK;YACH,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { ActivityWatchdog, DispatchOptions } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function activityWatchdog(\n  controller: AbortController,\n  options: DispatchOptions<unknown>,\n  pass: number,\n): ActivityWatchdog {\n  let idle: NodeJS.Timeout | undefined, settle: NodeJS.Timeout | undefined;\n  let lastActivity = Date.now();\n  const refresh = (completed: boolean) => {\n    lastActivity = Date.now();\n    clearTimeout(idle);\n    clearTimeout(settle);\n    if (!completed)\n      idle = setTimeout(\n        () =>\n          controller.abort(\n            new OutpostError(\n              \"timeout\",\n              \"Agent produced no output before the idle deadline\",\n            ),\n          ),\n        options.idleMs ?? executionDefaults.idleMs,\n      );\n    if (completed)\n      settle = setTimeout(\n        () => controller.abort(\"completion\"),\n        options.settleMs ?? executionDefaults.settleMs,\n      );\n  };\n\n  const warningInterval =\n    options.idleWarningMs ?? executionDefaults.idleWarningMs;\n  const warnings = setInterval(() => {\n    if (Date.now() - lastActivity >= warningInterval) {\n      const message = `Agent has been idle for ${Math.floor((Date.now() - lastActivity) / 1000)} seconds`;\n      notify(options.warn, message);\n      notify(options.observe, {\n        kind: \"warning\",\n        message,\n        pass,\n        at: new Date().toISOString(),\n      });\n    }\n  }, warningInterval);\n\n  return {\n    refresh,\n    close() {\n      clearTimeout(idle);\n      clearTimeout(settle);\n      clearInterval(warnings);\n    },\n  };\n}\n"]}
+{"version":3,"file":"activity-watchdog.js","sourceRoot":"","sources":["../../src/application/activity-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAC9B,UAA2B,EAC3B,OAAiC,EACjC,IAAY;IAEZ,IAAI,IAAgC,EAAE,MAAkC,CAAC;IACzE,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,CAAC,SAAkB,EAAE,EAAE;QACrC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,IAAI,KAAK,KAAK,CAAC;YAC3B,IAAI,GAAG,UAAU,CACf,GAAG,EAAE,CACH,UAAU,CAAC,KAAK,CACd,IAAI,YAAY,CACd,SAAS,EACT,mDAAmD,CACpD,CACF,EACH,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAC3C,CAAC;QACJ,IAAI,SAAS;YACX,MAAM,GAAG,UAAU,CACjB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,EACpC,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAC/C,CAAC;IACN,CAAC,CAAC;IAEF,MAAM,eAAe,GACnB,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC,aAAa,CAAC;IAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,IAAI,eAAe,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,2BAA2B,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YACpG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE;gBACtB,IAAI,EAAE,SAAS;gBACf,OAAO;gBACP,IAAI;gBACJ,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,eAAe,CAAC,CAAC;IAEpB,OAAO;QACL,OAAO;QACP,IAAI;YACF,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC;QACJ,CAAC;QACD,KAAK;YACH,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { ActivityWatchdog, DispatchOptions } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function activityWatchdog(\n  controller: AbortController,\n  options: DispatchOptions<unknown>,\n  pass: number,\n): ActivityWatchdog {\n  let idle: NodeJS.Timeout | undefined, settle: NodeJS.Timeout | undefined;\n  let lastActivity = Date.now();\n  let holds = 0;\n  const refresh = (completed: boolean) => {\n    lastActivity = Date.now();\n    clearTimeout(idle);\n    clearTimeout(settle);\n    if (!completed && holds === 0)\n      idle = setTimeout(\n        () =>\n          controller.abort(\n            new OutpostError(\n              \"timeout\",\n              \"Agent produced no output before the idle deadline\",\n            ),\n          ),\n        options.idleMs ?? executionDefaults.idleMs,\n      );\n    if (completed)\n      settle = setTimeout(\n        () => controller.abort(\"completion\"),\n        options.settleMs ?? executionDefaults.settleMs,\n      );\n  };\n\n  const warningInterval =\n    options.idleWarningMs ?? executionDefaults.idleWarningMs;\n  const warnings = setInterval(() => {\n    if (holds === 0 && Date.now() - lastActivity >= warningInterval) {\n      const message = `Agent has been idle for ${Math.floor((Date.now() - lastActivity) / 1000)} seconds`;\n      notify(options.warn, message);\n      notify(options.observe, {\n        kind: \"warning\",\n        message,\n        pass,\n        at: new Date().toISOString(),\n      });\n    }\n  }, warningInterval);\n\n  return {\n    refresh,\n    hold() {\n      holds++;\n      refresh(false);\n      let released = false;\n      return () => {\n        if (released) return;\n        released = true;\n        holds--;\n        refresh(false);\n      };\n    },\n    close() {\n      clearTimeout(idle);\n      clearTimeout(settle);\n      clearInterval(warnings);\n    },\n  };\n}\n"]}

package/dist/application/agent-bootstrap.d.ts

@@ -1,3 +1,3 @@
-import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { Agent } from "../domain/agent.types.ts";
 import type { SandboxLease } from "../domain/sandbox.types.ts";
-export declare function prepareAdapter(agent: AgentAdapter, runtime: SandboxLease, signal: AbortSignal): Promise<AgentAdapter>;
+export declare function prepareAdapter(agent: Agent, runtime: SandboxLease, signal: AbortSignal): Promise<Agent>;

package/dist/application/agent-bootstrap.js

@@ -6,6 +6,8 @@ function isBootstrapAgent(name) {
     return Object.hasOwn(agentPackages, name);
 }
 export async function prepareAdapter(agent, runtime, signal) {
+    if (agent.kind !== "cli")
+        return agent;
     const executable = agent.bootstrap ?? agent.conversations;
     if (!executable)
         return agent;

package/dist/application/agent-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-bootstrap.js","sourceRoot":"","sources":["../../src/application/agent-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAmB,EACnB,OAAqB,EACrB,MAAmB;IAEnB,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC;IAC1D,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,SAAS,CACP,gBAAgB,CAAC,UAAU,CAAC,EAC5B,4BAA4B,UAAU,EAAE,CACzC,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACvD,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC;QACE,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE;YACT,IAAI;YACJ,iBAAiB,UAAU,qCAAqC,UAAU,kBAAkB,KAAK,CAAC,MAAM,CAAC,yBAAyB,KAAK,CAAC,MAAM,CAAC,kFAAkF,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,0BAA0B,KAAK,CAAC,MAAM,CAAC,MAAM;SACnS;QACD,MAAM;KACP,EACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAC7B,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,SAAS,CACP,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChD,qDAAqD,CACtD,CAAC;IACF,OAAO;QACL,GAAG,KAAK;QACR,OAAO,CAAC,KAAK;YACX,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { posix } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { quote, requireSuccess } from \"../infrastructure/process.ts\";\nimport { agentPackages } from \"./agent-bootstrap.constants.ts\";\n\nfunction isBootstrapAgent(name: string): name is keyof typeof agentPackages {\n  return Object.hasOwn(agentPackages, name);\n}\n\nexport async function prepareAdapter(\n  agent: AgentAdapter,\n  runtime: SandboxLease,\n  signal: AbortSignal,\n): Promise<AgentAdapter> {\n  const executable = agent.bootstrap ?? agent.conversations;\n  if (!executable) return agent;\n  invariant(\n    isBootstrapAgent(executable),\n    `Unknown agent bootstrap: ${executable}`,\n  );\n  const cli = agentPackages[executable];\n  const prefix = posix.join(runtime.home, \".outpost-tools\"),\n    target = posix.join(prefix, \"bin\", executable);\n  const installed = await requireSuccess(\n    {\n      executable: \"sh\",\n      arguments: [\n        \"-c\",\n        `if command -v ${executable} >/dev/null 2>&1; then command -v ${executable}; elif test -x ${quote(target)}; then printf '%s\\\\n' ${quote(target)}; else npm install --global --allow-scripts=@anthropic-ai/claude-code --prefix ${quote(prefix)} ${cli} >&2 && printf '%s\\\\n' ${quote(target)}; fi`,\n      ],\n      signal,\n    },\n    runtime.invoke.bind(runtime),\n  );\n  const binary = installed.stdout.trim();\n  invariant(\n    binary.startsWith(\"/\") && !binary.includes(\"\\n\"),\n    \"Agent bootstrap returned an invalid executable path\",\n  );\n  return {\n    ...agent,\n    request(input) {\n      return { ...agent.request(input), executable: binary };\n    },\n  };\n}\n"]}
+{"version":3,"file":"agent-bootstrap.js","sourceRoot":"","sources":["../../src/application/agent-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAY,EACZ,OAAqB,EACrB,MAAmB;IAEnB,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC;IAC1D,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,SAAS,CACP,gBAAgB,CAAC,UAAU,CAAC,EAC5B,4BAA4B,UAAU,EAAE,CACzC,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACvD,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC;QACE,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE;YACT,IAAI;YACJ,iBAAiB,UAAU,qCAAqC,UAAU,kBAAkB,KAAK,CAAC,MAAM,CAAC,yBAAyB,KAAK,CAAC,MAAM,CAAC,kFAAkF,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,0BAA0B,KAAK,CAAC,MAAM,CAAC,MAAM;SACnS;QACD,MAAM;KACP,EACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAC7B,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,SAAS,CACP,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChD,qDAAqD,CACtD,CAAC;IACF,OAAO;QACL,GAAG,KAAK;QACR,OAAO,CAAC,KAAK;YACX,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { posix } from \"node:path\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { quote, requireSuccess } from \"../infrastructure/process.ts\";\nimport { agentPackages } from \"./agent-bootstrap.constants.ts\";\n\nfunction isBootstrapAgent(name: string): name is keyof typeof agentPackages {\n  return Object.hasOwn(agentPackages, name);\n}\n\nexport async function prepareAdapter(\n  agent: Agent,\n  runtime: SandboxLease,\n  signal: AbortSignal,\n): Promise<Agent> {\n  if (agent.kind !== \"cli\") return agent;\n  const executable = agent.bootstrap ?? agent.conversations;\n  if (!executable) return agent;\n  invariant(\n    isBootstrapAgent(executable),\n    `Unknown agent bootstrap: ${executable}`,\n  );\n  const cli = agentPackages[executable];\n  const prefix = posix.join(runtime.home, \".outpost-tools\"),\n    target = posix.join(prefix, \"bin\", executable);\n  const installed = await requireSuccess(\n    {\n      executable: \"sh\",\n      arguments: [\n        \"-c\",\n        `if command -v ${executable} >/dev/null 2>&1; then command -v ${executable}; elif test -x ${quote(target)}; then printf '%s\\\\n' ${quote(target)}; else npm install --global --allow-scripts=@anthropic-ai/claude-code --prefix ${quote(prefix)} ${cli} >&2 && printf '%s\\\\n' ${quote(target)}; fi`,\n      ],\n      signal,\n    },\n    runtime.invoke.bind(runtime),\n  );\n  const binary = installed.stdout.trim();\n  invariant(\n    binary.startsWith(\"/\") && !binary.includes(\"\\n\"),\n    \"Agent bootstrap returned an invalid executable path\",\n  );\n  return {\n    ...agent,\n    request(input) {\n      return { ...agent.request(input), executable: binary };\n    },\n  };\n}\n"]}

package/dist/application/agent-storage.d.ts

@@ -1,2 +1,3 @@
-import type { AgentAdapter } from "../domain/agent.types.ts";
-export declare const storageFor: (agent: AgentAdapter) => import("../index.ts").ConversationStore | undefined;
+import type { Agent } from "../domain/agent.types.ts";
+import type { ConversationStore } from "../domain/conversation.types.ts";
+export declare const storageFor: (agent: Agent) => ConversationStore | undefined;

package/dist/application/agent-storage.js

@@ -1,4 +1,11 @@
+import { harnessConversations } from "../infrastructure/conversations/harness-store.js";
 import { nativeConversations } from "../infrastructure/conversations/native-store.js";
-export const storageFor = (agent) => agent.storage ??
-    (agent.conversations ? nativeConversations(agent.conversations) : undefined);
+export const storageFor = (agent) => agent.storage ?? defaultStorage(agent);
+function defaultStorage(agent) {
+    if (agent.kind === "custom")
+        return agent.resumable ? harnessConversations() : undefined;
+    return agent.conversations
+        ? nativeConversations(agent.conversations)
+        : undefined;
+}
 //# sourceMappingURL=agent-storage.js.map

package/dist/application/agent-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-storage.js","sourceRoot":"","sources":["../../src/application/agent-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAEtF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAE,EAAE,CAChD,KAAK,CAAC,OAAO;IACb,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC","sourcesContent":["import type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { nativeConversations } from \"../infrastructure/conversations/native-store.ts\";\n\nexport const storageFor = (agent: AgentAdapter) =>\n  agent.storage ??\n  (agent.conversations ? nativeConversations(agent.conversations) : undefined);\n"]}
+{"version":3,"file":"agent-storage.js","sourceRoot":"","sources":["../../src/application/agent-storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAEtF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAY,EAAiC,EAAE,CACxE,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AAEzC,SAAS,cAAc,CAAC,KAAY;IAClC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QACzB,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,OAAO,KAAK,CAAC,aAAa;QACxB,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC","sourcesContent":["import type { Agent } from \"../domain/agent.types.ts\";\nimport type { ConversationStore } from \"../domain/conversation.types.ts\";\nimport { harnessConversations } from \"../infrastructure/conversations/harness-store.ts\";\nimport { nativeConversations } from \"../infrastructure/conversations/native-store.ts\";\n\nexport const storageFor = (agent: Agent): ConversationStore | undefined =>\n  agent.storage ?? defaultStorage(agent);\n\nfunction defaultStorage(agent: Agent): ConversationStore | undefined {\n  if (agent.kind === \"custom\")\n    return agent.resumable ? harnessConversations() : undefined;\n  return agent.conversations\n    ? nativeConversations(agent.conversations)\n    : undefined;\n}\n"]}

package/dist/application/agent-turn.d.ts

@@ -1,4 +1,4 @@
-import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { Agent } from "../domain/agent.types.ts";
 import type { SandboxLease } from "../domain/sandbox.types.ts";
-import type { DispatchOptions, Turn } from "./execution.types.ts";
-export declare function turn(lease: SandboxLease, agent: AgentAdapter, prompt: string, options: DispatchOptions<unknown>, continuation: DispatchOptions["continuation"], markers: readonly string[], pass: number): Promise<Turn>;
+import type { DispatchOptions, Turn, TurnContext } from "./execution.types.ts";
+export declare function turn(lease: SandboxLease, agent: Agent, prompt: string, options: DispatchOptions<unknown>, continuation: DispatchOptions["continuation"], markers: readonly string[], pass: number, context: TurnContext): Promise<Turn>;

package/dist/application/agent-turn.js

@@ -1,9 +1,15 @@
+import { customTurn } from "./custom-turn.js";
 import { OutpostError } from "../domain/errors.js";
 import { activityWatchdog } from "./activity-watchdog.js";
 import { agentOutput } from "./agent-output.js";
 import { executionDefaults } from "./execution.constants.js";
 import { notify } from "./observation.js";
-export async function turn(lease, agent, prompt, options, continuation, markers, pass) {
+export async function turn(lease, agent, prompt, options, continuation, markers, pass, context) {
+    if (agent.kind === "custom")
+        return customTurn(lease, agent, prompt, options, pass, {
+            ...context,
+            continuation,
+        });
     const start = Date.now();
     const controller = new AbortController();
     const signal = options.signal

package/dist/application/agent-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../src/application/agent-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { activityWatchdog } from \"./activity-watchdog.ts\";\nimport { agentOutput } from \"./agent-output.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Turn } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport async function turn(\n  lease: SandboxLease,\n  agent: AgentAdapter,\n  prompt: string,\n  options: DispatchOptions<unknown>,\n  continuation: DispatchOptions[\"continuation\"],\n  markers: readonly string[],\n  pass: number,\n): Promise<Turn> {\n  const start = Date.now();\n  const controller = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n  const output = agentOutput(agent, options, markers, pass);\n  const watchdog = activityWatchdog(controller, options, pass);\n  watchdog.refresh(false);\n  let status = 0;\n  try {\n    const command = agent.request({\n      text: prompt,\n      ...(continuation ? { continuation } : {}),\n    });\n    const result = await lease.invoke({\n      ...command,\n      signal,\n      deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,\n      observe(channel, chunk) {\n        if (channel === \"stdout\") {\n          try {\n            output.append(chunk);\n          } catch (cause) {\n            controller.abort(cause);\n          }\n        }\n        watchdog.refresh(output.completed);\n      },\n    });\n    status = result.status;\n    output.flush();\n    if (status !== 0)\n      throw new OutpostError(\"process\", `Agent exited with status ${status}`, {\n        ...result,\n        conversation: output.conversation,\n      });\n  } catch (cause) {\n    options.signal?.throwIfAborted();\n    if (controller.signal.reason !== \"completion\")\n      throw controller.signal.reason instanceof OutpostError\n        ? controller.signal.reason\n        : cause;\n    notify(\n      options.warn,\n      \"Agent remained active after completion; its command was stopped and trailing output retained\",\n    );\n  } finally {\n    watchdog.close();\n  }\n  return { ...output.result(), status, durationMs: Date.now() - start };\n}\n"]}
+{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../src/application/agent-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import { customTurn } from \"./custom-turn.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { activityWatchdog } from \"./activity-watchdog.ts\";\nimport { agentOutput } from \"./agent-output.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Turn, TurnContext } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport async function turn(\n  lease: SandboxLease,\n  agent: Agent,\n  prompt: string,\n  options: DispatchOptions<unknown>,\n  continuation: DispatchOptions[\"continuation\"],\n  markers: readonly string[],\n  pass: number,\n  context: TurnContext,\n): Promise<Turn> {\n  if (agent.kind === \"custom\")\n    return customTurn(lease, agent, prompt, options, pass, {\n      ...context,\n      continuation,\n    });\n  const start = Date.now();\n  const controller = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n  const output = agentOutput(agent, options, markers, pass);\n  const watchdog = activityWatchdog(controller, options, pass);\n  watchdog.refresh(false);\n  let status = 0;\n  try {\n    const command = agent.request({\n      text: prompt,\n      ...(continuation ? { continuation } : {}),\n    });\n    const result = await lease.invoke({\n      ...command,\n      signal,\n      deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,\n      observe(channel, chunk) {\n        if (channel === \"stdout\") {\n          try {\n            output.append(chunk);\n          } catch (cause) {\n            controller.abort(cause);\n          }\n        }\n        watchdog.refresh(output.completed);\n      },\n    });\n    status = result.status;\n    output.flush();\n    if (status !== 0)\n      throw new OutpostError(\"process\", `Agent exited with status ${status}`, {\n        ...result,\n        conversation: output.conversation,\n      });\n  } catch (cause) {\n    options.signal?.throwIfAborted();\n    if (controller.signal.reason !== \"completion\")\n      throw controller.signal.reason instanceof OutpostError\n        ? controller.signal.reason\n        : cause;\n    notify(\n      options.warn,\n      \"Agent remained active after completion; its command was stopped and trailing output retained\",\n    );\n  } finally {\n    watchdog.close();\n  }\n  return { ...output.result(), status, durationMs: Date.now() - start };\n}\n"]}

package/dist/application/attach.js

@@ -7,6 +7,7 @@ import { completeBrief } from "./interactive-brief.js";
 import { createSandbox } from "./sandbox.js";
 export async function attach(options) {
     options.signal?.throwIfAborted();
+    invariant(options.agent.kind === "cli", "This harness does not support interactive attachment");
     validateBrief(options.brief, true);
     const brief = await completeBrief(options.brief, options.signal, options.ask);
     if (brief)

package/dist/application/attach.js.map

@@ -1 +1 @@
-{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/application/attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAMvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAuD;IAEvD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9E,IAAI,KAAK;QAAE,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,SAAS,CAAC,OAAO,EAAE,oDAAoD,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,MAAM,CAClB,OAAO,CAAC,YAAY,CAAC,EAAE,EACvB,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EACpE,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,CACf,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAC9D,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,OAAO,CAAC,SAAS,CAAC,SAAS,EAC3B,QAAQ,EACR,OAAO,CAAC,MAAM,EAAE,SAAS,CAC1B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO;YACL,GAAG,MAAM;YACT,GAAG,QAAQ;YACX,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;YACtC,OAAO,EAAE,OAAO;SACjB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,UAAU;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC","sourcesContent":["import type { RequiredAgent } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { commits } from \"../infrastructure/git/history.ts\";\nimport { storageFor } from \"./agent-storage.ts\";\nimport { completeBrief } from \"./interactive-brief.ts\";\nimport type {\n  AttachOptions,\n  AttachResult,\n  SandboxOptions,\n} from \"./outpost.types.ts\";\nimport { createSandbox } from \"./sandbox.ts\";\n\nexport async function attach(\n  options: SandboxOptions & AttachOptions & RequiredAgent,\n): Promise<AttachResult> {\n  options.signal?.throwIfAborted();\n  validateBrief(options.brief, true);\n  const brief = await completeBrief(options.brief, options.signal, options.ask);\n  if (brief) options = { ...options, brief };\n  if (options.continuation) {\n    const storage = storageFor(options.agent);\n    invariant(storage, \"This adapter does not support native conversations\");\n    await storage.locate(\n      options.continuation.id,\n      options.workspace?.repository ?? options.repository ?? process.cwd(),\n      options.conversationHome,\n    );\n  }\n  const sandbox = await createSandbox(options);\n  let successful = false;\n  try {\n    const baseline = (\n      await git(sandbox.workspace.directory, [\"rev-parse\", \"HEAD\"])\n    ).trim();\n    const result = await sandbox.attach(options);\n    const changes = await commits(\n      sandbox.workspace.directory,\n      baseline,\n      options.limits?.collectMs,\n    );\n    if (result.status === 0) await sandbox.workspace.integrate();\n    const disposal = await sandbox.close({ preserve: result.status !== 0 });\n    successful = true;\n    return {\n      ...result,\n      ...disposal,\n      branch: sandbox.workspace.branch,\n      directory: sandbox.workspace.directory,\n      commits: changes,\n    };\n  } finally {\n    if (!successful) await sandbox.close({ preserve: true });\n  }\n}\n"]}
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/application/attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAMvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAuD;IAEvD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,SAAS,CACP,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,EAC5B,sDAAsD,CACvD,CAAC;IACF,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9E,IAAI,KAAK;QAAE,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,SAAS,CAAC,OAAO,EAAE,oDAAoD,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,MAAM,CAClB,OAAO,CAAC,YAAY,CAAC,EAAE,EACvB,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EACpE,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,CACf,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAC9D,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,OAAO,CAAC,SAAS,CAAC,SAAS,EAC3B,QAAQ,EACR,OAAO,CAAC,MAAM,EAAE,SAAS,CAC1B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO;YACL,GAAG,MAAM;YACT,GAAG,QAAQ;YACX,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;YACtC,OAAO,EAAE,OAAO;SACjB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,UAAU;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC","sourcesContent":["import type { RequiredAgent } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { git } from \"../infrastructure/git/command.ts\";\nimport { commits } from \"../infrastructure/git/history.ts\";\nimport { storageFor } from \"./agent-storage.ts\";\nimport { completeBrief } from \"./interactive-brief.ts\";\nimport type {\n  AttachOptions,\n  AttachResult,\n  SandboxOptions,\n} from \"./outpost.types.ts\";\nimport { createSandbox } from \"./sandbox.ts\";\n\nexport async function attach(\n  options: SandboxOptions & AttachOptions & RequiredAgent,\n): Promise<AttachResult> {\n  options.signal?.throwIfAborted();\n  invariant(\n    options.agent.kind === \"cli\",\n    \"This harness does not support interactive attachment\",\n  );\n  validateBrief(options.brief, true);\n  const brief = await completeBrief(options.brief, options.signal, options.ask);\n  if (brief) options = { ...options, brief };\n  if (options.continuation) {\n    const storage = storageFor(options.agent);\n    invariant(storage, \"This adapter does not support native conversations\");\n    await storage.locate(\n      options.continuation.id,\n      options.workspace?.repository ?? options.repository ?? process.cwd(),\n      options.conversationHome,\n    );\n  }\n  const sandbox = await createSandbox(options);\n  let successful = false;\n  try {\n    const baseline = (\n      await git(sandbox.workspace.directory, [\"rev-parse\", \"HEAD\"])\n    ).trim();\n    const result = await sandbox.attach(options);\n    const changes = await commits(\n      sandbox.workspace.directory,\n      baseline,\n      options.limits?.collectMs,\n    );\n    if (result.status === 0) await sandbox.workspace.integrate();\n    const disposal = await sandbox.close({ preserve: result.status !== 0 });\n    successful = true;\n    return {\n      ...result,\n      ...disposal,\n      branch: sandbox.workspace.branch,\n      directory: sandbox.workspace.directory,\n      commits: changes,\n    };\n  } finally {\n    if (!successful) await sandbox.close({ preserve: true });\n  }\n}\n"]}

package/dist/application/custom-turn.d.ts

@@ -0,0 +1,5 @@
+import type { CustomAgent } from "../domain/agent.types.ts";
+import type { SandboxLease } from "../domain/sandbox.types.ts";
+import type { DispatchOptions, Turn } from "./execution.types.ts";
+import type { CustomTurnContext } from "./harness.types.ts";
+export declare function customTurn(lease: SandboxLease, agent: CustomAgent, prompt: string, options: DispatchOptions<unknown>, pass: number, context: CustomTurnContext): Promise<Turn>;

package/dist/application/custom-turn.js

@@ -0,0 +1,190 @@
+import { invariant, OutpostError } from "../domain/errors.js";
+import { addUsage } from "../domain/usage.js";
+import { activityWatchdog } from "./activity-watchdog.js";
+import { executionDefaults } from "./execution.constants.js";
+import { openTranscript } from "../infrastructure/conversations/harness-transcript.js";
+import { storageFor } from "./agent-storage.js";
+import { harnessHistory } from "./harness-history.js";
+import { harnessLoop } from "./harness-loop.js";
+import { notify } from "./observation.js";
+export async function customTurn(lease, agent, prompt, options, pass, context) {
+    const start = Date.now();
+    const controller = new AbortController();
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, controller.signal])
+        : controller.signal;
+    const watchdog = activityWatchdog(controller, options, pass);
+    const timer = setTimeout(() => controller.abort(new OutpostError("timeout", "Harness execution timed out")), options.deadlineMs ?? executionDefaults.deadlineMs);
+    let usage = { input: 0, cached: 0, output: 0 };
+    const pending = new Set();
+    const track = (operation) => {
+        pending.add(operation);
+        void operation
+            .finally(() => pending.delete(operation))
+            .catch(() => undefined);
+        return operation;
+    };
+    const emit = (event) => {
+        signal.throwIfAborted();
+        watchdog.refresh(false);
+        notify(options.observe, { ...event, pass, at: new Date().toISOString() });
+    };
+    const provider = agent.harness.modelProvider;
+    const scoped = (request) => {
+        const { reasoning, maxOutputTokens } = agent.model;
+        return {
+            ...(reasoning === undefined ? {} : { reasoning }),
+            ...(maxOutputTokens === undefined ? {} : { maxOutputTokens }),
+            ...request,
+            signal,
+        };
+    };
+    const account = (result) => {
+        signal.throwIfAborted();
+        invariant(result && typeof result.text === "string", "Model provider must return text");
+        if (result.usage) {
+            usage = addUsage(usage, result.usage);
+            notify(options.observe, {
+                kind: "usage",
+                tokens: result.usage,
+                pass,
+                at: new Date().toISOString(),
+            });
+        }
+        watchdog.refresh(false);
+        return result;
+    };
+    async function* stream(request) {
+        signal.throwIfAborted();
+        let finish;
+        track(new Promise((resolve) => (finish = resolve)));
+        try {
+            for await (const event of provider.stream(scoped(request))) {
+                signal.throwIfAborted();
+                watchdog.refresh(false);
+                yield event.type === "result"
+                    ? { type: "result", result: account(event.result) }
+                    : event;
+            }
+        }
+        finally {
+            finish();
+        }
+    }
+    const modelProvider = {
+        name: provider.name,
+        ...(provider.stream ? { stream } : {}),
+        request(request) {
+            return track((async () => {
+                signal.throwIfAborted();
+                return account(await provider.request(scoped(request)));
+            })());
+        },
+    };
+    const sandbox = {
+        root: lease.root,
+        home: lease.home,
+        invoke: (command) => {
+            signal.throwIfAborted();
+            return track(lease.invoke({
+                ...command,
+                observe(channel, chunk) {
+                    watchdog.refresh(false);
+                    notify((value) => command.observe?.(channel, value), chunk);
+                },
+                signal: command.signal
+                    ? AbortSignal.any([command.signal, signal])
+                    : signal,
+            }));
+        },
+        upload: (source, destination, settings = {}) => {
+            signal.throwIfAborted();
+            return track(lease.upload(source, destination, {
+                ...settings,
+                signal: settings.signal
+                    ? AbortSignal.any([settings.signal, signal])
+                    : signal,
+            }));
+        },
+        download: (source, destination, settings = {}) => {
+            signal.throwIfAborted();
+            return track(lease.download(source, destination, {
+                ...settings,
+                signal: settings.signal
+                    ? AbortSignal.any([settings.signal, signal])
+                    : signal,
+            }));
+        },
+        release: async () => {
+            throw new OutpostError("configuration", "The harness does not own its sandbox lease");
+        },
+    };
+    let transcript;
+    try {
+        signal.throwIfAborted();
+        watchdog.refresh(false);
+        const storage = storageFor(agent);
+        transcript = storage
+            ? await openTranscript({
+                repository: context.repository,
+                store: storage,
+                model: agent.model.name,
+                ...(context.continuation
+                    ? { continuation: context.continuation }
+                    : {}),
+            })
+            : undefined;
+        if (transcript)
+            emit({ kind: "conversation", id: transcript.id });
+        const text = await harnessLoop({
+            agent,
+            tools: context.repair
+                ? agent.harness.tools.filter((tool) => tool.readOnly)
+                : agent.harness.tools,
+            modelProvider,
+            sandbox,
+            signal,
+            emit,
+            hold: () => watchdog.hold(),
+        }, prompt, harnessHistory(transcript));
+        signal.throwIfAborted();
+        for (const value of [
+            usage.input,
+            usage.cached,
+            usage.output,
+            usage.cacheCreated ?? 0,
+        ])
+            invariant(Number.isSafeInteger(value) && value >= 0, "Harness usage must contain nonnegative token counts");
+        invariant(usage.cached + (usage.cacheCreated ?? 0) <= usage.input, "Cached tokens must be included in input usage");
+        notify(options.observe, {
+            kind: "result",
+            text,
+            pass,
+            at: new Date().toISOString(),
+        });
+        notify(options.observe, {
+            kind: "finished",
+            pass,
+            at: new Date().toISOString(),
+        });
+        return {
+            text,
+            usage,
+            status: 0,
+            durationMs: Date.now() - start,
+            ...(transcript ? { conversation: transcript.id } : {}),
+        };
+    }
+    catch (error) {
+        signal.throwIfAborted();
+        throw error;
+    }
+    finally {
+        await transcript?.close();
+        controller.abort(new OutpostError("aborted", "Harness turn ended"));
+        clearTimeout(timer);
+        watchdog.close();
+        await Promise.allSettled([...pending]);
+    }
+}
+//# sourceMappingURL=custom-turn.js.map

package/dist/application/custom-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-turn.js","sourceRoot":"","sources":["../../src/application/custom-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEvent, CustomAgent, Usage } from \"../domain/agent.types.ts\";\nimport type {\n  ModelProvider,\n  ModelRequest,\n  ModelResult,\n  ModelStreamEvent,\n} from \"../domain/model.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { invariant, OutpostError } from \"../domain/errors.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport { activityWatchdog } from \"./activity-watchdog.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Turn } from \"./execution.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 { harnessHistory } from \"./harness-history.ts\";\nimport { harnessLoop } from \"./harness-loop.ts\";\nimport type { CustomTurnContext } from \"./harness.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport async function customTurn(\n  lease: SandboxLease,\n  agent: CustomAgent,\n  prompt: string,\n  options: DispatchOptions<unknown>,\n  pass: number,\n  context: CustomTurnContext,\n): Promise<Turn> {\n  const start = Date.now();\n  const controller = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n  const watchdog = activityWatchdog(controller, options, pass);\n  const timer = setTimeout(\n    () =>\n      controller.abort(\n        new OutpostError(\"timeout\", \"Harness execution timed out\"),\n      ),\n    options.deadlineMs ?? executionDefaults.deadlineMs,\n  );\n  let usage: Usage = { input: 0, cached: 0, output: 0 };\n  const pending = new Set<Promise<unknown>>();\n  const track = <T>(operation: Promise<T>): Promise<T> => {\n    pending.add(operation);\n    void operation\n      .finally(() => pending.delete(operation))\n      .catch(() => undefined);\n    return operation;\n  };\n  const emit = (event: AgentEvent) => {\n    signal.throwIfAborted();\n    watchdog.refresh(false);\n    notify(options.observe, { ...event, pass, at: new Date().toISOString() });\n  };\n  const provider = agent.harness.modelProvider;\n  const scoped = (request: ModelRequest): ModelRequest => {\n    const { reasoning, maxOutputTokens } = agent.model;\n    return {\n      ...(reasoning === undefined ? {} : { reasoning }),\n      ...(maxOutputTokens === undefined ? {} : { maxOutputTokens }),\n      ...request,\n      signal,\n    };\n  };\n  const account = (result: ModelResult): ModelResult => {\n    signal.throwIfAborted();\n    invariant(\n      result && typeof result.text === \"string\",\n      \"Model provider must return text\",\n    );\n    if (result.usage) {\n      usage = addUsage(usage, result.usage);\n      notify(options.observe, {\n        kind: \"usage\",\n        tokens: result.usage,\n        pass,\n        at: new Date().toISOString(),\n      });\n    }\n    watchdog.refresh(false);\n    return result;\n  };\n  async function* stream(\n    request: ModelRequest,\n  ): AsyncGenerator<ModelStreamEvent> {\n    signal.throwIfAborted();\n    let finish!: () => void;\n    track(new Promise<void>((resolve) => (finish = resolve)));\n    try {\n      for await (const event of provider.stream!(scoped(request))) {\n        signal.throwIfAborted();\n        watchdog.refresh(false);\n        yield event.type === \"result\"\n          ? { type: \"result\", result: account(event.result) }\n          : event;\n      }\n    } finally {\n      finish();\n    }\n  }\n  const modelProvider: ModelProvider = {\n    name: provider.name,\n    ...(provider.stream ? { stream } : {}),\n    request(request) {\n      return track(\n        (async () => {\n          signal.throwIfAborted();\n          return account(await provider.request(scoped(request)));\n        })(),\n      );\n    },\n  };\n  const sandbox: SandboxLease = {\n    root: lease.root,\n    home: lease.home,\n    invoke: (command) => {\n      signal.throwIfAborted();\n      return track(\n        lease.invoke({\n          ...command,\n          observe(channel, chunk) {\n            watchdog.refresh(false);\n            notify((value) => command.observe?.(channel, value), chunk);\n          },\n          signal: command.signal\n            ? AbortSignal.any([command.signal, signal])\n            : signal,\n        }),\n      );\n    },\n    upload: (source, destination, settings = {}) => {\n      signal.throwIfAborted();\n      return track(\n        lease.upload(source, destination, {\n          ...settings,\n          signal: settings.signal\n            ? AbortSignal.any([settings.signal, signal])\n            : signal,\n        }),\n      );\n    },\n    download: (source, destination, settings = {}) => {\n      signal.throwIfAborted();\n      return track(\n        lease.download(source, destination, {\n          ...settings,\n          signal: settings.signal\n            ? AbortSignal.any([settings.signal, signal])\n            : signal,\n        }),\n      );\n    },\n    release: async () => {\n      throw new OutpostError(\n        \"configuration\",\n        \"The harness does not own its sandbox lease\",\n      );\n    },\n  };\n  let transcript: TranscriptHandle | undefined;\n  try {\n    signal.throwIfAborted();\n    watchdog.refresh(false);\n    const storage = storageFor(agent);\n    transcript = storage\n      ? await openTranscript({\n          repository: context.repository,\n          store: storage,\n          model: agent.model.name,\n          ...(context.continuation\n            ? { continuation: context.continuation }\n            : {}),\n        })\n      : undefined;\n    if (transcript) emit({ kind: \"conversation\", id: transcript.id });\n    const text = await harnessLoop(\n      {\n        agent,\n        tools: context.repair\n          ? agent.harness.tools.filter((tool) => tool.readOnly)\n          : agent.harness.tools,\n        modelProvider,\n        sandbox,\n        signal,\n        emit,\n        hold: () => watchdog.hold(),\n      },\n      prompt,\n      harnessHistory(transcript),\n    );\n    signal.throwIfAborted();\n    for (const value of [\n      usage.input,\n      usage.cached,\n      usage.output,\n      usage.cacheCreated ?? 0,\n    ])\n      invariant(\n        Number.isSafeInteger(value) && value >= 0,\n        \"Harness usage must contain nonnegative token counts\",\n      );\n    invariant(\n      usage.cached + (usage.cacheCreated ?? 0) <= usage.input,\n      \"Cached tokens must be included in input usage\",\n    );\n    notify(options.observe, {\n      kind: \"result\",\n      text,\n      pass,\n      at: new Date().toISOString(),\n    });\n    notify(options.observe, {\n      kind: \"finished\",\n      pass,\n      at: new Date().toISOString(),\n    });\n    return {\n      text,\n      usage,\n      status: 0,\n      durationMs: Date.now() - start,\n      ...(transcript ? { conversation: transcript.id } : {}),\n    };\n  } catch (error) {\n    signal.throwIfAborted();\n    throw error;\n  } finally {\n    await transcript?.close();\n    controller.abort(new OutpostError(\"aborted\", \"Harness turn ended\"));\n    clearTimeout(timer);\n    watchdog.close();\n    await Promise.allSettled([...pending]);\n  }\n}\n"]}

package/dist/application/dispatch-observation.d.ts

@@ -0,0 +1,3 @@
+import type { ObservedDispatchResult } from "./dispatch-observation.types.ts";
+import type { DispatchOptions } from "./execution.types.ts";
+export declare function observeDispatch<T, R extends ObservedDispatchResult>(options: DispatchOptions<T>, action: (options: DispatchOptions<T>) => Promise<R>): Promise<R>;

package/dist/application/dispatch-observation.js

@@ -0,0 +1,51 @@
+import { OutpostError } from "../domain/errors.js";
+import { addUsage } from "../domain/usage.js";
+import { notify } from "./observation.js";
+export function observeDispatch(options, action) {
+    if (!options.telemetry)
+        return action(options);
+    let session;
+    notify(() => {
+        session = options.telemetry?.startDispatch();
+    }, undefined);
+    const empty = () => ({ input: 0, cached: 0, output: 0 });
+    let previous = empty(), current = empty();
+    const { telemetry: _telemetry, ...settings } = options;
+    const observed = {
+        ...settings,
+        observe(event) {
+            if (event.kind === "phase" && event.name === "preparing prompt") {
+                previous = addUsage(previous, current);
+                current = empty();
+            }
+            if (event.kind === "usage")
+                current = addUsage(current, event.tokens);
+            if (event.kind === "summary")
+                current = event.tokens;
+            notify(options.observe, event);
+        },
+    };
+    return settle();
+    async function settle() {
+        try {
+            const result = await action(observed);
+            notify(() => session?.finish({
+                status: "done",
+                usage: result.usage,
+                completed: result.completed,
+            }), undefined);
+            return result;
+        }
+        catch (error) {
+            const cancelled = (options.signal?.aborted && error === options.signal.reason) ||
+                (error instanceof OutpostError && error.code === "aborted") ||
+                (error instanceof Error && error.name === "AbortError");
+            notify(() => session?.finish({
+                status: cancelled ? "cancelled" : "failed",
+                usage: addUsage(previous, current),
+            }), undefined);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=dispatch-observation.js.map

package/dist/application/dispatch-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-observation.js","sourceRoot":"","sources":["../../src/application/dispatch-observation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,eAAe,CAC7B,OAA2B,EAC3B,MAAmD;IAEnD,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,OAA6C,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE;QACV,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC/C,CAAC,EAAE,SAAS,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,GAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAChE,IAAI,QAAQ,GAAG,KAAK,EAAE,EACpB,OAAO,GAAG,KAAK,EAAE,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,QAAQ,GAAuB;QACnC,GAAG,QAAQ;QACX,OAAO,CAAC,KAAK;YACX,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAChE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACvC,OAAO,GAAG,KAAK,EAAE,CAAC;YACpB,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACtE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;IACF,OAAO,MAAM,EAAE,CAAC;IAEhB,KAAK,UAAU,MAAM;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,CACJ,GAAG,EAAE,CACH,OAAO,EAAE,MAAM,CAAC;gBACd,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,EACJ,SAAS,CACV,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GACb,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC5D,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;gBAC3D,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;YAC1D,MAAM,CACJ,GAAG,EAAE,CACH,OAAO,EAAE,MAAM,CAAC;gBACd,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;gBAC1C,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;aACnC,CAAC,EACJ,SAAS,CACV,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { Usage } from \"../domain/agent.types.ts\";\nimport type { DispatchTelemetrySession } from \"../domain/dispatch-telemetry.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { ObservedDispatchResult } from \"./dispatch-observation.types.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function observeDispatch<T, R extends ObservedDispatchResult>(\n  options: DispatchOptions<T>,\n  action: (options: DispatchOptions<T>) => Promise<R>,\n): Promise<R> {\n  if (!options.telemetry) return action(options);\n  let session: DispatchTelemetrySession | undefined;\n  notify(() => {\n    session = options.telemetry?.startDispatch();\n  }, undefined);\n  const empty = (): Usage => ({ input: 0, cached: 0, output: 0 });\n  let previous = empty(),\n    current = empty();\n  const { telemetry: _telemetry, ...settings } = options;\n  const observed: DispatchOptions<T> = {\n    ...settings,\n    observe(event) {\n      if (event.kind === \"phase\" && event.name === \"preparing prompt\") {\n        previous = addUsage(previous, current);\n        current = empty();\n      }\n      if (event.kind === \"usage\") current = addUsage(current, event.tokens);\n      if (event.kind === \"summary\") current = event.tokens;\n      notify(options.observe, event);\n    },\n  };\n  return settle();\n\n  async function settle(): Promise<R> {\n    try {\n      const result = await action(observed);\n      notify(\n        () =>\n          session?.finish({\n            status: \"done\",\n            usage: result.usage,\n            completed: result.completed,\n          }),\n        undefined,\n      );\n      return result;\n    } catch (error) {\n      const cancelled =\n        (options.signal?.aborted && error === options.signal.reason) ||\n        (error instanceof OutpostError && error.code === \"aborted\") ||\n        (error instanceof Error && error.name === \"AbortError\");\n      notify(\n        () =>\n          session?.finish({\n            status: cancelled ? \"cancelled\" : \"failed\",\n            usage: addUsage(previous, current),\n          }),\n        undefined,\n      );\n      throw error;\n    }\n  }\n}\n"]}

package/dist/application/dispatch-observation.types.d.ts

@@ -0,0 +1,5 @@
+import type { Usage } from "../domain/agent.types.ts";
+export interface ObservedDispatchResult {
+    readonly usage: Usage;
+    readonly completed: boolean;
+}

package/dist/application/dispatch-observation.types.js

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

package/dist/application/dispatch-observation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-observation.types.js","sourceRoot":"","sources":["../../src/application/dispatch-observation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"../domain/agent.types.ts\";\n\nexport interface ObservedDispatchResult {\n  readonly usage: Usage;\n  readonly completed: boolean;\n}\n"]}

package/dist/application/dispatch-validation.d.ts

@@ -1,4 +1,4 @@
-import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { Agent } from "../domain/agent.types.ts";
 import type { DispatchOptions } from "./execution.types.ts";
 export declare function validateDispatch(options: DispatchOptions<unknown>): void;
-export declare function preflightDispatch(options: DispatchOptions<unknown>, _repository: string, agent?: AgentAdapter): Promise<void>;
+export declare function preflightDispatch(options: DispatchOptions<unknown>, _repository: string, agent?: Agent): Promise<void>;

package/dist/application/dispatch-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-validation.js","sourceRoot":"","sources":["../../src/application/dispatch-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { dispatchDeadlines, executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\n\nexport function validateDispatch(options: DispatchOptions<unknown>): void {\n  options.signal?.throwIfAborted();\n  validateBrief(options.brief);\n  positive(options.passes ?? executionDefaults.passes, \"passes\");\n  invariant(\n    Number.isSafeInteger(options.passes ?? executionDefaults.passes),\n    \"passes must be an integer\",\n  );\n  for (const key of dispatchDeadlines)\n    if (options[key] !== undefined) positive(options[key], key);\n  if (options.response || options.continuation)\n    invariant(\n      (options.passes ?? executionDefaults.passes) === 1,\n      \"Structured responses and continuations require one pass\",\n    );\n  const markers =\n    options.until === undefined\n      ? []\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  invariant(\n    markers.every((marker) => marker.length > 0),\n    \"Completion markers cannot be empty\",\n  );\n}\n\nexport async function preflightDispatch(\n  options: DispatchOptions<unknown>,\n  _repository: string,\n  agent?: AgentAdapter,\n): Promise<void> {\n  validateDispatch(options);\n  if (options.continuation)\n    invariant(\n      agent?.resumable !== false,\n      `${agent?.name} does not support continuation or fork in Outpost`,\n    );\n  if (!options.response) return;\n  if (options.response.repairs > 0)\n    invariant(\n      agent?.resumable ?? !!(agent?.conversations || agent?.storage),\n      \"Response repair requires an adapter that supports continuation\",\n    );\n  const brief = options.brief;\n  const text = brief.text ?? (await readFile(resolve(brief.file!), \"utf8\"));\n  const resolved = text.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (token, key: string) =>\n    brief.values?.[key] === undefined ? token : String(brief.values[key]),\n  );\n  invariant(\n    resolved.includes(`<${options.response.tag}>`),\n    `Brief must request an opening <${options.response.tag}> tag`,\n  );\n}\n"]}
+{"version":3,"file":"dispatch-validation.js","sourceRoot":"","sources":["../../src/application/dispatch-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { dispatchDeadlines, executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\n\nexport function validateDispatch(options: DispatchOptions<unknown>): void {\n  options.signal?.throwIfAborted();\n  validateBrief(options.brief);\n  positive(options.passes ?? executionDefaults.passes, \"passes\");\n  invariant(\n    Number.isSafeInteger(options.passes ?? executionDefaults.passes),\n    \"passes must be an integer\",\n  );\n  for (const key of dispatchDeadlines)\n    if (options[key] !== undefined) positive(options[key], key);\n  if (options.response || options.continuation)\n    invariant(\n      (options.passes ?? executionDefaults.passes) === 1,\n      \"Structured responses and continuations require one pass\",\n    );\n  const markers =\n    options.until === undefined\n      ? []\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  invariant(\n    markers.every((marker) => marker.length > 0),\n    \"Completion markers cannot be empty\",\n  );\n}\n\nexport async function preflightDispatch(\n  options: DispatchOptions<unknown>,\n  _repository: string,\n  agent?: Agent,\n): Promise<void> {\n  validateDispatch(options);\n  if (options.continuation)\n    invariant(\n      agent?.resumable !== false,\n      `${agent?.name} does not support continuation or fork in Outpost`,\n    );\n  if (!options.response) return;\n  if (options.response.repairs > 0)\n    invariant(\n      agent?.resumable ?? !!(agent?.conversations || agent?.storage),\n      \"Response repair requires an adapter that supports continuation\",\n    );\n  const brief = options.brief;\n  const text = brief.text ?? (await readFile(resolve(brief.file!), \"utf8\"));\n  const resolved = text.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (token, key: string) =>\n    brief.values?.[key] === undefined ? token : String(brief.values[key]),\n  );\n  invariant(\n    resolved.includes(`<${options.response.tag}>`),\n    `Brief must request an opening <${options.response.tag}> tag`,\n  );\n}\n"]}