@oxagen/cli 0.5.0 → 0.6.1

package/dist/agent/fleet/orchestrator.js

@@ -0,0 +1,358 @@
+/**
+ * The fleet orchestrator — an army of coding subagents working one tree at once.
+ *
+ * Each task is run by a subagent: the local coding loop ({@link runAgent}) on the
+ * cheapest sufficient model, against the same working directory. The orchestrator
+ * keeps as many running as the concurrency cap allows while respecting two safety
+ * rules so parallel agents never corrupt the tree or each other:
+ *
+ *   1. Dependencies — a task waits until every task it `dependsOn` is `done`; if a
+ *      dependency fails, the task (and its dependents) are marked `blocked`.
+ *   2. File ownership — two tasks whose predicted `files` overlap are serialized,
+ *      so two agents never edit the same file at the same time.
+ *
+ * It records a weighted memory for every task it finishes (success or failure),
+ * accumulates token/cost totals, and emits a snapshot on every change for the
+ * agents screen to render. `runAgent` is injected so the engine is unit-testable
+ * without touching the gateway.
+ */
+import { EventEmitter } from "node:events";
+import { runAgent } from "../loop.js";
+import { enhancePrompt } from "../prompt-enhancer.js";
+import { accumulateUsage, routeModel } from "../model-router.js";
+import { emptyUsage, } from "./types.js";
+const TERMINAL = new Set(["done", "failed", "cancelled", "blocked"]);
+export class Fleet extends EventEmitter {
+    cwd;
+    concurrency;
+    memory;
+    store;
+    projectContext;
+    agents;
+    runner;
+    readOnly;
+    isolation;
+    tasks = new Map();
+    snapshots = new Map();
+    controllers = new Map();
+    running = new Set();
+    planId = null;
+    settle = null;
+    donePromise = null;
+    adhocCounter = 0;
+    constructor(opts) {
+        super();
+        this.cwd = opts.cwd;
+        this.concurrency = Math.max(1, opts.concurrency ?? 4);
+        this.memory = opts.memory ?? null;
+        this.store = opts.store ?? null;
+        this.projectContext = opts.projectContext;
+        this.agents = opts.agents ?? new Map();
+        this.runner = opts.runner ?? runAgent;
+        this.readOnly = opts.readOnly ?? false;
+        this.isolation = opts.isolation ?? null;
+    }
+    /** Register every task in a plan (does not start it). */
+    loadPlan(plan) {
+        this.planId = plan.id;
+        for (const task of plan.tasks) {
+            this.tasks.set(task.id, task);
+            this.snapshots.set(task.id, this.toSnapshot(task, ""));
+        }
+        this.store?.setStatus(plan.id, "executing");
+        this.emitUpdate();
+    }
+    /** Add one ad-hoc task (e.g. typed into the agents screen). Returns its id. */
+    dispatchPrompt(prompt) {
+        const id = `adhoc-${++this.adhocCounter}`;
+        const decision = routeModel({ text: prompt });
+        const task = {
+            id,
+            title: prompt.length > 64 ? prompt.slice(0, 61) + "…" : prompt,
+            description: prompt,
+            status: "queued",
+            dependsOn: [],
+            files: [],
+            tier: decision.tier,
+            model: decision.model,
+            createdAt: Date.now(),
+            usage: emptyUsage(),
+        };
+        this.tasks.set(id, task);
+        this.snapshots.set(id, this.toSnapshot(task, ""));
+        this.emitUpdate();
+        this.pump();
+        return id;
+    }
+    /** Begin scheduling. Resolves when every task has reached a terminal state. */
+    start() {
+        if (!this.donePromise) {
+            this.donePromise = new Promise((resolve) => {
+                this.settle = resolve;
+            });
+        }
+        this.pump();
+        this.checkDone();
+        return this.donePromise;
+    }
+    /** Cancel one running/queued task. */
+    cancelTask(id) {
+        const task = this.tasks.get(id);
+        if (!task || TERMINAL.has(task.status))
+            return;
+        this.controllers.get(id)?.abort();
+        this.controllers.delete(id);
+        this.running.delete(id);
+        this.update(id, { status: "cancelled", finishedAt: Date.now() });
+        this.pump();
+        this.checkDone();
+    }
+    /** Cancel everything in flight. */
+    cancelAll() {
+        for (const id of [...this.tasks.keys()]) {
+            const t = this.tasks.get(id);
+            if (t && !TERMINAL.has(t.status))
+                this.cancelTask(id);
+        }
+    }
+    snapshot() {
+        const agents = [...this.snapshots.values()];
+        const totals = agents.reduce((acc, a) => ({
+            inputTokens: acc.inputTokens + a.usage.inputTokens,
+            outputTokens: acc.outputTokens + a.usage.outputTokens,
+            costUsd: acc.costUsd + a.usage.costUsd,
+        }), emptyUsage());
+        return {
+            agents,
+            queuedCount: agents.filter((a) => a.status === "queued").length,
+            runningCount: agents.filter((a) => a.status === "running").length,
+            doneCount: agents.filter((a) => a.status === "done").length,
+            failedCount: agents.filter((a) => a.status === "failed" || a.status === "blocked").length,
+            totals,
+            concurrency: this.concurrency,
+        };
+    }
+    // ── Scheduling ──────────────────────────────────────────────────────────────
+    /** Fill open slots with ready tasks, honouring deps and file-ownership locks. */
+    pump() {
+        // First, mark tasks whose dependencies can never succeed as blocked.
+        for (const task of this.tasks.values()) {
+            if (task.status !== "queued")
+                continue;
+            const deps = task.dependsOn.map((d) => this.tasks.get(d));
+            if (deps.some((d) => d && (d.status === "failed" || d.status === "blocked" || d.status === "cancelled"))) {
+                this.update(task.id, { status: "blocked" });
+            }
+        }
+        while (this.running.size < this.concurrency) {
+            const next = this.pickReady();
+            if (!next)
+                break;
+            void this.run(next);
+        }
+    }
+    /** The next queued task whose deps are all done and whose files are free. */
+    pickReady() {
+        const lockedFiles = new Set();
+        for (const id of this.running) {
+            for (const f of this.tasks.get(id)?.files ?? [])
+                lockedFiles.add(f);
+        }
+        for (const task of this.tasks.values()) {
+            if (task.status !== "queued")
+                continue;
+            const depsDone = task.dependsOn.every((d) => this.tasks.get(d)?.status === "done");
+            if (!depsDone)
+                continue;
+            // With isolation, overlapping files are safe (each agent has its own
+            // worktree; collisions become merge conflicts, surfaced at integration).
+            // Without it, serialize tasks that would fight over the same file.
+            if (!this.isolation && task.files.some((f) => lockedFiles.has(f)))
+                continue;
+            return task;
+        }
+        return undefined;
+    }
+    async run(task) {
+        this.running.add(task.id);
+        const controller = new AbortController();
+        this.controllers.set(task.id, controller);
+        this.update(task.id, { status: "running", startedAt: Date.now() });
+        let log = "";
+        let steps = 0;
+        const appendLog = (s) => {
+            log = (log + s).slice(-2000);
+        };
+        // With isolation on, the agent works in its own worktree, not the shared
+        // tree. Conflicts (if any) are surfaced after it finishes, not silently.
+        let workdir = this.cwd;
+        let conflict = null;
+        try {
+            if (this.isolation && !this.readOnly) {
+                workdir = await this.isolation.spawn(task.id);
+            }
+            // Enhance the task with code-graph context + lessons right before it runs.
+            const enhanced = await enhancePrompt({
+                prompt: task.description,
+                cwd: this.cwd,
+                memory: this.memory,
+            });
+            const result = await this.runner({
+                prompt: enhanced.prompt,
+                cwd: workdir,
+                model: task.model,
+                projectContext: this.projectContext,
+                agent: task.agent ? this.agents.get(task.agent) : undefined,
+                readOnly: this.readOnly,
+                signal: controller.signal,
+                onText: (delta) => {
+                    appendLog(delta);
+                    this.update(task.id, { logTail: log });
+                },
+                onToolCall: (name) => {
+                    steps++;
+                    this.update(task.id, { lastTool: name, steps });
+                },
+            });
+            const usage = accumulateUsage(emptyUsage(), task.model, result.usage);
+            let summary = result.text.trim().slice(0, 280);
+            // Commit the agent's work atomically (pinned, so it can never be lost),
+            // then merge it back. A conflict is surfaced — never a corrupt tree.
+            if (this.isolation && !this.readOnly && !controller.signal.aborted) {
+                await this.isolation.checkpoint(task.id, `fleet(${task.id}): ${task.title}`);
+                conflict = await this.isolation.integrate(task.id, `fleet(${task.id}): ${task.title}`);
+                if (!conflict.ok) {
+                    const files = (conflict.conflicts ?? []).join(", ");
+                    summary = `⚠ integration conflict in ${conflict.conflicts?.length ?? 0} file(s): ${files}`.slice(0, 280);
+                    this.emit("conflict", { taskId: task.id, ...conflict });
+                }
+            }
+            const aborted = "cancelled" === this.tasks.get(task.id)?.status;
+            this.update(task.id, {
+                status: aborted ? "cancelled" : "done",
+                finishedAt: Date.now(),
+                summary,
+                usage,
+                steps: result.steps,
+                logTail: log,
+                ...(conflict && !conflict.ok ? { error: summary } : {}),
+            });
+            this.recordSuccess(task, summary);
+        }
+        catch (err) {
+            // An aborted run surfaces as cancelled, not failed.
+            if (controller.signal.aborted) {
+                this.update(task.id, { status: "cancelled", finishedAt: Date.now() });
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                this.update(task.id, { status: "failed", finishedAt: Date.now(), error: message });
+                this.recordFailure(task, message);
+            }
+        }
+        finally {
+            // Tear down the worktree — but keep it on a conflict so a resolver agent
+            // or human can finish the merge in place. The pinned commits survive
+            // either way, so the agent's work is never lost.
+            if (this.isolation && !this.readOnly) {
+                await this.isolation.dispose(task.id, { keep: conflict ? !conflict.ok : false });
+            }
+            this.running.delete(task.id);
+            this.controllers.delete(task.id);
+            this.pump();
+            this.checkDone();
+        }
+    }
+    // ── Memory ──────────────────────────────────────────────────────────────────
+    recordSuccess(task, summary) {
+        const isFix = /\b(fix|bug|broken|regression|repair|error)\b/i.test(task.title + " " + task.description);
+        this.memory?.record({
+            kind: isFix ? "bug-root-cause" : "routine-change",
+            weight: task.tier === "precise" ? "high" : "low",
+            lesson: summary || task.title,
+            files: task.files,
+            taskId: task.id,
+            outcome: "success",
+        });
+    }
+    recordFailure(task, error) {
+        this.memory?.record({
+            kind: "gotcha",
+            weight: "high",
+            lesson: `Task "${task.title}" failed: ${error}`,
+            files: task.files,
+            taskId: task.id,
+            outcome: "failure",
+        });
+    }
+    // ── State plumbing ────────────────────────────────────────────────────────────
+    toSnapshot(task, logTail) {
+        return {
+            taskId: task.id,
+            title: task.title,
+            tier: task.tier,
+            model: task.model,
+            status: task.status,
+            steps: 0,
+            usage: task.usage,
+            startedAt: task.startedAt,
+            finishedAt: task.finishedAt,
+            logTail,
+            error: task.error,
+        };
+    }
+    update(id, patch) {
+        const task = this.tasks.get(id);
+        if (!task)
+            return;
+        // Apply task-level fields.
+        if (patch.status !== undefined)
+            task.status = patch.status;
+        if (patch.startedAt !== undefined)
+            task.startedAt = patch.startedAt;
+        if (patch.finishedAt !== undefined)
+            task.finishedAt = patch.finishedAt;
+        if (patch.summary !== undefined)
+            task.summary = patch.summary;
+        if (patch.error !== undefined)
+            task.error = patch.error;
+        if (patch.usage !== undefined)
+            task.usage = patch.usage;
+        this.store?.updateTask(this.planId ?? "", task);
+        const prev = this.snapshots.get(id);
+        const snap = {
+            ...(prev ?? this.toSnapshot(task, "")),
+            status: task.status,
+            startedAt: task.startedAt,
+            finishedAt: task.finishedAt,
+            usage: task.usage,
+            error: task.error,
+        };
+        if (patch.steps !== undefined)
+            snap.steps = patch.steps;
+        if (patch.lastTool !== undefined)
+            snap.lastTool = patch.lastTool;
+        if (patch.logTail !== undefined)
+            snap.logTail = patch.logTail;
+        this.snapshots.set(id, snap);
+        this.emitUpdate();
+    }
+    emitUpdate() {
+        this.emit("update", this.snapshot());
+    }
+    checkDone() {
+        if (!this.settle)
+            return;
+        const allTerminal = [...this.tasks.values()].every((t) => TERMINAL.has(t.status));
+        if (allTerminal && this.tasks.size > 0) {
+            if (this.planId && this.store) {
+                const anyFailed = [...this.tasks.values()].some((t) => t.status === "failed");
+                this.store.setStatus(this.planId, anyFailed ? "failed" : "completed");
+            }
+            const settle = this.settle;
+            this.settle = null;
+            settle();
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agent/fleet/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/agent/fleet/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMjE,OAAO,EACL,UAAU,GAKX,MAAM,YAAY,CAAC;AAyCpB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAErE,MAAM,OAAO,KAAM,SAAQ,YAAY;IACpB,GAAG,CAAS;IACZ,WAAW,CAAS;IACpB,MAAM,CAAqB;IAC3B,KAAK,CAAmB;IACxB,cAAc,CAA6B;IAC3C,MAAM,CAA+B;IACrC,MAAM,CAAc;IACpB,QAAQ,CAAU;IAClB,SAAS,CAAmB;IAE5B,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChC,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC7C,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,GAAkB,IAAI,CAAC;IAE7B,MAAM,GAAwB,IAAI,CAAC;IACnC,WAAW,GAAyB,IAAI,CAAC;IACzC,YAAY,GAAG,CAAC,CAAC;IAEzB,YAAY,IAAkB;QAC5B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,GAAG,EAA2B,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,yDAAyD;IACzD,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,+EAA+E;IAC/E,cAAc,CAAC,MAAc;QAC3B,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAS;YACjB,EAAE;YACF,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM;YAC9D,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,UAAU,EAAE;SACpB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+EAA+E;IAC/E,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC/C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,EAAU;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO;QAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,mCAAmC;IACnC,SAAS;QACP,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,QAAQ;QACN,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC1B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW;YAClD,YAAY,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY;YACrD,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO;SACvC,CAAC,EACF,UAAU,EAAE,CACb,CAAC;QACF,OAAO;YACL,MAAM;YACN,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC/D,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACjE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;YAC3D,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACzF,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;IAED,+EAA+E;IAE/E,iFAAiF;IACzE,IAAI;QACV,qEAAqE;QACrE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC;gBACzG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,6EAA6E;IACrE,SAAS;QACf,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE;gBAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;YACnF,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,qEAAqE;YACrE,yEAAyE;YACzE,mEAAmE;YACnE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,IAAU;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAEnE,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,SAAS,GAAG,CAAC,CAAS,EAAQ,EAAE;YACpC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,yEAAyE;QACzE,yEAAyE;QACzE,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,QAAQ,GAA6B,IAAI,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrC,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;gBACnC,MAAM,EAAE,IAAI,CAAC,WAAW;gBACxB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC;gBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,EAAE,OAAO;gBACZ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChB,SAAS,CAAC,KAAK,CAAC,CAAC;oBACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;gBACzC,CAAC;gBACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;oBACnB,KAAK,EAAE,CAAC;oBACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClD,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAE/C,wEAAwE;YACxE,qEAAqE;YACrE,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC7E,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpD,OAAO,GAAG,6BAA6B,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACzG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,WAAW,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;gBACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;gBACtC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,OAAO;gBACP,KAAK;gBACL,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,GAAG;gBACZ,GAAG,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oDAAoD;YACpD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxE,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACnF,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,yEAAyE;YACzE,qEAAqE;YACrE,iDAAiD;YACjD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,+EAA+E;IAEvE,aAAa,CAAC,IAAU,EAAE,OAAe;QAC/C,MAAM,KAAK,GAAG,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACxG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB;YACjD,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;YAChD,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,KAAK;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,IAAU,EAAE,KAAa;QAC7C,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,SAAS,IAAI,CAAC,KAAK,aAAa,KAAK,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IAEzE,UAAU,CAAC,IAAU,EAAE,OAAe;QAC5C,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,EAAU,EAAE,KAA6C;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,2BAA2B;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3D,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACpE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACvE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxD,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,GAAkB;YAC1B,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAClF,IAAI,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;gBAC9E,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/agent/fleet/store.d.ts

@@ -0,0 +1,13 @@
+import type { Plan, Task } from "./types.js";
+export interface PlanStore {
+    save(plan: Plan): void;
+    get(planId: string): Plan | undefined;
+    list(): Plan[];
+    /** Replace one task inside its plan and persist. */
+    updateTask(planId: string, task: Task): void;
+    /** Set a plan's lifecycle status and persist. */
+    setStatus(planId: string, status: Plan["status"]): void;
+}
+/** Open the plan store for a working directory. */
+export declare function openPlanStore(cwd: string): PlanStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/agent/fleet/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/agent/fleet/store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkC7C,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,IAAI,IAAI,IAAI,EAAE,CAAC;IACf,oDAAoD;IACpD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7C,iDAAiD;IACjD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAiCpD"}

package/dist/agent/fleet/store.js

@@ -0,0 +1,79 @@
+/**
+ * Plan persistence — durable storage for plans and their tasks.
+ *
+ * Plans live as JSON under `~/.config/oxagen/fleet/<project>.json` (one file per
+ * project, keyed by the working-directory name, consistent with the other CLI
+ * state). Persisting plans lets a dispatched fleet survive a crashed TUI and lets
+ * `oxagen agents` show what's in flight from a previous run.
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+function projectKey(cwd) {
+    return basename(cwd) || "default";
+}
+function storePath(cwd) {
+    return join(homedir(), ".config", "oxagen", "fleet", `${projectKey(cwd)}.json`);
+}
+function read(cwd) {
+    const path = storePath(cwd);
+    if (!existsSync(path))
+        return { plans: [] };
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return { plans: [] };
+    }
+}
+function write(cwd, data) {
+    const path = storePath(cwd);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(data, null, 2), "utf8");
+    }
+    catch {
+        /* persistence is best-effort; the fleet still runs from memory */
+    }
+}
+/** Open the plan store for a working directory. */
+export function openPlanStore(cwd) {
+    return {
+        save(plan) {
+            const data = read(cwd);
+            const idx = data.plans.findIndex((p) => p.id === plan.id);
+            if (idx >= 0)
+                data.plans[idx] = plan;
+            else
+                data.plans.unshift(plan);
+            // Keep the file bounded — the 50 most recent plans is plenty of history.
+            data.plans = data.plans.slice(0, 50);
+            write(cwd, data);
+        },
+        get(planId) {
+            return read(cwd).plans.find((p) => p.id === planId);
+        },
+        list() {
+            return read(cwd).plans;
+        },
+        updateTask(planId, task) {
+            const data = read(cwd);
+            const plan = data.plans.find((p) => p.id === planId);
+            if (!plan)
+                return;
+            const idx = plan.tasks.findIndex((t) => t.id === task.id);
+            if (idx >= 0)
+                plan.tasks[idx] = task;
+            write(cwd, data);
+        },
+        setStatus(planId, status) {
+            const data = read(cwd);
+            const plan = data.plans.find((p) => p.id === planId);
+            if (!plan)
+                return;
+            plan.status = status;
+            write(cwd, data);
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/agent/fleet/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/agent/fleet/store.ts"],"names":[],"mappings":"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"}

package/dist/agent/fleet/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Shared domain types for the agent fleet — task planning, the subagent army,
+ * and the agents screen.
+ *
+ * A *plan* decomposes a goal into *tasks*. A task is assigned to a subagent,
+ * which runs the local coding loop ({@link runAgent}) against the working tree.
+ * The fleet orchestrates many of these at once under a concurrency cap, records
+ * what each one built/fixed as memory, and feeds the agents screen its live
+ * roster.
+ *
+ * These types are deliberately framework-free (no Ink, no AI SDK) so the engine
+ * and its tests never import a renderer or hit the gateway.
+ */
+/** Cost/capability tier. Maps to a concrete gateway model via the model router. */
+export type ModelTier = "fast" | "balanced" | "precise";
+/** Lifecycle of a single planned task. */
+export type TaskStatus = "queued" | "blocked" | "running" | "done" | "failed" | "cancelled";
+/** Token + cost accounting for one task or the whole fleet. */
+export interface UsageTotals {
+    inputTokens: number;
+    outputTokens: number;
+    /** Estimated provider cost in USD, from the vendored rate card. */
+    costUsd: number;
+}
+export declare function emptyUsage(): UsageTotals;
+/** A unit of work the fleet can assign to one subagent. */
+export interface Task {
+    id: string;
+    title: string;
+    /** The full instruction handed to the subagent (already prompt-enhanced). */
+    description: string;
+    status: TaskStatus;
+    /** Task ids that must reach `done` before this one may start. */
+    dependsOn: string[];
+    /**
+     * Files this task is expected to touch (relative paths). Used to serialize
+     * tasks with overlapping file ownership so two agents never fight over a file.
+     */
+    files: string[];
+    /** Tier the planner/router chose for this task. */
+    tier: ModelTier;
+    /** Concrete gateway model slug resolved from the tier. */
+    model: string;
+    /** Named agent definition the planner assigned this task to (if any). */
+    agent?: string;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    /** Short summary the agent produced on completion. */
+    summary?: string;
+    /** Clean error message when `status === "failed"`. */
+    error?: string;
+    usage: UsageTotals;
+}
+/** A decomposed goal: an ordered set of tasks the fleet can execute. */
+export interface Plan {
+    id: string;
+    goal: string;
+    createdAt: number;
+    tasks: Task[];
+    status: "draft" | "executing" | "completed" | "failed";
+}
+/** A weighted lesson recorded as the fleet builds/fixes code. */
+export interface MemoryRecord {
+    id: string;
+    createdAt: number;
+    /** What kind of lesson this is — mirrors the platform `agent.memory.write` kinds. */
+    kind: "routine-change" | "constraint" | "bug-root-cause" | "convention-deviation" | "gotcha";
+    /** How much it should influence future work. */
+    weight: "low" | "high" | "critical";
+    /** The lesson itself, in one or two sentences. */
+    lesson: string;
+    /** Files the lesson is about (used for lexical recall scoring). */
+    files: string[];
+    /** Task that produced it, if any. */
+    taskId?: string;
+    outcome: "success" | "failure";
+}
+/** Live, render-friendly snapshot of one working subagent. */
+export interface AgentSnapshot {
+    taskId: string;
+    title: string;
+    tier: ModelTier;
+    model: string;
+    status: TaskStatus;
+    /** Tool-loop steps taken so far. */
+    steps: number;
+    /** Last tool the agent invoked, for the activity column. */
+    lastTool?: string;
+    usage: UsageTotals;
+    startedAt?: number;
+    finishedAt?: number;
+    /** Tail of the agent's streamed reasoning/output, for the detail view. */
+    logTail: string;
+    error?: string;
+}
+/** Whole-fleet snapshot the agents screen renders each tick. */
+export interface FleetSnapshot {
+    agents: AgentSnapshot[];
+    queuedCount: number;
+    runningCount: number;
+    doneCount: number;
+    failedCount: number;
+    totals: UsageTotals;
+    concurrency: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/fleet/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/fleet/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/fleet/types.js

@@ -0,0 +1,17 @@
+/**
+ * Shared domain types for the agent fleet — task planning, the subagent army,
+ * and the agents screen.
+ *
+ * A *plan* decomposes a goal into *tasks*. A task is assigned to a subagent,
+ * which runs the local coding loop ({@link runAgent}) against the working tree.
+ * The fleet orchestrates many of these at once under a concurrency cap, records
+ * what each one built/fixed as memory, and feeds the agents screen its live
+ * roster.
+ *
+ * These types are deliberately framework-free (no Ink, no AI SDK) so the engine
+ * and its tests never import a renderer or hit the gateway.
+ */
+export function emptyUsage() {
+    return { inputTokens: 0, outputTokens: 0, costUsd: 0 };
+}
+//# sourceMappingURL=types.js.map

package/dist/agent/fleet/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/fleet/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AACzD,CAAC"}