@elie-laloum/outpost 2.0.0 → 4.0.0

package/dist/application/agent-output.js

@@ -7,7 +7,7 @@ export function agentOutput(agent, options, markers, pass) {
     let pending = "", text = "", rawTail = "";
     let finalText, conversation, failure;
     let usage = { input: 0, cached: 0, output: 0 };
-    let completed = false;
+    let completed = false, finished = false;
     const handlers = {
         text: (event) => {
             text += event.text;
@@ -18,6 +18,9 @@ export function agentOutput(agent, options, markers, pass) {
         conversation: (event) => {
             conversation = event.id;
         },
+        finished: () => {
+            finished = true;
+        },
         failure: (event) => {
             failure = event.message;
         },
@@ -33,7 +36,9 @@ export function agentOutput(agent, options, markers, pass) {
             if (event.kind !== "raw")
                 notify(options.observe, { ...event, pass, at });
         }
-        completed = markers.some((marker) => (finalText ?? text).includes(marker));
+        completed =
+            (!agent.requiresFinishedEvent || finished) &&
+                markers.some((marker) => (finalText ?? text).includes(marker));
     }
     return {
         get completed() {
@@ -61,6 +66,8 @@ export function agentOutput(agent, options, markers, pass) {
         result() {
             if (failure)
                 throw new OutpostError("process", failure, { conversation });
+            if (agent.requiresFinishedEvent && !finished)
+                throw new OutpostError("process", "Agent exited without a successful final event", { conversation });
             return {
                 text: finalText ?? (text || rawTail),
                 usage,

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

@@ -1 +1 @@
-{"version":3,"file":"agent-output.js","sourceRoot":"","sources":["../../src/application/agent-output.ts"],"names":[],"mappings":"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","sourcesContent":["import { visitAgentEvent } from \"../domain/agent-events.ts\";\nimport type { AgentAdapter, Usage } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { AgentOutput, DispatchOptions } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function agentOutput(\n  agent: AgentAdapter,\n  options: DispatchOptions<unknown>,\n  markers: readonly string[],\n  pass: number,\n): AgentOutput {\n  let pending = \"\",\n    text = \"\",\n    rawTail = \"\";\n  let finalText: string | undefined,\n    conversation: string | undefined,\n    failure: string | undefined;\n  let usage: Usage = { input: 0, cached: 0, output: 0 };\n  let completed = false;\n  const handlers: import(\"../domain/agent.types.ts\").AgentEventHandlers = {\n    text: (event) => {\n      text += event.text;\n    },\n    result: (event) => {\n      finalText = event.text;\n    },\n    conversation: (event) => {\n      conversation = event.id;\n    },\n    failure: (event) => {\n      failure = event.message;\n    },\n    usage: (event) => {\n      usage = addUsage(usage, event.tokens);\n    },\n  };\n  function consume(line: string): void {\n    const at = new Date().toISOString();\n    notify(options.observe, { kind: \"raw\", value: line, pass, at });\n    for (const event of agent.events(line)) {\n      visitAgentEvent(event, handlers);\n      if (event.kind !== \"raw\") notify(options.observe, { ...event, pass, at });\n    }\n    completed = markers.some((marker) => (finalText ?? text).includes(marker));\n  }\n  return {\n    get completed() {\n      return completed;\n    },\n    get conversation() {\n      return conversation;\n    },\n    append(chunk) {\n      rawTail = (rawTail + chunk).slice(-executionDefaults.rawTailBytes);\n      pending += chunk;\n      let end: number;\n      while ((end = pending.indexOf(\"\\n\")) >= 0) {\n        consume(pending.slice(0, end));\n        pending = pending.slice(end + 1);\n      }\n      if (pending.length > executionDefaults.eventBytes)\n        throw new OutpostError(\"process\", \"Agent emitted an oversized event\");\n    },\n    flush() {\n      if (pending) consume(pending);\n      pending = \"\";\n    },\n    result() {\n      if (failure) throw new OutpostError(\"process\", failure, { conversation });\n      return {\n        text: finalText ?? (text || rawTail),\n        usage,\n        ...(conversation ? { conversation } : {}),\n      };\n    },\n  };\n}\n"]}
+{"version":3,"file":"agent-output.js","sourceRoot":"","sources":["../../src/application/agent-output.ts"],"names":[],"mappings":"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","sourcesContent":["import { visitAgentEvent } from \"../domain/agent-events.ts\";\nimport type { AgentAdapter, Usage } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { AgentOutput, DispatchOptions } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function agentOutput(\n  agent: AgentAdapter,\n  options: DispatchOptions<unknown>,\n  markers: readonly string[],\n  pass: number,\n): AgentOutput {\n  let pending = \"\",\n    text = \"\",\n    rawTail = \"\";\n  let finalText: string | undefined,\n    conversation: string | undefined,\n    failure: string | undefined;\n  let usage: Usage = { input: 0, cached: 0, output: 0 };\n  let completed = false,\n    finished = false;\n  const handlers: import(\"../domain/agent.types.ts\").AgentEventHandlers = {\n    text: (event) => {\n      text += event.text;\n    },\n    result: (event) => {\n      finalText = event.text;\n    },\n    conversation: (event) => {\n      conversation = event.id;\n    },\n    finished: () => {\n      finished = true;\n    },\n    failure: (event) => {\n      failure = event.message;\n    },\n    usage: (event) => {\n      usage = addUsage(usage, event.tokens);\n    },\n  };\n  function consume(line: string): void {\n    const at = new Date().toISOString();\n    notify(options.observe, { kind: \"raw\", value: line, pass, at });\n    for (const event of agent.events(line)) {\n      visitAgentEvent(event, handlers);\n      if (event.kind !== \"raw\") notify(options.observe, { ...event, pass, at });\n    }\n    completed =\n      (!agent.requiresFinishedEvent || finished) &&\n      markers.some((marker) => (finalText ?? text).includes(marker));\n  }\n  return {\n    get completed() {\n      return completed;\n    },\n    get conversation() {\n      return conversation;\n    },\n    append(chunk) {\n      rawTail = (rawTail + chunk).slice(-executionDefaults.rawTailBytes);\n      pending += chunk;\n      let end: number;\n      while ((end = pending.indexOf(\"\\n\")) >= 0) {\n        consume(pending.slice(0, end));\n        pending = pending.slice(end + 1);\n      }\n      if (pending.length > executionDefaults.eventBytes)\n        throw new OutpostError(\"process\", \"Agent emitted an oversized event\");\n    },\n    flush() {\n      if (pending) consume(pending);\n      pending = \"\";\n    },\n    result() {\n      if (failure) throw new OutpostError(\"process\", failure, { conversation });\n      if (agent.requiresFinishedEvent && !finished)\n        throw new OutpostError(\n          \"process\",\n          \"Agent exited without a successful final event\",\n          { conversation },\n        );\n      return {\n        text: finalText ?? (text || rawTail),\n        usage,\n        ...(conversation ? { conversation } : {}),\n      };\n    },\n  };\n}\n"]}

package/dist/application/artifact-tasks.d.ts

@@ -0,0 +1,5 @@
+import type { ArtifactContract, ArtifactReference, ArtifactStore } from "../domain/artifact.types.ts";
+import type { Task, TaskContext } from "../domain/workflow.types.ts";
+import type { ArtifactTaskOptions } from "./artifact-tasks.types.ts";
+export declare function artifactTask<T>(options: ArtifactTaskOptions<T>): Task<ArtifactReference>;
+export declare function readArtifact<T>(context: TaskContext, dependency: Task<ArtifactReference>, contract: ArtifactContract<T>, store: ArtifactStore): Promise<T>;

package/dist/application/artifact-tasks.js

@@ -0,0 +1,31 @@
+import { publishArtifact, readStoredArtifact } from "../domain/artifact.js";
+import { validateArtifactReference } from "../domain/artifact-reference.js";
+import { task } from "../domain/workflow.js";
+export function artifactTask(options) {
+    const { store, contract, produce, parents, ...definition } = options;
+    return task({
+        ...definition,
+        async perform(context) {
+            const lineage = parents?.(context) ?? [];
+            return publishArtifact(store, contract, await produce(context), {
+                producer: {
+                    executionId: context.executionId,
+                    taskKey: definition.key,
+                    attempt: context.attempt,
+                },
+                parents: lineage,
+                signal: context.signal,
+            });
+        },
+    });
+}
+export async function readArtifact(context, dependency, contract, store) {
+    const reference = validateArtifactReference(context.value(dependency));
+    if (reference.producer.executionId !== context.executionId ||
+        reference.producer.taskKey !== dependency.key)
+        throw new Error("Artifact dependency producer mismatch");
+    return readStoredArtifact(store, contract, reference, {
+        signal: context.signal,
+    });
+}
+//# sourceMappingURL=artifact-tasks.js.map

package/dist/application/artifact-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tasks.js","sourceRoot":"","sources":["../../src/application/artifact-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAM5E,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAI7C,MAAM,UAAU,YAAY,CAC1B,OAA+B;IAE/B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IACrE,OAAO,IAAI,CAAC;QACV,GAAG,UAAU;QACb,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC9D,QAAQ,EAAE;oBACR,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,UAAU,CAAC,GAAG;oBACvB,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB;gBACD,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAoB,EACpB,UAAmC,EACnC,QAA6B,EAC7B,KAAoB;IAEpB,MAAM,SAAS,GAAG,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACvE,IACE,SAAS,CAAC,QAAQ,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;QACtD,SAAS,CAAC,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC,GAAG;QAE7C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,OAAO,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE;QACpD,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { publishArtifact, readStoredArtifact } from \"../domain/artifact.ts\";\nimport { validateArtifactReference } from \"../domain/artifact-reference.ts\";\nimport type {\n  ArtifactContract,\n  ArtifactReference,\n  ArtifactStore,\n} from \"../domain/artifact.types.ts\";\nimport { task } from \"../domain/workflow.ts\";\nimport type { Task, TaskContext } from \"../domain/workflow.types.ts\";\nimport type { ArtifactTaskOptions } from \"./artifact-tasks.types.ts\";\n\nexport function artifactTask<T>(\n  options: ArtifactTaskOptions<T>,\n): Task<ArtifactReference> {\n  const { store, contract, produce, parents, ...definition } = options;\n  return task({\n    ...definition,\n    async perform(context) {\n      const lineage = parents?.(context) ?? [];\n      return publishArtifact(store, contract, await produce(context), {\n        producer: {\n          executionId: context.executionId,\n          taskKey: definition.key,\n          attempt: context.attempt,\n        },\n        parents: lineage,\n        signal: context.signal,\n      });\n    },\n  });\n}\n\nexport async function readArtifact<T>(\n  context: TaskContext,\n  dependency: Task<ArtifactReference>,\n  contract: ArtifactContract<T>,\n  store: ArtifactStore,\n): Promise<T> {\n  const reference = validateArtifactReference(context.value(dependency));\n  if (\n    reference.producer.executionId !== context.executionId ||\n    reference.producer.taskKey !== dependency.key\n  )\n    throw new Error(\"Artifact dependency producer mismatch\");\n  return readStoredArtifact(store, contract, reference, {\n    signal: context.signal,\n  });\n}\n"]}

package/dist/application/artifact-tasks.types.d.ts

@@ -0,0 +1,8 @@
+import type { ArtifactContract, ArtifactReference, ArtifactStore } from "../domain/artifact.types.ts";
+import type { TaskContext, TaskOptions } from "../domain/workflow.types.ts";
+export type ArtifactTaskOptions<T> = Omit<TaskOptions<ArtifactReference>, "perform"> & {
+    readonly store: ArtifactStore;
+    readonly contract: ArtifactContract<T>;
+    readonly produce: (context: TaskContext) => T | Promise<T>;
+    readonly parents?: (context: TaskContext) => readonly ArtifactReference[];
+};

package/dist/application/artifact-tasks.types.js

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

package/dist/application/artifact-tasks.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tasks.types.js","sourceRoot":"","sources":["../../src/application/artifact-tasks.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ArtifactContract,\n  ArtifactReference,\n  ArtifactStore,\n} from \"../domain/artifact.types.ts\";\nimport type { TaskContext, TaskOptions } from \"../domain/workflow.types.ts\";\n\nexport type ArtifactTaskOptions<T> = Omit<\n  TaskOptions<ArtifactReference>,\n  \"perform\"\n> & {\n  readonly store: ArtifactStore;\n  readonly contract: ArtifactContract<T>;\n  readonly produce: (context: TaskContext) => T | Promise<T>;\n  readonly parents?: (context: TaskContext) => readonly ArtifactReference[];\n};\n"]}

package/dist/application/diagnostic-probe.d.ts

@@ -0,0 +1,3 @@
+import type { Executor } from "../infrastructure/process.types.ts";
+import type { DiagnosticCheck, DiagnosticProbe } from "./doctor.types.ts";
+export declare function diagnosticProbe(probe: DiagnosticProbe, execute?: Executor): Promise<DiagnosticCheck>;

package/dist/application/diagnostic-probe.js

@@ -0,0 +1,55 @@
+import { OutpostError } from "../domain/errors.js";
+import { executeProcess } from "../infrastructure/process.js";
+import { doctorDefaults } from "./doctor.constants.js";
+export async function diagnosticProbe(probe, execute = executeProcess) {
+    const failure = (reason) => ({
+        id: probe.id,
+        status: probe.failureStatus,
+        message: `${reason}. ${probe.remedy}`,
+    });
+    try {
+        const result = await execute({
+            ...probe.command,
+            deadlineMs: doctorDefaults.deadlineMs,
+            retain: probe.command.retain ?? doctorDefaults.retain,
+        });
+        if (result.status !== 0)
+            return failure(`Exited with status ${result.status}`);
+        if (!probe.readVersion)
+            return {
+                id: probe.id,
+                status: "pass",
+                message: "Check succeeded.",
+            };
+        const version = /\bv?(\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?)\b/.exec(result.stdout || result.stderr)?.[1];
+        if (!version)
+            return failure("Version could not be identified");
+        if (probe.referenceVersion)
+            return {
+                id: probe.id,
+                status: version === probe.referenceVersion ? "pass" : "warn",
+                version,
+                referenceVersion: probe.referenceVersion,
+                message: version === probe.referenceVersion
+                    ? "Matches the version pinned by Outpost; protocol and authentication are not tested."
+                    : "Differs from the version pinned by Outpost; compatibility is unverified.",
+            };
+        return {
+            id: probe.id,
+            status: "pass",
+            version,
+            message: "Version identified.",
+        };
+    }
+    catch (error) {
+        if (error instanceof OutpostError && error.code === "timeout")
+            return failure("Check timed out");
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT")
+            return failure("Executable not found on PATH");
+        return failure("Command could not be executed");
+    }
+}
+//# sourceMappingURL=diagnostic-probe.js.map

package/dist/application/diagnostic-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-probe.js","sourceRoot":"","sources":["../../src/application/diagnostic-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAsB,EACtB,UAAoB,cAAc;IAElC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAmB,EAAE,CAAC,CAAC;QACpD,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,KAAK,CAAC,aAAa;QAC3B,OAAO,EAAE,GAAG,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE;KACtC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,GAAG,KAAK,CAAC,OAAO;YAChB,UAAU,EAAE,cAAc,CAAC,UAAU;YACrC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;SACtD,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YACrB,OAAO,OAAO,CAAC,sBAAsB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,WAAW;YACpB,OAAO;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,kBAAkB;aAC5B,CAAC;QACJ,MAAM,OAAO,GAAG,kDAAkD,CAAC,IAAI,CACrE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAC/B,EAAE,CAAC,CAAC,CAAC,CAAC;QACP,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,gBAAgB;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC5D,OAAO;gBACP,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,OAAO,EACL,OAAO,KAAK,KAAK,CAAC,gBAAgB;oBAChC,CAAC,CAAC,oFAAoF;oBACtF,CAAC,CAAC,0EAA0E;aACjF,CAAC;QACJ,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,MAAM;YACd,OAAO;YACP,OAAO,EAAE,qBAAqB;SAC/B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAC3D,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACpC,IACE,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,IAAI,KAAK;YACf,KAAK,CAAC,IAAI,KAAK,QAAQ;YAEvB,OAAO,OAAO,CAAC,8BAA8B,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport { executeProcess } from \"../infrastructure/process.ts\";\nimport type { Executor } from \"../infrastructure/process.types.ts\";\nimport { doctorDefaults } from \"./doctor.constants.ts\";\nimport type { DiagnosticCheck, DiagnosticProbe } from \"./doctor.types.ts\";\n\nexport async function diagnosticProbe(\n  probe: DiagnosticProbe,\n  execute: Executor = executeProcess,\n): Promise<DiagnosticCheck> {\n  const failure = (reason: string): DiagnosticCheck => ({\n    id: probe.id,\n    status: probe.failureStatus,\n    message: `${reason}. ${probe.remedy}`,\n  });\n  try {\n    const result = await execute({\n      ...probe.command,\n      deadlineMs: doctorDefaults.deadlineMs,\n      retain: probe.command.retain ?? doctorDefaults.retain,\n    });\n    if (result.status !== 0)\n      return failure(`Exited with status ${result.status}`);\n    if (!probe.readVersion)\n      return {\n        id: probe.id,\n        status: \"pass\",\n        message: \"Check succeeded.\",\n      };\n    const version = /\\bv?(\\d+\\.\\d+\\.\\d+(?:-[\\w.-]+)?(?:\\+[\\w.-]+)?)\\b/.exec(\n      result.stdout || result.stderr,\n    )?.[1];\n    if (!version) return failure(\"Version could not be identified\");\n    if (probe.referenceVersion)\n      return {\n        id: probe.id,\n        status: version === probe.referenceVersion ? \"pass\" : \"warn\",\n        version,\n        referenceVersion: probe.referenceVersion,\n        message:\n          version === probe.referenceVersion\n            ? \"Matches the version pinned by Outpost; protocol and authentication are not tested.\"\n            : \"Differs from the version pinned by Outpost; compatibility is unverified.\",\n      };\n    return {\n      id: probe.id,\n      status: \"pass\",\n      version,\n      message: \"Version identified.\",\n    };\n  } catch (error) {\n    if (error instanceof OutpostError && error.code === \"timeout\")\n      return failure(\"Check timed out\");\n    if (\n      error &&\n      typeof error === \"object\" &&\n      \"code\" in error &&\n      error.code === \"ENOENT\"\n    )\n      return failure(\"Executable not found on PATH\");\n    return failure(\"Command could not be executed\");\n  }\n}\n"]}

package/dist/application/dispatch-validation.js

@@ -22,6 +22,8 @@ export function validateDispatch(options) {
 }
 export async function preflightDispatch(options, _repository, agent) {
     validateDispatch(options);
+    if (options.continuation)
+        invariant(agent?.resumable !== false, `${agent?.name} does not support continuation or fork in Outpost`);
     if (!options.response)
         return;
     if (options.response.repairs > 0)

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

@@ -1 +1 @@
-{"version":3,"file":"dispatch-validation.js","sourceRoot":"","sources":["../../src/application/dispatch-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,MAAM,UAAU,gBAAgB,CAAC,OAAiC;IAChE,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/D,SAAS,CACP,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAChE,2BAA2B,CAC5B,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,iBAAiB;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY;QAC1C,SAAS,CACP,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,EAClD,yDAAyD,CAC1D,CAAC;IACJ,MAAM,OAAO,GACX,OAAO,CAAC,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACjC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACjB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,SAAS,CACP,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAC5C,oCAAoC,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC,EACjC,WAAmB,EACnB,KAAoB;IAEpB,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO;IAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC;QAC9B,SAAS,CACP,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,aAAa,IAAI,KAAK,EAAE,OAAO,CAAC,EAC9D,gEAAgE,CACjE,CAAC;IACJ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE,CAC3E,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACtE,CAAC;IACF,SAAS,CACP,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,EAC9C,kCAAkC,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAC9D,CAAC;AACJ,CAAC","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { dispatchDeadlines, executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\n\nexport function validateDispatch(options: DispatchOptions<unknown>): void {\n  options.signal?.throwIfAborted();\n  validateBrief(options.brief);\n  positive(options.passes ?? executionDefaults.passes, \"passes\");\n  invariant(\n    Number.isSafeInteger(options.passes ?? executionDefaults.passes),\n    \"passes must be an integer\",\n  );\n  for (const key of dispatchDeadlines)\n    if (options[key] !== undefined) positive(options[key], key);\n  if (options.response || options.continuation)\n    invariant(\n      (options.passes ?? executionDefaults.passes) === 1,\n      \"Structured responses and continuations require one pass\",\n    );\n  const markers =\n    options.until === undefined\n      ? []\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  invariant(\n    markers.every((marker) => marker.length > 0),\n    \"Completion markers cannot be empty\",\n  );\n}\n\nexport async function preflightDispatch(\n  options: DispatchOptions<unknown>,\n  _repository: string,\n  agent?: AgentAdapter,\n): Promise<void> {\n  validateDispatch(options);\n  if (!options.response) return;\n  if (options.response.repairs > 0)\n    invariant(\n      agent?.resumable ?? !!(agent?.conversations || agent?.storage),\n      \"Response repair requires an adapter that supports continuation\",\n    );\n  const brief = options.brief;\n  const text = brief.text ?? (await readFile(resolve(brief.file!), \"utf8\"));\n  const resolved = text.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (token, key: string) =>\n    brief.values?.[key] === undefined ? token : String(brief.values[key]),\n  );\n  invariant(\n    resolved.includes(`<${options.response.tag}>`),\n    `Brief must request an opening <${options.response.tag}> tag`,\n  );\n}\n"]}
+{"version":3,"file":"dispatch-validation.js","sourceRoot":"","sources":["../../src/application/dispatch-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,MAAM,UAAU,gBAAgB,CAAC,OAAiC;IAChE,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/D,SAAS,CACP,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAChE,2BAA2B,CAC5B,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,iBAAiB;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY;QAC1C,SAAS,CACP,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,EAClD,yDAAyD,CAC1D,CAAC;IACJ,MAAM,OAAO,GACX,OAAO,CAAC,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACjC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACjB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,SAAS,CACP,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAC5C,oCAAoC,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC,EACjC,WAAmB,EACnB,KAAoB;IAEpB,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,OAAO,CAAC,YAAY;QACtB,SAAS,CACP,KAAK,EAAE,SAAS,KAAK,KAAK,EAC1B,GAAG,KAAK,EAAE,IAAI,mDAAmD,CAClE,CAAC;IACJ,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO;IAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC;QAC9B,SAAS,CACP,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,aAAa,IAAI,KAAK,EAAE,OAAO,CAAC,EAC9D,gEAAgE,CACjE,CAAC;IACJ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE,CAC3E,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACtE,CAAC;IACF,SAAS,CACP,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,EAC9C,kCAAkC,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAC9D,CAAC;AACJ,CAAC","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { validateBrief } from \"../domain/prompts.ts\";\nimport { dispatchDeadlines, executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions } from \"./execution.types.ts\";\n\nexport function validateDispatch(options: DispatchOptions<unknown>): void {\n  options.signal?.throwIfAborted();\n  validateBrief(options.brief);\n  positive(options.passes ?? executionDefaults.passes, \"passes\");\n  invariant(\n    Number.isSafeInteger(options.passes ?? executionDefaults.passes),\n    \"passes must be an integer\",\n  );\n  for (const key of dispatchDeadlines)\n    if (options[key] !== undefined) positive(options[key], key);\n  if (options.response || options.continuation)\n    invariant(\n      (options.passes ?? executionDefaults.passes) === 1,\n      \"Structured responses and continuations require one pass\",\n    );\n  const markers =\n    options.until === undefined\n      ? []\n      : typeof options.until === \"string\"\n        ? [options.until]\n        : options.until;\n  invariant(\n    markers.every((marker) => marker.length > 0),\n    \"Completion markers cannot be empty\",\n  );\n}\n\nexport async function preflightDispatch(\n  options: DispatchOptions<unknown>,\n  _repository: string,\n  agent?: AgentAdapter,\n): Promise<void> {\n  validateDispatch(options);\n  if (options.continuation)\n    invariant(\n      agent?.resumable !== false,\n      `${agent?.name} does not support continuation or fork in Outpost`,\n    );\n  if (!options.response) return;\n  if (options.response.repairs > 0)\n    invariant(\n      agent?.resumable ?? !!(agent?.conversations || agent?.storage),\n      \"Response repair requires an adapter that supports continuation\",\n    );\n  const brief = options.brief;\n  const text = brief.text ?? (await readFile(resolve(brief.file!), \"utf8\"));\n  const resolved = text.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (token, key: string) =>\n    brief.values?.[key] === undefined ? token : String(brief.values[key]),\n  );\n  invariant(\n    resolved.includes(`<${options.response.tag}>`),\n    `Brief must request an opening <${options.response.tag}> tag`,\n  );\n}\n"]}

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

@@ -0,0 +1,11 @@
+import { claudeDiagnostics } from "../adapters/agents/claude-diagnostics.ts";
+import { codexDiagnostics } from "../adapters/agents/codex-diagnostics.ts";
+import { geminiDiagnostics } from "../adapters/agents/gemini-diagnostics.ts";
+export declare const agentDiagnosticPlans: {
+    readonly gemini: typeof geminiDiagnostics;
+    readonly claude: typeof claudeDiagnostics;
+    readonly codex: typeof codexDiagnostics;
+};
+export declare const agentDiagnosticDefaults: Readonly<{
+    retain: 65536;
+}>;

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

@@ -0,0 +1,10 @@
+import { claudeDiagnostics } from "../adapters/agents/claude-diagnostics.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,
+};
+export const agentDiagnosticDefaults = Object.freeze({ retain: 65_536 });
+//# sourceMappingURL=doctor-agent.constants.js.map

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

@@ -0,0 +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"]}

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

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

package/dist/application/doctor-agent.js

@@ -0,0 +1,53 @@
+import { stripVTControlCharacters } from "node:util";
+import { diagnosticProbe } from "./diagnostic-probe.js";
+import { agentDiagnosticDefaults, agentDiagnosticPlans, } from "./doctor-agent.constants.js";
+export async function diagnoseAgentCli(agent, execute) {
+    const checks = [];
+    for (const plan of agentDiagnosticPlans[agent]()) {
+        let help = "";
+        const check = await diagnosticProbe({
+            id: `agent.cli.${plan.mode}`,
+            command: { ...plan.command, retain: agentDiagnosticDefaults.retain },
+            failureStatus: "fail",
+            remedy: "The agent CLI help command failed. Check the agent CLI in this image and rebuild it if needed.",
+        }, async (command) => {
+            const result = await execute(command);
+            help = stripVTControlCharacters(`${result.stdout}\n${result.stderr}`);
+            return result;
+        });
+        if (check.status !== "pass") {
+            checks.push(check);
+            continue;
+        }
+        const usage = help
+            .split(/\r?\n/)
+            .some((line) => line.trim().startsWith(`Usage: ${plan.usage} [`));
+        if (!usage) {
+            checks.push({
+                id: check.id,
+                status: "warn",
+                message: "Command exited successfully but the expected help could not be identified; CLI support is unverified.",
+            });
+            continue;
+        }
+        const declared = new Set([
+            ...help.matchAll(/^\s*(?:-[A-Za-z0-9?],?\s+)?(--[A-Za-z][\w-]*)\b/gm),
+        ].map((match) => match[1]));
+        const missing = plan.options.filter((option) => !declared.has(option));
+        if (missing.length) {
+            checks.push({
+                id: check.id,
+                status: "fail",
+                message: `Help does not declare required options: ${missing.join(", ")}. Rebuild the image with a CLI supporting Outpost's default invocation.`,
+            });
+            continue;
+        }
+        checks.push({
+            id: check.id,
+            status: "pass",
+            message: "Help identifies the command and declares the options used by Outpost's default invocation. Conversation execution and event decoding are not tested.",
+        });
+    }
+    return checks;
+}
+//# sourceMappingURL=doctor-agent.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,3 @@
+import type { Executor } from "../infrastructure/process.types.ts";
+import type { DiagnosticCheck, DoctorImageOptions } from "./doctor.types.ts";
+export declare function diagnoseImage(options: DoctorImageOptions, execute?: Executor): Promise<readonly DiagnosticCheck[]>;

package/dist/application/doctor-image.js

@@ -0,0 +1,133 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+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 { diagnosticProbe } from "./diagnostic-probe.js";
+import { doctorDefaults } from "./doctor.constants.js";
+export async function diagnoseImage(options, execute = executeProcess) {
+    const stop = new AbortController();
+    const pending = inspectImage(options, execute, stop.signal);
+    const unregister = registerCleanup(async () => {
+        stop.abort(new OutpostError("aborted", "Image diagnostics interrupted"));
+        await pending;
+    });
+    try {
+        return await pending;
+    }
+    finally {
+        unregister();
+    }
+}
+async function inspectImage({ provider, agent, image }, execute, signal) {
+    const directory = await mkdtemp(join(tmpdir(), "outpost-doctor-"));
+    const checks = [];
+    let lease;
+    let retained = false;
+    let container;
+    const tracked = (command) => {
+        if (command.arguments?.[0] === "create") {
+            const index = command.arguments.indexOf("--name");
+            container = command.arguments[index + 1];
+        }
+        return execute(command);
+    };
+    try {
+        lease = await diagnosticContainer(provider, image, doctorDefaults.deadlineMs, tracked).acquire({
+            repository: directory,
+            directory,
+            gitDirectories: [],
+            variables: {},
+            signal,
+        });
+        checks.push({
+            id: "image.runtime",
+            status: "pass",
+            message: "Temporary sandbox started with network disabled and an empty workspace.",
+        });
+        const sandbox = lease;
+        const invoke = (command) => sandbox.invoke({ ...command, signal });
+        for (const executable of ["node", "git"]) {
+            checks.push(await diagnosticProbe({
+                id: `image.${executable}`,
+                command: { executable, arguments: ["--version"] },
+                failureStatus: "fail",
+                readVersion: true,
+                remedy: `Install ${executable} in the image and rebuild it.`,
+            }, invoke));
+        }
+        checks.push(await diagnosticProbe({
+            id: "image.home",
+            command: {
+                executable: "sh",
+                arguments: ["-c", 'test -d "$HOME" && test -w "$HOME"'],
+            },
+            failureStatus: "fail",
+            remedy: "Check the image user and permissions of the private agent home.",
+        }, invoke));
+        const agentVersion = await diagnosticProbe({
+            id: "agent.sandbox",
+            command: { executable: agent, arguments: ["--version"] },
+            failureStatus: "fail",
+            readVersion: true,
+            referenceVersion: agentVersions[agent],
+            remedy: `Install ${agent} in the image and rebuild it. This check does not bootstrap agents.`,
+        }, invoke);
+        checks.push(agentVersion);
+        if (agentVersion.status === "fail")
+            checks.push({
+                id: "agent.cli",
+                status: "skipped",
+                message: "CLI help checks require a successful agent version probe.",
+            });
+        else
+            checks.push(...(await diagnoseAgentCli(agent, invoke)));
+    }
+    catch (error) {
+        retained = error instanceof AggregateError;
+        checks.push({
+            id: "image.runtime",
+            status: "fail",
+            message: "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.",
+        });
+    }
+    finally {
+        if (lease) {
+            try {
+                await lease.release();
+                checks.push({
+                    id: "image.cleanup",
+                    status: "pass",
+                    message: "Diagnostic container removed.",
+                });
+            }
+            catch {
+                retained = true;
+            }
+        }
+        if (retained)
+            checks.push({
+                id: "image.cleanup",
+                status: "fail",
+                message: `Cleanup could not be confirmed. Inspect container ${container ?? "creation state"} with ${provider}; temporary workspace retained at ${directory}.`,
+            });
+        if (!retained) {
+            try {
+                await rm(directory, { recursive: true, force: true });
+            }
+            catch {
+                checks.push({
+                    id: "image.workspace",
+                    status: "fail",
+                    message: `Could not remove temporary workspace ${directory}.`,
+                });
+            }
+        }
+    }
+    return checks;
+}
+//# sourceMappingURL=doctor-image.js.map

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

@@ -0,0 +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  { provider, 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      provider,\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 ${provider}; 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.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProtocolReport } from "./doctor-protocol.types.ts";
+import type { DoctorAgent } from "./doctor.types.ts";
+export declare function diagnoseAgentProtocol(agent: DoctorAgent): AgentProtocolReport;

package/dist/application/doctor-protocol.js

@@ -0,0 +1,30 @@
+import { isDeepStrictEqual } from "node:util";
+import { claude } from "../adapters/agents/claude-adapter.js";
+import { codex } from "../adapters/agents/codex-adapter.js";
+import { gemini } from "../adapters/agents/gemini-adapter.js";
+import { protocolFixtures } from "../adapters/agents/protocol-fixtures.constants.js";
+import { agentVersions } from "../providers/versions.constants.js";
+export function diagnoseAgentProtocol(agent) {
+    const adapter = { claude, codex, gemini }[agent]();
+    const checks = protocolFixtures[agent].map((fixture) => {
+        const events = fixture.lines.flatMap((line) => adapter.events(line));
+        const passed = isDeepStrictEqual(events, fixture.expected);
+        return {
+            id: `protocol.fixture.${fixture.name}`,
+            status: passed ? "pass" : "fail",
+            message: passed
+                ? "Bundled synthetic events decode to the expected structural observations. No installed CLI or model was invoked."
+                : "Bundled synthetic events do not match the expected structural observations.",
+        };
+    });
+    return {
+        scope: "bundled-protocol-fixtures",
+        agent,
+        referenceVersion: agentVersions[agent],
+        installedCli: "unverified",
+        modelCompatibility: "unverified",
+        checks,
+        hasFailures: checks.some((check) => check.status === "fail"),
+    };
+}
+//# sourceMappingURL=doctor-protocol.js.map

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

@@ -0,0 +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,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,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,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,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 { claude } from \"../adapters/agents/claude-adapter.ts\";\nimport { codex } from \"../adapters/agents/codex-adapter.ts\";\nimport { gemini } 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 = { claude, codex, gemini }[agent]();\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"]}

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

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

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

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

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

@@ -0,0 +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"]}

package/dist/application/doctor-sandbox.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const sandboxDiagnosticDefaults: Readonly<{
+    maximumDeadlineMs: 60000;
+    command: "process.stdout.write('outpost-stdout'); process.stderr.write('outpost-stderr'); process.exitCode = 7";
+    home: "const fs = require('node:fs'); fs.accessSync(process.argv[1], fs.constants.R_OK | fs.constants.W_OK); if (!fs.statSync(process.argv[1]).isDirectory()) process.exit(1)";
+}>;

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

@@ -0,0 +1,6 @@
+export const sandboxDiagnosticDefaults = Object.freeze({
+    maximumDeadlineMs: 60_000,
+    command: "process.stdout.write('outpost-stdout'); process.stderr.write('outpost-stderr'); process.exitCode = 7",
+    home: "const fs = require('node:fs'); fs.accessSync(process.argv[1], fs.constants.R_OK | fs.constants.W_OK); if (!fs.statSync(process.argv[1]).isDirectory()) process.exit(1)",
+});
+//# sourceMappingURL=doctor-sandbox.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-sandbox.constants.js","sourceRoot":"","sources":["../../src/application/doctor-sandbox.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,iBAAiB,EAAE,MAAM;IACzB,OAAO,EACL,sGAAsG;IACxG,IAAI,EAAE,wKAAwK;CAC/K,CAAC,CAAC","sourcesContent":["export const sandboxDiagnosticDefaults = Object.freeze({\n  maximumDeadlineMs: 60_000,\n  command:\n    \"process.stdout.write('outpost-stdout'); process.stderr.write('outpost-stderr'); process.exitCode = 7\",\n  home: \"const fs = require('node:fs'); fs.accessSync(process.argv[1], fs.constants.R_OK | fs.constants.W_OK); if (!fs.statSync(process.argv[1]).isDirectory()) process.exit(1)\",\n});\n"]}

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

@@ -0,0 +1,4 @@
+import type { SandboxLease } from "../domain/sandbox.types.ts";
+import type { SandboxDiagnosticOptions, SandboxDiagnosticReport } from "./doctor-sandbox.types.ts";
+import type { Sandbox } from "./outpost.types.ts";
+export declare function diagnoseSandbox(target: Sandbox | SandboxLease, options?: SandboxDiagnosticOptions): Promise<SandboxDiagnosticReport>;