@elie-laloum/outpost 4.2.0 → 6.0.1

package/dist/application/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/application/doctor.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { agentVersions } from \"../providers/versions.constants.ts\";\nimport { diagnoseImage } from \"./doctor-image.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults, providerDiagnostics } from \"./doctor.constants.ts\";\nimport type {\n  DiagnosticCheck,\n  DoctorOptions,\n  DoctorReport,\n} from \"./doctor.types.ts\";\n\nexport async function diagnose(\n  options: DoctorOptions,\n  execute: Executor = executeProcess,\n): Promise<DoctorReport> {\n  const { provider, agent, image } = options;\n  if (image !== undefined) {\n    invariant(\n      provider === \"docker\" || provider === \"podman\",\n      \"--image requires docker or podman.\",\n    );\n    invariant(\n      image.length > 0 &&\n        !image.startsWith(\"-\") &&\n        !/[\\x00-\\x20\\x7f]/.test(image),\n      \"Invalid diagnostic image name.\",\n    );\n  }\n  const capabilities = providerDiagnostics[provider];\n  const checks: DiagnosticCheck[] = [\n    {\n      id: \"host.node\",\n      status:\n        Number(process.versions.node.split(\".\")[0]) >=\n        doctorDefaults.minimumNodeMajor\n          ? \"pass\"\n          : \"fail\",\n      version: process.versions.node,\n      message: `Outpost requires Node.js ${doctorDefaults.minimumNodeMajor}+.`,\n    },\n  ];\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"host.git\",\n        command: { executable: \"git\", arguments: [\"--version\"] },\n        failureStatus: \"fail\",\n        remedy: \"Install Git and make it available on PATH.\",\n        readVersion: true,\n      },\n      execute,\n    ),\n  );\n  if (capabilities.placement === \"mounted\") {\n    const engine = await diagnosticProbe(\n      {\n        id: \"provider.cli\",\n        command: { executable: provider, arguments: [\"--version\"] },\n        failureStatus: \"fail\",\n        remedy: `Install ${provider} and make it available on PATH.`,\n        readVersion: true,\n      },\n      execute,\n    );\n    checks.push(engine);\n    if (engine.status === \"pass\")\n      checks.push(\n        await diagnosticProbe(\n          {\n            id: \"provider.connection\",\n            command: {\n              executable: provider,\n              arguments: [\"info\"],\n            },\n            failureStatus: \"fail\",\n            remedy: `Check ${provider} is running and accessible to this user; on macOS, start its virtual machine.`,\n          },\n          execute,\n        ),\n      );\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: \"host.tar\",\n          command: { executable: \"tar\", arguments: [\"--version\"] },\n          failureStatus: \"fail\",\n          remedy: \"Install GNU tar or bsdtar for container transfers.\",\n        },\n        execute,\n      ),\n    );\n  }\n  if (capabilities.placement === \"remote\")\n    checks.push({\n      id: \"provider.cloud\",\n      status: \"skipped\",\n      message:\n        \"Cloud SDK, credentials, account access and allocation are not checked.\",\n    });\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"agent.host\",\n        command: { executable: agent, arguments: [\"--version\"] },\n        failureStatus: \"warn\",\n        remedy:\n          \"Host CLI is unavailable or unverified. A sandbox may have its own CLI; dispatch can bootstrap a missing agent.\",\n        readVersion: true,\n        referenceVersion: agentVersions[agent],\n      },\n      execute,\n    ),\n  );\n  if (image !== undefined && (provider === \"docker\" || provider === \"podman\")) {\n    const connected = checks.some(\n      (check) => check.id === \"provider.connection\" && check.status === \"pass\",\n    );\n    if (connected)\n      checks.push(\n        ...(await diagnoseImage({ provider, agent, image }, execute)),\n      );\n    else\n      checks.push({\n        id: \"image.runtime\",\n        status: \"skipped\",\n        message: \"Image checks require a reachable container engine.\",\n      });\n  }\n  if (capabilities.placement !== \"host\" && image === undefined)\n    checks.push({\n      id: \"agent.sandbox\",\n      status: \"skipped\",\n      message:\n        \"Agent version inside the sandbox is not checked; the host version does not describe the sandbox.\",\n    });\n  checks.push({\n    id: \"execution\",\n    status: \"skipped\",\n    message:\n      image === undefined\n        ? \"Images, mounts, repository state, authentication and model access are not tested. No sandbox is allocated.\"\n        : \"Workflow mounts, repository state, authentication and model access are not tested. Image checks use a separate temporary sandbox.\",\n  });\n  return {\n    ...options,\n    scope: image === undefined ? \"host\" : \"host-and-image\",\n    ...capabilities,\n    checks,\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/application/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAO5E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAsB,EACtB,UAAoB,cAAc;IAElC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,SAAS,CACP,eAAe,KAAK,QAAQ,IAAI,eAAe,KAAK,QAAQ,EAC5D,oCAAoC,CACrC,CAAC;QACF,SAAS,CACP,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACtB,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAChC,gCAAgC,CACjC,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAsB;QAChC;YACE,EAAE,EAAE,WAAW;YACf,MAAM,EACJ,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3C,cAAc,CAAC,gBAAgB;gBAC7B,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,MAAM;YACZ,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YAC9B,OAAO,EAAE,4BAA4B,cAAc,CAAC,gBAAgB,IAAI;SACzE;KACF,CAAC;IACF,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;QACE,EAAE,EAAE,UAAU;QACd,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE;QACxD,aAAa,EAAE,MAAM;QACrB,MAAM,EAAE,4CAA4C;QACpD,WAAW,EAAE,IAAI;KAClB,EACD,OAAO,CACR,CACF,CAAC;IACF,IAAI,YAAY,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC;YACE,EAAE,EAAE,cAAc;YAClB,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE;YAClE,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,WAAW,eAAe,iCAAiC;YACnE,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;YAC1B,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;gBACE,EAAE,EAAE,qBAAqB;gBACzB,OAAO,EAAE;oBACP,UAAU,EAAE,eAAe;oBAC3B,SAAS,EAAE,CAAC,MAAM,CAAC;iBACpB;gBACD,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,SAAS,eAAe,+EAA+E;aAChH,EACD,OAAO,CACR,CACF,CAAC;QACJ,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;YACE,EAAE,EAAE,UAAU;YACd,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE;YACxD,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,oDAAoD;SAC7D,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,SAAS,KAAK,QAAQ;QACrC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,gBAAgB;YACpB,MAAM,EAAE,SAAS;YACjB,OAAO,EACL,wEAAwE;SAC3E,CAAC,CAAC;IACL,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;QACE,EAAE,EAAE,YAAY;QAChB,GAAG,iBAAiB,CAAC,KAAK,CAAC;QAC3B,aAAa,EAAE,MAAM;QACrB,MAAM,EACJ,gHAAgH;KACnH,EACD,OAAO,CACR,CACF,CAAC;IACF,IACE,KAAK,KAAK,SAAS;QACnB,CAAC,eAAe,KAAK,QAAQ,IAAI,eAAe,KAAK,QAAQ,CAAC,EAC9D,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAC3B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,qBAAqB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CACzE,CAAC;QACF,IAAI,SAAS;YACX,MAAM,CAAC,IAAI,CACT,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CACrE,CAAC;;YAEF,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,eAAe;gBACnB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,oDAAoD;aAC9D,CAAC,CAAC;IACP,CAAC;IACD,IAAI,YAAY,CAAC,SAAS,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS;QAC1D,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,eAAe;YACnB,MAAM,EAAE,SAAS;YACjB,OAAO,EACL,kGAAkG;SACrG,CAAC,CAAC;IACL,MAAM,CAAC,IAAI,CAAC;QACV,EAAE,EAAE,WAAW;QACf,MAAM,EAAE,SAAS;QACjB,OAAO,EACL,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,4GAA4G;YAC9G,CAAC,CAAC,mIAAmI;KAC1I,CAAC,CAAC;IACH,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB;QACtD,GAAG,YAAY;QACf,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC;KAC7D,CAAC;AACJ,CAAC","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { agentVersionProbe } from \"./doctor-agent.ts\";\nimport { diagnoseImage } from \"./doctor-image.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults, providerDiagnostics } from \"./doctor.constants.ts\";\nimport type {\n  DiagnosticCheck,\n  DoctorOptions,\n  DoctorReport,\n} from \"./doctor.types.ts\";\n\nexport async function diagnose(\n  options: DoctorOptions,\n  execute: Executor = executeProcess,\n): Promise<DoctorReport> {\n  const { sandboxProvider, agent, image } = options;\n  if (image !== undefined) {\n    invariant(\n      sandboxProvider === \"docker\" || sandboxProvider === \"podman\",\n      \"--image requires docker or podman.\",\n    );\n    invariant(\n      image.length > 0 &&\n        !image.startsWith(\"-\") &&\n        !/[\\x00-\\x20\\x7f]/.test(image),\n      \"Invalid diagnostic image name.\",\n    );\n  }\n  const capabilities = providerDiagnostics[sandboxProvider];\n  const checks: DiagnosticCheck[] = [\n    {\n      id: \"host.node\",\n      status:\n        Number(process.versions.node.split(\".\")[0]) >=\n        doctorDefaults.minimumNodeMajor\n          ? \"pass\"\n          : \"fail\",\n      version: process.versions.node,\n      message: `Outpost requires Node.js ${doctorDefaults.minimumNodeMajor}+.`,\n    },\n  ];\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"host.git\",\n        command: { executable: \"git\", arguments: [\"--version\"] },\n        failureStatus: \"fail\",\n        remedy: \"Install Git and make it available on PATH.\",\n        readVersion: true,\n      },\n      execute,\n    ),\n  );\n  if (capabilities.placement === \"mounted\") {\n    const engine = await diagnosticProbe(\n      {\n        id: \"provider.cli\",\n        command: { executable: sandboxProvider, arguments: [\"--version\"] },\n        failureStatus: \"fail\",\n        remedy: `Install ${sandboxProvider} and make it available on PATH.`,\n        readVersion: true,\n      },\n      execute,\n    );\n    checks.push(engine);\n    if (engine.status === \"pass\")\n      checks.push(\n        await diagnosticProbe(\n          {\n            id: \"provider.connection\",\n            command: {\n              executable: sandboxProvider,\n              arguments: [\"info\"],\n            },\n            failureStatus: \"fail\",\n            remedy: `Check ${sandboxProvider} is running and accessible to this user; on macOS, start its virtual machine.`,\n          },\n          execute,\n        ),\n      );\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: \"host.tar\",\n          command: { executable: \"tar\", arguments: [\"--version\"] },\n          failureStatus: \"fail\",\n          remedy: \"Install GNU tar or bsdtar for container transfers.\",\n        },\n        execute,\n      ),\n    );\n  }\n  if (capabilities.placement === \"remote\")\n    checks.push({\n      id: \"provider.cloud\",\n      status: \"skipped\",\n      message:\n        \"Cloud SDK, credentials, account access and allocation are not checked.\",\n    });\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"agent.host\",\n        ...agentVersionProbe(agent),\n        failureStatus: \"warn\",\n        remedy:\n          \"Host CLI is unavailable or unverified. A sandbox may have its own CLI; dispatch can bootstrap a missing agent.\",\n      },\n      execute,\n    ),\n  );\n  if (\n    image !== undefined &&\n    (sandboxProvider === \"docker\" || sandboxProvider === \"podman\")\n  ) {\n    const connected = checks.some(\n      (check) => check.id === \"provider.connection\" && check.status === \"pass\",\n    );\n    if (connected)\n      checks.push(\n        ...(await diagnoseImage({ sandboxProvider, agent, image }, execute)),\n      );\n    else\n      checks.push({\n        id: \"image.runtime\",\n        status: \"skipped\",\n        message: \"Image checks require a reachable container engine.\",\n      });\n  }\n  if (capabilities.placement !== \"host\" && image === undefined)\n    checks.push({\n      id: \"agent.sandbox\",\n      status: \"skipped\",\n      message:\n        \"Agent version inside the sandbox is not checked; the host version does not describe the sandbox.\",\n    });\n  checks.push({\n    id: \"execution\",\n    status: \"skipped\",\n    message:\n      image === undefined\n        ? \"Images, mounts, repository state, authentication and model access are not tested. No sandbox is allocated.\"\n        : \"Workflow mounts, repository state, authentication and model access are not tested. Image checks use a separate temporary sandbox.\",\n  });\n  return {\n    ...options,\n    scope: image === undefined ? \"host\" : \"host-and-image\",\n    ...capabilities,\n    checks,\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}

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

@@ -1,6 +1,14 @@
+import type { AgentCliDiagnostic } from "../adapters/agents/cli-diagnostics.types.ts";
+import type { CliHarness } from "../domain/agent.types.ts";
 import type { Command } from "../domain/command.types.ts";
 export type DoctorProvider = "docker" | "podman" | "local" | "vercel" | "daytona";
-export type DoctorAgent = "codex" | "claude" | "gemini";
+export type DoctorAgent = "codex" | "claude" | "antigravity" | "copilot" | "kimi";
+export interface DoctorAgentProfile {
+    readonly executable: string;
+    readonly referenceVersion?: string;
+    diagnostics(): readonly AgentCliDiagnostic[];
+    harness(): CliHarness;
+}
 export type DiagnosticStatus = "pass" | "warn" | "fail" | "skipped";
 export interface DiagnosticCheck {
     readonly id: string;
@@ -11,16 +19,16 @@ export interface DiagnosticCheck {
 }
 export interface DoctorOptions {
     readonly image?: string;
-    readonly provider: DoctorProvider;
+    readonly sandboxProvider: DoctorProvider;
     readonly agent: DoctorAgent;
 }
 export interface DoctorImageOptions {
-    readonly provider: "docker" | "podman";
+    readonly sandboxProvider: "docker" | "podman";
     readonly agent: DoctorAgent;
     readonly image: string;
 }
 export interface DoctorReport {
-    readonly provider: DoctorProvider;
+    readonly sandboxProvider: DoctorProvider;
     readonly agent: DoctorAgent;
     readonly scope: "host" | "host-and-image";
     readonly image?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.types.js","sourceRoot":"","sources":["../../src/application/doctor.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Command } from \"../domain/command.types.ts\";\nexport type DoctorProvider =\n  \"docker\" | \"podman\" | \"local\" | \"vercel\" | \"daytona\";\nexport type DoctorAgent = \"codex\" | \"claude\" | \"gemini\";\nexport type DiagnosticStatus = \"pass\" | \"warn\" | \"fail\" | \"skipped\";\nexport interface DiagnosticCheck {\n  readonly id: string;\n  readonly status: DiagnosticStatus;\n  readonly message: string;\n  readonly version?: string;\n  readonly referenceVersion?: string;\n}\nexport interface DoctorOptions {\n  readonly image?: string;\n  readonly provider: DoctorProvider;\n  readonly agent: DoctorAgent;\n}\nexport interface DoctorImageOptions {\n  readonly provider: \"docker\" | \"podman\";\n  readonly agent: DoctorAgent;\n  readonly image: string;\n}\nexport interface DoctorReport {\n  readonly provider: DoctorProvider;\n  readonly agent: DoctorAgent;\n  readonly scope: \"host\" | \"host-and-image\";\n  readonly image?: string;\n  readonly placement: \"mounted\" | \"host\" | \"remote\";\n  readonly interactiveTerminal: boolean;\n  readonly checks: readonly DiagnosticCheck[];\n  readonly hasFailures: boolean;\n}\nexport interface DiagnosticProbe {\n  readonly id: string;\n  readonly command: Command;\n  readonly failureStatus: \"fail\" | \"warn\";\n  readonly remedy: string;\n  readonly readVersion?: boolean;\n  readonly referenceVersion?: string;\n}\n"]}
+{"version":3,"file":"doctor.types.js","sourceRoot":"","sources":["../../src/application/doctor.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentCliDiagnostic } from \"../adapters/agents/cli-diagnostics.types.ts\";\nimport type { CliHarness } from \"../domain/agent.types.ts\";\nimport type { Command } from \"../domain/command.types.ts\";\nexport type DoctorProvider =\n  \"docker\" | \"podman\" | \"local\" | \"vercel\" | \"daytona\";\nexport type DoctorAgent =\n  \"codex\" | \"claude\" | \"antigravity\" | \"copilot\" | \"kimi\";\nexport interface DoctorAgentProfile {\n  readonly executable: string;\n  readonly referenceVersion?: string;\n  diagnostics(): readonly AgentCliDiagnostic[];\n  harness(): CliHarness;\n}\nexport type DiagnosticStatus = \"pass\" | \"warn\" | \"fail\" | \"skipped\";\nexport interface DiagnosticCheck {\n  readonly id: string;\n  readonly status: DiagnosticStatus;\n  readonly message: string;\n  readonly version?: string;\n  readonly referenceVersion?: string;\n}\nexport interface DoctorOptions {\n  readonly image?: string;\n  readonly sandboxProvider: DoctorProvider;\n  readonly agent: DoctorAgent;\n}\nexport interface DoctorImageOptions {\n  readonly sandboxProvider: \"docker\" | \"podman\";\n  readonly agent: DoctorAgent;\n  readonly image: string;\n}\nexport interface DoctorReport {\n  readonly sandboxProvider: DoctorProvider;\n  readonly agent: DoctorAgent;\n  readonly scope: \"host\" | \"host-and-image\";\n  readonly image?: string;\n  readonly placement: \"mounted\" | \"host\" | \"remote\";\n  readonly interactiveTerminal: boolean;\n  readonly checks: readonly DiagnosticCheck[];\n  readonly hasFailures: boolean;\n}\nexport interface DiagnosticProbe {\n  readonly id: string;\n  readonly command: Command;\n  readonly failureStatus: \"fail\" | \"warn\";\n  readonly remedy: string;\n  readonly readVersion?: boolean;\n  readonly referenceVersion?: string;\n}\n"]}

package/dist/application/execution.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 { WorkspaceRecord } from "../domain/workspace.types.ts";
 import type { DispatchOptions, Execution, Turn } from "./execution.types.ts";
@@ -6,4 +6,4 @@ export { renderBrief } from "./brief-renderer.ts";
 export { preflightDispatch, validateDispatch } from "./dispatch-validation.ts";
 export type { DispatchOptions, Execution, Turn } from "./execution.types.ts";
 export { notify } from "./observation.ts";
-export declare function execute<T>(workspace: WorkspaceRecord, lease: SandboxLease, agent: AgentAdapter, host: boolean, options: DispatchOptions<T>, afterTurn?: (turn: Turn) => Promise<Turn>): Promise<Execution<T>>;
+export declare function execute<T>(workspace: WorkspaceRecord, lease: SandboxLease, agent: Agent, host: boolean, options: DispatchOptions<T>, afterTurn?: (turn: Turn) => Promise<Turn>): Promise<Execution<T>>;

package/dist/application/execution.js

@@ -51,7 +51,7 @@ export async function execute(workspace, lease, agent, host, options, afterTurn)
             pass: index + 1,
             at: new Date().toISOString(),
         });
-        const finished = await turn(lease, agent, prompt, options, continuation, markers, index + 1);
+        const finished = await turn(lease, agent, prompt, options, continuation, markers, index + 1, { repository: workspace.repository, repair: repair !== undefined });
         const current = afterTurn ? await afterTurn(finished) : finished;
         turns.push(current);
         notify(options.observe, {

package/dist/application/execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/application/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentAdapter, Usage } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { ResponseError } from \"../domain/response.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { WorkspaceRecord } from \"../domain/workspace.types.ts\";\nimport { turn } from \"./agent-turn.ts\";\nimport { renderBrief } from \"./brief-renderer.ts\";\nimport { validateDispatch } from \"./dispatch-validation.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Execution, Turn } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport { renderBrief } from \"./brief-renderer.ts\";\nexport { preflightDispatch, validateDispatch } from \"./dispatch-validation.ts\";\nexport type { DispatchOptions, Execution, Turn } from \"./execution.types.ts\";\nexport { notify } from \"./observation.ts\";\n\nexport async function execute<T>(\n  workspace: WorkspaceRecord,\n  lease: SandboxLease,\n  agent: AgentAdapter,\n  host: boolean,\n  options: DispatchOptions<T>,\n  afterTurn?: (turn: Turn) => Promise<Turn>,\n): Promise<Execution<T>> {\n  validateDispatch(options);\n  const markers =\n    options.until === undefined\n      ? [executionDefaults.completion]\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  const turns: Turn[] = [];\n  let value: T = undefined as T,\n    completed = false,\n    continuation = options.continuation;\n  let repair: string | undefined;\n  const attempts = options.response\n    ? 1 + options.response.repairs\n    : (options.passes ?? executionDefaults.passes);\n  for (let index = 0; index < attempts; index++) {\n    options.signal?.throwIfAborted();\n    notify(options.observe, {\n      kind: \"phase\",\n      name: \"preparing prompt\",\n      agent: agent.name,\n      branch: workspace.branch,\n      directory: workspace.directory,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    const prompt =\n      repair ??\n      (await renderBrief(options.brief, workspace, lease, host, options));\n    if (options.response && !repair)\n      invariant(\n        prompt.includes(`<${options.response.tag}>`),\n        `Brief must request an opening <${options.response.tag}> tag`,\n      );\n    notify(options.observe, {\n      kind: \"prompt\",\n      text: prompt,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    notify(options.observe, {\n      kind: \"phase\",\n      name: \"running\",\n      agent: agent.name,\n      branch: workspace.branch,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    const finished = await turn(\n      lease,\n      agent,\n      prompt,\n      options,\n      continuation,\n      markers,\n      index + 1,\n    );\n    const current = afterTurn ? await afterTurn(finished) : finished;\n    turns.push(current);\n    notify(options.observe, {\n      kind: \"summary\",\n      durationMs: current.durationMs,\n      status: current.status,\n      tokens: current.usage,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    completed = markers.some((marker) => current.text.includes(marker));\n    if (options.response) {\n      try {\n        value = await options.response.read(current.text);\n        completed = true;\n        break;\n      } catch (error) {\n        if (!(error instanceof ResponseError)) throw error;\n        error.recovery = {\n          conversation: current.conversation,\n          branch: workspace.branch,\n          directory: workspace.directory,\n          turns,\n        };\n        if (index + 1 >= attempts || !current.conversation) throw error;\n        continuation = { id: current.conversation };\n        repair = [\n          `Correct the response inside <${options.response.tag}> and </${options.response.tag}>.`,\n          `Validation failure: ${error.message}`,\n          `Previous content: ${error.raw ?? \"No complete tagged response was returned.\"}`,\n          `Cause: ${error.cause instanceof Error ? error.cause.message : (JSON.stringify(error.cause) ?? \"unspecified\")}`,\n          `Further repair attempts after this one: ${attempts - index - 2}.`,\n          \"Do not edit files, run commands or continue implementation. Only return the corrected response.\",\n        ].join(\"\\n\");\n      }\n    }\n    if (!options.response && completed) break;\n  }\n  const conversation = turns.at(-1)?.conversation;\n  const completion = markers.find((marker) =>\n    turns.at(-1)?.text.includes(marker),\n  );\n  return {\n    text: turns.map((item) => item.text).join(\"\\n\"),\n    turns,\n    value,\n    completed,\n    ...(completion ? { completion } : {}),\n    ...(conversation ? { conversation } : {}),\n    usage: turns.reduce((sum, item) => addUsage(sum, item.usage), {\n      input: 0,\n      cached: 0,\n      output: 0,\n    } as Usage),\n  };\n}\n"]}
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/application/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Agent, Usage } from \"../domain/agent.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { ResponseError } from \"../domain/response.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { WorkspaceRecord } from \"../domain/workspace.types.ts\";\nimport { turn } from \"./agent-turn.ts\";\nimport { renderBrief } from \"./brief-renderer.ts\";\nimport { validateDispatch } from \"./dispatch-validation.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Execution, Turn } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport { renderBrief } from \"./brief-renderer.ts\";\nexport { preflightDispatch, validateDispatch } from \"./dispatch-validation.ts\";\nexport type { DispatchOptions, Execution, Turn } from \"./execution.types.ts\";\nexport { notify } from \"./observation.ts\";\n\nexport async function execute<T>(\n  workspace: WorkspaceRecord,\n  lease: SandboxLease,\n  agent: Agent,\n  host: boolean,\n  options: DispatchOptions<T>,\n  afterTurn?: (turn: Turn) => Promise<Turn>,\n): Promise<Execution<T>> {\n  validateDispatch(options);\n  const markers =\n    options.until === undefined\n      ? [executionDefaults.completion]\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  const turns: Turn[] = [];\n  let value: T = undefined as T,\n    completed = false,\n    continuation = options.continuation;\n  let repair: string | undefined;\n  const attempts = options.response\n    ? 1 + options.response.repairs\n    : (options.passes ?? executionDefaults.passes);\n  for (let index = 0; index < attempts; index++) {\n    options.signal?.throwIfAborted();\n    notify(options.observe, {\n      kind: \"phase\",\n      name: \"preparing prompt\",\n      agent: agent.name,\n      branch: workspace.branch,\n      directory: workspace.directory,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    const prompt =\n      repair ??\n      (await renderBrief(options.brief, workspace, lease, host, options));\n    if (options.response && !repair)\n      invariant(\n        prompt.includes(`<${options.response.tag}>`),\n        `Brief must request an opening <${options.response.tag}> tag`,\n      );\n    notify(options.observe, {\n      kind: \"prompt\",\n      text: prompt,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    notify(options.observe, {\n      kind: \"phase\",\n      name: \"running\",\n      agent: agent.name,\n      branch: workspace.branch,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    const finished = await turn(\n      lease,\n      agent,\n      prompt,\n      options,\n      continuation,\n      markers,\n      index + 1,\n      { repository: workspace.repository, repair: repair !== undefined },\n    );\n    const current = afterTurn ? await afterTurn(finished) : finished;\n    turns.push(current);\n    notify(options.observe, {\n      kind: \"summary\",\n      durationMs: current.durationMs,\n      status: current.status,\n      tokens: current.usage,\n      pass: index + 1,\n      at: new Date().toISOString(),\n    });\n    completed = markers.some((marker) => current.text.includes(marker));\n    if (options.response) {\n      try {\n        value = await options.response.read(current.text);\n        completed = true;\n        break;\n      } catch (error) {\n        if (!(error instanceof ResponseError)) throw error;\n        error.recovery = {\n          conversation: current.conversation,\n          branch: workspace.branch,\n          directory: workspace.directory,\n          turns,\n        };\n        if (index + 1 >= attempts || !current.conversation) throw error;\n        continuation = { id: current.conversation };\n        repair = [\n          `Correct the response inside <${options.response.tag}> and </${options.response.tag}>.`,\n          `Validation failure: ${error.message}`,\n          `Previous content: ${error.raw ?? \"No complete tagged response was returned.\"}`,\n          `Cause: ${error.cause instanceof Error ? error.cause.message : (JSON.stringify(error.cause) ?? \"unspecified\")}`,\n          `Further repair attempts after this one: ${attempts - index - 2}.`,\n          \"Do not edit files, run commands or continue implementation. Only return the corrected response.\",\n        ].join(\"\\n\");\n      }\n    }\n    if (!options.response && completed) break;\n  }\n  const conversation = turns.at(-1)?.conversation;\n  const completion = markers.find((marker) =>\n    turns.at(-1)?.text.includes(marker),\n  );\n  return {\n    text: turns.map((item) => item.text).join(\"\\n\"),\n    turns,\n    value,\n    completed,\n    ...(completion ? { completion } : {}),\n    ...(conversation ? { conversation } : {}),\n    usage: turns.reduce((sum, item) => addUsage(sum, item.usage), {\n      input: 0,\n      cached: 0,\n      output: 0,\n    } as Usage),\n  };\n}\n"]}

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

@@ -1,10 +1,11 @@
 import type { TransportReference } from "../domain/transport.types.ts";
-import type { AgentAdapter, AgentObservation, Usage } from "../domain/agent.types.ts";
+import type { Agent, AgentObservation, Usage } from "../domain/agent.types.ts";
+import type { DispatchTelemetry } from "../domain/dispatch-telemetry.types.ts";
 import type { Brief } from "../domain/prompts.types.ts";
 import type { ResponseSpec } from "../domain/response.types.ts";
 import type { Logging } from "../infrastructure/journal.types.ts";
 export interface DispatchOptions<T = undefined> {
-    readonly agent?: AgentAdapter;
+    readonly agent?: Agent;
     readonly logging?: Logging;
     readonly label?: string;
     readonly brief: Brief;
@@ -21,10 +22,15 @@ export interface DispatchOptions<T = undefined> {
         readonly fork?: boolean;
     };
     readonly response?: ResponseSpec<T>;
+    readonly telemetry?: DispatchTelemetry;
     readonly observe?: (event: AgentObservation) => void;
     readonly warn?: (message: string) => void;
     readonly diagnostic?: (message: string) => void;
 }
+export interface TurnContext {
+    readonly repository: string;
+    readonly repair: boolean;
+}
 export interface Turn {
     readonly text: string;
     readonly status: number;
@@ -43,6 +49,7 @@ export interface AgentOutput {
 }
 export interface ActivityWatchdog {
     refresh(completed: boolean): void;
+    hold(): () => void;
     close(): void;
 }
 export interface Execution<T> {

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

@@ -1 +1 @@
-{"version":3,"file":"execution.types.js","sourceRoot":"","sources":["../../src/application/execution.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TransportReference } from \"../domain/transport.types.ts\";\nimport type {\n  AgentAdapter,\n  AgentObservation,\n  Usage,\n} from \"../domain/agent.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { ResponseSpec } from \"../domain/response.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\n\nexport interface DispatchOptions<T = undefined> {\n  readonly agent?: AgentAdapter;\n  readonly logging?: Logging;\n  readonly label?: string;\n  readonly brief: Brief;\n  readonly passes?: number;\n  readonly until?: string | readonly string[];\n  readonly idleMs?: number;\n  readonly idleWarningMs?: number;\n  readonly settleMs?: number;\n  readonly deadlineMs?: number;\n  readonly expansionMs?: number;\n  readonly signal?: AbortSignal;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly response?: ResponseSpec<T>;\n  readonly observe?: (event: AgentObservation) => void;\n  readonly warn?: (message: string) => void;\n  readonly diagnostic?: (message: string) => void;\n}\n\nexport interface Turn {\n  readonly text: string;\n  readonly status: number;\n  readonly conversation?: string;\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly usage: Usage;\n  readonly durationMs: number;\n}\n\nexport interface AgentOutput {\n  readonly completed: boolean;\n  readonly conversation: string | undefined;\n  append(chunk: string): void;\n  flush(): void;\n  result(): Pick<Turn, \"text\" | \"usage\" | \"conversation\">;\n}\n\nexport interface ActivityWatchdog {\n  refresh(completed: boolean): void;\n  close(): void;\n}\n\nexport interface Execution<T> {\n  readonly text: string;\n  readonly turns: readonly Turn[];\n  readonly usage: Usage;\n  readonly conversation?: string;\n  readonly value: T;\n  readonly completed: boolean;\n  readonly completion?: string;\n}\n"]}
+{"version":3,"file":"execution.types.js","sourceRoot":"","sources":["../../src/application/execution.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TransportReference } from \"../domain/transport.types.ts\";\nimport type { Agent, AgentObservation, Usage } from \"../domain/agent.types.ts\";\nimport type { DispatchTelemetry } from \"../domain/dispatch-telemetry.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { ResponseSpec } from \"../domain/response.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\n\nexport interface DispatchOptions<T = undefined> {\n  readonly agent?: Agent;\n  readonly logging?: Logging;\n  readonly label?: string;\n  readonly brief: Brief;\n  readonly passes?: number;\n  readonly until?: string | readonly string[];\n  readonly idleMs?: number;\n  readonly idleWarningMs?: number;\n  readonly settleMs?: number;\n  readonly deadlineMs?: number;\n  readonly expansionMs?: number;\n  readonly signal?: AbortSignal;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly response?: ResponseSpec<T>;\n  readonly telemetry?: DispatchTelemetry;\n  readonly observe?: (event: AgentObservation) => void;\n  readonly warn?: (message: string) => void;\n  readonly diagnostic?: (message: string) => void;\n}\n\nexport interface TurnContext {\n  readonly repository: string;\n  readonly repair: boolean;\n}\n\nexport interface Turn {\n  readonly text: string;\n  readonly status: number;\n  readonly conversation?: string;\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly usage: Usage;\n  readonly durationMs: number;\n}\n\nexport interface AgentOutput {\n  readonly completed: boolean;\n  readonly conversation: string | undefined;\n  append(chunk: string): void;\n  flush(): void;\n  result(): Pick<Turn, \"text\" | \"usage\" | \"conversation\">;\n}\n\nexport interface ActivityWatchdog {\n  refresh(completed: boolean): void;\n  hold(): () => void;\n  close(): void;\n}\n\nexport interface Execution<T> {\n  readonly text: string;\n  readonly turns: readonly Turn[];\n  readonly usage: Usage;\n  readonly conversation?: string;\n  readonly value: T;\n  readonly completed: boolean;\n  readonly completion?: string;\n}\n"]}

package/dist/application/harness-context.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessHistory, HarnessRuntime } from "./harness.types.ts";
+export declare function compact(runtime: HarnessRuntime, history: HarnessHistory, step: number): Promise<void>;

package/dist/application/harness-context.js

@@ -0,0 +1,54 @@
+import { SUMMARY_INSTRUCTIONS } from "../domain/context.constants.js";
+import { OutpostError } from "../domain/errors.js";
+import { validateMessages } from "../domain/model-messages.js";
+const renderers = {
+    text: (block) => block.text,
+    "tool-call": (block) => `[tool call ${block.name} ${JSON.stringify(block.input)}]`,
+    "tool-result": (block) => `[tool ${block.isError ? "error" : "result"}]\n${block.content}`,
+    reasoning: () => "",
+};
+export async function compact(runtime, history, step) {
+    const strategy = runtime.agent.harness.context;
+    if (!strategy)
+        return;
+    const compacted = await strategy.compact({
+        messages: history.messages,
+        step,
+        model: runtime.agent.model,
+        signal: runtime.signal,
+        summarize: (messages) => summarize(runtime, messages),
+    });
+    runtime.signal.throwIfAborted();
+    if (compacted === undefined)
+        return;
+    validateMessages(compacted);
+    const cleaned = compacted.map((message) => ({
+        ...message,
+        content: message.content.filter((block) => block.type !== "reasoning"),
+    }));
+    validateMessages(cleaned);
+    await history.replace(cleaned);
+    runtime.emit({
+        kind: "compaction",
+        strategy: strategy.name,
+        messages: cleaned.length,
+    });
+}
+async function summarize(runtime, messages) {
+    const result = await runtime.modelProvider.request({
+        model: runtime.agent.model.name,
+        system: SUMMARY_INSTRUCTIONS,
+        prompt: messages.map(render).join("\n\n") || "(no earlier messages)",
+    });
+    if ((result.stopReason ?? "end") !== "end" || !result.text.trim())
+        throw new OutpostError("response", "The model could not summarize history");
+    return result.text;
+}
+function render(message) {
+    const body = message.content
+        .map((block) => renderers[block.type](block))
+        .filter(Boolean)
+        .join("\n");
+    return `${message.role === "user" ? "User" : "Assistant"}:\n${body}`;
+}
+//# sourceMappingURL=harness-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-context.js","sourceRoot":"","sources":["../../src/application/harness-context.ts"],"names":[],"mappings":"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","sourcesContent":["import { SUMMARY_INSTRUCTIONS } from \"../domain/context.constants.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { validateMessages } from \"../domain/model-messages.ts\";\nimport type { ModelContentBlock, ModelMessage } from \"../domain/model.types.ts\";\nimport type {\n  BlockRenderers,\n  HarnessHistory,\n  HarnessRuntime,\n} from \"./harness.types.ts\";\n\nconst renderers: BlockRenderers = {\n  text: (block) => block.text,\n  \"tool-call\": (block) =>\n    `[tool call ${block.name} ${JSON.stringify(block.input)}]`,\n  \"tool-result\": (block) =>\n    `[tool ${block.isError ? \"error\" : \"result\"}]\\n${block.content}`,\n  reasoning: () => \"\",\n};\n\nexport async function compact(\n  runtime: HarnessRuntime,\n  history: HarnessHistory,\n  step: number,\n): Promise<void> {\n  const strategy = runtime.agent.harness.context;\n  if (!strategy) return;\n  const compacted = await strategy.compact({\n    messages: history.messages,\n    step,\n    model: runtime.agent.model,\n    signal: runtime.signal,\n    summarize: (messages) => summarize(runtime, messages),\n  });\n  runtime.signal.throwIfAborted();\n  if (compacted === undefined) return;\n  validateMessages(compacted);\n  const cleaned = compacted.map((message) => ({\n    ...message,\n    content: message.content.filter((block) => block.type !== \"reasoning\"),\n  }));\n  validateMessages(cleaned);\n  await history.replace(cleaned);\n  runtime.emit({\n    kind: \"compaction\",\n    strategy: strategy.name,\n    messages: cleaned.length,\n  });\n}\n\nasync function summarize(\n  runtime: HarnessRuntime,\n  messages: readonly ModelMessage[],\n): Promise<string> {\n  const result = await runtime.modelProvider.request({\n    model: runtime.agent.model.name,\n    system: SUMMARY_INSTRUCTIONS,\n    prompt: messages.map(render).join(\"\\n\\n\") || \"(no earlier messages)\",\n  });\n  if ((result.stopReason ?? \"end\") !== \"end\" || !result.text.trim())\n    throw new OutpostError(\"response\", \"The model could not summarize history\");\n  return result.text;\n}\n\nfunction render(message: ModelMessage): string {\n  const body = message.content\n    .map((block) =>\n      (renderers[block.type] as (value: ModelContentBlock) => string)(block),\n    )\n    .filter(Boolean)\n    .join(\"\\n\");\n  return `${message.role === \"user\" ? \"User\" : \"Assistant\"}:\\n${body}`;\n}\n"]}

package/dist/application/harness-history.d.ts

@@ -0,0 +1,3 @@
+import type { TranscriptHandle } from "../infrastructure/conversations/harness-transcript.types.ts";
+import type { HarnessHistory } from "./harness.types.ts";
+export declare function harnessHistory(transcript?: TranscriptHandle): HarnessHistory;

package/dist/application/harness-history.js

@@ -0,0 +1,17 @@
+export function harnessHistory(transcript) {
+    let messages = transcript?.messages ?? [];
+    return {
+        get messages() {
+            return messages;
+        },
+        async append(message) {
+            await transcript?.append({ type: "message", message });
+            messages = [...messages, message];
+        },
+        async replace(next) {
+            await transcript?.append({ type: "compaction", messages: next });
+            messages = [...next];
+        },
+    };
+}
+//# sourceMappingURL=harness-history.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-history.js","sourceRoot":"","sources":["../../src/application/harness-history.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,cAAc,CAAC,UAA6B;IAC1D,IAAI,QAAQ,GAA4B,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC;IACnE,OAAO;QACL,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ModelMessage } from \"../domain/model.types.ts\";\nimport type { TranscriptHandle } from \"../infrastructure/conversations/harness-transcript.types.ts\";\nimport type { HarnessHistory } from \"./harness.types.ts\";\n\nexport function harnessHistory(transcript?: TranscriptHandle): HarnessHistory {\n  let messages: readonly ModelMessage[] = transcript?.messages ?? [];\n  return {\n    get messages() {\n      return messages;\n    },\n    async append(message) {\n      await transcript?.append({ type: \"message\", message });\n      messages = [...messages, message];\n    },\n    async replace(next) {\n      await transcript?.append({ type: \"compaction\", messages: next });\n      messages = [...next];\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,9 @@
+import type { ModelMessage, ModelResult, ModelToolCallBlock } from "../domain/model.types.ts";
+import type { ToolOutput } from "../domain/tool.types.ts";
+import type { HarnessRuntime, ToolDenial, ToolOutcome } from "./harness.types.ts";
+export declare function sessionInstructions(runtime: HarnessRuntime, prompt: string): Promise<readonly string[]>;
+export declare function beforeModel(runtime: HarnessRuntime, messages: readonly ModelMessage[], step: number): Promise<void>;
+export declare function afterModel(runtime: HarnessRuntime, result: ModelResult, step: number): Promise<void>;
+export declare function beforeTool(runtime: HarnessRuntime, call: ModelToolCallBlock, step: number): Promise<ToolDenial | ModelToolCallBlock>;
+export declare function afterTool(runtime: HarnessRuntime, call: ModelToolCallBlock, outcome: ToolOutcome, step: number, normalize: (output: ToolOutput) => ToolOutcome): Promise<ToolOutcome>;
+export declare function stopRequest(runtime: HarnessRuntime, text: string, step: number): Promise<string | undefined>;

package/dist/application/harness-hooks.js

@@ -0,0 +1,90 @@
+import { OutpostError } from "../domain/errors.js";
+export async function sessionInstructions(runtime, prompt) {
+    const texts = [];
+    for (const decision of await each(runtime, "session-start", { prompt }, 0)) {
+        if (decision === undefined)
+            continue;
+        expect(typeof decision.instructions === "string", "session-start hooks may only return { instructions }");
+        texts.push(decision.instructions);
+    }
+    return texts;
+}
+export async function beforeModel(runtime, messages, step) {
+    await each(runtime, "before-model", { messages }, step);
+}
+export async function afterModel(runtime, result, step) {
+    await each(runtime, "after-model", { result }, step);
+}
+export async function beforeTool(runtime, call, step) {
+    let current = call;
+    for (const hook of hooks(runtime, "before-tool")) {
+        const decision = await hook.run({
+            call: current,
+            ...context(runtime, step),
+        });
+        if (decision === undefined)
+            continue;
+        expect(decision !== null && typeof decision === "object", "before-tool hooks may return { deny } or { input }");
+        if ("deny" in decision) {
+            expect(typeof decision.deny === "string" && decision.deny.trim() !== "", "before-tool deny reasons must be nonempty text");
+            return { deny: decision.deny };
+        }
+        expect("input" in decision, "before-tool hooks may return { deny } or { input }");
+        current = { ...current, input: decision.input };
+    }
+    return current;
+}
+export async function afterTool(runtime, call, outcome, step, normalize) {
+    let current = outcome;
+    for (const hook of hooks(runtime, "after-tool")) {
+        const decision = await hook.run({
+            call,
+            result: current,
+            ...context(runtime, step),
+        });
+        if (decision === undefined)
+            continue;
+        expect(decision !== null && typeof decision === "object" && "result" in decision, "after-tool hooks may only return { result }");
+        current = normalize(decision.result);
+    }
+    return current;
+}
+export async function stopRequest(runtime, text, step) {
+    for (const hook of hooks(runtime, "stop")) {
+        const decision = await hook.run({ text, ...context(runtime, step) });
+        if (decision === undefined)
+            continue;
+        expect(decision !== null &&
+            typeof decision === "object" &&
+            typeof decision.continue === "string" &&
+            decision.continue.trim() !== "", "stop hooks may only return { continue } with nonempty text");
+        return decision.continue;
+    }
+    return undefined;
+}
+async function each(runtime, phase, event, step) {
+    const decisions = [];
+    for (const hook of hooks(runtime, phase))
+        decisions.push(await hook.run({
+            ...event,
+            ...context(runtime, step),
+        }));
+    return decisions;
+}
+function hooks(runtime, phase) {
+    return runtime.agent.harness.hooks.filter((hook) => hook.on === phase);
+}
+function context(runtime, step) {
+    runtime.signal.throwIfAborted();
+    return {
+        sandbox: runtime.sandbox,
+        signal: runtime.signal,
+        model: runtime.agent.model,
+        step,
+    };
+}
+function expect(condition, message) {
+    if (!condition)
+        throw new OutpostError("configuration", message);
+}
+//# sourceMappingURL=harness-hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-hooks.js","sourceRoot":"","sources":["../../src/application/harness-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport type {\n  HarnessHook,\n  HarnessHookContext,\n  HarnessHookEvents,\n  HarnessHookInput,\n  HarnessHookPhase,\n  HarnessHookResult,\n} from \"../domain/hook.types.ts\";\nimport type {\n  ModelMessage,\n  ModelResult,\n  ModelToolCallBlock,\n} from \"../domain/model.types.ts\";\nimport type { ToolOutput } from \"../domain/tool.types.ts\";\nimport type {\n  HarnessRuntime,\n  ToolDenial,\n  ToolOutcome,\n} from \"./harness.types.ts\";\n\nexport async function sessionInstructions(\n  runtime: HarnessRuntime,\n  prompt: string,\n): Promise<readonly string[]> {\n  const texts: string[] = [];\n  for (const decision of await each(runtime, \"session-start\", { prompt }, 0)) {\n    if (decision === undefined) continue;\n    expect(\n      typeof decision.instructions === \"string\",\n      \"session-start hooks may only return { instructions }\",\n    );\n    texts.push(decision.instructions);\n  }\n  return texts;\n}\n\nexport async function beforeModel(\n  runtime: HarnessRuntime,\n  messages: readonly ModelMessage[],\n  step: number,\n): Promise<void> {\n  await each(runtime, \"before-model\", { messages }, step);\n}\n\nexport async function afterModel(\n  runtime: HarnessRuntime,\n  result: ModelResult,\n  step: number,\n): Promise<void> {\n  await each(runtime, \"after-model\", { result }, step);\n}\n\nexport async function beforeTool(\n  runtime: HarnessRuntime,\n  call: ModelToolCallBlock,\n  step: number,\n): Promise<ToolDenial | ModelToolCallBlock> {\n  let current = call;\n  for (const hook of hooks(runtime, \"before-tool\")) {\n    const decision = await hook.run({\n      call: current,\n      ...context(runtime, step),\n    });\n    if (decision === undefined) continue;\n    expect(\n      decision !== null && typeof decision === \"object\",\n      \"before-tool hooks may return { deny } or { input }\",\n    );\n    if (\"deny\" in decision) {\n      expect(\n        typeof decision.deny === \"string\" && decision.deny.trim() !== \"\",\n        \"before-tool deny reasons must be nonempty text\",\n      );\n      return { deny: decision.deny };\n    }\n    expect(\n      \"input\" in decision,\n      \"before-tool hooks may return { deny } or { input }\",\n    );\n    current = { ...current, input: decision.input };\n  }\n  return current;\n}\n\nexport async function afterTool(\n  runtime: HarnessRuntime,\n  call: ModelToolCallBlock,\n  outcome: ToolOutcome,\n  step: number,\n  normalize: (output: ToolOutput) => ToolOutcome,\n): Promise<ToolOutcome> {\n  let current = outcome;\n  for (const hook of hooks(runtime, \"after-tool\")) {\n    const decision = await hook.run({\n      call,\n      result: current,\n      ...context(runtime, step),\n    });\n    if (decision === undefined) continue;\n    expect(\n      decision !== null && typeof decision === \"object\" && \"result\" in decision,\n      \"after-tool hooks may only return { result }\",\n    );\n    current = normalize(decision.result);\n  }\n  return current;\n}\n\nexport async function stopRequest(\n  runtime: HarnessRuntime,\n  text: string,\n  step: number,\n): Promise<string | undefined> {\n  for (const hook of hooks(runtime, \"stop\")) {\n    const decision = await hook.run({ text, ...context(runtime, step) });\n    if (decision === undefined) continue;\n    expect(\n      decision !== null &&\n        typeof decision === \"object\" &&\n        typeof decision.continue === \"string\" &&\n        decision.continue.trim() !== \"\",\n      \"stop hooks may only return { continue } with nonempty text\",\n    );\n    return decision.continue;\n  }\n  return undefined;\n}\n\nasync function each<Phase extends HarnessHookPhase>(\n  runtime: HarnessRuntime,\n  phase: Phase,\n  event: HarnessHookEvents[Phase],\n  step: number,\n): Promise<readonly HarnessHookResult<Phase>[]> {\n  const decisions: HarnessHookResult<Phase>[] = [];\n  for (const hook of hooks(runtime, phase))\n    decisions.push(\n      await hook.run({\n        ...event,\n        ...context(runtime, step),\n      } as HarnessHookInput<Phase>),\n    );\n  return decisions;\n}\n\nfunction hooks<Phase extends HarnessHookPhase>(\n  runtime: HarnessRuntime,\n  phase: Phase,\n): readonly HarnessHook<Phase>[] {\n  return runtime.agent.harness.hooks.filter(\n    (hook): hook is HarnessHook<Phase> => hook.on === phase,\n  );\n}\n\nfunction context(runtime: HarnessRuntime, step: number): HarnessHookContext {\n  runtime.signal.throwIfAborted();\n  return {\n    sandbox: runtime.sandbox,\n    signal: runtime.signal,\n    model: runtime.agent.model,\n    step,\n  };\n}\n\nfunction expect(condition: unknown, message: string): asserts condition {\n  if (!condition) throw new OutpostError(\"configuration\", message);\n}\n"]}

package/dist/application/harness-loop.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessHistory, HarnessRuntime } from "./harness.types.ts";
+export declare function harnessLoop(runtime: HarnessRuntime, prompt: string, history: HarnessHistory): Promise<string>;

package/dist/application/harness-loop.js

@@ -0,0 +1,132 @@
+import { OutpostError } from "../domain/errors.js";
+import { loadedSkills } from "../domain/skill.js";
+import { addUsage } from "../domain/usage.js";
+import { compact } from "./harness-context.js";
+import { afterModel, beforeModel, sessionInstructions, stopRequest, } from "./harness-hooks.js";
+import { executeToolCalls } from "./tool-execution.js";
+const stopHandlers = {
+    end: async (runtime, state, result, content) => {
+        const message = await stopRequest(runtime, result.text, state.step);
+        await state.history.append({ role: "assistant", content });
+        if (message === undefined)
+            return result.text;
+        runtime.emit({ kind: "stop-prevented", message });
+        await state.history.append({
+            role: "user",
+            content: [{ type: "text", text: message }],
+        });
+        return undefined;
+    },
+    "max-tokens": async (_runtime, state) => {
+        throw new OutpostError("limit", `Model output reached maxOutputTokens during step ${state.step}`, { limit: "maxOutputTokens", step: state.step });
+    },
+    refusal: async (_runtime, state) => {
+        throw new OutpostError("response", "The model refused to continue", {
+            step: state.step,
+        });
+    },
+    "tool-calls": async (runtime, state, _result, content) => {
+        const calls = content.filter((block) => block.type === "tool-call");
+        state.toolCalls += calls.length;
+        const { maxToolCalls } = runtime.agent.harness.limits;
+        if (maxToolCalls !== undefined && state.toolCalls > maxToolCalls)
+            throw limit("maxToolCalls", `Harness exceeded ${maxToolCalls} tool calls`);
+        await state.history.append({ role: "assistant", content });
+        await state.history.append({
+            role: "user",
+            content: await executeToolCalls(runtime, calls, state.step, loadedSkills(state.history.messages)),
+        });
+        return undefined;
+    },
+};
+export async function harnessLoop(runtime, prompt, history) {
+    const { harness, model } = runtime.agent;
+    const system = [
+        await instructions(runtime),
+        ...(await sessionInstructions(runtime, prompt)),
+    ]
+        .filter((text) => text.trim())
+        .join("\n\n");
+    const tools = runtime.tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    }));
+    await history.append({
+        role: "user",
+        content: [{ type: "text", text: prompt }],
+    });
+    let usage = { input: 0, cached: 0, output: 0 };
+    let toolCalls = 0;
+    for (let step = 1;; step++) {
+        runtime.signal.throwIfAborted();
+        if (step > harness.limits.maxSteps)
+            throw limit("maxSteps", `Harness reached ${harness.limits.maxSteps} steps without a final answer`);
+        const exceeded = exceededUsage(usage, harness.limits.usage);
+        if (exceeded)
+            throw limit("usage", `Harness exceeded its ${exceeded} token budget`);
+        runtime.emit({ kind: "step", index: step });
+        await compact(runtime, history, step);
+        await beforeModel(runtime, history.messages, step);
+        const result = await requestModel(runtime, {
+            model: model.name,
+            messages: history.messages,
+            ...(system ? { system } : {}),
+            ...(tools.length ? { tools } : {}),
+            ...(harness.cache ? { cache: true } : {}),
+        });
+        if (harness.limits.usage && !result.usage)
+            throw new OutpostError("configuration", "Harness usage limits require a model provider that reports usage");
+        if (result.usage)
+            usage = addUsage(usage, result.usage);
+        await afterModel(runtime, result, step);
+        const content = result.content ?? [
+            { type: "text", text: result.text },
+        ];
+        for (const block of content)
+            if (block.type === "text" && block.text)
+                runtime.emit({ kind: "text", text: block.text });
+        const state = { history, step, toolCalls };
+        const reason = result.stopReason ?? inferredStop(content);
+        const answer = await stopHandlers[reason](runtime, state, result, content);
+        toolCalls = state.toolCalls;
+        if (answer !== undefined)
+            return answer;
+    }
+}
+async function instructions(runtime) {
+    const texts = await Promise.all(runtime.agent.harness.instructions.map((entry) => entry.resolve({
+        sandbox: runtime.sandbox,
+        signal: runtime.signal,
+        model: runtime.agent.model,
+    })));
+    runtime.signal.throwIfAborted();
+    return texts.filter((text) => text.trim()).join("\n\n");
+}
+function inferredStop(content) {
+    return content.some((block) => block.type === "tool-call")
+        ? "tool-calls"
+        : "end";
+}
+function exceededUsage(usage, limits) {
+    return Object.entries(limits ?? {}).find(([key, value]) => (usage[key] ?? 0) > (value ?? Infinity))?.[0];
+}
+function limit(name, message) {
+    return new OutpostError("limit", message, { limit: name });
+}
+async function requestModel(runtime, request) {
+    const provider = runtime.modelProvider;
+    if (!provider.stream)
+        return provider.request(request);
+    let result;
+    for await (const event of provider.stream(request)) {
+        if (event.type === "text-delta")
+            runtime.emit({ kind: "text-delta", text: event.text });
+        if (event.type === "result")
+            result = event.result;
+    }
+    if (!result)
+        throw new OutpostError("response", "Model stream ended without a result");
+    return result;
+}
+//# sourceMappingURL=harness-loop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-loop.js","sourceRoot":"","sources":["../../src/application/harness-loop.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Usage } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type {\n  ModelContentBlock,\n  ModelRequest,\n  ModelResult,\n  ModelStopReason,\n  ModelToolCallBlock,\n  ModelToolSpec,\n} from \"../domain/model.types.ts\";\nimport { loadedSkills } from \"../domain/skill.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type {\n  HarnessHistory,\n  HarnessRuntime,\n  LoopState,\n  StopHandler,\n} from \"./harness.types.ts\";\nimport { compact } from \"./harness-context.ts\";\nimport {\n  afterModel,\n  beforeModel,\n  sessionInstructions,\n  stopRequest,\n} from \"./harness-hooks.ts\";\nimport { executeToolCalls } from \"./tool-execution.ts\";\n\nconst stopHandlers: Readonly<Record<ModelStopReason, StopHandler>> = {\n  end: async (runtime, state, result, content) => {\n    const message = await stopRequest(runtime, result.text, state.step);\n    await state.history.append({ role: \"assistant\", content });\n    if (message === undefined) return result.text;\n    runtime.emit({ kind: \"stop-prevented\", message });\n    await state.history.append({\n      role: \"user\",\n      content: [{ type: \"text\", text: message }],\n    });\n    return undefined;\n  },\n  \"max-tokens\": async (_runtime, state) => {\n    throw new OutpostError(\n      \"limit\",\n      `Model output reached maxOutputTokens during step ${state.step}`,\n      { limit: \"maxOutputTokens\", step: state.step },\n    );\n  },\n  refusal: async (_runtime, state) => {\n    throw new OutpostError(\"response\", \"The model refused to continue\", {\n      step: state.step,\n    });\n  },\n  \"tool-calls\": async (runtime, state, _result, content) => {\n    const calls = content.filter(\n      (block): block is ModelToolCallBlock => block.type === \"tool-call\",\n    );\n    state.toolCalls += calls.length;\n    const { maxToolCalls } = runtime.agent.harness.limits;\n    if (maxToolCalls !== undefined && state.toolCalls > maxToolCalls)\n      throw limit(\n        \"maxToolCalls\",\n        `Harness exceeded ${maxToolCalls} tool calls`,\n      );\n    await state.history.append({ role: \"assistant\", content });\n    await state.history.append({\n      role: \"user\",\n      content: await executeToolCalls(\n        runtime,\n        calls,\n        state.step,\n        loadedSkills(state.history.messages),\n      ),\n    });\n    return undefined;\n  },\n};\n\nexport async function harnessLoop(\n  runtime: HarnessRuntime,\n  prompt: string,\n  history: HarnessHistory,\n): Promise<string> {\n  const { harness, model } = runtime.agent;\n  const system = [\n    await instructions(runtime),\n    ...(await sessionInstructions(runtime, prompt)),\n  ]\n    .filter((text) => text.trim())\n    .join(\"\\n\\n\");\n  const tools: ModelToolSpec[] = runtime.tools.map((tool) => ({\n    name: tool.name,\n    description: tool.description,\n    inputSchema: tool.inputSchema,\n  }));\n  await history.append({\n    role: \"user\",\n    content: [{ type: \"text\", text: prompt }],\n  });\n  let usage: Usage = { input: 0, cached: 0, output: 0 };\n  let toolCalls = 0;\n  for (let step = 1; ; step++) {\n    runtime.signal.throwIfAborted();\n    if (step > harness.limits.maxSteps)\n      throw limit(\n        \"maxSteps\",\n        `Harness reached ${harness.limits.maxSteps} steps without a final answer`,\n      );\n    const exceeded = exceededUsage(usage, harness.limits.usage);\n    if (exceeded)\n      throw limit(\"usage\", `Harness exceeded its ${exceeded} token budget`);\n    runtime.emit({ kind: \"step\", index: step });\n    await compact(runtime, history, step);\n    await beforeModel(runtime, history.messages, step);\n    const result = await requestModel(runtime, {\n      model: model.name,\n      messages: history.messages,\n      ...(system ? { system } : {}),\n      ...(tools.length ? { tools } : {}),\n      ...(harness.cache ? { cache: true } : {}),\n    });\n    if (harness.limits.usage && !result.usage)\n      throw new OutpostError(\n        \"configuration\",\n        \"Harness usage limits require a model provider that reports usage\",\n      );\n    if (result.usage) usage = addUsage(usage, result.usage);\n    await afterModel(runtime, result, step);\n    const content: readonly ModelContentBlock[] = result.content ?? [\n      { type: \"text\", text: result.text },\n    ];\n    for (const block of content)\n      if (block.type === \"text\" && block.text)\n        runtime.emit({ kind: \"text\", text: block.text });\n    const state: LoopState = { history, step, toolCalls };\n    const reason = result.stopReason ?? inferredStop(content);\n    const answer = await stopHandlers[reason](runtime, state, result, content);\n    toolCalls = state.toolCalls;\n    if (answer !== undefined) return answer;\n  }\n}\n\nasync function instructions(runtime: HarnessRuntime): Promise<string> {\n  const texts = await Promise.all(\n    runtime.agent.harness.instructions.map((entry) =>\n      entry.resolve({\n        sandbox: runtime.sandbox,\n        signal: runtime.signal,\n        model: runtime.agent.model,\n      }),\n    ),\n  );\n  runtime.signal.throwIfAborted();\n  return texts.filter((text) => text.trim()).join(\"\\n\\n\");\n}\n\nfunction inferredStop(content: readonly ModelContentBlock[]): ModelStopReason {\n  return content.some((block) => block.type === \"tool-call\")\n    ? \"tool-calls\"\n    : \"end\";\n}\n\nfunction exceededUsage(\n  usage: Usage,\n  limits: Partial<Usage> | undefined,\n): string | undefined {\n  return Object.entries(limits ?? {}).find(\n    ([key, value]) => (usage[key as keyof Usage] ?? 0) > (value ?? Infinity),\n  )?.[0];\n}\n\nfunction limit(name: string, message: string): OutpostError {\n  return new OutpostError(\"limit\", message, { limit: name });\n}\n\nasync function requestModel(\n  runtime: HarnessRuntime,\n  request: ModelRequest,\n): Promise<ModelResult> {\n  const provider = runtime.modelProvider;\n  if (!provider.stream) return provider.request(request);\n  let result: ModelResult | undefined;\n  for await (const event of provider.stream(request)) {\n    if (event.type === \"text-delta\")\n      runtime.emit({ kind: \"text-delta\", text: event.text });\n    if (event.type === \"result\") result = event.result;\n  }\n  if (!result)\n    throw new OutpostError(\"response\", \"Model stream ended without a result\");\n  return result;\n}\n"]}