@elie-laloum/outpost 5.0.0 → 7.0.0

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

@@ -1,7 +1,30 @@
 import { agentVersions } from "../providers/versions.js";
-export const agentPackages = Object.freeze({
-    claude: `@anthropic-ai/claude-code@${agentVersions.claude}`,
-    gemini: `@google/gemini-cli@${agentVersions.gemini}`,
-    codex: `@openai/codex@${agentVersions.codex}`,
+export const agentInstallers = Object.freeze({
+    claude: {
+        kind: "npm",
+        binary: "claude",
+        package: `@anthropic-ai/claude-code@${agentVersions.claude}`,
+        allowScripts: true,
+    },
+    codex: {
+        kind: "npm",
+        binary: "codex",
+        package: `@openai/codex@${agentVersions.codex}`,
+    },
+    copilot: {
+        kind: "npm",
+        binary: "copilot",
+        package: `@github/copilot@${agentVersions.copilot}`,
+    },
+    kimi: {
+        kind: "npm",
+        binary: "kimi",
+        package: `@moonshot-ai/kimi-code@${agentVersions.kimi}`,
+    },
+    antigravity: {
+        kind: "antigravity",
+        binary: "agy",
+        installed: ".local/bin/agy",
+    },
 });
 //# sourceMappingURL=agent-bootstrap.constants.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-bootstrap.constants.js","sourceRoot":"","sources":["../../src/application/agent-bootstrap.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,6BAA6B,aAAa,CAAC,MAAM,EAAE;IAC3D,MAAM,EAAE,sBAAsB,aAAa,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,iBAAiB,aAAa,CAAC,KAAK,EAAE;CAC9C,CAAC,CAAC","sourcesContent":["import { agentVersions } from \"../providers/versions.ts\";\n\nexport const agentPackages = Object.freeze({\n  claude: `@anthropic-ai/claude-code@${agentVersions.claude}`,\n  gemini: `@google/gemini-cli@${agentVersions.gemini}`,\n  codex: `@openai/codex@${agentVersions.codex}`,\n});\n"]}
+{"version":3,"file":"agent-bootstrap.constants.js","sourceRoot":"","sources":["../../src/application/agent-bootstrap.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,MAAM,CAAC,MAAM,eAAe,GAC1B,MAAM,CAAC,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,6BAA6B,aAAa,CAAC,MAAM,EAAE;QAC5D,YAAY,EAAE,IAAI;KACnB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,iBAAiB,aAAa,CAAC,KAAK,EAAE;KAChD;IACD,OAAO,EAAE;QACP,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,mBAAmB,aAAa,CAAC,OAAO,EAAE;KACpD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,0BAA0B,aAAa,CAAC,IAAI,EAAE;KACxD;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,gBAAgB;KAC5B;CACF,CAAC,CAAC","sourcesContent":["import { agentVersions } from \"../providers/versions.ts\";\nimport type { AgentInstaller } from \"./agent-bootstrap.types.ts\";\n\nexport const agentInstallers: Readonly<Record<string, AgentInstaller>> =\n  Object.freeze({\n    claude: {\n      kind: \"npm\",\n      binary: \"claude\",\n      package: `@anthropic-ai/claude-code@${agentVersions.claude}`,\n      allowScripts: true,\n    },\n    codex: {\n      kind: \"npm\",\n      binary: \"codex\",\n      package: `@openai/codex@${agentVersions.codex}`,\n    },\n    copilot: {\n      kind: \"npm\",\n      binary: \"copilot\",\n      package: `@github/copilot@${agentVersions.copilot}`,\n    },\n    kimi: {\n      kind: \"npm\",\n      binary: \"kimi\",\n      package: `@moonshot-ai/kimi-code@${agentVersions.kimi}`,\n    },\n    antigravity: {\n      kind: \"antigravity\",\n      binary: \"agy\",\n      installed: \".local/bin/agy\",\n    },\n  });\n"]}

package/dist/application/agent-bootstrap.js

@@ -1,33 +1,60 @@
 import { posix } from "node:path";
 import { invariant } from "../domain/errors.js";
 import { quote, requireSuccess } from "../infrastructure/process.js";
-import { agentPackages } from "./agent-bootstrap.constants.js";
-function isBootstrapAgent(name) {
-    return Object.hasOwn(agentPackages, name);
+import { antigravityInstall } from "../providers/antigravity-install.js";
+import { agentInstallers } from "./agent-bootstrap.constants.js";
+const installations = {
+    npm: (installer, home) => {
+        const prefix = posix.join(home, ".outpost-tools");
+        const scripts = installer.allowScripts
+            ? ` --allow-scripts=${installer.package.replace(/@[^@/]+$/, "")}`
+            : "";
+        return {
+            target: posix.join(prefix, "bin", installer.binary),
+            install: `npm install --global${scripts} --prefix ${quote(prefix)} ${installer.package}`,
+        };
+    },
+    antigravity: (installer, home) => ({
+        target: posix.join(home, installer.installed),
+        install: antigravityInstall(posix.join(home, installer.installed)),
+    }),
+};
+function installation(installer, home) {
+    return installer.kind === "npm"
+        ? installations.npm(installer, home)
+        : installations.antigravity(installer, home);
 }
 export async function prepareAdapter(agent, runtime, signal) {
     if (agent.kind !== "cli")
         return agent;
-    const executable = agent.bootstrap ?? agent.conversations;
-    if (!executable)
+    const name = agent.bootstrap ?? agent.conversations;
+    if (!name)
         return agent;
-    invariant(isBootstrapAgent(executable), `Unknown agent bootstrap: ${executable}`);
-    const cli = agentPackages[executable];
-    const prefix = posix.join(runtime.home, ".outpost-tools"), target = posix.join(prefix, "bin", executable);
+    const installer = Object.hasOwn(agentInstallers, name)
+        ? agentInstallers[name]
+        : undefined;
+    invariant(installer, `Unknown agent bootstrap: ${name}`);
+    const { binary } = installer;
+    const { target, install } = installation(installer, runtime.home);
     const installed = await requireSuccess({
         executable: "sh",
         arguments: [
             "-c",
-            `if command -v ${executable} >/dev/null 2>&1; then command -v ${executable}; elif test -x ${quote(target)}; then printf '%s\\n' ${quote(target)}; else npm install --global --allow-scripts=@anthropic-ai/claude-code --prefix ${quote(prefix)} ${cli} >&2 && printf '%s\\n' ${quote(target)}; fi`,
+            `if command -v ${binary} >/dev/null 2>&1; then command -v ${binary}; elif test -x ${quote(target)}; then printf '%s\\n' ${quote(target)}; else ${install} >&2 && test -x ${quote(target)} && printf '%s\\n' ${quote(target)}; fi`,
         ],
         signal,
     }, runtime.invoke.bind(runtime));
-    const binary = installed.stdout.trim();
-    invariant(binary.startsWith("/") && !binary.includes("\n"), "Agent bootstrap returned an invalid executable path");
+    const path = installed.stdout.trim();
+    invariant(path.startsWith("/") && !path.includes("\n"), "Agent bootstrap returned an invalid executable path");
     return {
         ...agent,
+        ...(agent.fork
+            ? {
+                fork: (id, invoke) => agent.fork(id, (command) => invoke({ ...command, executable: path })),
+            }
+            : {}),
         request(input) {
-            return { ...agent.request(input), executable: binary };
+            return { ...agent.request(input), executable: path };
         },
     };
 }

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

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

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

@@ -0,0 +1,19 @@
+export type AgentInstaller = {
+    readonly kind: "npm";
+    readonly binary: string;
+    readonly package: string;
+    readonly allowScripts?: boolean;
+} | {
+    readonly kind: "antigravity";
+    readonly binary: string;
+    readonly installed: string;
+};
+export interface AgentInstallation {
+    readonly target: string;
+    readonly install: string;
+}
+export type AgentInstallations = {
+    readonly [Kind in AgentInstaller["kind"]]: (installer: Extract<AgentInstaller, {
+        kind: Kind;
+    }>, home: string) => AgentInstallation;
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bootstrap.types.js","sourceRoot":"","sources":["../../src/application/agent-bootstrap.types.ts"],"names":[],"mappings":"","sourcesContent":["export type AgentInstaller =\n  | {\n      readonly kind: \"npm\";\n      readonly binary: string;\n      readonly package: string;\n      readonly allowScripts?: boolean;\n    }\n  | {\n      readonly kind: \"antigravity\";\n      readonly binary: string;\n      readonly installed: string;\n    };\n\nexport interface AgentInstallation {\n  readonly target: string;\n  readonly install: string;\n}\n\nexport type AgentInstallations = {\n  readonly [Kind in AgentInstaller[\"kind\"]]: (\n    installer: Extract<AgentInstaller, { kind: Kind }>,\n    home: string,\n  ) => AgentInstallation;\n};\n"]}

package/dist/application/agent-output.js

@@ -1,12 +1,16 @@
+import { observationDefaults } from "../domain/observation.constants.js";
 import { visitAgentEvent } from "../domain/agent-events.js";
 import { OutpostError } from "../domain/errors.js";
-import { addUsage } from "../domain/usage.js";
+import { addUsage, usageDifference } from "../domain/usage.js";
 import { executionDefaults } from "./execution.constants.js";
 import { notify } from "./observation.js";
 export function agentOutput(agent, options, markers, pass) {
+    const calls = new Map();
     let pending = "", text = "", rawTail = "";
     let finalText, conversation, failure;
     let usage = { input: 0, cached: 0, output: 0 };
+    let baseline = { input: 0, cached: 0, output: 0 };
+    let reportedUsage = false, finalUsage = false;
     let completed = false, finished = false;
     const handlers = {
         text: (event) => {
@@ -24,23 +28,86 @@ export function agentOutput(agent, options, markers, pass) {
         failure: (event) => {
             failure = event.message;
         },
-        usage: (event) => {
-            usage = addUsage(usage, event.tokens);
-        },
+        usage: (event) => recordUsage(event.tokens, event.cumulative),
     };
+    function recordUsage(tokens, cumulative = false) {
+        reportedUsage = true;
+        if (cumulative && (!baseline || baseline.complete === false)) {
+            recordUsage({ input: 0, cached: 0, output: 0, complete: false });
+            return;
+        }
+        if (cumulative && tokens.complete !== false)
+            finalUsage = true;
+        const current = cumulative ? usageDifference(tokens, baseline) : tokens;
+        const delta = cumulative ? usageDifference(current, usage) : current;
+        usage = addUsage(usage, delta);
+        notify(options.observe, {
+            kind: "usage",
+            tokens: delta,
+            pass,
+            at: new Date().toISOString(),
+        });
+    }
     function consume(line) {
         const at = new Date().toISOString();
+        if (oversized(line))
+            return;
+        const events = agent.events(line);
         notify(options.observe, { kind: "raw", value: line, pass, at });
-        for (const event of agent.events(line)) {
+        for (const decoded of events) {
+            if (decoded.kind === "tool" && decoded.callId) {
+                if (calls.size >= observationDefaults.toolCallLimit)
+                    calls.delete(calls.keys().next().value);
+                calls.set(decoded.callId, decoded.name);
+            }
+            const event = decoded.kind === "tool-result" && !decoded.name
+                ? { ...decoded, name: calls.get(decoded.callId) ?? decoded.callId }
+                : decoded;
+            if (event.kind === "tool-result")
+                calls.delete(event.callId);
             visitAgentEvent(event, handlers);
-            if (event.kind !== "raw")
+            if (event.kind !== "raw" && event.kind !== "usage")
                 notify(options.observe, { ...event, pass, at });
         }
         completed =
             (!agent.requiresFinishedEvent || finished) &&
                 markers.some((marker) => (finalText ?? text).includes(marker));
     }
+    function oversized(line) {
+        const bytes = Buffer.byteLength(line);
+        if (bytes <= executionDefaults.eventBytes)
+            return false;
+        notify(options.observe, {
+            kind: "raw",
+            value: line.slice(0, observationDefaults.previewCharacters),
+            bytes,
+            truncated: true,
+            pass,
+            at: new Date().toISOString(),
+        });
+        throw new OutpostError("process", "Agent emitted an oversized event", {
+            stopReason: "oversized-event",
+        });
+    }
     return {
+        get usage() {
+            return usage;
+        },
+        get reportedUsage() {
+            return reportedUsage;
+        },
+        get finalUsage() {
+            return finalUsage;
+        },
+        recordUsage,
+        setUsageBaseline(tokens) {
+            baseline = tokens;
+            if (!tokens || tokens.complete === false)
+                recordUsage({ input: 0, cached: 0, output: 0, complete: false });
+        },
+        get failure() {
+            return failure;
+        },
         get completed() {
             return completed;
         },
@@ -55,8 +122,7 @@ export function agentOutput(agent, options, markers, pass) {
                 consume(pending.slice(0, end));
                 pending = pending.slice(end + 1);
             }
-            if (pending.length > executionDefaults.eventBytes)
-                throw new OutpostError("process", "Agent emitted an oversized event");
+            oversized(pending);
         },
         flush() {
             if (pending)

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    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"]}
+{"version":3,"file":"agent-output.js","sourceRoot":"","sources":["../../src/application/agent-output.ts"],"names":[],"mappings":"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","sourcesContent":["import { observationDefaults } from \"../domain/observation.constants.ts\";\nimport { visitAgentEvent } from \"../domain/agent-events.ts\";\nimport type { AgentAdapter, Usage } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { addUsage, usageDifference } 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  const calls = new Map<string, string>();\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 baseline: Usage | undefined = { input: 0, cached: 0, output: 0 };\n  let reportedUsage = false,\n    finalUsage = false;\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) => recordUsage(event.tokens, event.cumulative),\n  };\n  function recordUsage(tokens: Usage, cumulative = false): void {\n    reportedUsage = true;\n    if (cumulative && (!baseline || baseline.complete === false)) {\n      recordUsage({ input: 0, cached: 0, output: 0, complete: false });\n      return;\n    }\n    if (cumulative && tokens.complete !== false) finalUsage = true;\n    const current = cumulative ? usageDifference(tokens, baseline!) : tokens;\n    const delta = cumulative ? usageDifference(current, usage) : current;\n    usage = addUsage(usage, delta);\n    notify(options.observe, {\n      kind: \"usage\",\n      tokens: delta,\n      pass,\n      at: new Date().toISOString(),\n    });\n  }\n  function consume(line: string): void {\n    const at = new Date().toISOString();\n    if (oversized(line)) return;\n    const events = agent.events(line);\n    notify(options.observe, { kind: \"raw\", value: line, pass, at });\n    for (const decoded of events) {\n      if (decoded.kind === \"tool\" && decoded.callId) {\n        if (calls.size >= observationDefaults.toolCallLimit)\n          calls.delete(calls.keys().next().value!);\n        calls.set(decoded.callId, decoded.name);\n      }\n      const event =\n        decoded.kind === \"tool-result\" && !decoded.name\n          ? { ...decoded, name: calls.get(decoded.callId) ?? decoded.callId }\n          : decoded;\n      if (event.kind === \"tool-result\") calls.delete(event.callId);\n      visitAgentEvent(event, handlers);\n      if (event.kind !== \"raw\" && event.kind !== \"usage\")\n        notify(options.observe, { ...event, pass, at });\n    }\n    completed =\n      (!agent.requiresFinishedEvent || finished) &&\n      markers.some((marker) => (finalText ?? text).includes(marker));\n  }\n  function oversized(line: string): boolean {\n    const bytes = Buffer.byteLength(line);\n    if (bytes <= executionDefaults.eventBytes) return false;\n    notify(options.observe, {\n      kind: \"raw\",\n      value: line.slice(0, observationDefaults.previewCharacters),\n      bytes,\n      truncated: true,\n      pass,\n      at: new Date().toISOString(),\n    });\n    throw new OutpostError(\"process\", \"Agent emitted an oversized event\", {\n      stopReason: \"oversized-event\",\n    });\n  }\n  return {\n    get usage() {\n      return usage;\n    },\n    get reportedUsage() {\n      return reportedUsage;\n    },\n    get finalUsage() {\n      return finalUsage;\n    },\n    recordUsage,\n    setUsageBaseline(tokens) {\n      baseline = tokens;\n      if (!tokens || tokens.complete === false)\n        recordUsage({ input: 0, cached: 0, output: 0, complete: false });\n    },\n    get failure() {\n      return failure;\n    },\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      oversized(pending);\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/agent-request.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter, AgentInput } from "../domain/agent.types.ts";
+import type { Command, CommandResult } from "../domain/command.types.ts";
+export declare function agentRequest(agent: AgentAdapter, input: AgentInput, invoke: (command: Command) => Promise<CommandResult>, forked?: (id: string) => void): Promise<Command>;

package/dist/application/agent-request.js

@@ -0,0 +1,11 @@
+import { invariant } from "../domain/errors.js";
+export async function agentRequest(agent, input, invoke, forked) {
+    if (input.continuation?.fork && agent.fork) {
+        const id = await agent.fork(input.continuation.id, invoke);
+        invariant(id && id !== input.continuation.id, "Native fork must return a distinct conversation identifier");
+        forked?.(id);
+        return agent.request({ ...input, continuation: { id } });
+    }
+    return agent.request(input);
+}
+//# sourceMappingURL=agent-request.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-request.js","sourceRoot":"","sources":["../../src/application/agent-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAmB,EACnB,KAAiB,EACjB,MAAoD,EACpD,MAA6B;IAE7B,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3D,SAAS,CACP,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC,YAAY,CAAC,EAAE,EAClC,4DAA4D,CAC7D,CAAC;QACF,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type { AgentAdapter, AgentInput } from \"../domain/agent.types.ts\";\nimport type { Command, CommandResult } from \"../domain/command.types.ts\";\n\nexport async function agentRequest(\n  agent: AgentAdapter,\n  input: AgentInput,\n  invoke: (command: Command) => Promise<CommandResult>,\n  forked?: (id: string) => void,\n): Promise<Command> {\n  if (input.continuation?.fork && agent.fork) {\n    const id = await agent.fork(input.continuation.id, invoke);\n    invariant(\n      id && id !== input.continuation.id,\n      \"Native fork must return a distinct conversation identifier\",\n    );\n    forked?.(id);\n    return agent.request({ ...input, continuation: { id } });\n  }\n  return agent.request(input);\n}\n"]}

package/dist/application/agent-turn.js

@@ -1,8 +1,12 @@
+import { collectAgentUsage, prepareAgentUsage, warnUsage, } from "./agent-usage.js";
+import { agentRequest } from "./agent-request.js";
+import { boundedLines } from "./output-lines.js";
+import { stopReason } from "./stop-reason.js";
 import { customTurn } from "./custom-turn.js";
 import { OutpostError } from "../domain/errors.js";
 import { activityWatchdog } from "./activity-watchdog.js";
 import { agentOutput } from "./agent-output.js";
-import { executionDefaults } from "./execution.constants.js";
+import { agentConnectionFailurePattern, executionDefaults, } from "./execution.constants.js";
 import { notify } from "./observation.js";
 export async function turn(lease, agent, prompt, options, continuation, markers, pass, context) {
     if (agent.kind === "custom")
@@ -18,11 +22,40 @@ export async function turn(lease, agent, prompt, options, continuation, markers,
     const output = agentOutput(agent, options, markers, pass);
     const watchdog = activityWatchdog(controller, options, pass);
     watchdog.refresh(false);
+    const stderr = boundedLines((text, truncated) => notify(options.observe, {
+        kind: "stderr",
+        text,
+        truncated,
+        pass,
+        at: new Date().toISOString(),
+    }));
     let status = 0;
+    let commandCompleted = false;
+    let preparedConversation;
     try {
-        const command = agent.request({
+        if (agent.usage === "session")
+            warnUsage(options, pass, `${agent.name}: token usage is collected after the command exits; use budget.attempts and time limits to bound execution before the final counters arrive`);
+        if (agent.usage === "unavailable") {
+            warnUsage(options, pass, `${agent.name}: token usage is unavailable; use budget.attempts and time limits`);
+            output.recordUsage({ input: 0, cached: 0, output: 0, complete: false });
+        }
+        await prepareAgentUsage(lease, agent, output, continuation, signal);
+        signal.throwIfAborted();
+        const command = await agentRequest(agent, {
             text: prompt,
             ...(continuation ? { continuation } : {}),
+        }, (command) => lease.invoke({
+            ...command,
+            signal,
+            deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,
+        }), (id) => {
+            preparedConversation = id;
+            notify(options.observe, {
+                kind: "conversation",
+                id,
+                pass,
+                at: new Date().toISOString(),
+            });
         });
         const result = await lease.invoke({
             ...command,
@@ -37,28 +70,63 @@ export async function turn(lease, agent, prompt, options, continuation, markers,
                         controller.abort(cause);
                     }
                 }
+                if (channel === "stderr")
+                    stderr.append(chunk);
                 watchdog.refresh(output.completed);
             },
         });
+        commandCompleted = true;
         status = result.status;
         output.flush();
         if (status !== 0)
             throw new OutpostError("process", `Agent exited with status ${status}`, {
                 ...result,
-                conversation: output.conversation,
+                conversation: output.conversation ?? preparedConversation,
             });
     }
     catch (cause) {
+        const reason = stopReason(options.signal, controller.signal.reason, cause);
+        if (reason)
+            notify(options.observe, {
+                kind: "stopped",
+                reason,
+                pass,
+                at: new Date().toISOString(),
+            });
         options.signal?.throwIfAborted();
-        if (controller.signal.reason !== "completion")
-            throw controller.signal.reason instanceof OutpostError
+        if (controller.signal.reason !== "completion") {
+            const error = controller.signal.reason instanceof OutpostError
                 ? controller.signal.reason
                 : cause;
+            if (error instanceof OutpostError &&
+                error.code === "timeout" &&
+                output.failure &&
+                agentConnectionFailurePattern.test(output.failure)) {
+                const diagnosed = new OutpostError(error.code, `${error.message}. The agent reported a connection failure. Check the model endpoint and network access.`, { ...error.details, agentDiagnostic: "connection" }, error);
+                diagnosed.recovery = error.recovery;
+                throw diagnosed;
+            }
+            throw error;
+        }
         notify(options.warn, "Agent remained active after completion; its command was stopped and trailing output retained");
     }
     finally {
+        stderr.flush();
         watchdog.close();
+        try {
+            output.flush();
+        }
+        catch {
+            commandCompleted = false;
+        }
+        await collectAgentUsage(lease, agent, output, options, pass, commandCompleted);
     }
-    return { ...output.result(), status, durationMs: Date.now() - start };
+    options.signal?.throwIfAborted();
+    return {
+        ...(preparedConversation ? { conversation: preparedConversation } : {}),
+        ...output.result(),
+        status,
+        durationMs: Date.now() - start,
+    };
 }
 //# sourceMappingURL=agent-turn.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../src/application/agent-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import { customTurn } from \"./custom-turn.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { activityWatchdog } from \"./activity-watchdog.ts\";\nimport { agentOutput } from \"./agent-output.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport type { DispatchOptions, Turn, TurnContext } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport async function turn(\n  lease: SandboxLease,\n  agent: Agent,\n  prompt: string,\n  options: DispatchOptions<unknown>,\n  continuation: DispatchOptions[\"continuation\"],\n  markers: readonly string[],\n  pass: number,\n  context: TurnContext,\n): Promise<Turn> {\n  if (agent.kind === \"custom\")\n    return customTurn(lease, agent, prompt, options, pass, {\n      ...context,\n      continuation,\n    });\n  const start = Date.now();\n  const controller = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n  const output = agentOutput(agent, options, markers, pass);\n  const watchdog = activityWatchdog(controller, options, pass);\n  watchdog.refresh(false);\n  let status = 0;\n  try {\n    const command = agent.request({\n      text: prompt,\n      ...(continuation ? { continuation } : {}),\n    });\n    const result = await lease.invoke({\n      ...command,\n      signal,\n      deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,\n      observe(channel, chunk) {\n        if (channel === \"stdout\") {\n          try {\n            output.append(chunk);\n          } catch (cause) {\n            controller.abort(cause);\n          }\n        }\n        watchdog.refresh(output.completed);\n      },\n    });\n    status = result.status;\n    output.flush();\n    if (status !== 0)\n      throw new OutpostError(\"process\", `Agent exited with status ${status}`, {\n        ...result,\n        conversation: output.conversation,\n      });\n  } catch (cause) {\n    options.signal?.throwIfAborted();\n    if (controller.signal.reason !== \"completion\")\n      throw controller.signal.reason instanceof OutpostError\n        ? controller.signal.reason\n        : cause;\n    notify(\n      options.warn,\n      \"Agent remained active after completion; its command was stopped and trailing output retained\",\n    );\n  } finally {\n    watchdog.close();\n  }\n  return { ...output.result(), status, durationMs: Date.now() - start };\n}\n"]}
+{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../src/application/agent-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  collectAgentUsage,\n  prepareAgentUsage,\n  warnUsage,\n} from \"./agent-usage.ts\";\nimport { agentRequest } from \"./agent-request.ts\";\nimport { boundedLines } from \"./output-lines.ts\";\nimport { stopReason } from \"./stop-reason.ts\";\nimport { customTurn } from \"./custom-turn.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport { activityWatchdog } from \"./activity-watchdog.ts\";\nimport { agentOutput } from \"./agent-output.ts\";\nimport {\n  agentConnectionFailurePattern,\n  executionDefaults,\n} from \"./execution.constants.ts\";\nimport type { DispatchOptions, Turn, TurnContext } from \"./execution.types.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport async function turn(\n  lease: SandboxLease,\n  agent: Agent,\n  prompt: string,\n  options: DispatchOptions<unknown>,\n  continuation: DispatchOptions[\"continuation\"],\n  markers: readonly string[],\n  pass: number,\n  context: TurnContext,\n): Promise<Turn> {\n  if (agent.kind === \"custom\")\n    return customTurn(lease, agent, prompt, options, pass, {\n      ...context,\n      continuation,\n    });\n  const start = Date.now();\n  const controller = new AbortController();\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n  const output = agentOutput(agent, options, markers, pass);\n  const watchdog = activityWatchdog(controller, options, pass);\n  watchdog.refresh(false);\n  const stderr = boundedLines((text, truncated) =>\n    notify(options.observe, {\n      kind: \"stderr\",\n      text,\n      truncated,\n      pass,\n      at: new Date().toISOString(),\n    }),\n  );\n  let status = 0;\n  let commandCompleted = false;\n  let preparedConversation: string | undefined;\n  try {\n    if (agent.usage === \"session\")\n      warnUsage(\n        options,\n        pass,\n        `${agent.name}: token usage is collected after the command exits; use budget.attempts and time limits to bound execution before the final counters arrive`,\n      );\n    if (agent.usage === \"unavailable\") {\n      warnUsage(\n        options,\n        pass,\n        `${agent.name}: token usage is unavailable; use budget.attempts and time limits`,\n      );\n      output.recordUsage({ input: 0, cached: 0, output: 0, complete: false });\n    }\n    await prepareAgentUsage(lease, agent, output, continuation, signal);\n    signal.throwIfAborted();\n    const command = await agentRequest(\n      agent,\n      {\n        text: prompt,\n        ...(continuation ? { continuation } : {}),\n      },\n      (command) =>\n        lease.invoke({\n          ...command,\n          signal,\n          deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,\n        }),\n      (id) => {\n        preparedConversation = id;\n        notify(options.observe, {\n          kind: \"conversation\",\n          id,\n          pass,\n          at: new Date().toISOString(),\n        });\n      },\n    );\n    const result = await lease.invoke({\n      ...command,\n      signal,\n      deadlineMs: options.deadlineMs ?? executionDefaults.deadlineMs,\n      observe(channel, chunk) {\n        if (channel === \"stdout\") {\n          try {\n            output.append(chunk);\n          } catch (cause) {\n            controller.abort(cause);\n          }\n        }\n        if (channel === \"stderr\") stderr.append(chunk);\n        watchdog.refresh(output.completed);\n      },\n    });\n    commandCompleted = true;\n    status = result.status;\n    output.flush();\n    if (status !== 0)\n      throw new OutpostError(\"process\", `Agent exited with status ${status}`, {\n        ...result,\n        conversation: output.conversation ?? preparedConversation,\n      });\n  } catch (cause) {\n    const reason = stopReason(options.signal, controller.signal.reason, cause);\n    if (reason)\n      notify(options.observe, {\n        kind: \"stopped\",\n        reason,\n        pass,\n        at: new Date().toISOString(),\n      });\n    options.signal?.throwIfAborted();\n    if (controller.signal.reason !== \"completion\") {\n      const error =\n        controller.signal.reason instanceof OutpostError\n          ? controller.signal.reason\n          : cause;\n      if (\n        error instanceof OutpostError &&\n        error.code === \"timeout\" &&\n        output.failure &&\n        agentConnectionFailurePattern.test(output.failure)\n      ) {\n        const diagnosed = new OutpostError(\n          error.code,\n          `${error.message}. The agent reported a connection failure. Check the model endpoint and network access.`,\n          { ...error.details, agentDiagnostic: \"connection\" },\n          error,\n        );\n        diagnosed.recovery = error.recovery;\n        throw diagnosed;\n      }\n      throw error;\n    }\n    notify(\n      options.warn,\n      \"Agent remained active after completion; its command was stopped and trailing output retained\",\n    );\n  } finally {\n    stderr.flush();\n    watchdog.close();\n    try {\n      output.flush();\n    } catch {\n      commandCompleted = false;\n    }\n    await collectAgentUsage(\n      lease,\n      agent,\n      output,\n      options,\n      pass,\n      commandCompleted,\n    );\n  }\n  options.signal?.throwIfAborted();\n  return {\n    ...(preparedConversation ? { conversation: preparedConversation } : {}),\n    ...output.result(),\n    status,\n    durationMs: Date.now() - start,\n  };\n}\n"]}

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

@@ -0,0 +1,6 @@
+import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { SandboxLease } from "../domain/sandbox.types.ts";
+import type { AgentOutput, DispatchOptions } from "./execution.types.ts";
+export declare function warnUsage(options: DispatchOptions<unknown>, pass: number, message: string): void;
+export declare function prepareAgentUsage(lease: SandboxLease, agent: AgentAdapter, output: AgentOutput, continuation: DispatchOptions<unknown>["continuation"], signal: AbortSignal): Promise<void>;
+export declare function collectAgentUsage(lease: SandboxLease, agent: AgentAdapter, output: AgentOutput, options: DispatchOptions<unknown>, pass: number, completed: boolean): Promise<void>;

package/dist/application/agent-usage.js

@@ -0,0 +1,57 @@
+import { executionDefaults } from "./execution.constants.js";
+import { notify } from "./observation.js";
+export function warnUsage(options, pass, message) {
+    notify(options.warn, message);
+    notify(options.observe, {
+        kind: "warning",
+        message,
+        pass,
+        at: new Date().toISOString(),
+    });
+}
+async function readAgentUsage(lease, agent, conversation, signal) {
+    const command = agent.usageCommand?.(conversation);
+    if (!command)
+        return;
+    const result = await lease.invoke({
+        ...command,
+        ...(signal ? { signal } : {}),
+        deadlineMs: Math.min(command.deadlineMs ?? executionDefaults.usageMs, executionDefaults.usageMs),
+    });
+    return result.status === 0 ? agent.usageResult?.(result.stdout) : undefined;
+}
+export async function prepareAgentUsage(lease, agent, output, continuation, signal) {
+    if (agent.usage !== "session" || !continuation)
+        return;
+    let baseline;
+    if (!continuation.fork) {
+        try {
+            baseline = await readAgentUsage(lease, agent, continuation.id, signal);
+        }
+        catch {
+            signal.throwIfAborted();
+        }
+    }
+    output.setUsageBaseline(baseline);
+}
+export async function collectAgentUsage(lease, agent, output, options, pass, completed) {
+    if (agent.usage === undefined)
+        return;
+    if (agent.usage === "session" && !output.finalUsage && output.conversation) {
+        try {
+            const tokens = await readAgentUsage(lease, agent, output.conversation);
+            if (tokens)
+                output.recordUsage(tokens, true);
+        }
+        catch {
+            warnUsage(options, pass, `${agent.name}: session token usage could not be collected`);
+        }
+    }
+    if (!output.reportedUsage ||
+        !completed ||
+        (agent.usage === "session" && !output.finalUsage))
+        output.recordUsage({ input: 0, cached: 0, output: 0, complete: false });
+    if (output.usage.complete === false)
+        warnUsage(options, pass, `${agent.name}: token usage is incomplete; reported counters are a lower bound. Use budget.attempts with task timeouts or dispatch deadlines.`);
+}
+//# sourceMappingURL=agent-usage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-usage.js","sourceRoot":"","sources":["../../src/application/agent-usage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,SAAS,CACvB,OAAiC,EACjC,IAAY,EACZ,OAAe;IAEf,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE;QACtB,IAAI,EAAE,SAAS;QACf,OAAO;QACP,IAAI;QACJ,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,KAAmB,EACnB,KAAmB,EACnB,YAAoB,EACpB,MAAoB;IAEpB,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;QAChC,GAAG,OAAO;QACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,UAAU,EAAE,IAAI,CAAC,GAAG,CAClB,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,OAAO,EAC/C,iBAAiB,CAAC,OAAO,CAC1B;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAmB,EACnB,KAAmB,EACnB,MAAmB,EACnB,YAAsD,EACtD,MAAmB;IAEnB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,YAAY;QAAE,OAAO;IACvD,IAAI,QAA2B,CAAC;IAChC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAmB,EACnB,KAAmB,EACnB,MAAmB,EACnB,OAAiC,EACjC,IAAY,EACZ,SAAkB;IAElB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO;IACtC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACvE,IAAI,MAAM;gBAAE,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CACP,OAAO,EACP,IAAI,EACJ,GAAG,KAAK,CAAC,IAAI,8CAA8C,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IACE,CAAC,MAAM,CAAC,aAAa;QACrB,CAAC,SAAS;QACV,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAEjD,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,KAAK;QACjC,SAAS,CACP,OAAO,EACP,IAAI,EACJ,GAAG,KAAK,CAAC,IAAI,iIAAiI,CAC/I,CAAC;AACN,CAAC","sourcesContent":["import type { AgentAdapter, Usage } from \"../domain/agent.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { AgentOutput, DispatchOptions } from \"./execution.types.ts\";\nimport { executionDefaults } from \"./execution.constants.ts\";\nimport { notify } from \"./observation.ts\";\n\nexport function warnUsage(\n  options: DispatchOptions<unknown>,\n  pass: number,\n  message: string,\n): void {\n  notify(options.warn, message);\n  notify(options.observe, {\n    kind: \"warning\",\n    message,\n    pass,\n    at: new Date().toISOString(),\n  });\n}\n\nasync function readAgentUsage(\n  lease: SandboxLease,\n  agent: AgentAdapter,\n  conversation: string,\n  signal?: AbortSignal,\n): Promise<Usage | undefined> {\n  const command = agent.usageCommand?.(conversation);\n  if (!command) return;\n  const result = await lease.invoke({\n    ...command,\n    ...(signal ? { signal } : {}),\n    deadlineMs: Math.min(\n      command.deadlineMs ?? executionDefaults.usageMs,\n      executionDefaults.usageMs,\n    ),\n  });\n  return result.status === 0 ? agent.usageResult?.(result.stdout) : undefined;\n}\n\nexport async function prepareAgentUsage(\n  lease: SandboxLease,\n  agent: AgentAdapter,\n  output: AgentOutput,\n  continuation: DispatchOptions<unknown>[\"continuation\"],\n  signal: AbortSignal,\n): Promise<void> {\n  if (agent.usage !== \"session\" || !continuation) return;\n  let baseline: Usage | undefined;\n  if (!continuation.fork) {\n    try {\n      baseline = await readAgentUsage(lease, agent, continuation.id, signal);\n    } catch {\n      signal.throwIfAborted();\n    }\n  }\n  output.setUsageBaseline(baseline);\n}\n\nexport async function collectAgentUsage(\n  lease: SandboxLease,\n  agent: AgentAdapter,\n  output: AgentOutput,\n  options: DispatchOptions<unknown>,\n  pass: number,\n  completed: boolean,\n): Promise<void> {\n  if (agent.usage === undefined) return;\n  if (agent.usage === \"session\" && !output.finalUsage && output.conversation) {\n    try {\n      const tokens = await readAgentUsage(lease, agent, output.conversation);\n      if (tokens) output.recordUsage(tokens, true);\n    } catch {\n      warnUsage(\n        options,\n        pass,\n        `${agent.name}: session token usage could not be collected`,\n      );\n    }\n  }\n  if (\n    !output.reportedUsage ||\n    !completed ||\n    (agent.usage === \"session\" && !output.finalUsage)\n  )\n    output.recordUsage({ input: 0, cached: 0, output: 0, complete: false });\n  if (output.usage.complete === false)\n    warnUsage(\n      options,\n      pass,\n      `${agent.name}: token usage is incomplete; reported counters are a lower bound. Use budget.attempts with task timeouts or dispatch deadlines.`,\n    );\n}\n"]}

package/dist/application/attach.js

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