@elie-laloum/outpost 4.2.0 → 5.0.0

package/dist/application/harness-context.js

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

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

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

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

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

package/dist/application/harness-history.js

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

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

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

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

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

package/dist/application/harness-hooks.js

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

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

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

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

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

package/dist/application/harness-loop.js

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

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

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

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

@@ -0,0 +1,55 @@
+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 agent: CustomAgent;
+    readonly tools: readonly HarnessTool[];
+    readonly modelProvider: ModelProvider;
+    readonly sandbox: SandboxLease;
+    readonly signal: AbortSignal;
+    emit(event: AgentEvent): void;
+    hold(): () => void;
+}
+export interface ToolCallBatch {
+    readonly concurrent: boolean;
+    readonly calls: readonly PreparedCall[];
+}
+export type ValidatedInput = {
+    readonly value: unknown;
+} | {
+    readonly outcome: ToolOutcome;
+};
+export interface ToolOutcome {
+    readonly content: string;
+    readonly isError: boolean;
+}
+export interface HarnessHistory {
+    readonly messages: readonly ModelMessage[];
+    append(message: ModelMessage): Promise<void>;
+    replace(messages: readonly ModelMessage[]): Promise<void>;
+}
+export interface CustomTurnContext extends TurnContext {
+    readonly continuation?: DispatchOptions["continuation"];
+}
+export interface LoopState {
+    readonly history: HarnessHistory;
+    readonly step: number;
+    toolCalls: number;
+}
+export type StopHandler = (runtime: HarnessRuntime, state: LoopState, result: ModelResult, content: readonly ModelContentBlock[]) => Promise<string | undefined>;
+export interface PreparedCall {
+    readonly call: ModelToolCallBlock;
+    readonly tool?: HarnessTool;
+    readonly input?: unknown;
+    readonly outcome?: ToolOutcome;
+}
+export interface ToolDenial {
+    readonly deny: string;
+}
+export type BlockRenderers = {
+    readonly [Type in ModelContentBlock["type"]]: (block: Extract<ModelContentBlock, {
+        type: Type;
+    }>) => string;
+};

package/dist/application/harness.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/application/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentEvent, CustomAgent } from \"../domain/agent.types.ts\";\nimport type {\n  ModelContentBlock,\n  ModelMessage,\n  ModelProvider,\n  ModelResult,\n  ModelToolCallBlock,\n} from \"../domain/model.types.ts\";\nimport type { SandboxLease } from \"../domain/sandbox.types.ts\";\nimport type { HarnessTool } from \"../domain/tool.types.ts\";\nimport type { DispatchOptions, TurnContext } from \"./execution.types.ts\";\n\nexport interface HarnessRuntime {\n  readonly agent: CustomAgent;\n  readonly tools: readonly HarnessTool[];\n  readonly modelProvider: ModelProvider;\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  emit(event: AgentEvent): void;\n  hold(): () => void;\n}\n\nexport interface ToolCallBatch {\n  readonly concurrent: boolean;\n  readonly calls: readonly PreparedCall[];\n}\n\nexport type ValidatedInput =\n  { readonly value: unknown } | { readonly outcome: ToolOutcome };\n\nexport interface ToolOutcome {\n  readonly content: string;\n  readonly isError: boolean;\n}\n\nexport interface HarnessHistory {\n  readonly messages: readonly ModelMessage[];\n  append(message: ModelMessage): Promise<void>;\n  replace(messages: readonly ModelMessage[]): Promise<void>;\n}\n\nexport interface CustomTurnContext extends TurnContext {\n  readonly continuation?: DispatchOptions[\"continuation\"];\n}\n\nexport interface LoopState {\n  readonly history: HarnessHistory;\n  readonly step: number;\n  toolCalls: number;\n}\n\nexport type StopHandler = (\n  runtime: HarnessRuntime,\n  state: LoopState,\n  result: ModelResult,\n  content: readonly ModelContentBlock[],\n) => Promise<string | undefined>;\n\nexport interface PreparedCall {\n  readonly call: ModelToolCallBlock;\n  readonly tool?: HarnessTool;\n  readonly input?: unknown;\n  readonly outcome?: ToolOutcome;\n}\n\nexport interface ToolDenial {\n  readonly deny: string;\n}\n\nexport type BlockRenderers = {\n  readonly [Type in ModelContentBlock[\"type\"]]: (\n    block: Extract<ModelContentBlock, { type: Type }>,\n  ) => string;\n};\n"]}

package/dist/application/lifecycle.constants.d.ts

@@ -1,2 +1,2 @@
 export declare const hookDeadlineMs = 600000;
-export declare const warmConfigurationKeys: readonly ["repository", "branch", "provider", "workspace", "copies", "hooks", "limits", "bootstrap", "conversationHome", "includeUncommitted"];
+export declare const warmConfigurationKeys: readonly ["repository", "branch", "sandboxProvider", "workspace", "copies", "hooks", "limits", "bootstrap", "conversationHome", "includeUncommitted"];

package/dist/application/lifecycle.constants.js

@@ -2,7 +2,7 @@ export const hookDeadlineMs = 600_000;
 export const warmConfigurationKeys = [
     "repository",
     "branch",
-    "provider",
+    "sandboxProvider",
     "workspace",
     "copies",
     "hooks",

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

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.constants.js","sourceRoot":"","sources":["../../src/application/lifecycle.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,WAAW;IACX,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,oBAAoB;CACZ,CAAC","sourcesContent":["export const hookDeadlineMs = 600_000;\nexport const warmConfigurationKeys = [\n  \"repository\",\n  \"branch\",\n  \"provider\",\n  \"workspace\",\n  \"copies\",\n  \"hooks\",\n  \"limits\",\n  \"bootstrap\",\n  \"conversationHome\",\n  \"includeUncommitted\",\n] as const;\n"]}
+{"version":3,"file":"lifecycle.constants.js","sourceRoot":"","sources":["../../src/application/lifecycle.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY;IACZ,QAAQ;IACR,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,oBAAoB;CACZ,CAAC","sourcesContent":["export const hookDeadlineMs = 600_000;\nexport const warmConfigurationKeys = [\n  \"repository\",\n  \"branch\",\n  \"sandboxProvider\",\n  \"workspace\",\n  \"copies\",\n  \"hooks\",\n  \"limits\",\n  \"bootstrap\",\n  \"conversationHome\",\n  \"includeUncommitted\",\n] as const;\n"]}

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

@@ -1,5 +1,5 @@
 import type { Transport, TransportReference } from "../domain/transport.types.ts";
-import type { AgentAdapter } from "../domain/agent.types.ts";
+import type { Agent } from "../domain/agent.types.ts";
 import type { Command, CommandResult } from "../domain/command.types.ts";
 import type { Brief } from "../domain/prompts.types.ts";
 import type { SandboxProvider } from "../domain/sandbox.types.ts";
@@ -21,11 +21,11 @@ export interface WorkspaceOptions {
 }
 export interface Workspace extends WorkspaceRecord {
     dispatch<T = undefined>(options: Omit<SandboxOptions, Exclude<keyof WorkspaceOptions, "hooks" | "label"> | "workspace"> & DispatchOptions<T> & {
-        readonly agent: AgentAdapter;
+        readonly agent: Agent;
     }): Promise<DispatchResult<T>>;
     sandbox(options?: Omit<SandboxOptions, Exclude<keyof WorkspaceOptions, "hooks" | "label"> | "workspace">): Promise<Sandbox>;
     attach(options: Omit<SandboxOptions, Exclude<keyof WorkspaceOptions, "hooks" | "label"> | "workspace"> & AttachOptions & {
-        readonly agent: AgentAdapter;
+        readonly agent: Agent;
     }): Promise<AttachResult>;
     close(options?: {
         readonly preserve?: boolean;
@@ -35,8 +35,8 @@ export interface Workspace extends WorkspaceRecord {
 }
 export interface SandboxOptions extends WorkspaceOptions {
     readonly includeUncommitted?: boolean;
-    readonly agent?: AgentAdapter;
-    readonly provider?: SandboxProvider;
+    readonly agent?: Agent;
+    readonly sandboxProvider?: SandboxProvider;
     readonly workspace?: Workspace;
     readonly hooks?: LifecycleHooks;
     readonly signal?: AbortSignal;
@@ -48,7 +48,7 @@ export interface SandboxOptions extends WorkspaceOptions {
 }
 export interface AttachOptions {
     readonly ask?: VariableQuestion;
-    readonly agent?: AgentAdapter;
+    readonly agent?: Agent;
     readonly brief?: Brief;
     readonly continuation?: {
         readonly id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"outpost.types.js","sourceRoot":"","sources":["../../src/application/outpost.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { AgentAdapter } from \"../domain/agent.types.ts\";\nimport type { Command, CommandResult } from \"../domain/command.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type {\n  BranchPolicy,\n  Commit,\n  Disposal,\n  LifecycleHooks,\n  StageLimits,\n  WorkspaceRecord,\n} from \"../domain/workspace.types.ts\";\nimport type { StorageReservationOptions } from \"../infrastructure/storage-reservations.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { DispatchOptions, Execution } from \"./execution.types.ts\";\nimport type { VariableQuestion } from \"./interactive-brief.types.ts\";\n\nexport interface WorkspaceOptions {\n  readonly storageQuota?: Omit<StorageReservationOptions, \"signal\">;\n  readonly signal?: AbortSignal;\n  readonly repository?: string;\n  readonly branch?: BranchPolicy;\n  readonly copies?: readonly string[];\n  readonly limits?: StageLimits;\n  readonly label?: string;\n  readonly hooks?: LifecycleHooks;\n}\n\nexport interface Workspace extends WorkspaceRecord {\n  dispatch<T = undefined>(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      DispatchOptions<T> & { readonly agent: AgentAdapter },\n  ): Promise<DispatchResult<T>>;\n  sandbox(\n    options?: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    >,\n  ): Promise<Sandbox>;\n  attach(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      AttachOptions & { readonly agent: AgentAdapter },\n  ): Promise<AttachResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  integrate(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SandboxOptions extends WorkspaceOptions {\n  readonly includeUncommitted?: boolean;\n  readonly agent?: AgentAdapter;\n  readonly provider?: SandboxProvider;\n  readonly workspace?: Workspace;\n  readonly hooks?: LifecycleHooks;\n  readonly signal?: AbortSignal;\n  readonly logging?: Logging;\n  readonly bootstrap?: boolean;\n  readonly conversationHome?: string;\n  readonly recoveryTransport?: Transport;\n  readonly activityTransport?: Transport;\n}\n\nexport interface AttachOptions {\n  readonly ask?: VariableQuestion;\n  readonly agent?: AgentAdapter;\n  readonly brief?: Brief;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly signal?: AbortSignal;\n  readonly terminal?: Command[\"terminal\"];\n}\n\nexport interface AttachResult extends CommandResult, Disposal {\n  readonly commits: readonly Commit[];\n  readonly branch: string;\n  readonly directory: string;\n}\n\nexport interface DispatchResult<T> extends Execution<T> {\n  readonly branch: string;\n  readonly directory: string;\n  readonly commits: readonly Commit[];\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly logReference?: TransportReference;\n  readonly log?: string;\n  readonly retainedDirectory?: string;\n  resume<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n  fork<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n}\n\nexport type ContinuationOptions<T = undefined> = DispatchOptions<T> &\n  Omit<SandboxOptions, \"agent\">;\n\nexport interface WarmDispatchResult<T> extends Omit<\n  DispatchResult<T>,\n  \"resume\" | \"fork\"\n> {\n  resume<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n  fork<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n}\n\nexport interface Sandbox {\n  diagnose(\n    options?: SandboxDiagnosticOptions,\n  ): Promise<SandboxDiagnosticReport>;\n  readonly workspace: Workspace;\n  readonly root: string;\n  dispatch<T = undefined>(\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  resume<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  fork<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  attach(options?: AttachOptions): Promise<AttachResult>;\n  command(command: Command): Promise<CommandResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n"]}
+{"version":3,"file":"outpost.types.js","sourceRoot":"","sources":["../../src/application/outpost.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { Agent } from \"../domain/agent.types.ts\";\nimport type { Command, CommandResult } from \"../domain/command.types.ts\";\nimport type { Brief } from \"../domain/prompts.types.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type {\n  BranchPolicy,\n  Commit,\n  Disposal,\n  LifecycleHooks,\n  StageLimits,\n  WorkspaceRecord,\n} from \"../domain/workspace.types.ts\";\nimport type { StorageReservationOptions } from \"../infrastructure/storage-reservations.types.ts\";\nimport type { Logging } from \"../infrastructure/journal.types.ts\";\nimport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n} from \"./doctor-sandbox.types.ts\";\nimport type { DispatchOptions, Execution } from \"./execution.types.ts\";\nimport type { VariableQuestion } from \"./interactive-brief.types.ts\";\n\nexport interface WorkspaceOptions {\n  readonly storageQuota?: Omit<StorageReservationOptions, \"signal\">;\n  readonly signal?: AbortSignal;\n  readonly repository?: string;\n  readonly branch?: BranchPolicy;\n  readonly copies?: readonly string[];\n  readonly limits?: StageLimits;\n  readonly label?: string;\n  readonly hooks?: LifecycleHooks;\n}\n\nexport interface Workspace extends WorkspaceRecord {\n  dispatch<T = undefined>(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      DispatchOptions<T> & { readonly agent: Agent },\n  ): Promise<DispatchResult<T>>;\n  sandbox(\n    options?: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    >,\n  ): Promise<Sandbox>;\n  attach(\n    options: Omit<\n      SandboxOptions,\n      Exclude<keyof WorkspaceOptions, \"hooks\" | \"label\"> | \"workspace\"\n    > &\n      AttachOptions & { readonly agent: Agent },\n  ): Promise<AttachResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  integrate(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface SandboxOptions extends WorkspaceOptions {\n  readonly includeUncommitted?: boolean;\n  readonly agent?: Agent;\n  readonly sandboxProvider?: SandboxProvider;\n  readonly workspace?: Workspace;\n  readonly hooks?: LifecycleHooks;\n  readonly signal?: AbortSignal;\n  readonly logging?: Logging;\n  readonly bootstrap?: boolean;\n  readonly conversationHome?: string;\n  readonly recoveryTransport?: Transport;\n  readonly activityTransport?: Transport;\n}\n\nexport interface AttachOptions {\n  readonly ask?: VariableQuestion;\n  readonly agent?: Agent;\n  readonly brief?: Brief;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n  readonly signal?: AbortSignal;\n  readonly terminal?: Command[\"terminal\"];\n}\n\nexport interface AttachResult extends CommandResult, Disposal {\n  readonly commits: readonly Commit[];\n  readonly branch: string;\n  readonly directory: string;\n}\n\nexport interface DispatchResult<T> extends Execution<T> {\n  readonly branch: string;\n  readonly directory: string;\n  readonly commits: readonly Commit[];\n  readonly transcript?: string;\n  readonly transcriptReference?: TransportReference;\n  readonly logReference?: TransportReference;\n  readonly log?: string;\n  readonly retainedDirectory?: string;\n  resume<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n  fork<U = undefined>(\n    options: ContinuationOptions<U>,\n  ): Promise<DispatchResult<U>>;\n}\n\nexport type ContinuationOptions<T = undefined> = DispatchOptions<T> &\n  Omit<SandboxOptions, \"agent\">;\n\nexport interface WarmDispatchResult<T> extends Omit<\n  DispatchResult<T>,\n  \"resume\" | \"fork\"\n> {\n  resume<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n  fork<U = undefined>(\n    options: DispatchOptions<U>,\n  ): Promise<WarmDispatchResult<U>>;\n}\n\nexport interface Sandbox {\n  diagnose(\n    options?: SandboxDiagnosticOptions,\n  ): Promise<SandboxDiagnosticReport>;\n  readonly workspace: Workspace;\n  readonly root: string;\n  dispatch<T = undefined>(\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  resume<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  fork<T = undefined>(\n    id: string,\n    options: DispatchOptions<T>,\n  ): Promise<WarmDispatchResult<T>>;\n  attach(options?: AttachOptions): Promise<AttachResult>;\n  command(command: Command): Promise<CommandResult>;\n  close(options?: { readonly preserve?: boolean }): Promise<Disposal>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n"]}

package/dist/application/remote-download.js

@@ -13,7 +13,7 @@ export async function downloadChanges(context, synchronized, transfer) {
         .split("\0")
         .filter(Boolean);
     for (const file of incoming) {
-        if (/^\.outpost\/(locks|recovery|workspaces|logs)(\/|$)/i.test(file))
+        if (/^\.outpost\/(locks|recovery|workspaces|logs|conversations)(\/|$)/i.test(file))
             throw new OutpostError("workspace", "Remote file overlaps Outpost runtime state", { file });
         await safeDestination(join(transfer, "incoming"), file);
     }

package/dist/application/remote-download.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-download.js","sourceRoot":"","sources":["../../src/application/remote-download.ts"],"names":[],"mappings":"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","sourcesContent":["import { cp, mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join, posix } from \"node:path\";\nimport { downloadHistory } from \"./remote-history.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport {\n  fileManifest,\n  parseManifest,\n  sameFile,\n  sameLocalFile,\n} from \"../infrastructure/file-manifest.ts\";\nimport type { FileManifestEntry } from \"../domain/sandbox.types.ts\";\nimport { safeDestination } from \"../infrastructure/files.ts\";\nimport type {\n  RemoteChanges,\n  RemoteWorkspaceContext,\n} from \"./remote-workspace.types.ts\";\n\nexport async function downloadChanges(\n  context: RemoteWorkspaceContext,\n  synchronized: string,\n  transfer: string,\n): Promise<RemoteChanges> {\n  const { workspace, lease, remoteBundle, run } = context;\n  const head = (await run([\"rev-parse\", \"HEAD\"])).trim(),\n    patch = join(transfer, \"remote.patch\");\n  await run([\"diff\", \"--binary\", \"HEAD\", `--output=${remoteBundle}.patch`]);\n  await lease.download(`${remoteBundle}.patch`, patch);\n  const incoming = (\n    await run([\"ls-files\", \"--others\", \"--exclude-standard\", \"-z\"])\n  )\n    .split(\"\\0\")\n    .filter(Boolean);\n  for (const file of incoming) {\n    if (/^\\.outpost\\/(locks|recovery|workspaces|logs)(\\/|$)/i.test(file))\n      throw new OutpostError(\n        \"workspace\",\n        \"Remote file overlaps Outpost runtime state\",\n        { file },\n      );\n    await safeDestination(join(transfer, \"incoming\"), file);\n  }\n  let manifest: readonly FileManifestEntry[] | undefined;\n  if (lease.fileTransfers) {\n    manifest = parseManifest(\n      await lease.fileTransfers.manifest(lease.root, incoming),\n      incoming,\n    );\n    await writeFile(join(transfer, \"manifest.json\"), JSON.stringify(manifest), {\n      mode: 0o600,\n    });\n    const changed: FileManifestEntry[] = [];\n    for (const entry of manifest) {\n      const previous = context.transferred?.get(entry.path);\n      if (\n        previous &&\n        sameFile(previous, entry) &&\n        sameLocalFile(\n          entry,\n          await fileManifest(workspace.directory, entry.path),\n        )\n      ) {\n        const target = await safeDestination(\n          join(transfer, \"incoming\"),\n          entry.path,\n        );\n        await mkdir(dirname(target), { recursive: true });\n        await cp(\n          await safeDestination(workspace.directory, entry.path),\n          target,\n          { dereference: false, verbatimSymlinks: true },\n        );\n        continue;\n      }\n      changed.push(entry);\n    }\n    await lease.fileTransfers.downloadBatch(\n      lease.root,\n      changed,\n      join(transfer, \"incoming\"),\n    );\n    for (const entry of manifest) {\n      if (\n        !sameLocalFile(\n          entry,\n          await fileManifest(join(transfer, \"incoming\"), entry.path),\n        )\n      )\n        throw new OutpostError(\"workspace\", \"Incoming file checksum mismatch\", {\n          file: entry.path,\n        });\n    }\n  } else\n    for (const file of incoming) {\n      await lease.download(\n        posix.join(lease.root, file),\n        await safeDestination(join(transfer, \"incoming\"), file),\n      );\n    }\n  if (head !== synchronized) {\n    await downloadHistory(context, synchronized, head, transfer);\n  }\n\n  return { head, patch, incoming, ...(manifest ? { manifest } : {}) };\n}\n"]}
+{"version":3,"file":"remote-download.js","sourceRoot":"","sources":["../../src/application/remote-download.ts"],"names":[],"mappings":"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","sourcesContent":["import { cp, mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join, posix } from \"node:path\";\nimport { downloadHistory } from \"./remote-history.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport {\n  fileManifest,\n  parseManifest,\n  sameFile,\n  sameLocalFile,\n} from \"../infrastructure/file-manifest.ts\";\nimport type { FileManifestEntry } from \"../domain/sandbox.types.ts\";\nimport { safeDestination } from \"../infrastructure/files.ts\";\nimport type {\n  RemoteChanges,\n  RemoteWorkspaceContext,\n} from \"./remote-workspace.types.ts\";\n\nexport async function downloadChanges(\n  context: RemoteWorkspaceContext,\n  synchronized: string,\n  transfer: string,\n): Promise<RemoteChanges> {\n  const { workspace, lease, remoteBundle, run } = context;\n  const head = (await run([\"rev-parse\", \"HEAD\"])).trim(),\n    patch = join(transfer, \"remote.patch\");\n  await run([\"diff\", \"--binary\", \"HEAD\", `--output=${remoteBundle}.patch`]);\n  await lease.download(`${remoteBundle}.patch`, patch);\n  const incoming = (\n    await run([\"ls-files\", \"--others\", \"--exclude-standard\", \"-z\"])\n  )\n    .split(\"\\0\")\n    .filter(Boolean);\n  for (const file of incoming) {\n    if (\n      /^\\.outpost\\/(locks|recovery|workspaces|logs|conversations)(\\/|$)/i.test(\n        file,\n      )\n    )\n      throw new OutpostError(\n        \"workspace\",\n        \"Remote file overlaps Outpost runtime state\",\n        { file },\n      );\n    await safeDestination(join(transfer, \"incoming\"), file);\n  }\n  let manifest: readonly FileManifestEntry[] | undefined;\n  if (lease.fileTransfers) {\n    manifest = parseManifest(\n      await lease.fileTransfers.manifest(lease.root, incoming),\n      incoming,\n    );\n    await writeFile(join(transfer, \"manifest.json\"), JSON.stringify(manifest), {\n      mode: 0o600,\n    });\n    const changed: FileManifestEntry[] = [];\n    for (const entry of manifest) {\n      const previous = context.transferred?.get(entry.path);\n      if (\n        previous &&\n        sameFile(previous, entry) &&\n        sameLocalFile(\n          entry,\n          await fileManifest(workspace.directory, entry.path),\n        )\n      ) {\n        const target = await safeDestination(\n          join(transfer, \"incoming\"),\n          entry.path,\n        );\n        await mkdir(dirname(target), { recursive: true });\n        await cp(\n          await safeDestination(workspace.directory, entry.path),\n          target,\n          { dereference: false, verbatimSymlinks: true },\n        );\n        continue;\n      }\n      changed.push(entry);\n    }\n    await lease.fileTransfers.downloadBatch(\n      lease.root,\n      changed,\n      join(transfer, \"incoming\"),\n    );\n    for (const entry of manifest) {\n      if (\n        !sameLocalFile(\n          entry,\n          await fileManifest(join(transfer, \"incoming\"), entry.path),\n        )\n      )\n        throw new OutpostError(\"workspace\", \"Incoming file checksum mismatch\", {\n          file: entry.path,\n        });\n    }\n  } else\n    for (const file of incoming) {\n      await lease.download(\n        posix.join(lease.root, file),\n        await safeDestination(join(transfer, \"incoming\"), file),\n      );\n    }\n  if (head !== synchronized) {\n    await downloadHistory(context, synchronized, head, transfer);\n  }\n\n  return { head, patch, incoming, ...(manifest ? { manifest } : {}) };\n}\n"]}