@elie-laloum/outpost 5.0.0 → 7.0.0

package/dist/application/harness-budget.js

@@ -0,0 +1,42 @@
+import { invariant, OutpostError } from "../domain/errors.js";
+import { addUsage } from "../domain/usage.js";
+export function harnessBudget(limits, parent) {
+    let usage = { input: 0, cached: 0, output: 0 };
+    let failure;
+    return {
+        check() {
+            parent?.check();
+            if (failure)
+                throw failure;
+        },
+        account(result) {
+            parent?.account(result);
+            try {
+                if (result.usage) {
+                    const tokens = result.usage;
+                    for (const value of [
+                        tokens.input,
+                        tokens.cached,
+                        tokens.cacheCreated ?? 0,
+                        tokens.output,
+                    ])
+                        invariant(Number.isSafeInteger(value) && value >= 0, "Harness usage must contain nonnegative token counts");
+                    invariant(tokens.cached + (tokens.cacheCreated ?? 0) <= tokens.input, "Cached tokens must be included in input usage");
+                    usage = addUsage(usage, tokens);
+                }
+                if (!limits.usage)
+                    return;
+                if (!result.usage || result.usage.complete === false)
+                    throw new OutpostError("configuration", "Harness usage limits require a model provider that reports usage completely");
+                const exceeded = Object.entries(limits.usage).find(([key, value]) => (usage[key] ?? 0) > value);
+                if (exceeded)
+                    throw new OutpostError("limit", `Harness exceeded its ${exceeded[0]} token budget`, { limit: "usage" });
+            }
+            catch (error) {
+                failure ??= error;
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=harness-budget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-budget.js","sourceRoot":"","sources":["../../src/application/harness-budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,MAAsB;IAEtB,IAAI,KAAK,GAAU,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtD,IAAI,OAAgB,CAAC;IACrB,OAAO;QACL,KAAK;YACH,MAAM,EAAE,KAAK,EAAE,CAAC;YAChB,IAAI,OAAO;gBAAE,MAAM,OAAO,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,MAAM;YACZ,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBACjB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;oBAC5B,KAAK,MAAM,KAAK,IAAI;wBAClB,MAAM,CAAC,KAAK;wBACZ,MAAM,CAAC,MAAM;wBACb,MAAM,CAAC,YAAY,IAAI,CAAC;wBACxB,MAAM,CAAC,MAAM;qBACd;wBACC,SAAS,CACP,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EACzC,qDAAqD,CACtD,CAAC;oBACJ,SAAS,CACP,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,EAC1D,+CAA+C,CAChD,CAAC;oBACF,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClC,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,KAAK;oBAAE,OAAO;gBAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,KAAK;oBAClD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,6EAA6E,CAC9E,CAAC;gBACJ,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAChD,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,KAAK,CAAC,GAAuC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAChE,CAAC;gBACF,IAAI,QAAQ;oBACV,MAAM,IAAI,YAAY,CACpB,OAAO,EACP,wBAAwB,QAAQ,CAAC,CAAC,CAAC,eAAe,EAClD,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,KAAK,KAAK,CAAC;gBAClB,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { Usage } from \"../domain/agent.types.ts\";\nimport { invariant, OutpostError } from \"../domain/errors.ts\";\nimport type { HarnessLimits } from \"../domain/harness.types.ts\";\nimport { addUsage } from \"../domain/usage.ts\";\nimport type { HarnessBudget } from \"./harness-budget.types.ts\";\n\nexport function harnessBudget(\n  limits: HarnessLimits,\n  parent?: HarnessBudget,\n): HarnessBudget {\n  let usage: Usage = { input: 0, cached: 0, output: 0 };\n  let failure: unknown;\n  return {\n    check() {\n      parent?.check();\n      if (failure) throw failure;\n    },\n    account(result) {\n      parent?.account(result);\n      try {\n        if (result.usage) {\n          const tokens = result.usage;\n          for (const value of [\n            tokens.input,\n            tokens.cached,\n            tokens.cacheCreated ?? 0,\n            tokens.output,\n          ])\n            invariant(\n              Number.isSafeInteger(value) && value >= 0,\n              \"Harness usage must contain nonnegative token counts\",\n            );\n          invariant(\n            tokens.cached + (tokens.cacheCreated ?? 0) <= tokens.input,\n            \"Cached tokens must be included in input usage\",\n          );\n          usage = addUsage(usage, tokens);\n        }\n        if (!limits.usage) return;\n        if (!result.usage || result.usage.complete === false)\n          throw new OutpostError(\n            \"configuration\",\n            \"Harness usage limits require a model provider that reports usage completely\",\n          );\n        const exceeded = Object.entries(limits.usage).find(\n          ([key, value]) =>\n            (usage[key as Exclude<keyof Usage, \"complete\">] ?? 0) > value,\n        );\n        if (exceeded)\n          throw new OutpostError(\n            \"limit\",\n            `Harness exceeded its ${exceeded[0]} token budget`,\n            { limit: \"usage\" },\n          );\n      } catch (error) {\n        failure ??= error;\n        throw error;\n      }\n    },\n  };\n}\n"]}

package/dist/application/harness-budget.types.d.ts

@@ -0,0 +1,5 @@
+import type { ModelResult } from "../domain/model.types.ts";
+export interface HarnessBudget {
+    check(): void;
+    account(result: ModelResult): void;
+}

package/dist/application/harness-budget.types.js

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

package/dist/application/harness-budget.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-budget.types.js","sourceRoot":"","sources":["../../src/application/harness-budget.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ModelResult } from \"../domain/model.types.ts\";\n\nexport interface HarnessBudget {\n  check(): void;\n  account(result: ModelResult): void;\n}\n"]}

package/dist/application/harness-hooks.js

@@ -22,6 +22,11 @@ export async function beforeTool(runtime, call, step) {
             call: current,
             ...context(runtime, step),
         });
+        runtime.emit({
+            kind: "hook",
+            phase: "before-tool",
+            changed: decision !== undefined,
+        });
         if (decision === undefined)
             continue;
         expect(decision !== null && typeof decision === "object", "before-tool hooks may return { deny } or { input }");
@@ -42,6 +47,11 @@ export async function afterTool(runtime, call, outcome, step, normalize) {
             result: current,
             ...context(runtime, step),
         });
+        runtime.emit({
+            kind: "hook",
+            phase: "after-tool",
+            changed: decision !== undefined,
+        });
         if (decision === undefined)
             continue;
         expect(decision !== null && typeof decision === "object" && "result" in decision, "after-tool hooks may only return { result }");
@@ -52,6 +62,11 @@ export async function afterTool(runtime, call, outcome, step, normalize) {
 export async function stopRequest(runtime, text, step) {
     for (const hook of hooks(runtime, "stop")) {
         const decision = await hook.run({ text, ...context(runtime, step) });
+        runtime.emit({
+            kind: "hook",
+            phase: "stop",
+            changed: decision !== undefined,
+        });
         if (decision === undefined)
             continue;
         expect(decision !== null &&
@@ -64,11 +79,19 @@ export async function stopRequest(runtime, text, step) {
 }
 async function each(runtime, phase, event, step) {
     const decisions = [];
-    for (const hook of hooks(runtime, phase))
-        decisions.push(await hook.run({
+    for (const hook of hooks(runtime, phase)) {
+        const before = snapshot(event);
+        const decision = await hook.run({
             ...event,
             ...context(runtime, step),
-        }));
+        });
+        runtime.emit({
+            kind: "hook",
+            phase,
+            changed: decision !== undefined || before !== snapshot(event),
+        });
+        decisions.push(decision);
+    }
     return decisions;
 }
 function hooks(runtime, phase) {
@@ -87,4 +110,12 @@ function expect(condition, message) {
     if (!condition)
         throw new OutpostError("configuration", message);
 }
+function snapshot(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return undefined;
+    }
+}
 //# sourceMappingURL=harness-hooks.js.map

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

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

package/dist/application/harness-loop.js

@@ -1,6 +1,5 @@
 import { OutpostError } from "../domain/errors.js";
 import { loadedSkills } from "../domain/skill.js";
-import { addUsage } from "../domain/usage.js";
 import { compact } from "./harness-context.js";
 import { afterModel, beforeModel, sessionInstructions, stopRequest, } from "./harness-hooks.js";
 import { executeToolCalls } from "./tool-execution.js";
@@ -56,15 +55,18 @@ export async function harnessLoop(runtime, prompt, history) {
         role: "user",
         content: [{ type: "text", text: prompt }],
     });
-    let usage = { input: 0, cached: 0, output: 0 };
     let toolCalls = 0;
+    const announcedSkills = new Set();
     for (let step = 1;; step++) {
         runtime.signal.throwIfAborted();
         if (step > harness.limits.maxSteps)
             throw limit("maxSteps", `Harness reached ${harness.limits.maxSteps} steps without a final answer`);
-        const exceeded = exceededUsage(usage, harness.limits.usage);
-        if (exceeded)
-            throw limit("usage", `Harness exceeded its ${exceeded} token budget`);
+        runtime.budget.check();
+        const newlyLoaded = [...loadedSkills(history.messages)].filter((name) => !announcedSkills.has(name));
+        for (const name of newlyLoaded)
+            announcedSkills.add(name);
+        if (newlyLoaded.length)
+            runtime.emit({ kind: "skills-loaded", names: newlyLoaded });
         runtime.emit({ kind: "step", index: step });
         await compact(runtime, history, step);
         await beforeModel(runtime, history.messages, step);
@@ -75,21 +77,21 @@ export async function harnessLoop(runtime, prompt, history) {
             ...(tools.length ? { tools } : {}),
             ...(harness.cache ? { cache: true } : {}),
         });
-        if (harness.limits.usage && !result.usage)
-            throw new OutpostError("configuration", "Harness usage limits require a model provider that reports usage");
-        if (result.usage)
-            usage = addUsage(usage, result.usage);
         await afterModel(runtime, result, step);
         const content = result.content ?? [
             { type: "text", text: result.text },
         ];
-        for (const block of content)
+        for (const block of content) {
             if (block.type === "text" && block.text)
                 runtime.emit({ kind: "text", text: block.text });
+            if (block.type === "reasoning" && block.text)
+                runtime.emit({ kind: "reasoning", text: block.text });
+        }
         const state = { history, step, toolCalls };
         const reason = result.stopReason ?? inferredStop(content);
         const answer = await stopHandlers[reason](runtime, state, result, content);
         toolCalls = state.toolCalls;
+        runtime.budget.check();
         if (answer !== undefined)
             return answer;
     }
@@ -101,6 +103,10 @@ async function instructions(runtime) {
         model: runtime.agent.model,
     })));
     runtime.signal.throwIfAborted();
+    runtime.emit({
+        kind: "instructions-loaded",
+        count: texts.filter((text) => text.trim()).length,
+    });
     return texts.filter((text) => text.trim()).join("\n\n");
 }
 function inferredStop(content) {
@@ -108,25 +114,47 @@ function inferredStop(content) {
         ? "tool-calls"
         : "end";
 }
-function exceededUsage(usage, limits) {
-    return Object.entries(limits ?? {}).find(([key, value]) => (usage[key] ?? 0) > (value ?? Infinity))?.[0];
-}
 function limit(name, message) {
     return new OutpostError("limit", message, { limit: name });
 }
 async function requestModel(runtime, request) {
     const provider = runtime.modelProvider;
-    if (!provider.stream)
-        return provider.request(request);
-    let result;
-    for await (const event of provider.stream(request)) {
-        if (event.type === "text-delta")
-            runtime.emit({ kind: "text-delta", text: event.text });
-        if (event.type === "result")
-            result = event.result;
+    if (runtime.verbose)
+        runtime.emit({ kind: "model-request", request });
+    try {
+        const result = await receive();
+        if (runtime.verbose)
+            runtime.emit({ kind: "model-response", response: result });
+        return result;
+    }
+    catch (error) {
+        runtime.emit({
+            kind: "model-error",
+            message: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+    async function receive() {
+        if (!provider.stream)
+            return provider.request(request);
+        let result;
+        for await (const event of provider.stream(request)) {
+            if (event.type === "text-delta")
+                runtime.emit({ kind: "text-delta", text: event.text });
+            if (event.type === "reasoning")
+                runtime.emit({ kind: "reasoning", text: event.text });
+            if (event.type === "retry")
+                runtime.emit({
+                    kind: "model-retry",
+                    attempt: event.attempt,
+                    ...(event.message ? { message: event.message } : {}),
+                });
+            if (event.type === "result")
+                result = event.result;
+        }
+        if (!result)
+            throw new OutpostError("response", "Model stream ended without a result");
+        return result;
     }
-    if (!result)
-        throw new OutpostError("response", "Model stream ended without a result");
-    return result;
 }
 //# sourceMappingURL=harness-loop.js.map

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

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

package/dist/application/harness-model-provider.d.ts

@@ -0,0 +1,3 @@
+import type { ModelProvider } from "../domain/model.types.ts";
+import type { HarnessModelScope } from "./harness-model-provider.types.ts";
+export declare function harnessModelProvider(scope: HarnessModelScope): ModelProvider;

package/dist/application/harness-model-provider.js

@@ -0,0 +1,49 @@
+import { invariant } from "../domain/errors.js";
+export function harnessModelProvider(scope) {
+    const { agent, signal, budget, track } = scope;
+    const provider = agent.harness.modelProvider;
+    const scoped = (request) => {
+        signal.throwIfAborted();
+        budget.check();
+        const { reasoning, maxOutputTokens } = agent.model;
+        return {
+            ...(reasoning === undefined ? {} : { reasoning }),
+            ...(maxOutputTokens === undefined ? {} : { maxOutputTokens }),
+            ...request,
+            signal,
+        };
+    };
+    const account = (result) => {
+        signal.throwIfAborted();
+        invariant(result && typeof result.text === "string", "Model provider must return text");
+        scope.account(result);
+        budget.account(result);
+        return result;
+    };
+    async function* stream(request) {
+        let finish;
+        track(new Promise((resolve) => (finish = resolve)));
+        try {
+            let received = false;
+            for await (const event of provider.stream(scoped(request))) {
+                signal.throwIfAborted();
+                if (event.type === "result") {
+                    invariant(!received, "Model stream returned more than one result");
+                    received = true;
+                    yield { type: "result", result: account(event.result) };
+                    continue;
+                }
+                yield event;
+            }
+        }
+        finally {
+            finish();
+        }
+    }
+    return {
+        name: provider.name,
+        ...(provider.stream ? { stream } : {}),
+        request: (request) => track(Promise.resolve().then(async () => account(await provider.request(scoped(request))))),
+    };
+}
+//# sourceMappingURL=harness-model-provider.js.map

package/dist/application/harness-model-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-model-provider.js","sourceRoot":"","sources":["../../src/application/harness-model-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAShD,MAAM,UAAU,oBAAoB,CAAC,KAAwB;IAC3D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,OAAqB,EAAgB,EAAE;QACrD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;QACnD,OAAO;YACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;YACjD,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;YAC7D,GAAG,OAAO;YACV,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,MAAmB,EAAe,EAAE;QACnD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,SAAS,CACP,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EACzC,iCAAiC,CAClC,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,KAAK,SAAS,CAAC,CAAC,MAAM,CACpB,OAAqB;QAErB,IAAI,MAAmB,CAAC;QACxB,KAAK,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5B,SAAS,CAAC,CAAC,QAAQ,EAAE,4CAA4C,CAAC,CAAC;oBACnE,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxD,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CACnB,KAAK,CACH,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAChC,OAAO,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACjD,CACF;KACJ,CAAC;AACJ,CAAC","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type {\n  ModelProvider,\n  ModelRequest,\n  ModelResult,\n  ModelStreamEvent,\n} from \"../domain/model.types.ts\";\nimport type { HarnessModelScope } from \"./harness-model-provider.types.ts\";\n\nexport function harnessModelProvider(scope: HarnessModelScope): ModelProvider {\n  const { agent, signal, budget, track } = scope;\n  const provider = agent.harness.modelProvider;\n  const scoped = (request: ModelRequest): ModelRequest => {\n    signal.throwIfAborted();\n    budget.check();\n    const { reasoning, maxOutputTokens } = agent.model;\n    return {\n      ...(reasoning === undefined ? {} : { reasoning }),\n      ...(maxOutputTokens === undefined ? {} : { maxOutputTokens }),\n      ...request,\n      signal,\n    };\n  };\n  const account = (result: ModelResult): ModelResult => {\n    signal.throwIfAborted();\n    invariant(\n      result && typeof result.text === \"string\",\n      \"Model provider must return text\",\n    );\n    scope.account(result);\n    budget.account(result);\n    return result;\n  };\n  async function* stream(\n    request: ModelRequest,\n  ): AsyncGenerator<ModelStreamEvent> {\n    let finish!: () => void;\n    track(new Promise<void>((resolve) => (finish = resolve)));\n    try {\n      let received = false;\n      for await (const event of provider.stream!(scoped(request))) {\n        signal.throwIfAborted();\n        if (event.type === \"result\") {\n          invariant(!received, \"Model stream returned more than one result\");\n          received = true;\n          yield { type: \"result\", result: account(event.result) };\n          continue;\n        }\n        yield event;\n      }\n    } finally {\n      finish();\n    }\n  }\n  return {\n    name: provider.name,\n    ...(provider.stream ? { stream } : {}),\n    request: (request) =>\n      track(\n        Promise.resolve().then(async () =>\n          account(await provider.request(scoped(request))),\n        ),\n      ),\n  };\n}\n"]}

package/dist/application/harness-model-provider.types.d.ts

@@ -0,0 +1,10 @@
+import type { CustomAgent } from "../domain/agent.types.ts";
+import type { ModelResult } from "../domain/model.types.ts";
+import type { HarnessBudget } from "./harness-budget.types.ts";
+export interface HarnessModelScope {
+    readonly agent: CustomAgent;
+    readonly signal: AbortSignal;
+    readonly budget: HarnessBudget;
+    track<T>(operation: Promise<T>): Promise<T>;
+    account(result: ModelResult, subagentId?: string): void;
+}

package/dist/application/harness-model-provider.types.js

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

package/dist/application/harness-model-provider.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-model-provider.types.js","sourceRoot":"","sources":["../../src/application/harness-model-provider.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { CustomAgent } from \"../domain/agent.types.ts\";\nimport type { ModelResult } from \"../domain/model.types.ts\";\nimport type { HarnessBudget } from \"./harness-budget.types.ts\";\n\nexport interface HarnessModelScope {\n  readonly agent: CustomAgent;\n  readonly signal: AbortSignal;\n  readonly budget: HarnessBudget;\n  track<T>(operation: Promise<T>): Promise<T>;\n  account(result: ModelResult, subagentId?: string): void;\n}\n"]}

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

@@ -0,0 +1,4 @@
+import type { HarnessSubagent } from "../domain/subagent.types.ts";
+import type { HarnessToolContext } from "../domain/tool.types.ts";
+import type { HarnessRuntime } from "./harness.types.ts";
+export declare function runSubagent(runtime: HarnessRuntime, tool: HarnessSubagent, input: unknown, context: HarnessToolContext): Promise<string>;

package/dist/application/harness-subagent.js

@@ -0,0 +1,110 @@
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { OutpostError, recordRecovery } from "../domain/errors.js";
+import { MAX_DELEGATION_DEPTH } from "../domain/subagent.constants.js";
+import { openTranscript } from "../infrastructure/conversations/harness-transcript.js";
+import { storageFor } from "./agent-storage.js";
+import { harnessBudget } from "./harness-budget.js";
+import { harnessHistory } from "./harness-history.js";
+import { harnessLoop } from "./harness-loop.js";
+import { harnessModelProvider } from "./harness-model-provider.js";
+export async function runSubagent(runtime, tool, input, context) {
+    const validated = await tool.validate(input);
+    if ("issues" in validated)
+        throw new OutpostError("configuration", validated.issues);
+    if (runtime.depth >= runtime.maxDepth)
+        throw new OutpostError("limit", "Harness reached its delegation depth limit", { limit: "maxDelegationDepth" });
+    runtime.budget.check();
+    const agent = tool.subagent;
+    const budget = harnessBudget(agent.harness.limits, runtime.budget);
+    const id = randomUUID();
+    const depth = runtime.depth + 1;
+    const store = storageFor(agent);
+    let transcript;
+    let failure;
+    let text = "";
+    const lifecycle = (status) => runtime.emit({
+        kind: "subagent",
+        id,
+        callId: context.callId,
+        name: tool.name,
+        status,
+        ...(transcript ? { conversation: transcript.id } : {}),
+    });
+    try {
+        transcript = store
+            ? await openTranscript({
+                repository: runtime.repository,
+                store,
+                model: agent.model.name,
+                ...(runtime.conversation
+                    ? { parentConversation: runtime.conversation }
+                    : {}),
+                parentCallId: context.callId,
+            })
+            : undefined;
+        lifecycle("started");
+        text = await harnessLoop({
+            ...runtime,
+            agent,
+            budget,
+            depth,
+            maxDepth: Math.min(runtime.maxDepth, depth +
+                (agent.harness.limits.maxDelegationDepth ?? MAX_DELEGATION_DEPTH)),
+            conversation: transcript?.id,
+            tools: agent.harness.tools,
+            permissions: [
+                ...runtime.permissions,
+                ...(agent.harness.permissions ? [agent.harness.permissions] : []),
+            ],
+            sandbox: context.sandbox,
+            signal: context.signal,
+            modelProvider: harnessModelProvider({
+                agent,
+                signal: context.signal,
+                budget,
+                ...runtime.modelScope,
+                account: (result) => runtime.modelScope.account(result, id),
+            }),
+            emit: (event) => {
+                context.signal.throwIfAborted();
+                runtime.emit({ ...event, subagentId: event.subagentId ?? id });
+            },
+        }, validated.value.prompt, harnessHistory(transcript));
+        context.signal.throwIfAborted();
+    }
+    catch (error) {
+        failure = error;
+    }
+    try {
+        if (transcript && store)
+            await store.capture(transcript.id, {
+                repository: runtime.repository,
+                sandbox: context.sandbox,
+                staging: join(runtime.repository, ".outpost", "conversations", "harness"),
+            });
+    }
+    catch (error) {
+        if (failure)
+            recordRecovery(failure, {
+                subagentCaptureError: error,
+                conversation: transcript?.id,
+            });
+        failure ??= error;
+    }
+    finally {
+        await transcript?.close();
+    }
+    if (failure) {
+        if (!runtime.signal.aborted)
+            lifecycle("failed");
+        throw failure;
+    }
+    context.signal.throwIfAborted();
+    lifecycle("finished");
+    return JSON.stringify({
+        text,
+        ...(transcript ? { conversation: transcript.id } : {}),
+    });
+}
+//# sourceMappingURL=harness-subagent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-subagent.js","sourceRoot":"","sources":["../../src/application/harness-subagent.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { OutpostError, recordRecovery } from \"../domain/errors.ts\";\nimport { MAX_DELEGATION_DEPTH } from \"../domain/subagent.constants.ts\";\nimport type { HarnessSubagent } from \"../domain/subagent.types.ts\";\nimport type { HarnessToolContext } from \"../domain/tool.types.ts\";\nimport { openTranscript } from \"../infrastructure/conversations/harness-transcript.ts\";\nimport type { TranscriptHandle } from \"../infrastructure/conversations/harness-transcript.types.ts\";\nimport { storageFor } from \"./agent-storage.ts\";\nimport { harnessBudget } from \"./harness-budget.ts\";\nimport { harnessHistory } from \"./harness-history.ts\";\nimport { harnessLoop } from \"./harness-loop.ts\";\nimport { harnessModelProvider } from \"./harness-model-provider.ts\";\nimport type { HarnessRuntime } from \"./harness.types.ts\";\n\nexport async function runSubagent(\n  runtime: HarnessRuntime,\n  tool: HarnessSubagent,\n  input: unknown,\n  context: HarnessToolContext,\n): Promise<string> {\n  const validated = await tool.validate(input);\n  if (\"issues\" in validated)\n    throw new OutpostError(\"configuration\", validated.issues);\n  if (runtime.depth >= runtime.maxDepth)\n    throw new OutpostError(\n      \"limit\",\n      \"Harness reached its delegation depth limit\",\n      { limit: \"maxDelegationDepth\" },\n    );\n  runtime.budget.check();\n  const agent = tool.subagent;\n  const budget = harnessBudget(agent.harness.limits, runtime.budget);\n  const id = randomUUID();\n  const depth = runtime.depth + 1;\n  const store = storageFor(agent);\n  let transcript: TranscriptHandle | undefined;\n  let failure: unknown;\n  let text = \"\";\n  const lifecycle = (status: \"started\" | \"finished\" | \"failed\") =>\n    runtime.emit({\n      kind: \"subagent\",\n      id,\n      callId: context.callId,\n      name: tool.name,\n      status,\n      ...(transcript ? { conversation: transcript.id } : {}),\n    });\n  try {\n    transcript = store\n      ? await openTranscript({\n          repository: runtime.repository,\n          store,\n          model: agent.model.name,\n          ...(runtime.conversation\n            ? { parentConversation: runtime.conversation }\n            : {}),\n          parentCallId: context.callId,\n        })\n      : undefined;\n    lifecycle(\"started\");\n    text = await harnessLoop(\n      {\n        ...runtime,\n        agent,\n        budget,\n        depth,\n        maxDepth: Math.min(\n          runtime.maxDepth,\n          depth +\n            (agent.harness.limits.maxDelegationDepth ?? MAX_DELEGATION_DEPTH),\n        ),\n        conversation: transcript?.id,\n        tools: agent.harness.tools,\n        permissions: [\n          ...runtime.permissions,\n          ...(agent.harness.permissions ? [agent.harness.permissions] : []),\n        ],\n        sandbox: context.sandbox,\n        signal: context.signal,\n        modelProvider: harnessModelProvider({\n          agent,\n          signal: context.signal,\n          budget,\n          ...runtime.modelScope,\n          account: (result) => runtime.modelScope.account(result, id),\n        }),\n        emit: (event) => {\n          context.signal.throwIfAborted();\n          runtime.emit({ ...event, subagentId: event.subagentId ?? id });\n        },\n      },\n      validated.value.prompt,\n      harnessHistory(transcript),\n    );\n    context.signal.throwIfAborted();\n  } catch (error) {\n    failure = error;\n  }\n  try {\n    if (transcript && store)\n      await store.capture(transcript.id, {\n        repository: runtime.repository,\n        sandbox: context.sandbox,\n        staging: join(\n          runtime.repository,\n          \".outpost\",\n          \"conversations\",\n          \"harness\",\n        ),\n      });\n  } catch (error) {\n    if (failure)\n      recordRecovery(failure, {\n        subagentCaptureError: error,\n        conversation: transcript?.id,\n      });\n    failure ??= error;\n  } finally {\n    await transcript?.close();\n  }\n  if (failure) {\n    if (!runtime.signal.aborted) lifecycle(\"failed\");\n    throw failure;\n  }\n  context.signal.throwIfAborted();\n  lifecycle(\"finished\");\n  return JSON.stringify({\n    text,\n    ...(transcript ? { conversation: transcript.id } : {}),\n  });\n}\n"]}

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

@@ -1,9 +1,20 @@
+import type { HarnessBudget } from "./harness-budget.types.ts";
+import type { HarnessPermissions } from "../domain/permissions.types.ts";
+import type { HarnessModelScope } from "./harness-model-provider.types.ts";
 import type { AgentEvent, CustomAgent } from "../domain/agent.types.ts";
 import type { ModelContentBlock, ModelMessage, ModelProvider, ModelResult, ModelToolCallBlock } from "../domain/model.types.ts";
 import type { SandboxLease } from "../domain/sandbox.types.ts";
 import type { HarnessTool } from "../domain/tool.types.ts";
 import type { DispatchOptions, TurnContext } from "./execution.types.ts";
 export interface HarnessRuntime {
+    readonly verbose?: boolean;
+    readonly repository: string;
+    readonly conversation?: string | undefined;
+    readonly budget: HarnessBudget;
+    readonly permissions: readonly HarnessPermissions[];
+    readonly depth: number;
+    readonly maxDepth: number;
+    readonly modelScope: Pick<HarnessModelScope, "track" | "account">;
     readonly agent: CustomAgent;
     readonly tools: readonly HarnessTool[];
     readonly modelProvider: ModelProvider;