@elie-laloum/outpost 1.1.0

package/dist/application/campaign.js

@@ -0,0 +1,195 @@
+import { randomUUID } from "node:crypto";
+import { readPlan } from "../domain/backlog.js";
+import { invariant, OutpostError, positive } from "../domain/errors.js";
+import { response } from "../domain/response.js";
+import { task, workflow } from "../domain/workflow.js";
+import { git } from "../infrastructure/git.js";
+import { notify } from "./execution.js";
+import { createSandbox, dispatch } from "./outpost.js";
+export async function campaign(options) {
+    options.signal?.throwIfAborted();
+    const limit = positive(options.cycles ?? 10, "cycles");
+    const concurrency = positive(options.concurrency ?? 3, "concurrency");
+    positive(options.implementationPasses ?? 100, "implementationPasses");
+    positive(options.reviewPasses ?? 1, "reviewPasses");
+    const { backlog, planner, reviewer, merger, cycles: _cycles, concurrency: _concurrency, implementationPasses, reviewPasses, standards = "Follow the repository conventions. Keep changes focused, test behavior and commit the result.", observe, ...runtime } = options;
+    const repository = runtime.repository ?? process.cwd();
+    const outcomes = [];
+    const emit = (phase, cycle, issue) => notify(observe, { phase, cycle, ...(issue ? { issue } : {}) });
+    for (let cycle = 1; cycle <= limit; cycle++) {
+        runtime.signal?.throwIfAborted();
+        emit("backlog", cycle);
+        const available = await backlog.list(runtime.signal);
+        invariant(new Set(available.map((issue) => issue.id)).size === available.length, "Backlog contains duplicate issue ids");
+        if (!available.length)
+            return { cycles: cycle - 1, reason: "empty", issues: outcomes };
+        const pending = new Set(available.map((issue) => issue.id));
+        const ready = available.filter((issue) => !issue.blockedBy?.some((id) => pending.has(id)));
+        if (!ready.length)
+            return { cycles: cycle - 1, reason: "blocked", issues: outcomes };
+        const prefix = `outpost/batch-${randomUUID().slice(0, 8)}`;
+        let assignments;
+        if (planner !== false) {
+            emit("plan", cycle);
+            const plan = await dispatch({
+                ...runtime,
+                agent: planner ?? runtime.agent,
+                branch: { mode: "named", name: `${prefix}-planning` },
+                brief: {
+                    text: `Select independent, unblocked issues from this backlog. Read the repository without editing files. Return <assignments>{"issues":[{"id":"an existing id","branch":"${prefix}-short-name"}]}</assignments>. Return an empty array when blocked.\n${JSON.stringify(ready)}`,
+                },
+                response: response.json({
+                    tag: "assignments",
+                    schema: readPlan,
+                    repairs: 1,
+                }),
+            });
+            invariant(!plan.commits.length && !plan.retainedDirectory, "Planner changed its workspace; inspect the planning branch before continuing");
+            assignments = plan.value;
+        }
+        else
+            assignments = ready.slice(0, concurrency).map((issue, index) => ({
+                id: issue.id,
+                branch: `${prefix}-${index + 1}`,
+            }));
+        if (!assignments.length)
+            return { cycles: cycle - 1, reason: "blocked", issues: outcomes };
+        const baseline = (await git(repository, ["rev-parse", "HEAD"])).trim();
+        for (const assignment of assignments) {
+            invariant(ready.some((issue) => issue.id === assignment.id), `Plan selected an unavailable or blocked issue: ${assignment.id}`);
+            await git(repository, [
+                "check-ref-format",
+                "--branch",
+                assignment.branch,
+            ]);
+            const exists = await git(repository, [
+                "show-ref",
+                "--verify",
+                `refs/heads/${assignment.branch}`,
+            ]).then(() => true, () => false);
+            invariant(!exists, `Issue branch already exists: ${assignment.branch}`);
+        }
+        const jobs = assignments.map((assignment, index) => task({
+            key: `issue-${index + 1}`,
+            async perform({ signal }) {
+                const issue = await backlog.get(assignment.id, signal);
+                invariant(issue.id === assignment.id, "Tracker returned a different issue");
+                const sandbox = await createSandbox({
+                    ...runtime,
+                    signal,
+                    branch: { mode: "named", name: assignment.branch, from: baseline },
+                });
+                let success = false;
+                try {
+                    emit("implement", cycle, issue.id);
+                    const implemented = await sandbox.dispatch({
+                        agent: runtime.agent,
+                        signal,
+                        passes: implementationPasses ?? 100,
+                        brief: {
+                            text: `Implement issue ${issue.id}: ${issue.title}\n${issue.body ?? ""}\n${standards}\nDo not close the issue. When complete, write <outpost>done</outpost>.`,
+                        },
+                    });
+                    if (!implemented.commits.length) {
+                        success = true;
+                        return undefined;
+                    }
+                    if (reviewer !== false) {
+                        emit("review", cycle, issue.id);
+                        await sandbox.dispatch({
+                            agent: reviewer ?? runtime.agent,
+                            signal,
+                            passes: reviewPasses ?? 1,
+                            brief: {
+                                text: `Review issue ${issue.id} on ${assignment.branch}. Inspect git diff ${baseline}...HEAD, fix concrete defects, run the relevant tests and commit corrections.\n${standards}\nDo not close the issue. When complete, write <outpost>done</outpost>.`,
+                            },
+                        });
+                    }
+                    const clean = await sandbox.command({
+                        executable: "git",
+                        arguments: ["status", "--porcelain"],
+                        signal,
+                    });
+                    invariant(clean.status === 0 && !clean.stdout.trim(), `Issue ${issue.id} has uncommitted changes`);
+                    const head = (await git(sandbox.workspace.directory, ["rev-parse", "HEAD"])).trim();
+                    success = true;
+                    return { ...assignment, head };
+                }
+                finally {
+                    await sandbox.close({ preserve: !success });
+                }
+            },
+        }));
+        const execution = await workflow(`batch-${cycle}`, jobs).start({
+            concurrency,
+            stopOnError: false,
+            ...(runtime.signal ? { signal: runtime.signal } : {}),
+        });
+        runtime.signal?.throwIfAborted();
+        const completed = [];
+        jobs.forEach((job, index) => {
+            const record = execution.tasks[index];
+            if (record.status !== "done")
+                outcomes.push({
+                    ...assignments[index],
+                    state: "failed",
+                    error: record.error,
+                });
+            else {
+                const item = execution.value(job);
+                if (item)
+                    completed.push(item);
+                else
+                    outcomes.push({ ...assignments[index], state: "empty" });
+            }
+        });
+        if (!completed.length)
+            return { cycles: cycle, reason: "no-progress", issues: outcomes };
+        emit("merge", cycle);
+        const integration = await createSandbox({
+            ...runtime,
+            agent: merger ?? runtime.agent,
+            branch: { mode: "integrate" },
+        });
+        let integrated = false;
+        try {
+            for (const item of completed) {
+                const merged = await integration.command({
+                    executable: "git",
+                    arguments: ["merge", "--no-edit", item.head],
+                    ...(runtime.signal ? { signal: runtime.signal } : {}),
+                });
+                await integration.dispatch({
+                    agent: merger ?? runtime.agent,
+                    ...(runtime.signal ? { signal: runtime.signal } : {}),
+                    brief: {
+                        text: `Validate integration of issue ${item.id} from commit ${item.head}. ${merged.status ? "Resolve the current Git merge conflict and finish the merge." : "The commits have been merged."} Run relevant tests, fix integration defects and commit any changes. ${standards} Do not close issues. When complete, write <outpost>done</outpost>.`,
+                    },
+                });
+                const verified = await integration.command({
+                    executable: "git",
+                    arguments: ["merge-base", "--is-ancestor", item.head, "HEAD"],
+                });
+                if (verified.status)
+                    throw new OutpostError("conflict", "Merge did not include the issue commits", { issue: item.id, branch: item.branch });
+            }
+            const clean = await integration.command({
+                executable: "git",
+                arguments: ["status", "--porcelain"],
+            });
+            invariant(clean.status === 0 && !clean.stdout.trim(), "Integration has uncommitted changes");
+            await integration.workspace.integrate();
+            integrated = true;
+        }
+        finally {
+            await integration.close({ preserve: !integrated });
+        }
+        for (const item of completed) {
+            emit("close", cycle, item.id);
+            await backlog.close(item.id, runtime.signal);
+            outcomes.push({ id: item.id, branch: item.branch, state: "merged" });
+        }
+    }
+    return { cycles: limit, reason: "limit", issues: outcomes };
+}
+//# sourceMappingURL=campaign.js.map

package/dist/application/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/application/campaign.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { AgentAdapter } from \"../domain/ports.ts\";\nimport type { Assignment, Backlog, Issue } from \"../domain/backlog.ts\";\nimport { readPlan } from \"../domain/backlog.ts\";\nimport { invariant, OutpostError, positive } from \"../domain/errors.ts\";\nimport { response } from \"../domain/response.ts\";\nimport { task, workflow } from \"../domain/workflow.ts\";\nimport { git } from \"../infrastructure/git.ts\";\nimport { notify } from \"./execution.ts\";\nimport { createSandbox, dispatch, type SandboxOptions } from \"./outpost.ts\";\n\nexport interface CampaignEvent {\n  readonly phase:\n    \"backlog\" | \"plan\" | \"implement\" | \"review\" | \"merge\" | \"close\";\n  readonly cycle: number;\n  readonly issue?: string;\n}\n\nexport interface CampaignOptions extends Omit<\n  SandboxOptions,\n  \"workspace\" | \"branch\" | \"agent\"\n> {\n  readonly agent: AgentAdapter;\n  readonly backlog: Backlog;\n  readonly planner?: AgentAdapter | false;\n  readonly reviewer?: AgentAdapter | false;\n  readonly merger?: AgentAdapter;\n  readonly cycles?: number;\n  readonly concurrency?: number;\n  readonly implementationPasses?: number;\n  readonly reviewPasses?: number;\n  readonly standards?: string;\n  readonly observe?: (event: CampaignEvent) => void;\n}\n\nexport interface IssueOutcome {\n  readonly id: string;\n  readonly branch: string;\n  readonly state: \"empty\" | \"failed\" | \"merged\";\n  readonly error?: unknown;\n}\n\nexport interface CampaignResult {\n  readonly cycles: number;\n  readonly reason: \"empty\" | \"blocked\" | \"no-progress\" | \"limit\";\n  readonly issues: readonly IssueOutcome[];\n}\n\nexport async function campaign(\n  options: CampaignOptions,\n): Promise<CampaignResult> {\n  options.signal?.throwIfAborted();\n  const limit = positive(options.cycles ?? 10, \"cycles\");\n  const concurrency = positive(options.concurrency ?? 3, \"concurrency\");\n  positive(options.implementationPasses ?? 100, \"implementationPasses\");\n  positive(options.reviewPasses ?? 1, \"reviewPasses\");\n  const {\n    backlog,\n    planner,\n    reviewer,\n    merger,\n    cycles: _cycles,\n    concurrency: _concurrency,\n    implementationPasses,\n    reviewPasses,\n    standards = \"Follow the repository conventions. Keep changes focused, test behavior and commit the result.\",\n    observe,\n    ...runtime\n  } = options;\n  const repository = runtime.repository ?? process.cwd();\n  const outcomes: IssueOutcome[] = [];\n  const emit = (phase: CampaignEvent[\"phase\"], cycle: number, issue?: string) =>\n    notify(observe, { phase, cycle, ...(issue ? { issue } : {}) });\n  for (let cycle = 1; cycle <= limit; cycle++) {\n    runtime.signal?.throwIfAborted();\n    emit(\"backlog\", cycle);\n    const available = await backlog.list(runtime.signal);\n    invariant(\n      new Set(available.map((issue) => issue.id)).size === available.length,\n      \"Backlog contains duplicate issue ids\",\n    );\n    if (!available.length)\n      return { cycles: cycle - 1, reason: \"empty\", issues: outcomes };\n    const pending = new Set(available.map((issue) => issue.id));\n    const ready = available.filter(\n      (issue) => !issue.blockedBy?.some((id) => pending.has(id)),\n    );\n    if (!ready.length)\n      return { cycles: cycle - 1, reason: \"blocked\", issues: outcomes };\n    const prefix = `outpost/batch-${randomUUID().slice(0, 8)}`;\n    let assignments: readonly Assignment[];\n    if (planner !== false) {\n      emit(\"plan\", cycle);\n      const plan = await dispatch({\n        ...runtime,\n        agent: planner ?? runtime.agent,\n        branch: { mode: \"named\", name: `${prefix}-planning` },\n        brief: {\n          text: `Select independent, unblocked issues from this backlog. Read the repository without editing files. Return <assignments>{\"issues\":[{\"id\":\"an existing id\",\"branch\":\"${prefix}-short-name\"}]}</assignments>. Return an empty array when blocked.\\n${JSON.stringify(ready)}`,\n        },\n        response: response.json({\n          tag: \"assignments\",\n          schema: readPlan,\n          repairs: 1,\n        }),\n      });\n      invariant(\n        !plan.commits.length && !plan.retainedDirectory,\n        \"Planner changed its workspace; inspect the planning branch before continuing\",\n      );\n      assignments = plan.value;\n    } else\n      assignments = ready.slice(0, concurrency).map((issue, index) => ({\n        id: issue.id,\n        branch: `${prefix}-${index + 1}`,\n      }));\n    if (!assignments.length)\n      return { cycles: cycle - 1, reason: \"blocked\", issues: outcomes };\n    const baseline = (await git(repository, [\"rev-parse\", \"HEAD\"])).trim();\n    for (const assignment of assignments) {\n      invariant(\n        ready.some((issue) => issue.id === assignment.id),\n        `Plan selected an unavailable or blocked issue: ${assignment.id}`,\n      );\n      await git(repository, [\n        \"check-ref-format\",\n        \"--branch\",\n        assignment.branch,\n      ]);\n      const exists = await git(repository, [\n        \"show-ref\",\n        \"--verify\",\n        `refs/heads/${assignment.branch}`,\n      ]).then(\n        () => true,\n        () => false,\n      );\n      invariant(!exists, `Issue branch already exists: ${assignment.branch}`);\n    }\n    const jobs = assignments.map((assignment, index) =>\n      task({\n        key: `issue-${index + 1}`,\n        async perform({ signal }) {\n          const issue: Issue = await backlog.get(assignment.id, signal);\n          invariant(\n            issue.id === assignment.id,\n            \"Tracker returned a different issue\",\n          );\n          const sandbox = await createSandbox({\n            ...runtime,\n            signal,\n            branch: { mode: \"named\", name: assignment.branch, from: baseline },\n          });\n          let success = false;\n          try {\n            emit(\"implement\", cycle, issue.id);\n            const implemented = await sandbox.dispatch({\n              agent: runtime.agent,\n              signal,\n              passes: implementationPasses ?? 100,\n              brief: {\n                text: `Implement issue ${issue.id}: ${issue.title}\\n${issue.body ?? \"\"}\\n${standards}\\nDo not close the issue. When complete, write <outpost>done</outpost>.`,\n              },\n            });\n            if (!implemented.commits.length) {\n              success = true;\n              return undefined;\n            }\n            if (reviewer !== false) {\n              emit(\"review\", cycle, issue.id);\n              await sandbox.dispatch({\n                agent: reviewer ?? runtime.agent,\n                signal,\n                passes: reviewPasses ?? 1,\n                brief: {\n                  text: `Review issue ${issue.id} on ${assignment.branch}. Inspect git diff ${baseline}...HEAD, fix concrete defects, run the relevant tests and commit corrections.\\n${standards}\\nDo not close the issue. When complete, write <outpost>done</outpost>.`,\n                },\n              });\n            }\n            const clean = await sandbox.command({\n              executable: \"git\",\n              arguments: [\"status\", \"--porcelain\"],\n              signal,\n            });\n            invariant(\n              clean.status === 0 && !clean.stdout.trim(),\n              `Issue ${issue.id} has uncommitted changes`,\n            );\n            const head = (\n              await git(sandbox.workspace.directory, [\"rev-parse\", \"HEAD\"])\n            ).trim();\n            success = true;\n            return { ...assignment, head };\n          } finally {\n            await sandbox.close({ preserve: !success });\n          }\n        },\n      }),\n    );\n    const execution = await workflow(`batch-${cycle}`, jobs).start({\n      concurrency,\n      stopOnError: false,\n      ...(runtime.signal ? { signal: runtime.signal } : {}),\n    });\n    runtime.signal?.throwIfAborted();\n    const completed: (Assignment & { head: string })[] = [];\n    jobs.forEach((job, index) => {\n      const record = execution.tasks[index]!;\n      if (record.status !== \"done\")\n        outcomes.push({\n          ...assignments[index]!,\n          state: \"failed\",\n          error: record.error,\n        });\n      else {\n        const item = execution.value(job);\n        if (item) completed.push(item);\n        else outcomes.push({ ...assignments[index]!, state: \"empty\" });\n      }\n    });\n    if (!completed.length)\n      return { cycles: cycle, reason: \"no-progress\", issues: outcomes };\n    emit(\"merge\", cycle);\n    const integration = await createSandbox({\n      ...runtime,\n      agent: merger ?? runtime.agent,\n      branch: { mode: \"integrate\" },\n    });\n    let integrated = false;\n    try {\n      for (const item of completed) {\n        const merged = await integration.command({\n          executable: \"git\",\n          arguments: [\"merge\", \"--no-edit\", item.head],\n          ...(runtime.signal ? { signal: runtime.signal } : {}),\n        });\n        await integration.dispatch({\n          agent: merger ?? runtime.agent,\n          ...(runtime.signal ? { signal: runtime.signal } : {}),\n          brief: {\n            text: `Validate integration of issue ${item.id} from commit ${item.head}. ${merged.status ? \"Resolve the current Git merge conflict and finish the merge.\" : \"The commits have been merged.\"} Run relevant tests, fix integration defects and commit any changes. ${standards} Do not close issues. When complete, write <outpost>done</outpost>.`,\n          },\n        });\n        const verified = await integration.command({\n          executable: \"git\",\n          arguments: [\"merge-base\", \"--is-ancestor\", item.head, \"HEAD\"],\n        });\n        if (verified.status)\n          throw new OutpostError(\n            \"conflict\",\n            \"Merge did not include the issue commits\",\n            { issue: item.id, branch: item.branch },\n          );\n      }\n      const clean = await integration.command({\n        executable: \"git\",\n        arguments: [\"status\", \"--porcelain\"],\n      });\n      invariant(\n        clean.status === 0 && !clean.stdout.trim(),\n        \"Integration has uncommitted changes\",\n      );\n      await integration.workspace.integrate();\n      integrated = true;\n    } finally {\n      await integration.close({ preserve: !integrated });\n    }\n    for (const item of completed) {\n      emit(\"close\", cycle, item.id);\n      await backlog.close(item.id, runtime.signal);\n      outcomes.push({ id: item.id, branch: item.branch, state: \"merged\" });\n    }\n  }\n  return { cycles: limit, reason: \"limit\", issues: outcomes };\n}\n"]}

package/dist/application/execution.d.ts

@@ -0,0 +1,48 @@
+import type { AgentAdapter, AgentObservation, SandboxLease, Usage, WorkspaceRecord } from "../domain/ports.ts";
+import { type Brief } from "../domain/prompts.ts";
+import { type ResponseSpec } from "../domain/response.ts";
+import type { Logging } from "../infrastructure/journal.ts";
+export interface DispatchOptions<T = undefined> {
+    readonly agent?: AgentAdapter;
+    readonly logging?: Logging;
+    readonly label?: string;
+    readonly brief: Brief;
+    readonly passes?: number;
+    readonly until?: string | readonly string[];
+    readonly idleMs?: number;
+    readonly idleWarningMs?: number;
+    readonly settleMs?: number;
+    readonly deadlineMs?: number;
+    readonly expansionMs?: number;
+    readonly signal?: AbortSignal;
+    readonly continuation?: {
+        readonly id: string;
+        readonly fork?: boolean;
+    };
+    readonly response?: ResponseSpec<T>;
+    readonly observe?: (event: AgentObservation) => void;
+    readonly warn?: (message: string) => void;
+    readonly diagnostic?: (message: string) => void;
+}
+export interface Turn {
+    readonly text: string;
+    readonly status: number;
+    readonly conversation?: string;
+    readonly transcript?: string;
+    readonly usage: Usage;
+    readonly durationMs: number;
+}
+export interface Execution<T> {
+    readonly text: string;
+    readonly turns: readonly Turn[];
+    readonly usage: Usage;
+    readonly conversation?: string;
+    readonly value: T;
+    readonly completed: boolean;
+    readonly completion?: string;
+}
+export declare function notify<T>(observer: ((value: T) => void) | undefined, value: T): void;
+export declare function renderBrief(brief: Brief, workspace: WorkspaceRecord, lease: SandboxLease, host: boolean, options: Pick<DispatchOptions, "signal" | "expansionMs" | "warn" | "diagnostic">): Promise<string>;
+export declare function validateDispatch(options: DispatchOptions<unknown>): void;
+export declare function preflightDispatch(options: DispatchOptions<unknown>, _repository: string, agent?: AgentAdapter): Promise<void>;
+export declare function execute<T>(workspace: WorkspaceRecord, lease: SandboxLease, agent: AgentAdapter, host: boolean, options: DispatchOptions<T>, afterTurn?: (turn: Turn) => Promise<Turn>): Promise<Execution<T>>;

package/dist/application/execution.js

@@ -0,0 +1,322 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { OutpostError, invariant, positive } from "../domain/errors.js";
+import { prepareBrief, validateBrief } from "../domain/prompts.js";
+import { ResponseError } from "../domain/response.js";
+import { shell } from "../infrastructure/process.js";
+export function notify(observer, value) {
+    try {
+        observer?.(value);
+    }
+    catch {
+        /* Observers cannot change execution outcomes. */
+    }
+}
+export async function renderBrief(brief, workspace, lease, host, options) {
+    if (brief.text !== undefined)
+        return brief.text;
+    const source = await readFile(resolve(brief.file), "utf8");
+    const prepared = prepareBrief(source, brief.values, {
+        WORK_BRANCH: workspace.branch,
+        BASE_BRANCH: workspace.baseBranch,
+    });
+    if (prepared.unused.length)
+        notify(options.warn, `Unused prompt variables: ${prepared.unused.join(", ")}`);
+    const controller = new AbortController();
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, controller.signal])
+        : controller.signal;
+    const pending = prepared.fragments.map(async (fragment) => {
+        if (fragment.kind === "literal")
+            return fragment.value;
+        try {
+            const command = host
+                ? shell(fragment.value)
+                : { executable: "sh", arguments: ["-c", fragment.value] };
+            const result = await lease.invoke({
+                ...command,
+                signal,
+                deadlineMs: options.expansionMs ?? 30_000,
+            });
+            if (result.status !== 0)
+                throw new OutpostError("prompt", "Prompt command failed", {
+                    command: fragment.value,
+                    ...result,
+                });
+            notify(options.diagnostic, `Prompt command expanded to approximately ${Math.ceil(result.stdout.length / 4)} tokens`);
+            return result.stdout.trimEnd();
+        }
+        catch (cause) {
+            controller.abort(cause);
+            throw cause;
+        }
+    });
+    const results = await Promise.allSettled(pending);
+    const failure = results.find((result) => result.status === "rejected");
+    if (failure?.status === "rejected")
+        throw failure.reason;
+    return results
+        .map((result) => result.value)
+        .join("");
+}
+export function validateDispatch(options) {
+    options.signal?.throwIfAborted();
+    validateBrief(options.brief);
+    positive(options.passes ?? 1, "passes");
+    invariant(Number.isSafeInteger(options.passes ?? 1), "passes must be an integer");
+    for (const key of [
+        "idleMs",
+        "idleWarningMs",
+        "settleMs",
+        "deadlineMs",
+        "expansionMs",
+    ])
+        if (options[key] !== undefined)
+            positive(options[key], key);
+    if (options.response || options.continuation)
+        invariant((options.passes ?? 1) === 1, "Structured responses and continuations require one pass");
+    const markers = options.until === undefined
+        ? []
+        : typeof options.until === "string"
+            ? [options.until]
+            : options.until;
+    invariant(markers.every((marker) => marker.length > 0), "Completion markers cannot be empty");
+}
+export async function preflightDispatch(options, _repository, agent) {
+    validateDispatch(options);
+    if (!options.response)
+        return;
+    if (options.response.repairs > 0)
+        invariant(agent?.resumable ?? !!(agent?.conversations || agent?.storage), "Response repair requires an adapter that supports continuation");
+    const brief = options.brief;
+    const text = brief.text ?? (await readFile(resolve(brief.file), "utf8"));
+    const resolved = text.replace(/\{\{\s*(\w+)\s*\}\}/g, (token, key) => brief.values?.[key] === undefined ? token : String(brief.values[key]));
+    invariant(resolved.includes(`<${options.response.tag}>`), `Brief must request an opening <${options.response.tag}> tag`);
+}
+async function turn(lease, agent, prompt, options, continuation, markers, pass) {
+    const start = Date.now();
+    const controller = new AbortController();
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, controller.signal])
+        : controller.signal;
+    let idle, settle;
+    let pending = "", text = "", conversation, failure;
+    let finalText, rawTail = "", lastActivity = Date.now();
+    let usage = { input: 0, cached: 0, output: 0 };
+    let completed = false;
+    const refresh = () => {
+        lastActivity = Date.now();
+        clearTimeout(idle);
+        clearTimeout(settle);
+        if (!completed)
+            idle = setTimeout(() => controller.abort(new OutpostError("timeout", "Agent produced no output before the idle deadline")), options.idleMs ?? 600_000);
+        if (completed)
+            settle = setTimeout(() => controller.abort("completion"), options.settleMs ?? 60_000);
+    };
+    const consume = (line) => {
+        const at = new Date().toISOString();
+        notify(options.observe, { kind: "raw", value: line, pass, at });
+        for (const event of agent.events(line)) {
+            if (event.kind === "text")
+                text += event.text;
+            if (event.kind === "result")
+                finalText = event.text;
+            if (event.kind === "conversation")
+                conversation = event.id;
+            if (event.kind === "failure")
+                failure = event.message;
+            if (event.kind === "usage")
+                usage = {
+                    input: usage.input + event.tokens.input,
+                    cached: usage.cached + event.tokens.cached,
+                    output: usage.output + event.tokens.output,
+                    ...(usage.cacheCreated !== undefined ||
+                        event.tokens.cacheCreated !== undefined
+                        ? {
+                            cacheCreated: (usage.cacheCreated ?? 0) + (event.tokens.cacheCreated ?? 0),
+                        }
+                        : {}),
+                };
+            if (event.kind !== "raw")
+                notify(options.observe, { ...event, pass, at });
+        }
+        completed = markers.some((marker) => (finalText ?? text).includes(marker));
+    };
+    const warningInterval = options.idleWarningMs ?? 60_000;
+    const warnings = setInterval(() => {
+        if (Date.now() - lastActivity >= warningInterval) {
+            const message = `Agent has been idle for ${Math.floor((Date.now() - lastActivity) / 1000)} seconds`;
+            notify(options.warn, message);
+            notify(options.observe, {
+                kind: "warning",
+                message,
+                pass,
+                at: new Date().toISOString(),
+            });
+        }
+    }, warningInterval);
+    refresh();
+    let status = 0;
+    try {
+        const command = agent.request({
+            text: prompt,
+            ...(continuation ? { continuation } : {}),
+        });
+        const result = await lease.invoke({
+            ...command,
+            signal,
+            deadlineMs: options.deadlineMs ?? 3_600_000,
+            observe(channel, chunk) {
+                if (channel === "stdout") {
+                    rawTail = (rawTail + chunk).slice(-65_536);
+                    pending += chunk;
+                    let end;
+                    while ((end = pending.indexOf("\n")) >= 0) {
+                        consume(pending.slice(0, end));
+                        pending = pending.slice(end + 1);
+                    }
+                    if (pending.length > 16_777_216)
+                        controller.abort(new OutpostError("process", "Agent emitted an oversized event"));
+                }
+                refresh();
+            },
+        });
+        status = result.status;
+        if (pending)
+            consume(pending);
+        if (status !== 0)
+            throw new OutpostError("process", `Agent exited with status ${status}`, {
+                ...result,
+                conversation,
+            });
+    }
+    catch (cause) {
+        options.signal?.throwIfAborted();
+        if (controller.signal.reason !== "completion")
+            throw controller.signal.reason instanceof OutpostError
+                ? controller.signal.reason
+                : cause;
+        notify(options.warn, "Agent remained active after completion; its command was stopped and trailing output retained");
+    }
+    finally {
+        clearTimeout(idle);
+        clearTimeout(settle);
+        clearInterval(warnings);
+    }
+    if (failure)
+        throw new OutpostError("process", failure, { conversation });
+    return {
+        text: finalText ?? (text || rawTail),
+        status,
+        usage,
+        durationMs: Date.now() - start,
+        ...(conversation ? { conversation } : {}),
+    };
+}
+export async function execute(workspace, lease, agent, host, options, afterTurn) {
+    validateDispatch(options);
+    const markers = options.until === undefined
+        ? ["<outpost>done</outpost>"]
+        : typeof options.until === "string"
+            ? [options.until]
+            : options.until;
+    const turns = [];
+    let value = undefined, completed = false, continuation = options.continuation;
+    let repair;
+    const attempts = options.response
+        ? 1 + options.response.repairs
+        : (options.passes ?? 1);
+    for (let index = 0; index < attempts; index++) {
+        notify(options.observe, {
+            kind: "phase",
+            name: "preparing prompt",
+            agent: agent.name,
+            branch: workspace.branch,
+            directory: workspace.directory,
+            pass: index + 1,
+            at: new Date().toISOString(),
+        });
+        const prompt = repair ??
+            (await renderBrief(options.brief, workspace, lease, host, options));
+        if (options.response && !repair)
+            invariant(prompt.includes(`<${options.response.tag}>`), `Brief must request an opening <${options.response.tag}> tag`);
+        notify(options.observe, {
+            kind: "prompt",
+            text: prompt,
+            pass: index + 1,
+            at: new Date().toISOString(),
+        });
+        notify(options.observe, {
+            kind: "phase",
+            name: "running",
+            agent: agent.name,
+            branch: workspace.branch,
+            pass: index + 1,
+            at: new Date().toISOString(),
+        });
+        const finished = await turn(lease, agent, prompt, options, continuation, markers, index + 1);
+        const current = afterTurn ? await afterTurn(finished) : finished;
+        turns.push(current);
+        notify(options.observe, {
+            kind: "summary",
+            durationMs: current.durationMs,
+            status: current.status,
+            tokens: current.usage,
+            pass: index + 1,
+            at: new Date().toISOString(),
+        });
+        completed = markers.some((marker) => current.text.includes(marker));
+        if (options.response) {
+            try {
+                value = await options.response.read(current.text);
+                completed = true;
+                break;
+            }
+            catch (error) {
+                if (!(error instanceof ResponseError))
+                    throw error;
+                error.recovery = {
+                    conversation: current.conversation,
+                    branch: workspace.branch,
+                    directory: workspace.directory,
+                    turns,
+                };
+                if (index + 1 >= attempts || !current.conversation)
+                    throw error;
+                continuation = { id: current.conversation };
+                repair = [
+                    `Correct the response inside <${options.response.tag}> and </${options.response.tag}>.`,
+                    `Validation failure: ${error.message}`,
+                    `Previous content: ${error.raw ?? "No complete tagged response was returned."}`,
+                    `Cause: ${error.cause instanceof Error ? error.cause.message : (JSON.stringify(error.cause) ?? "unspecified")}`,
+                    `Further repair attempts after this one: ${attempts - index - 2}.`,
+                    "Do not edit files, run commands or continue implementation. Only return the corrected response.",
+                ].join("\n");
+            }
+        }
+        else if (completed)
+            break;
+    }
+    const conversation = turns.at(-1)?.conversation;
+    const completion = markers.find((marker) => turns.at(-1)?.text.includes(marker));
+    return {
+        text: turns.map((item) => item.text).join("\n"),
+        turns,
+        value,
+        completed,
+        ...(completion ? { completion } : {}),
+        ...(conversation ? { conversation } : {}),
+        usage: turns.reduce((sum, item) => ({
+            input: sum.input + item.usage.input,
+            cached: sum.cached + item.usage.cached,
+            output: sum.output + item.usage.output,
+            ...(sum.cacheCreated !== undefined ||
+                item.usage.cacheCreated !== undefined
+                ? {
+                    cacheCreated: (sum.cacheCreated ?? 0) + (item.usage.cacheCreated ?? 0),
+                }
+                : {}),
+        }), { input: 0, cached: 0, output: 0 }),
+    };
+}
+//# sourceMappingURL=execution.js.map