@elie-laloum/outpost 5.0.0 → 7.0.0

package/dist/application/doctor-agent.constants.js

@@ -1,10 +1,47 @@
+import { antigravityVariables } from "../adapters/agents/antigravity.constants.js";
+import { antigravityHarness } from "../adapters/agents/antigravity-adapter.js";
+import { antigravityDiagnostics } from "../adapters/agents/antigravity-diagnostics.js";
+import { claudeHarness } from "../adapters/agents/claude-adapter.js";
 import { claudeDiagnostics } from "../adapters/agents/claude-diagnostics.js";
+import { codexHarness } from "../adapters/agents/codex-adapter.js";
 import { codexDiagnostics } from "../adapters/agents/codex-diagnostics.js";
-import { geminiDiagnostics } from "../adapters/agents/gemini-diagnostics.js";
-export const agentDiagnosticPlans = {
-    gemini: geminiDiagnostics,
-    claude: claudeDiagnostics,
-    codex: codexDiagnostics,
-};
+import { copilotHarness } from "../adapters/agents/copilot-adapter.js";
+import { copilotDiagnostics } from "../adapters/agents/copilot-diagnostics.js";
+import { kimiHarness } from "../adapters/agents/kimi-adapter.js";
+import { kimiDiagnostics } from "../adapters/agents/kimi-diagnostics.js";
+import { agentVersions } from "../providers/versions.constants.js";
+export const doctorAgents = Object.freeze({
+    codex: {
+        executable: "codex",
+        referenceVersion: agentVersions.codex,
+        diagnostics: codexDiagnostics,
+        harness: () => codexHarness(),
+    },
+    claude: {
+        executable: "claude",
+        referenceVersion: agentVersions.claude,
+        diagnostics: claudeDiagnostics,
+        harness: () => claudeHarness(),
+    },
+    antigravity: {
+        executable: "agy",
+        referenceVersion: agentVersions.antigravity,
+        variables: antigravityVariables,
+        diagnostics: antigravityDiagnostics,
+        harness: () => antigravityHarness(),
+    },
+    copilot: {
+        executable: "copilot",
+        referenceVersion: agentVersions.copilot,
+        diagnostics: copilotDiagnostics,
+        harness: () => copilotHarness(),
+    },
+    kimi: {
+        executable: "kimi",
+        referenceVersion: agentVersions.kimi,
+        diagnostics: kimiDiagnostics,
+        harness: () => kimiHarness(),
+    },
+});
 export const agentDiagnosticDefaults = Object.freeze({ retain: 65_536 });
 //# sourceMappingURL=doctor-agent.constants.js.map

package/dist/application/doctor-agent.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-agent.constants.js","sourceRoot":"","sources":["../../src/application/doctor-agent.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,gBAAgB;CACf,CAAC;AACX,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC","sourcesContent":["import { claudeDiagnostics } from \"../adapters/agents/claude-diagnostics.ts\";\nimport { codexDiagnostics } from \"../adapters/agents/codex-diagnostics.ts\";\nimport { geminiDiagnostics } from \"../adapters/agents/gemini-diagnostics.ts\";\n\nexport const agentDiagnosticPlans = {\n  gemini: geminiDiagnostics,\n  claude: claudeDiagnostics,\n  codex: codexDiagnostics,\n} as const;\nexport const agentDiagnosticDefaults = Object.freeze({ retain: 65_536 });\n"]}
+{"version":3,"file":"doctor-agent.constants.js","sourceRoot":"","sources":["../../src/application/doctor-agent.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,YAAY,GACvB,MAAM,CAAC,MAAM,CAAC;IACZ,KAAK,EAAE;QACL,UAAU,EAAE,OAAO;QACnB,gBAAgB,EAAE,aAAa,CAAC,KAAK;QACrC,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;KAC9B;IACD,MAAM,EAAE;QACN,UAAU,EAAE,QAAQ;QACpB,gBAAgB,EAAE,aAAa,CAAC,MAAM;QACtC,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;KAC/B;IACD,WAAW,EAAE;QACX,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,aAAa,CAAC,WAAW;QAC3C,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,sBAAsB;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE;KACpC;IACD,OAAO,EAAE;QACP,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,aAAa,CAAC,OAAO;QACvC,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;KAChC;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM;QAClB,gBAAgB,EAAE,aAAa,CAAC,IAAI;QACpC,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;KAC7B;CACF,CAAC,CAAC;AACL,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC","sourcesContent":["import { antigravityVariables } from \"../adapters/agents/antigravity.constants.ts\";\nimport { antigravityHarness } from \"../adapters/agents/antigravity-adapter.ts\";\nimport { antigravityDiagnostics } from \"../adapters/agents/antigravity-diagnostics.ts\";\nimport { claudeHarness } from \"../adapters/agents/claude-adapter.ts\";\nimport { claudeDiagnostics } from \"../adapters/agents/claude-diagnostics.ts\";\nimport { codexHarness } from \"../adapters/agents/codex-adapter.ts\";\nimport { codexDiagnostics } from \"../adapters/agents/codex-diagnostics.ts\";\nimport { copilotHarness } from \"../adapters/agents/copilot-adapter.ts\";\nimport { copilotDiagnostics } from \"../adapters/agents/copilot-diagnostics.ts\";\nimport { kimiHarness } from \"../adapters/agents/kimi-adapter.ts\";\nimport { kimiDiagnostics } from \"../adapters/agents/kimi-diagnostics.ts\";\nimport { agentVersions } from \"../providers/versions.constants.ts\";\nimport type { DoctorAgent, DoctorAgentProfile } from \"./doctor.types.ts\";\n\nexport const doctorAgents: Readonly<Record<DoctorAgent, DoctorAgentProfile>> =\n  Object.freeze({\n    codex: {\n      executable: \"codex\",\n      referenceVersion: agentVersions.codex,\n      diagnostics: codexDiagnostics,\n      harness: () => codexHarness(),\n    },\n    claude: {\n      executable: \"claude\",\n      referenceVersion: agentVersions.claude,\n      diagnostics: claudeDiagnostics,\n      harness: () => claudeHarness(),\n    },\n    antigravity: {\n      executable: \"agy\",\n      referenceVersion: agentVersions.antigravity,\n      variables: antigravityVariables,\n      diagnostics: antigravityDiagnostics,\n      harness: () => antigravityHarness(),\n    },\n    copilot: {\n      executable: \"copilot\",\n      referenceVersion: agentVersions.copilot,\n      diagnostics: copilotDiagnostics,\n      harness: () => copilotHarness(),\n    },\n    kimi: {\n      executable: \"kimi\",\n      referenceVersion: agentVersions.kimi,\n      diagnostics: kimiDiagnostics,\n      harness: () => kimiHarness(),\n    },\n  });\nexport const agentDiagnosticDefaults = Object.freeze({ retain: 65_536 });\n"]}

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

@@ -1,3 +1,4 @@
 import type { Executor } from "../infrastructure/process.types.ts";
-import type { DiagnosticCheck, DoctorAgent } from "./doctor.types.ts";
+import type { DiagnosticCheck, DiagnosticProbe, DoctorAgent } from "./doctor.types.ts";
+export declare function agentVersionProbe(agent: DoctorAgent): Pick<DiagnosticProbe, "command" | "readVersion" | "referenceVersion">;
 export declare function diagnoseAgentCli(agent: DoctorAgent, execute: Executor): Promise<readonly DiagnosticCheck[]>;

package/dist/application/doctor-agent.js

@@ -1,9 +1,21 @@
 import { stripVTControlCharacters } from "node:util";
 import { diagnosticProbe } from "./diagnostic-probe.js";
-import { agentDiagnosticDefaults, agentDiagnosticPlans, } from "./doctor-agent.constants.js";
+import { agentDiagnosticDefaults, doctorAgents, } from "./doctor-agent.constants.js";
+export function agentVersionProbe(agent) {
+    const { executable, referenceVersion, variables } = doctorAgents[agent];
+    return {
+        command: {
+            executable,
+            arguments: ["--version"],
+            ...(variables ? { variables } : {}),
+        },
+        readVersion: true,
+        ...(referenceVersion === undefined ? {} : { referenceVersion }),
+    };
+}
 export async function diagnoseAgentCli(agent, execute) {
     const checks = [];
-    for (const plan of agentDiagnosticPlans[agent]()) {
+    for (const plan of doctorAgents[agent].diagnostics()) {
         let help = "";
         const check = await diagnosticProbe({
             id: `agent.cli.${plan.mode}`,
@@ -21,7 +33,7 @@ export async function diagnoseAgentCli(agent, execute) {
         }
         const usage = help
             .split(/\r?\n/)
-            .some((line) => line.trim().startsWith(`Usage: ${plan.usage} [`));
+            .some((line) => line.trim().startsWith(plan.usage));
         if (!usage) {
             checks.push({
                 id: check.id,

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

@@ -1 +1 @@
-{"version":3,"file":"doctor-agent.js","sourceRoot":"","sources":["../../src/application/doctor-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAGrC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAkB,EAClB,OAAiB;IAEjB,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,eAAe,CACjC;YACE,EAAE,EAAE,aAAa,IAAI,CAAC,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,uBAAuB,CAAC,MAAM,EAAE;YACpE,aAAa,EAAE,MAAM;YACrB,MAAM,EACJ,gGAAgG;SACnG,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,GAAG,wBAAwB,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC;QAChB,CAAC,CACF,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI;aACf,KAAK,CAAC,OAAO,CAAC;aACd,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,MAAM;gBACd,OAAO,EACL,uGAAuG;aAC1G,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB;YACE,GAAG,IAAI,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SACtE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC3B,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yEAAyE;aAChJ,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EACL,sJAAsJ;SACzJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { stripVTControlCharacters } from \"node:util\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport {\n  agentDiagnosticDefaults,\n  agentDiagnosticPlans,\n} from \"./doctor-agent.constants.ts\";\nimport type { DiagnosticCheck, DoctorAgent } from \"./doctor.types.ts\";\n\nexport async function diagnoseAgentCli(\n  agent: DoctorAgent,\n  execute: Executor,\n): Promise<readonly DiagnosticCheck[]> {\n  const checks: DiagnosticCheck[] = [];\n  for (const plan of agentDiagnosticPlans[agent]()) {\n    let help = \"\";\n    const check = await diagnosticProbe(\n      {\n        id: `agent.cli.${plan.mode}`,\n        command: { ...plan.command, retain: agentDiagnosticDefaults.retain },\n        failureStatus: \"fail\",\n        remedy:\n          \"The agent CLI help command failed. Check the agent CLI in this image and rebuild it if needed.\",\n      },\n      async (command) => {\n        const result = await execute(command);\n        help = stripVTControlCharacters(`${result.stdout}\\n${result.stderr}`);\n        return result;\n      },\n    );\n    if (check.status !== \"pass\") {\n      checks.push(check);\n      continue;\n    }\n    const usage = help\n      .split(/\\r?\\n/)\n      .some((line) => line.trim().startsWith(`Usage: ${plan.usage} [`));\n    if (!usage) {\n      checks.push({\n        id: check.id,\n        status: \"warn\",\n        message:\n          \"Command exited successfully but the expected help could not be identified; CLI support is unverified.\",\n      });\n      continue;\n    }\n    const declared = new Set(\n      [\n        ...help.matchAll(/^\\s*(?:-[A-Za-z0-9?],?\\s+)?(--[A-Za-z][\\w-]*)\\b/gm),\n      ].map((match) => match[1]),\n    );\n    const missing = plan.options.filter((option) => !declared.has(option));\n    if (missing.length) {\n      checks.push({\n        id: check.id,\n        status: \"fail\",\n        message: `Help does not declare required options: ${missing.join(\", \")}. Rebuild the image with a CLI supporting Outpost's default invocation.`,\n      });\n      continue;\n    }\n    checks.push({\n      id: check.id,\n      status: \"pass\",\n      message:\n        \"Help identifies the command and declares the options used by Outpost's default invocation. Conversation execution and event decoding are not tested.\",\n    });\n  }\n  return checks;\n}\n"]}
+{"version":3,"file":"doctor-agent.js","sourceRoot":"","sources":["../../src/application/doctor-agent.ts"],"names":[],"mappings":"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","sourcesContent":["import { stripVTControlCharacters } from \"node:util\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport {\n  agentDiagnosticDefaults,\n  doctorAgents,\n} from \"./doctor-agent.constants.ts\";\nimport type {\n  DiagnosticCheck,\n  DiagnosticProbe,\n  DoctorAgent,\n} from \"./doctor.types.ts\";\n\nexport function agentVersionProbe(\n  agent: DoctorAgent,\n): Pick<DiagnosticProbe, \"command\" | \"readVersion\" | \"referenceVersion\"> {\n  const { executable, referenceVersion, variables } = doctorAgents[agent];\n  return {\n    command: {\n      executable,\n      arguments: [\"--version\"],\n      ...(variables ? { variables } : {}),\n    },\n    readVersion: true,\n    ...(referenceVersion === undefined ? {} : { referenceVersion }),\n  };\n}\n\nexport async function diagnoseAgentCli(\n  agent: DoctorAgent,\n  execute: Executor,\n): Promise<readonly DiagnosticCheck[]> {\n  const checks: DiagnosticCheck[] = [];\n  for (const plan of doctorAgents[agent].diagnostics()) {\n    let help = \"\";\n    const check = await diagnosticProbe(\n      {\n        id: `agent.cli.${plan.mode}`,\n        command: { ...plan.command, retain: agentDiagnosticDefaults.retain },\n        failureStatus: \"fail\",\n        remedy:\n          \"The agent CLI help command failed. Check the agent CLI in this image and rebuild it if needed.\",\n      },\n      async (command) => {\n        const result = await execute(command);\n        help = stripVTControlCharacters(`${result.stdout}\\n${result.stderr}`);\n        return result;\n      },\n    );\n    if (check.status !== \"pass\") {\n      checks.push(check);\n      continue;\n    }\n    const usage = help\n      .split(/\\r?\\n/)\n      .some((line) => line.trim().startsWith(plan.usage));\n    if (!usage) {\n      checks.push({\n        id: check.id,\n        status: \"warn\",\n        message:\n          \"Command exited successfully but the expected help could not be identified; CLI support is unverified.\",\n      });\n      continue;\n    }\n    const declared = new Set(\n      [\n        ...help.matchAll(/^\\s*(?:-[A-Za-z0-9?],?\\s+)?(--[A-Za-z][\\w-]*)\\b/gm),\n      ].map((match) => match[1]),\n    );\n    const missing = plan.options.filter((option) => !declared.has(option));\n    if (missing.length) {\n      checks.push({\n        id: check.id,\n        status: \"fail\",\n        message: `Help does not declare required options: ${missing.join(\", \")}. Rebuild the image with a CLI supporting Outpost's default invocation.`,\n      });\n      continue;\n    }\n    checks.push({\n      id: check.id,\n      status: \"pass\",\n      message:\n        \"Help identifies the command and declares the options used by Outpost's default invocation. Conversation execution and event decoding are not tested.\",\n    });\n  }\n  return checks;\n}\n"]}

package/dist/application/doctor-image.js

@@ -5,8 +5,8 @@ import { OutpostError } from "../domain/errors.js";
 import { executeProcess } from "../infrastructure/process.js";
 import { registerCleanup } from "../infrastructure/shutdown.js";
 import { diagnosticContainer } from "../providers/diagnostic-container.js";
-import { agentVersions } from "../providers/versions.constants.js";
-import { diagnoseAgentCli } from "./doctor-agent.js";
+import { doctorAgents } from "./doctor-agent.constants.js";
+import { agentVersionProbe, diagnoseAgentCli } from "./doctor-agent.js";
 import { diagnosticProbe } from "./diagnostic-probe.js";
 import { doctorDefaults } from "./doctor.constants.js";
 export async function diagnoseImage(options, execute = executeProcess) {
@@ -71,11 +71,9 @@ async function inspectImage({ sandboxProvider, agent, image }, execute, signal)
         }, invoke));
         const agentVersion = await diagnosticProbe({
             id: "agent.sandbox",
-            command: { executable: agent, arguments: ["--version"] },
+            ...agentVersionProbe(agent),
             failureStatus: "fail",
-            readVersion: true,
-            referenceVersion: agentVersions[agent],
-            remedy: `Install ${agent} in the image and rebuild it. This check does not bootstrap agents.`,
+            remedy: `Install ${doctorAgents[agent].executable} in the image and rebuild it. This check does not bootstrap agents.`,
         }, invoke);
         checks.push(agentVersion);
         if (agentVersion.status === "fail")

package/dist/application/doctor-image.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-image.js","sourceRoot":"","sources":["../../src/application/doctor-image.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtemp, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { diagnosticContainer } from \"../providers/diagnostic-container.ts\";\nimport { agentVersions } from \"../providers/versions.constants.ts\";\nimport { diagnoseAgentCli } from \"./doctor-agent.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults } from \"./doctor.constants.ts\";\nimport type { DiagnosticCheck, DoctorImageOptions } from \"./doctor.types.ts\";\n\nexport async function diagnoseImage(\n  options: DoctorImageOptions,\n  execute: Executor = executeProcess,\n): Promise<readonly DiagnosticCheck[]> {\n  const stop = new AbortController();\n  const pending = inspectImage(options, execute, stop.signal);\n  const unregister = registerCleanup(async () => {\n    stop.abort(new OutpostError(\"aborted\", \"Image diagnostics interrupted\"));\n    await pending;\n  });\n  try {\n    return await pending;\n  } finally {\n    unregister();\n  }\n}\n\nasync function inspectImage(\n  { sandboxProvider, agent, image }: DoctorImageOptions,\n  execute: Executor,\n  signal: AbortSignal,\n): Promise<readonly DiagnosticCheck[]> {\n  const directory = await mkdtemp(join(tmpdir(), \"outpost-doctor-\"));\n  const checks: DiagnosticCheck[] = [];\n  let lease: SandboxLease | undefined;\n  let retained = false;\n  let container: string | undefined;\n  const tracked: Executor = (command) => {\n    if (command.arguments?.[0] === \"create\") {\n      const index = command.arguments.indexOf(\"--name\");\n      container = command.arguments[index + 1];\n    }\n    return execute(command);\n  };\n  try {\n    lease = await diagnosticContainer(\n      sandboxProvider,\n      image,\n      doctorDefaults.deadlineMs,\n      tracked,\n    ).acquire({\n      repository: directory,\n      directory,\n      gitDirectories: [],\n      variables: {},\n      signal,\n    });\n    checks.push({\n      id: \"image.runtime\",\n      status: \"pass\",\n      message:\n        \"Temporary sandbox started with network disabled and an empty workspace.\",\n    });\n    const sandbox = lease;\n    const invoke: Executor = (command) =>\n      sandbox.invoke({ ...command, signal });\n    for (const executable of [\"node\", \"git\"]) {\n      checks.push(\n        await diagnosticProbe(\n          {\n            id: `image.${executable}`,\n            command: { executable, arguments: [\"--version\"] },\n            failureStatus: \"fail\",\n            readVersion: true,\n            remedy: `Install ${executable} in the image and rebuild it.`,\n          },\n          invoke,\n        ),\n      );\n    }\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: \"image.home\",\n          command: {\n            executable: \"sh\",\n            arguments: [\"-c\", 'test -d \"$HOME\" && test -w \"$HOME\"'],\n          },\n          failureStatus: \"fail\",\n          remedy:\n            \"Check the image user and permissions of the private agent home.\",\n        },\n        invoke,\n      ),\n    );\n    const agentVersion = await diagnosticProbe(\n      {\n        id: \"agent.sandbox\",\n        command: { executable: agent, arguments: [\"--version\"] },\n        failureStatus: \"fail\",\n        readVersion: true,\n        referenceVersion: agentVersions[agent],\n        remedy: `Install ${agent} in the image and rebuild it. This check does not bootstrap agents.`,\n      },\n      invoke,\n    );\n    checks.push(agentVersion);\n    if (agentVersion.status === \"fail\")\n      checks.push({\n        id: \"agent.cli\",\n        status: \"skipped\",\n        message: \"CLI help checks require a successful agent version probe.\",\n      });\n    else checks.push(...(await diagnoseAgentCli(agent, invoke)));\n  } catch (error) {\n    retained = error instanceof AggregateError;\n    checks.push({\n      id: \"image.runtime\",\n      status: \"fail\",\n      message:\n        \"Image diagnostics could not start. Check that the image exists locally, its UID matches the host, and sh, sleep, setsid, kill, tar and cp are installed. No image is downloaded.\",\n    });\n  } finally {\n    if (lease) {\n      try {\n        await lease.release();\n        checks.push({\n          id: \"image.cleanup\",\n          status: \"pass\",\n          message: \"Diagnostic container removed.\",\n        });\n      } catch {\n        retained = true;\n      }\n    }\n    if (retained)\n      checks.push({\n        id: \"image.cleanup\",\n        status: \"fail\",\n        message: `Cleanup could not be confirmed. Inspect container ${container ?? \"creation state\"} with ${sandboxProvider}; temporary workspace retained at ${directory}.`,\n      });\n    if (!retained) {\n      try {\n        await rm(directory, { recursive: true, force: true });\n      } catch {\n        checks.push({\n          id: \"image.workspace\",\n          status: \"fail\",\n          message: `Could not remove temporary workspace ${directory}.`,\n        });\n      }\n    }\n  }\n  return checks;\n}\n"]}
+{"version":3,"file":"doctor-image.js","sourceRoot":"","sources":["../../src/application/doctor-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA2B,EAC3B,UAAoB,cAAc;IAElC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,IAAI,EAAE;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAsB,EACrD,OAAiB,EACjB,MAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,KAA+B,CAAC;IACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAA6B,CAAC;IAClC,MAAM,OAAO,GAAa,CAAC,OAAO,EAAE,EAAE;QACpC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClD,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,mBAAmB,CAC/B,eAAe,EACf,KAAK,EACL,cAAc,CAAC,UAAU,EACzB,OAAO,CACR,CAAC,OAAO,CAAC;YACR,UAAU,EAAE,SAAS;YACrB,SAAS;YACT,cAAc,EAAE,EAAE;YAClB,SAAS,EAAE,EAAE;YACb,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,eAAe;YACnB,MAAM,EAAE,MAAM;YACd,OAAO,EACL,yEAAyE;SAC5E,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,MAAM,MAAM,GAAa,CAAC,OAAO,EAAE,EAAE,CACnC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;gBACE,EAAE,EAAE,SAAS,UAAU,EAAE;gBACzB,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE;gBACjD,aAAa,EAAE,MAAM;gBACrB,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,WAAW,UAAU,+BAA+B;aAC7D,EACD,MAAM,CACP,CACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CACT,MAAM,eAAe,CACnB;YACE,EAAE,EAAE,YAAY;YAChB,OAAO,EAAE;gBACP,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,CAAC,IAAI,EAAE,oCAAoC,CAAC;aACxD;YACD,aAAa,EAAE,MAAM;YACrB,MAAM,EACJ,iEAAiE;SACpE,EACD,MAAM,CACP,CACF,CAAC;QACF,MAAM,YAAY,GAAG,MAAM,eAAe,CACxC;YACE,EAAE,EAAE,eAAe;YACnB,GAAG,iBAAiB,CAAC,KAAK,CAAC;YAC3B,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,WAAW,YAAY,CAAC,KAAK,CAAC,CAAC,UAAU,qEAAqE;SACvH,EACD,MAAM,CACP,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,IAAI,YAAY,CAAC,MAAM,KAAK,MAAM;YAChC,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,2DAA2D;aACrE,CAAC,CAAC;;YACA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,GAAG,KAAK,YAAY,cAAc,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,eAAe;YACnB,MAAM,EAAE,MAAM;YACd,OAAO,EACL,kLAAkL;SACrL,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,eAAe;oBACnB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,+BAA+B;iBACzC,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QACD,IAAI,QAAQ;YACV,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,eAAe;gBACnB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,qDAAqD,SAAS,IAAI,gBAAgB,SAAS,eAAe,qCAAqC,SAAS,GAAG;aACrK,CAAC,CAAC;QACL,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,iBAAiB;oBACrB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,wCAAwC,SAAS,GAAG;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { mkdtemp, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { diagnosticContainer } from \"../providers/diagnostic-container.ts\";\nimport { doctorAgents } from \"./doctor-agent.constants.ts\";\nimport { agentVersionProbe, diagnoseAgentCli } from \"./doctor-agent.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults } from \"./doctor.constants.ts\";\nimport type { DiagnosticCheck, DoctorImageOptions } from \"./doctor.types.ts\";\n\nexport async function diagnoseImage(\n  options: DoctorImageOptions,\n  execute: Executor = executeProcess,\n): Promise<readonly DiagnosticCheck[]> {\n  const stop = new AbortController();\n  const pending = inspectImage(options, execute, stop.signal);\n  const unregister = registerCleanup(async () => {\n    stop.abort(new OutpostError(\"aborted\", \"Image diagnostics interrupted\"));\n    await pending;\n  });\n  try {\n    return await pending;\n  } finally {\n    unregister();\n  }\n}\n\nasync function inspectImage(\n  { sandboxProvider, agent, image }: DoctorImageOptions,\n  execute: Executor,\n  signal: AbortSignal,\n): Promise<readonly DiagnosticCheck[]> {\n  const directory = await mkdtemp(join(tmpdir(), \"outpost-doctor-\"));\n  const checks: DiagnosticCheck[] = [];\n  let lease: SandboxLease | undefined;\n  let retained = false;\n  let container: string | undefined;\n  const tracked: Executor = (command) => {\n    if (command.arguments?.[0] === \"create\") {\n      const index = command.arguments.indexOf(\"--name\");\n      container = command.arguments[index + 1];\n    }\n    return execute(command);\n  };\n  try {\n    lease = await diagnosticContainer(\n      sandboxProvider,\n      image,\n      doctorDefaults.deadlineMs,\n      tracked,\n    ).acquire({\n      repository: directory,\n      directory,\n      gitDirectories: [],\n      variables: {},\n      signal,\n    });\n    checks.push({\n      id: \"image.runtime\",\n      status: \"pass\",\n      message:\n        \"Temporary sandbox started with network disabled and an empty workspace.\",\n    });\n    const sandbox = lease;\n    const invoke: Executor = (command) =>\n      sandbox.invoke({ ...command, signal });\n    for (const executable of [\"node\", \"git\"]) {\n      checks.push(\n        await diagnosticProbe(\n          {\n            id: `image.${executable}`,\n            command: { executable, arguments: [\"--version\"] },\n            failureStatus: \"fail\",\n            readVersion: true,\n            remedy: `Install ${executable} in the image and rebuild it.`,\n          },\n          invoke,\n        ),\n      );\n    }\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: \"image.home\",\n          command: {\n            executable: \"sh\",\n            arguments: [\"-c\", 'test -d \"$HOME\" && test -w \"$HOME\"'],\n          },\n          failureStatus: \"fail\",\n          remedy:\n            \"Check the image user and permissions of the private agent home.\",\n        },\n        invoke,\n      ),\n    );\n    const agentVersion = await diagnosticProbe(\n      {\n        id: \"agent.sandbox\",\n        ...agentVersionProbe(agent),\n        failureStatus: \"fail\",\n        remedy: `Install ${doctorAgents[agent].executable} in the image and rebuild it. This check does not bootstrap agents.`,\n      },\n      invoke,\n    );\n    checks.push(agentVersion);\n    if (agentVersion.status === \"fail\")\n      checks.push({\n        id: \"agent.cli\",\n        status: \"skipped\",\n        message: \"CLI help checks require a successful agent version probe.\",\n      });\n    else checks.push(...(await diagnoseAgentCli(agent, invoke)));\n  } catch (error) {\n    retained = error instanceof AggregateError;\n    checks.push({\n      id: \"image.runtime\",\n      status: \"fail\",\n      message:\n        \"Image diagnostics could not start. Check that the image exists locally, its UID matches the host, and sh, sleep, setsid, kill, tar and cp are installed. No image is downloaded.\",\n    });\n  } finally {\n    if (lease) {\n      try {\n        await lease.release();\n        checks.push({\n          id: \"image.cleanup\",\n          status: \"pass\",\n          message: \"Diagnostic container removed.\",\n        });\n      } catch {\n        retained = true;\n      }\n    }\n    if (retained)\n      checks.push({\n        id: \"image.cleanup\",\n        status: \"fail\",\n        message: `Cleanup could not be confirmed. Inspect container ${container ?? \"creation state\"} with ${sandboxProvider}; temporary workspace retained at ${directory}.`,\n      });\n    if (!retained) {\n      try {\n        await rm(directory, { recursive: true, force: true });\n      } catch {\n        checks.push({\n          id: \"image.workspace\",\n          status: \"fail\",\n          message: `Could not remove temporary workspace ${directory}.`,\n        });\n      }\n    }\n  }\n  return checks;\n}\n"]}

package/dist/application/doctor-protocol.js

@@ -1,16 +1,9 @@
 import { isDeepStrictEqual } from "node:util";
-import { claudeHarness } from "../adapters/agents/claude-adapter.js";
-import { codexHarness } from "../adapters/agents/codex-adapter.js";
-import { geminiHarness } from "../adapters/agents/gemini-adapter.js";
 import { protocolFixtures } from "../adapters/agents/protocol-fixtures.constants.js";
-import { agentVersions } from "../providers/versions.constants.js";
+import { doctorAgents } from "./doctor-agent.constants.js";
 export function diagnoseAgentProtocol(agent) {
-    const adapter = {
-        claude: claudeHarness,
-        codex: codexHarness,
-        gemini: geminiHarness,
-    }[agent]()
-        .bind();
+    const profile = doctorAgents[agent];
+    const adapter = profile.harness().bind();
     const checks = protocolFixtures[agent].map((fixture) => {
         const events = fixture.lines.flatMap((line) => adapter.events(line));
         const passed = isDeepStrictEqual(events, fixture.expected);
@@ -25,7 +18,9 @@ export function diagnoseAgentProtocol(agent) {
     return {
         scope: "bundled-protocol-fixtures",
         agent,
-        referenceVersion: agentVersions[agent],
+        ...(profile.referenceVersion === undefined
+            ? {}
+            : { referenceVersion: profile.referenceVersion }),
         installedCli: "unverified",
         modelCompatibility: "unverified",
         checks,

package/dist/application/doctor-protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-protocol.js","sourceRoot":"","sources":["../../src/application/doctor-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAInE,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,aAAa;KACtB,CACE,KAAK,CAAC,EAAE;SACR,IAAI,EAAE,CAAC;IACV,MAAM,MAAM,GAAsB,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACxE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO;YACL,EAAE,EAAE,oBAAoB,OAAO,CAAC,IAAI,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAChC,OAAO,EAAE,MAAM;gBACb,CAAC,CAAC,iHAAiH;gBACnH,CAAC,CAAC,6EAA6E;SAClF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,2BAA2B;QAClC,KAAK;QACL,gBAAgB,EAAE,aAAa,CAAC,KAAK,CAAC;QACtC,YAAY,EAAE,YAAY;QAC1B,kBAAkB,EAAE,YAAY;QAChC,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 { isDeepStrictEqual } from \"node:util\";\nimport { claudeHarness } from \"../adapters/agents/claude-adapter.ts\";\nimport { codexHarness } from \"../adapters/agents/codex-adapter.ts\";\nimport { geminiHarness } from \"../adapters/agents/gemini-adapter.ts\";\nimport { protocolFixtures } from \"../adapters/agents/protocol-fixtures.constants.ts\";\nimport { agentVersions } from \"../providers/versions.constants.ts\";\nimport type { AgentProtocolReport } from \"./doctor-protocol.types.ts\";\nimport type { DiagnosticCheck, DoctorAgent } from \"./doctor.types.ts\";\n\nexport function diagnoseAgentProtocol(agent: DoctorAgent): AgentProtocolReport {\n  const adapter = {\n    claude: claudeHarness,\n    codex: codexHarness,\n    gemini: geminiHarness,\n  }\n    [agent]()\n    .bind();\n  const checks: DiagnosticCheck[] = protocolFixtures[agent].map((fixture) => {\n    const events = fixture.lines.flatMap((line) => adapter.events(line));\n    const passed = isDeepStrictEqual(events, fixture.expected);\n    return {\n      id: `protocol.fixture.${fixture.name}`,\n      status: passed ? \"pass\" : \"fail\",\n      message: passed\n        ? \"Bundled synthetic events decode to the expected structural observations. No installed CLI or model was invoked.\"\n        : \"Bundled synthetic events do not match the expected structural observations.\",\n    };\n  });\n  return {\n    scope: \"bundled-protocol-fixtures\",\n    agent,\n    referenceVersion: agentVersions[agent],\n    installedCli: \"unverified\",\n    modelCompatibility: \"unverified\",\n    checks,\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}
+{"version":3,"file":"doctor-protocol.js","sourceRoot":"","sources":["../../src/application/doctor-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,MAAM,GAAsB,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACxE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO;YACL,EAAE,EAAE,oBAAoB,OAAO,CAAC,IAAI,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAChC,OAAO,EAAE,MAAM;gBACb,CAAC,CAAC,iHAAiH;gBACnH,CAAC,CAAC,6EAA6E;SAClF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,2BAA2B;QAClC,KAAK;QACL,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACnD,YAAY,EAAE,YAAY;QAC1B,kBAAkB,EAAE,YAAY;QAChC,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 { isDeepStrictEqual } from \"node:util\";\nimport { protocolFixtures } from \"../adapters/agents/protocol-fixtures.constants.ts\";\nimport { doctorAgents } from \"./doctor-agent.constants.ts\";\nimport type { AgentProtocolReport } from \"./doctor-protocol.types.ts\";\nimport type { DiagnosticCheck, DoctorAgent } from \"./doctor.types.ts\";\n\nexport function diagnoseAgentProtocol(agent: DoctorAgent): AgentProtocolReport {\n  const profile = doctorAgents[agent];\n  const adapter = profile.harness().bind();\n  const checks: DiagnosticCheck[] = protocolFixtures[agent].map((fixture) => {\n    const events = fixture.lines.flatMap((line) => adapter.events(line));\n    const passed = isDeepStrictEqual(events, fixture.expected);\n    return {\n      id: `protocol.fixture.${fixture.name}`,\n      status: passed ? \"pass\" : \"fail\",\n      message: passed\n        ? \"Bundled synthetic events decode to the expected structural observations. No installed CLI or model was invoked.\"\n        : \"Bundled synthetic events do not match the expected structural observations.\",\n    };\n  });\n  return {\n    scope: \"bundled-protocol-fixtures\",\n    agent,\n    ...(profile.referenceVersion === undefined\n      ? {}\n      : { referenceVersion: profile.referenceVersion }),\n    installedCli: \"unverified\",\n    modelCompatibility: \"unverified\",\n    checks,\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}

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

@@ -2,7 +2,7 @@ import type { DiagnosticCheck, DoctorAgent } from "./doctor.types.ts";
 export interface AgentProtocolReport {
     readonly scope: "bundled-protocol-fixtures";
     readonly agent: DoctorAgent;
-    readonly referenceVersion: string;
+    readonly referenceVersion?: string;
     readonly installedCli: "unverified";
     readonly modelCompatibility: "unverified";
     readonly checks: readonly DiagnosticCheck[];

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

@@ -1 +1 @@
-{"version":3,"file":"doctor-protocol.types.js","sourceRoot":"","sources":["../../src/application/doctor-protocol.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DiagnosticCheck, DoctorAgent } from \"./doctor.types.ts\";\n\nexport interface AgentProtocolReport {\n  readonly scope: \"bundled-protocol-fixtures\";\n  readonly agent: DoctorAgent;\n  readonly referenceVersion: string;\n  readonly installedCli: \"unverified\";\n  readonly modelCompatibility: \"unverified\";\n  readonly checks: readonly DiagnosticCheck[];\n  readonly hasFailures: boolean;\n}\n"]}
+{"version":3,"file":"doctor-protocol.types.js","sourceRoot":"","sources":["../../src/application/doctor-protocol.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DiagnosticCheck, DoctorAgent } from \"./doctor.types.ts\";\n\nexport interface AgentProtocolReport {\n  readonly scope: \"bundled-protocol-fixtures\";\n  readonly agent: DoctorAgent;\n  readonly referenceVersion?: string;\n  readonly installedCli: \"unverified\";\n  readonly modelCompatibility: \"unverified\";\n  readonly checks: readonly DiagnosticCheck[];\n  readonly hasFailures: boolean;\n}\n"]}

package/dist/application/doctor-sandbox.js

@@ -1,6 +1,5 @@
 import { invariant } from "../domain/errors.js";
-import { agentVersions } from "../providers/versions.constants.js";
-import { diagnoseAgentCli } from "./doctor-agent.js";
+import { agentVersionProbe, diagnoseAgentCli } from "./doctor-agent.js";
 import { diagnosticProbe } from "./diagnostic-probe.js";
 import { doctorDefaults } from "./doctor.constants.js";
 import { diagnoseTransfers } from "./doctor-transfers.js";
@@ -69,9 +68,7 @@ export async function diagnoseSandbox(target, options = {}) {
     if (options.agent) {
         const version = await diagnosticProbe({
             id: "agent.sandbox",
-            command: { executable: options.agent, arguments: ["--version"] },
-            readVersion: true,
-            referenceVersion: agentVersions[options.agent],
+            ...agentVersionProbe(options.agent),
             failureStatus: "fail",
             remedy: "Install the agent explicitly; diagnostics never bootstrap it.",
         }, invoke);

package/dist/application/doctor-sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-sandbox.js","sourceRoot":"","sources":["../../src/application/doctor-sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { agentVersions } from \"../providers/versions.constants.ts\";\nimport { diagnoseAgentCli } from \"./doctor-agent.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults } from \"./doctor.constants.ts\";\nimport type { DiagnosticCheck } from \"./doctor.types.ts\";\nimport { diagnoseTransfers } from \"./doctor-transfers.ts\";\nimport { sandboxDiagnosticDefaults } from \"./doctor-sandbox.constants.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { Sandbox } from \"./outpost.types.ts\";\n\nexport async function diagnoseSandbox(\n  target: Sandbox | SandboxLease,\n  options: SandboxDiagnosticOptions = {},\n): Promise<SandboxDiagnosticReport> {\n  if (\"diagnose\" in target) return target.diagnose(options);\n  const deadlineMs = options.deadlineMs ?? doctorDefaults.deadlineMs;\n  invariant(\n    Number.isInteger(deadlineMs) &&\n      deadlineMs > 0 &&\n      deadlineMs <= sandboxDiagnosticDefaults.maximumDeadlineMs,\n    \"Diagnostic deadlineMs must be an integer from 1 to 60000\",\n  );\n  options.signal?.throwIfAborted();\n  const invoke: Executor = (command) => {\n    options.signal?.throwIfAborted();\n    return target.invoke({\n      ...command,\n      deadlineMs,\n      retain: command.retain ?? doctorDefaults.retain,\n      signal: options.signal\n        ? AbortSignal.any([options.signal, AbortSignal.timeout(deadlineMs)])\n        : AbortSignal.timeout(deadlineMs),\n    });\n  };\n  const checks: DiagnosticCheck[] = [];\n  for (const executable of [\"node\", \"git\"]) {\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: `sandbox.${executable}`,\n          command: { executable, arguments: [\"--version\"] },\n          readVersion: true,\n          failureStatus: \"fail\",\n          remedy: `Install ${executable} in this sandbox.`,\n        },\n        invoke,\n      ),\n    );\n  }\n  try {\n    const result = await invoke({\n      executable: \"node\",\n      arguments: [\"-e\", sandboxDiagnosticDefaults.command],\n    });\n    const passed =\n      result.status === 7 &&\n      result.stdout === \"outpost-stdout\" &&\n      result.stderr === \"outpost-stderr\";\n    checks.push({\n      id: \"sandbox.command\",\n      status: passed ? \"pass\" : \"fail\",\n      message: passed\n        ? \"Observed separate output streams and nonzero process exit status.\"\n        : \"Command output or exit status did not match the diagnostic sentinel.\",\n    });\n  } catch {\n    checks.push({\n      id: \"sandbox.command\",\n      status: \"fail\",\n      message: \"Bounded command probe failed or was interrupted.\",\n    });\n  }\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"sandbox.home\",\n        command: {\n          executable: \"node\",\n          arguments: [\"-e\", sandboxDiagnosticDefaults.home, target.home],\n        },\n        failureStatus: \"fail\",\n        remedy: \"Check the lease home directory and its permissions.\",\n      },\n      invoke,\n    ),\n  );\n  if (options.agent) {\n    const version = await diagnosticProbe(\n      {\n        id: \"agent.sandbox\",\n        command: { executable: options.agent, arguments: [\"--version\"] },\n        readVersion: true,\n        referenceVersion: agentVersions[options.agent],\n        failureStatus: \"fail\",\n        remedy: \"Install the agent explicitly; diagnostics never bootstrap it.\",\n      },\n      invoke,\n    );\n    checks.push(version);\n    if (version.status !== \"fail\")\n      checks.push(...(await diagnoseAgentCli(options.agent, invoke)));\n  }\n  if (options.transfers === true)\n    checks.push(\n      ...(await diagnoseTransfers(\n        target,\n        { deadlineMs, ...(options.signal ? { signal: options.signal } : {}) },\n        invoke,\n      )),\n    );\n  checks.push({\n    id: \"model\",\n    status: \"skipped\",\n    message:\n      \"Authentication, model access and installed agent protocol compatibility are unverified. No model request was made.\",\n  });\n  const observed = (id: string) => {\n    const check = checks.find((check) => check.id === id);\n    if (!check) return \"unverified\" as const;\n    return check.status === \"pass\" ? (\"pass\" as const) : (\"fail\" as const);\n  };\n  return {\n    scope: \"owned-sandbox\",\n    ownership: \"caller\",\n    ...(options.sandboxProvider\n      ? {\n          sandboxProvider: {\n            name: options.sandboxProvider.name,\n            placement: options.sandboxProvider.placement,\n          },\n        }\n      : {}),\n    capabilities: [\n      {\n        id: \"command\",\n        advertised: true,\n        observed: observed(\"sandbox.command\"),\n      },\n      {\n        id: \"transfers\",\n        advertised: true,\n        observed: observed(\"sandbox.transfers\"),\n      },\n      {\n        id: \"batchTransfers\",\n        advertised: target.fileTransfers !== undefined,\n        observed: \"unverified\",\n      },\n      {\n        id: \"interactiveTerminal\",\n        advertised: \"unknown\",\n        observed: \"unverified\",\n      },\n    ],\n    checks,\n    modelCompatibility: \"unverified\",\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}
+{"version":3,"file":"doctor-sandbox.js","sourceRoot":"","sources":["../../src/application/doctor-sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { agentVersionProbe, diagnoseAgentCli } from \"./doctor-agent.ts\";\nimport { diagnosticProbe } from \"./diagnostic-probe.ts\";\nimport { doctorDefaults } from \"./doctor.constants.ts\";\nimport type { DiagnosticCheck } from \"./doctor.types.ts\";\nimport { diagnoseTransfers } from \"./doctor-transfers.ts\";\nimport { sandboxDiagnosticDefaults } from \"./doctor-sandbox.constants.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { Sandbox } from \"./outpost.types.ts\";\n\nexport async function diagnoseSandbox(\n  target: Sandbox | SandboxLease,\n  options: SandboxDiagnosticOptions = {},\n): Promise<SandboxDiagnosticReport> {\n  if (\"diagnose\" in target) return target.diagnose(options);\n  const deadlineMs = options.deadlineMs ?? doctorDefaults.deadlineMs;\n  invariant(\n    Number.isInteger(deadlineMs) &&\n      deadlineMs > 0 &&\n      deadlineMs <= sandboxDiagnosticDefaults.maximumDeadlineMs,\n    \"Diagnostic deadlineMs must be an integer from 1 to 60000\",\n  );\n  options.signal?.throwIfAborted();\n  const invoke: Executor = (command) => {\n    options.signal?.throwIfAborted();\n    return target.invoke({\n      ...command,\n      deadlineMs,\n      retain: command.retain ?? doctorDefaults.retain,\n      signal: options.signal\n        ? AbortSignal.any([options.signal, AbortSignal.timeout(deadlineMs)])\n        : AbortSignal.timeout(deadlineMs),\n    });\n  };\n  const checks: DiagnosticCheck[] = [];\n  for (const executable of [\"node\", \"git\"]) {\n    checks.push(\n      await diagnosticProbe(\n        {\n          id: `sandbox.${executable}`,\n          command: { executable, arguments: [\"--version\"] },\n          readVersion: true,\n          failureStatus: \"fail\",\n          remedy: `Install ${executable} in this sandbox.`,\n        },\n        invoke,\n      ),\n    );\n  }\n  try {\n    const result = await invoke({\n      executable: \"node\",\n      arguments: [\"-e\", sandboxDiagnosticDefaults.command],\n    });\n    const passed =\n      result.status === 7 &&\n      result.stdout === \"outpost-stdout\" &&\n      result.stderr === \"outpost-stderr\";\n    checks.push({\n      id: \"sandbox.command\",\n      status: passed ? \"pass\" : \"fail\",\n      message: passed\n        ? \"Observed separate output streams and nonzero process exit status.\"\n        : \"Command output or exit status did not match the diagnostic sentinel.\",\n    });\n  } catch {\n    checks.push({\n      id: \"sandbox.command\",\n      status: \"fail\",\n      message: \"Bounded command probe failed or was interrupted.\",\n    });\n  }\n  checks.push(\n    await diagnosticProbe(\n      {\n        id: \"sandbox.home\",\n        command: {\n          executable: \"node\",\n          arguments: [\"-e\", sandboxDiagnosticDefaults.home, target.home],\n        },\n        failureStatus: \"fail\",\n        remedy: \"Check the lease home directory and its permissions.\",\n      },\n      invoke,\n    ),\n  );\n  if (options.agent) {\n    const version = await diagnosticProbe(\n      {\n        id: \"agent.sandbox\",\n        ...agentVersionProbe(options.agent),\n        failureStatus: \"fail\",\n        remedy: \"Install the agent explicitly; diagnostics never bootstrap it.\",\n      },\n      invoke,\n    );\n    checks.push(version);\n    if (version.status !== \"fail\")\n      checks.push(...(await diagnoseAgentCli(options.agent, invoke)));\n  }\n  if (options.transfers === true)\n    checks.push(\n      ...(await diagnoseTransfers(\n        target,\n        { deadlineMs, ...(options.signal ? { signal: options.signal } : {}) },\n        invoke,\n      )),\n    );\n  checks.push({\n    id: \"model\",\n    status: \"skipped\",\n    message:\n      \"Authentication, model access and installed agent protocol compatibility are unverified. No model request was made.\",\n  });\n  const observed = (id: string) => {\n    const check = checks.find((check) => check.id === id);\n    if (!check) return \"unverified\" as const;\n    return check.status === \"pass\" ? (\"pass\" as const) : (\"fail\" as const);\n  };\n  return {\n    scope: \"owned-sandbox\",\n    ownership: \"caller\",\n    ...(options.sandboxProvider\n      ? {\n          sandboxProvider: {\n            name: options.sandboxProvider.name,\n            placement: options.sandboxProvider.placement,\n          },\n        }\n      : {}),\n    capabilities: [\n      {\n        id: \"command\",\n        advertised: true,\n        observed: observed(\"sandbox.command\"),\n      },\n      {\n        id: \"transfers\",\n        advertised: true,\n        observed: observed(\"sandbox.transfers\"),\n      },\n      {\n        id: \"batchTransfers\",\n        advertised: target.fileTransfers !== undefined,\n        observed: \"unverified\",\n      },\n      {\n        id: \"interactiveTerminal\",\n        advertised: \"unknown\",\n        observed: \"unverified\",\n      },\n    ],\n    checks,\n    modelCompatibility: \"unverified\",\n    hasFailures: checks.some((check) => check.status === \"fail\"),\n  };\n}\n"]}

package/dist/application/doctor.js

@@ -1,10 +1,29 @@
-import { invariant } from "../domain/errors.js";
+import { invariant, OutpostError } from "../domain/errors.js";
+import { registerCleanup } from "../infrastructure/shutdown.js";
 import { executeProcess } from "../infrastructure/process.js";
-import { agentVersions } from "../providers/versions.constants.js";
+import { agentVersionProbe } from "./doctor-agent.js";
 import { diagnoseImage } from "./doctor-image.js";
 import { diagnosticProbe } from "./diagnostic-probe.js";
 import { doctorDefaults, providerDiagnostics } from "./doctor.constants.js";
 export async function diagnose(options, execute = executeProcess) {
+    const stop = new AbortController();
+    const pending = inspect(options, execute, stop.signal);
+    const unregister = registerCleanup(async () => {
+        stop.abort(new OutpostError("aborted", "Host diagnostics interrupted"));
+        await pending;
+    });
+    try {
+        return await pending;
+    }
+    finally {
+        unregister();
+    }
+}
+async function inspect(options, execute, signal) {
+    const probe = (command) => {
+        signal.throwIfAborted();
+        return execute({ ...command, signal });
+    };
     const { sandboxProvider, agent, image } = options;
     if (image !== undefined) {
         invariant(sandboxProvider === "docker" || sandboxProvider === "podman", "--image requires docker or podman.");
@@ -30,7 +49,7 @@ export async function diagnose(options, execute = executeProcess) {
         failureStatus: "fail",
         remedy: "Install Git and make it available on PATH.",
         readVersion: true,
-    }, execute));
+    }, probe));
     if (capabilities.placement === "mounted") {
         const engine = await diagnosticProbe({
             id: "provider.cli",
@@ -38,7 +57,7 @@ export async function diagnose(options, execute = executeProcess) {
             failureStatus: "fail",
             remedy: `Install ${sandboxProvider} and make it available on PATH.`,
             readVersion: true,
-        }, execute);
+        }, probe);
         checks.push(engine);
         if (engine.status === "pass")
             checks.push(await diagnosticProbe({
@@ -49,13 +68,13 @@ export async function diagnose(options, execute = executeProcess) {
                 },
                 failureStatus: "fail",
                 remedy: `Check ${sandboxProvider} is running and accessible to this user; on macOS, start its virtual machine.`,
-            }, execute));
+            }, probe));
         checks.push(await diagnosticProbe({
             id: "host.tar",
             command: { executable: "tar", arguments: ["--version"] },
             failureStatus: "fail",
             remedy: "Install GNU tar or bsdtar for container transfers.",
-        }, execute));
+        }, probe));
     }
     if (capabilities.placement === "remote")
         checks.push({
@@ -65,12 +84,11 @@ export async function diagnose(options, execute = executeProcess) {
         });
     checks.push(await diagnosticProbe({
         id: "agent.host",
-        command: { executable: agent, arguments: ["--version"] },
+        ...agentVersionProbe(agent),
         failureStatus: "warn",
         remedy: "Host CLI is unavailable or unverified. A sandbox may have its own CLI; dispatch can bootstrap a missing agent.",
-        readVersion: true,
-        referenceVersion: agentVersions[agent],
-    }, execute));
+    }, probe));
+    signal.throwIfAborted();
     if (image !== undefined &&
         (sandboxProvider === "docker" || sandboxProvider === "podman")) {
         const connected = checks.some((check) => check.id === "provider.connection" && check.status === "pass");

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 { 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        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 (\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"]}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/application/doctor.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant, OutpostError } from \"../domain/errors.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.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 stop = new AbortController();\n  const pending = inspect(options, execute, stop.signal);\n  const unregister = registerCleanup(async () => {\n    stop.abort(new OutpostError(\"aborted\", \"Host diagnostics interrupted\"));\n    await pending;\n  });\n  try {\n    return await pending;\n  } finally {\n    unregister();\n  }\n}\n\nasync function inspect(\n  options: DoctorOptions,\n  execute: Executor,\n  signal: AbortSignal,\n): Promise<DoctorReport> {\n  const probe: Executor = (command) => {\n    signal.throwIfAborted();\n    return execute({ ...command, signal });\n  };\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      probe,\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      probe,\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          probe,\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        probe,\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      probe,\n    ),\n  );\n  signal.throwIfAborted();\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,15 @@
+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;
+    readonly variables?: Command["variables"];
+    diagnostics(): readonly AgentCliDiagnostic[];
+    harness(): CliHarness;
+}
 export type DiagnosticStatus = "pass" | "warn" | "fail" | "skipped";
 export interface DiagnosticCheck {
     readonly id: 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 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"]}
+{"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  readonly variables?: Command[\"variables\"];\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.constants.d.ts

@@ -5,9 +5,11 @@ export declare const executionDefaults: Readonly<{
     settleMs: 60000;
     deadlineMs: 3600000;
     expansionMs: 30000;
+    usageMs: 5000;
     attachMs: 86400000;
     completion: "<outpost>done</outpost>";
     rawTailBytes: 65536;
     eventBytes: 16777216;
 }>;
 export declare const dispatchDeadlines: readonly ["idleMs", "idleWarningMs", "settleMs", "deadlineMs", "expansionMs"];
+export declare const agentConnectionFailurePattern: RegExp;

package/dist/application/execution.constants.js

@@ -5,6 +5,7 @@ export const executionDefaults = Object.freeze({
     settleMs: 60_000,
     deadlineMs: 3_600_000,
     expansionMs: 30_000,
+    usageMs: 5000,
     attachMs: 86_400_000,
     completion: "<outpost>done</outpost>",
     rawTailBytes: 65_536,
@@ -17,4 +18,5 @@ export const dispatchDeadlines = [
     "deadlineMs",
     "expansionMs",
 ];
+export const agentConnectionFailurePattern = /\b(?:connection (?:failed|refused|reset)|error sending request|ECONNREFUSED|ENOTFOUND|EAI_AGAIN)\b/i;
 //# sourceMappingURL=execution.constants.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"execution.constants.js","sourceRoot":"","sources":["../../src/application/execution.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,OAAO;IACf,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,yBAAyB;IACrC,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,UAAU;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,eAAe;IACf,UAAU;IACV,YAAY;IACZ,aAAa;CACL,CAAC","sourcesContent":["export const executionDefaults = Object.freeze({\n  passes: 1,\n  idleMs: 600_000,\n  idleWarningMs: 60_000,\n  settleMs: 60_000,\n  deadlineMs: 3_600_000,\n  expansionMs: 30_000,\n  attachMs: 86_400_000,\n  completion: \"<outpost>done</outpost>\",\n  rawTailBytes: 65_536,\n  eventBytes: 16_777_216,\n});\n\nexport const dispatchDeadlines = [\n  \"idleMs\",\n  \"idleWarningMs\",\n  \"settleMs\",\n  \"deadlineMs\",\n  \"expansionMs\",\n] as const;\n"]}
+{"version":3,"file":"execution.constants.js","sourceRoot":"","sources":["../../src/application/execution.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,OAAO;IACf,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,MAAM;IACnB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,yBAAyB;IACrC,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,UAAU;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,eAAe;IACf,UAAU;IACV,YAAY;IACZ,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,6BAA6B,GACxC,qGAAqG,CAAC","sourcesContent":["export const executionDefaults = Object.freeze({\n  passes: 1,\n  idleMs: 600_000,\n  idleWarningMs: 60_000,\n  settleMs: 60_000,\n  deadlineMs: 3_600_000,\n  expansionMs: 30_000,\n  usageMs: 5000,\n  attachMs: 86_400_000,\n  completion: \"<outpost>done</outpost>\",\n  rawTailBytes: 65_536,\n  eventBytes: 16_777_216,\n});\n\nexport const dispatchDeadlines = [\n  \"idleMs\",\n  \"idleWarningMs\",\n  \"settleMs\",\n  \"deadlineMs\",\n  \"expansionMs\",\n] as const;\n\nexport const agentConnectionFailurePattern =\n  /\\b(?:connection (?:failed|refused|reset)|error sending request|ECONNREFUSED|ENOTFOUND|EAI_AGAIN)\\b/i;\n"]}

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

@@ -1,3 +1,4 @@
+import type { ObservationHub } from "../domain/observation.types.ts";
 import type { TransportReference } from "../domain/transport.types.ts";
 import type { Agent, AgentObservation, Usage } from "../domain/agent.types.ts";
 import type { DispatchTelemetry } from "../domain/dispatch-telemetry.types.ts";
@@ -5,6 +6,7 @@ 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 observation?: ObservationHub;
     readonly agent?: Agent;
     readonly logging?: Logging;
     readonly label?: string;
@@ -41,6 +43,12 @@ export interface Turn {
     readonly durationMs: number;
 }
 export interface AgentOutput {
+    readonly usage: Usage;
+    readonly reportedUsage: boolean;
+    readonly finalUsage: boolean;
+    recordUsage(tokens: Usage, cumulative?: boolean): void;
+    setUsageBaseline(tokens: Usage | undefined): void;
+    readonly failure: string | undefined;
     readonly completed: boolean;
     readonly conversation: string | undefined;
     append(chunk: string): void;

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 { 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"]}
+{"version":3,"file":"execution.types.js","sourceRoot":"","sources":["../../src/application/execution.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ObservationHub } from \"../domain/observation.types.ts\";\nimport 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 observation?: ObservationHub;\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 usage: Usage;\n  readonly reportedUsage: boolean;\n  readonly finalUsage: boolean;\n  recordUsage(tokens: Usage, cumulative?: boolean): void;\n  setUsageBaseline(tokens: Usage | undefined): void;\n  readonly failure: string | undefined;\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-budget.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessLimits } from "../domain/harness.types.ts";
+import type { HarnessBudget } from "./harness-budget.types.ts";
+export declare function harnessBudget(limits: HarnessLimits, parent?: HarnessBudget): HarnessBudget;