@wrongstack/core 0.32.0 → 0.41.0

package/dist/index.js

@@ -1295,11 +1295,62 @@ function deepMerge(a, b) {
   return out;
 }
 
+// src/utils/term.ts
+var hasStdout = () => typeof process !== "undefined" && !!process.stdout;
+var hasStdin = () => typeof process !== "undefined" && !!process.stdin;
+function isStdoutTTY() {
+  return hasStdout() && Boolean(process.stdout.isTTY);
+}
+function isStdinTTY() {
+  return hasStdin() && Boolean(process.stdin.isTTY);
+}
+function isInteractive() {
+  return isStdinTTY() && isStdoutTTY();
+}
+function getTermSize() {
+  if (!hasStdout()) return { rows: 24, cols: 80 };
+  return {
+    rows: process.stdout.rows ?? 24,
+    cols: process.stdout.columns ?? 80
+  };
+}
+function onResize(cb, stream = process.stdout) {
+  if (!stream || typeof stream.on !== "function") return () => {
+  };
+  const handler = () => {
+    cb({
+      rows: stream.rows ?? 24,
+      cols: stream.columns ?? 80
+    });
+  };
+  stream.on("resize", handler);
+  return () => {
+    stream.off("resize", handler);
+  };
+}
+function setRawMode(input, mode) {
+  if (!input || input.isTTY !== true) return false;
+  if (typeof input.setRawMode !== "function") return false;
+  input.setRawMode(mode);
+  return true;
+}
+function writeTo(s, stream) {
+  if (!stream || typeof stream.write !== "function") return false;
+  stream.write(s);
+  return true;
+}
+function writeOut(s, stream = process.stdout) {
+  return writeTo(s, stream);
+}
+function writeErr(s, stream = process.stderr) {
+  return writeTo(s, stream);
+}
+
 // src/utils/color.ts
 var isColorTty = () => {
   if (process.env.NO_COLOR) return false;
   if (process.env.FORCE_COLOR) return true;
-  return Boolean(process.stdout?.isTTY);
+  return isStdoutTTY();
 };
 var COLOR = isColorTty();
 var wrap = (open5, close) => (s) => COLOR ? `\x1B[${open5}m${s}\x1B[${close}m` : s;
@@ -1403,10 +1454,10 @@ var DefaultLogger = class _DefaultLogger {
     if (r <= LEVEL_RANK.warn || this.level === "debug" || this.level === "trace") {
       const head = `${color.dim(ts)} ${COLORS[level](level.toUpperCase().padEnd(5))} ${msg}`;
       if (ctx !== void 0) {
-        process.stderr.write(`${head} ${formatCtx(ctx)}
+        writeErr(`${head} ${formatCtx(ctx)}
 `);
       } else {
-        process.stderr.write(`${head}
+        writeErr(`${head}
 `);
       }
     }
@@ -5487,9 +5538,9 @@ var DefaultMemoryStore = class {
   async readAll() {
     const parts = [];
     for (const scope of ["project-agents", "project-memory", "user-memory"]) {
-      const writeErr = this.writeErrors.get(scope);
-      if (writeErr) {
-        parts.push(`> \u26A0\uFE0F Memory write error (${labelOf(scope)}): ${writeErr.message}`);
+      const writeErr2 = this.writeErrors.get(scope);
+      if (writeErr2) {
+        parts.push(`> \u26A0\uFE0F Memory write error (${labelOf(scope)}): ${writeErr2.message}`);
       }
       const body = await this.read(scope);
       if (body.trim()) parts.push(`## ${labelOf(scope)}
@@ -13686,637 +13737,911 @@ function buildGoalPreamble(goal) {
     "BEGIN.]"
   ].join("\n");
 }
-
-// src/coordination/director.ts
 init_atomic_write();
-
-// src/coordination/large-answer-store.ts
-var LargeAnswerStore = class {
+var DEFAULT_MAX_TARGET_FILES = 30;
+var CollabSession = class extends EventEmitter {
+  sessionId;
+  options;
+  snapshot;
+  director;
+  fleetBus;
+  subagentIds = /* @__PURE__ */ new Map();
+  // role → subagentId
+  bugs = /* @__PURE__ */ new Map();
+  plans = /* @__PURE__ */ new Map();
+  evaluations = /* @__PURE__ */ new Map();
+  disposers = new Array();
+  settled = false;
+  timeoutMs;
+  cancelled = false;
+  alerts = [];
+  /** Tracks tool call counts per subagent for progress-based timeout decisions. */
+  progressBySubagent = /* @__PURE__ */ new Map();
+  /** Last tool call count when a timeout warning was handled. */
+  lastTimeoutProgress = /* @__PURE__ */ new Map();
+  /** Session-level timeout timer handle (cleared on cancel or natural completion). */
+  _timeoutTimer;
+  constructor(director, fleetBus, options) {
+    super();
+    this.sessionId = randomUUID();
+    this.options = options;
+    this.director = director;
+    this.fleetBus = fleetBus;
+    this.timeoutMs = options.timeoutMs ?? 10 * 60 * 1e3;
+    if (options.prebuiltSnapshot) {
+      this.snapshot = options.prebuiltSnapshot;
+    } else {
+      this.snapshot = {
+        id: this.sessionId,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        files: []
+      };
+    }
+  }
+  get id() {
+    return this.sessionId;
+  }
+  getSessionAlerts() {
+    return [...this.alerts];
+  }
+  isCancelled() {
+    return this.cancelled;
+  }
   /**
-   * Responses above this size (in characters) are stored out-of-context.
-   * Below this, the full answer is returned inline (no overhead).
-   * Default: 2000 chars ≈ 400-600 tokens.
+   * Snapshot of role → subagentId map. The Director calls coordinator.stop()
+   * for each agent when cancelling the session, using this map to enumerate
+   * all three collab agents.
    */
-  sizeThreshold;
-  store = /* @__PURE__ */ new Map();
-  constructor(sizeThreshold = 2e3) {
-    this.sizeThreshold = sizeThreshold;
+  getSubagentIds() {
+    return new Map(this.subagentIds);
   }
   /**
-   * Store a value, returning a summary + key for inline use.
-   * If the value is below sizeThreshold, returns it as-is (no store entry).
+   * Returns the effective file limit for this session.
+   * Priority: explicit `maxTargetFiles` > dynamic from `contextWindow` > `DEFAULT_MAX_TARGET_FILES`.
    */
-  storeAnswer(value) {
-    if (value === void 0 || value === null) {
-      return { summary: String(value), inline: true };
+  effectiveFileLimit() {
+    if (this.options.maxTargetFiles !== void 0) {
+      return this.options.maxTargetFiles;
     }
-    const serialized = typeof value === "string" ? value : JSON.stringify(value);
-    const size = serialized.length;
-    if (size <= this.sizeThreshold) {
-      return { summary: serialized.slice(0, 500), inline: true };
+    if (this.options.contextWindow !== void 0) {
+      return Math.max(5, Math.floor(this.options.contextWindow * 0.4 / 2e3));
     }
-    const key = `a-${hashStr(serialized)}`;
-    this.store.set(key, {
-      key,
-      value,
-      size,
-      storedAt: Date.now()
-    });
-    return {
-      key,
-      summary: `[stored: ${size} chars \u2014 use roll_up or ask_result tool to retrieve, key=${key}]`,
-      inline: false
-    };
+    return DEFAULT_MAX_TARGET_FILES;
   }
-  /**
-   * Retrieve a previously stored answer by its key.
-   * Returns undefined if the key is unknown or the store was cleared.
-   */
-  retrieveAnswer(key) {
-    return this.store.get(key)?.value;
+  async buildSnapshot() {
+    if (this.snapshot.files.length > 0) return this.snapshot;
+    const allFiles = [];
+    for (const pattern of this.options.targetPaths) {
+      const expanded = await expandGlob(pattern);
+      allFiles.push(...expanded);
+    }
+    const limit = this.effectiveFileLimit();
+    if (allFiles.length > limit) {
+      const hint = this.options.contextWindow ? `contextWindow=${this.options.contextWindow} \u2192 calculated limit=${limit}` : `default limit=${DEFAULT_MAX_TARGET_FILES}`;
+      throw new Error(
+        `[collab_debug] Target has ${allFiles.length} files, which exceeds the limit (${hint}). Narrow the target or pass maxTargetFiles / contextWindow to override. For large codebases, run package-by-package or module-by-module sessions instead of targeting the entire repo.`
+      );
+    }
+    for (const filePath of allFiles) {
+      try {
+        const content = await fsp3.readFile(filePath, "utf8");
+        const ext = filePath.split(".").pop() ?? "";
+        const language = ext === "ts" || ext === "tsx" ? "typescript" : ext === "js" || ext === "jsx" ? "javascript" : ext === "md" ? "markdown" : ext === "json" ? "json" : void 0;
+        this.snapshot.files.push({ path: filePath, content, language });
+      } catch {
+        this.snapshot.files.push({ path: filePath, content: "", language: void 0 });
+      }
+    }
+    return this.snapshot;
   }
   /**
-   * Check if a key exists in the store.
+   * Cancel the session. Emits director.cancel_collab on the FleetBus so all
+   * collab agents finish early. The session-level timeout timer is also cleared.
+   * Safe to call multiple times (idempotent after first call).
    */
-  hasAnswer(key) {
-    return this.store.has(key);
-  }
-  /** Number of stored entries. */
-  get size() {
-    return this.store.size;
-  }
-  /** Total characters stored. */
-  get totalChars() {
-    let total = 0;
-    for (const e of this.store.values()) total += e.size;
-    return total;
+  cancel(reason = "Director cancelled collab session") {
+    if (this.settled) return;
+    this.cancelled = true;
+    if (this._timeoutTimer) {
+      clearTimeout(this._timeoutTimer);
+      this._timeoutTimer = void 0;
+    }
+    this.fleetBus.emit({
+      subagentId: this.director.id,
+      ts: Date.now(),
+      type: "director.cancel_collab",
+      payload: { sessionId: this.sessionId, reason, cancelledAt: (/* @__PURE__ */ new Date()).toISOString() }
+    });
+    this.fleetBus.emit({
+      subagentId: this.director.id,
+      ts: Date.now(),
+      type: "collab.cancelled",
+      payload: { sessionId: this.sessionId, reason }
+    });
   }
-  /** Clear all stored entries. Call at the end of a director run. */
-  clear() {
-    this.store.clear();
+  async start() {
+    if (this.settled) throw new Error("session already settled");
+    this.settled = true;
+    await this.buildSnapshot();
+    this.wireFleetBus();
+    const [bugHunterId, refactorPlannerId, criticId] = await Promise.all([
+      this.spawnAgent("bug-hunter", this.buildBugHunterTask()),
+      this.spawnAgent("refactor-planner", this.buildRefactorPlannerTask()),
+      this.spawnAgent("critic", this.buildCriticTask())
+    ]);
+    this.subagentIds.set("bug-hunter", bugHunterId);
+    this.subagentIds.set("refactor-planner", refactorPlannerId);
+    this.subagentIds.set("critic", criticId);
+    const timeout = new Promise((_, reject) => {
+      this._timeoutTimer = setTimeout(() => {
+        this.cancel("Session-level timeout reached");
+        reject(new Error(`CollabSession timed out after ${this.timeoutMs}ms`));
+      }, this.timeoutMs);
+    });
+    let results = null;
+    try {
+      results = await Promise.race([
+        Promise.all([
+          this.director.awaitTasks([bugHunterId]),
+          this.director.awaitTasks([refactorPlannerId]),
+          this.director.awaitTasks([criticId])
+        ]),
+        timeout
+      ]);
+    } catch (err) {
+      if (this._timeoutTimer) {
+        clearTimeout(this._timeoutTimer);
+        this._timeoutTimer = void 0;
+      }
+      this.cleanup();
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.emit("session.error", error);
+      throw error;
+    }
+    for (const result of results.flat()) {
+      await this.parseAndEmit(result);
+    }
+    const report = this.assembleReport();
+    this.cleanup();
+    this.emit("session.done", report);
+    return report;
   }
-};
-function hashStr(s) {
-  let h = 5381;
-  for (let i = 0; i < s.length; i++) {
-    h = h * 33 ^ s.charCodeAt(i);
+  async parseAndEmit(result) {
+    if (result.status !== "success" || result.result == null) return;
+    const text = typeof result.result === "string" ? result.result : JSON.stringify(result.result);
+    for (const obj of this.extractJsonObjects(text)) {
+      const type = "finding" in obj ? "bug.found" : "plan" in obj ? "refactor.plan" : "evaluation" in obj ? "critic.evaluation" : null;
+      if (!type) continue;
+      this.fleetBus.emit({
+        subagentId: result.subagentId,
+        taskId: result.taskId,
+        ts: Date.now(),
+        type,
+        payload: obj
+      });
+    }
   }
-  return (h >>> 0).toString(36);
-}
-
-// src/coordination/director-prompts.ts
-var DEFAULT_DIRECTOR_PREAMBLE = `You are the Director of a multi-agent fleet. You orchestrate worker
-subagents by spawning them, assigning tasks, awaiting completions, and
-rolling up their outputs into your next decision.
-
-Core fleet tools available to you:
-  - spawn_subagent       \u2014 create a worker with a chosen provider / model / role
-  - assign_task          \u2014 hand a piece of work to a specific subagent
-  - await_tasks          \u2014 block until named task ids complete (parallel-safe)
-  - ask_subagent         \u2014 synchronously query a running subagent via the bridge
-  - roll_up              \u2014 aggregate finished tasks into a markdown/json summary
-  - terminate_subagent   \u2014 abort a stuck worker (use sparingly)
-  - fleet_status         \u2014 snapshot of all subagents and pending tasks
-  - fleet_usage          \u2014 token + cost breakdown per subagent and total
-
-Working rules:
-  1. Decompose first. Before spawning, decide which sub-tasks are
-     independent and can run in parallel. Sequential work doesn't need a
-     subagent \u2014 do it yourself.
-  2. Match worker to job. Cheap/fast model for triage, capable model for
-     synthesis. Different providers per sibling is allowed and encouraged.
-  3. Always pair an assign with an await. Don't fire-and-forget; you owe
-     the user a single coherent answer at the end.
-  4. Roll up before deciding. After await_tasks resolves, call roll_up so
-     the results are folded back into your context in a compact form.
-  5. Budget is real. Check fleet_usage periodically. If a subagent is
-     thrashing, terminate it rather than letting cost climb silently.
-  6. Never claim a subagent's work as your own without verifying it. If a
-     result looks wrong, ask_subagent for clarification before passing it
-     to the user.
-  7. Wind down when satisfied. When the results are good enough, call
-     work_complete \u2014 no new subagents will spawn and queued tasks complete
-     as aborted. Running subagents finish naturally. Call terminate_subagent
-     only for ones you need to stop immediately.`;
-var DEFAULT_SUBAGENT_BASELINE = `You are a subagent operating under a Director. You were spawned to handle
-a specific slice of a larger plan \u2014 do that slice well and report back.
-
-Bridge contract:
-  - You have a parent (the Director). You may call \`request\` on the
-    parent bridge to ask a clarifying question. Use this sparingly; the
-    parent is also working.
-  - You MAY NOT request the parent's system prompt, tool list, or other
-    subagents' context. Those are not yours to read.
-  - Your final task output is what the Director sees. Be concise,
-    structured, and self-contained \u2014 assume the Director will paste your
-    output into its own context.`;
-function composeDirectorPrompt(parts = {}) {
-  const sections = [];
-  const preamble = parts.directorPreamble ?? DEFAULT_DIRECTOR_PREAMBLE;
-  if (preamble && preamble.trim().length > 0) sections.push(preamble.trim());
-  if (parts.rosterSummary && parts.rosterSummary.trim().length > 0) {
-    sections.push(`Available roles you can spawn:
-${parts.rosterSummary.trim()}`);
-  }
-  if (parts.basePrompt && parts.basePrompt.trim().length > 0) {
-    sections.push(parts.basePrompt.trim());
-  }
-  return sections.join("\n\n");
-}
-function composeSubagentPrompt(parts = {}) {
-  const sections = [];
-  const baseline = parts.baseline ?? DEFAULT_SUBAGENT_BASELINE;
-  if (baseline && baseline.trim().length > 0) sections.push(baseline.trim());
-  if (parts.role && parts.role.trim().length > 0) {
-    sections.push(`Role:
-${parts.role.trim()}`);
-  }
-  if (parts.task && parts.task.trim().length > 0) {
-    sections.push(`Task:
-${parts.task.trim()}`);
-  }
-  if (parts.sharedScratchpad && parts.sharedScratchpad.trim().length > 0) {
-    sections.push(
-      `Shared notes:
-A scratchpad shared with the rest of the fleet is mounted at \`${parts.sharedScratchpad.trim()}\`.
-- Write your final findings as markdown files there (e.g. \`findings.md\`, \`security.md\`).
-- Before starting, list the directory and read any sibling files relevant to your task \u2014 they may already contain context you can build on.
-- Use stable filenames (one file per concern); overwrite instead of appending so the Director sees the latest state.`
-    );
-  }
-  if (parts.override && parts.override.trim().length > 0) {
-    sections.push(parts.override.trim());
-  }
-  return sections.join("\n\n");
-}
-function rosterSummaryFromConfigs(roster) {
-  const lines = [];
-  for (const [roleId, cfg] of Object.entries(roster)) {
-    const tag = cfg.provider && cfg.model ? ` (${cfg.provider}/${cfg.model})` : "";
-    const headline = cfg.prompt ? (cfg.prompt.split("\n").find((l) => l.trim().length > 0) ?? "").trim().slice(0, 80) : "";
-    const tail = headline ? ` \u2014 ${headline}` : "";
-    lines.push(`- ${roleId}: ${cfg.name}${tag}${tail}`);
-  }
-  return lines.join("\n");
-}
-
-// src/coordination/fleet-bus.ts
-var FleetBus = class {
-  byId = /* @__PURE__ */ new Map();
-  byType = /* @__PURE__ */ new Map();
-  any = /* @__PURE__ */ new Set();
-  /**
-   * Hook a subagent's EventBus into the fleet. Uses `onAny()` (an alias for
-   * `onPattern('*')`) to forward all events with subagent attribution, so
-   * new kernel event types are automatically forwarded without any manual
-   * registration. `subagent.*` events are excluded because they originate
-   * from MultiAgentHost on the parent bus, not the subagent's own bus.
-   *
-   * Returns a disposer that detaches every subscription; call on
-   * subagent teardown so the listeners don't outlive the run.
-   */
-  attach(subagentId, bus, taskId) {
-    const off = bus.onAny((type, payload) => {
-      if (type.startsWith("subagent.")) return;
-      this.emit({ subagentId, taskId, ts: Date.now(), type, payload });
-    });
-    return () => {
-      off();
-    };
-  }
-  /** Subscribe to every event from one subagent. */
-  subscribe(subagentId, handler) {
-    let set = this.byId.get(subagentId);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.byId.set(subagentId, set);
+  extractJsonObjects(text) {
+    const objects = [];
+    let depth = 0;
+    let start = -1;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < text.length; i++) {
+      const ch = text[i];
+      if (inString) {
+        if (escaped) escaped = false;
+        else if (ch === "\\") escaped = true;
+        else if (ch === '"') inString = false;
+        continue;
+      }
+      if (ch === '"') {
+        inString = true;
+      } else if (ch === "{") {
+        if (depth === 0) start = i;
+        depth++;
+      } else if (ch === "}" && depth > 0) {
+        depth--;
+        if (depth === 0 && start >= 0) {
+          const candidate = text.slice(start, i + 1);
+          try {
+            const parsed = JSON.parse(candidate);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+              objects.push(parsed);
+            }
+          } catch {
+          }
+          start = -1;
+        }
+      }
     }
-    set.add(handler);
-    return () => {
-      set.delete(handler);
-    };
+    return objects;
   }
-  /** Subscribe to one event type across all subagents. */
-  filter(type, handler) {
-    let set = this.byType.get(type);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.byType.set(type, set);
+  budgetForRole(role) {
+    if (this.options.budgetOverrides?.[role]) {
+      return this.options.budgetOverrides[role];
     }
-    set.add(handler);
-    return () => {
-      set.delete(handler);
+    const defaults = {
+      "bug-hunter": { maxIterations: 2e3, maxToolCalls: 5e3, timeoutMs: 10 * 60 * 1e3 },
+      "refactor-planner": { maxIterations: 1500, maxToolCalls: 4e3, timeoutMs: 8 * 60 * 1e3 },
+      "critic": { maxIterations: 1e3, maxToolCalls: 3e3, timeoutMs: 6 * 60 * 1e3 }
     };
+    return defaults[role] ?? { maxIterations: 1500, maxToolCalls: 4e3, timeoutMs: 8 * 60 * 1e3 };
   }
-  /** Subscribe to literally everything. The fleet roll-up uses this. */
-  onAny(handler) {
-    this.any.add(handler);
-    return () => {
-      this.any.delete(handler);
+  async spawnAgent(role, taskBrief) {
+    const budget = this.budgetForRole(role);
+    const cfg = {
+      id: `${role}-${this.sessionId}`,
+      name: role,
+      role,
+      tools: ["fleet_emit", "fleet_status", "read", "grep", "glob", "bash", "write"],
+      maxIterations: budget.maxIterations,
+      maxToolCalls: budget.maxToolCalls,
+      timeoutMs: budget.timeoutMs
     };
+    const subagentId = await this.director.spawn(cfg);
+    await this.director.assign({ id: randomUUID(), subagentId, description: taskBrief });
+    return subagentId;
   }
-  emit(event) {
-    const byId = this.byId.get(event.subagentId);
-    if (byId)
-      for (const h of byId) {
-        try {
-          h(event);
-        } catch {
-        }
-      }
-    const byType = this.byType.get(event.type);
-    if (byType)
-      for (const h of byType) {
-        try {
-          h(event);
-        } catch {
-        }
-      }
-    for (const h of this.any) {
-      try {
-        h(event);
-      } catch {
-      }
-    }
-  }
-};
-var FleetUsageAggregator = class {
-  constructor(bus, priceLookup, metaLookup) {
-    this.priceLookup = priceLookup;
-    this.metaLookup = metaLookup;
-    this.unsub.push(bus.filter("provider.response", (e) => this.onProviderResponse(e)));
-    this.unsub.push(bus.filter("tool.executed", (e) => this.onToolExecuted(e)));
-    this.unsub.push(bus.filter("iteration.started", (e) => this.onIterationStarted(e)));
+  buildBugHunterTask() {
+    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
+    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
+${f.content}`).join("\n\n");
+    return `You are BugHunter. Scan the following files for bugs and code smells.
+
+Target files:
+${fileContents}
+
+For each bug found, emit it using the fleet_emit tool immediately:
+{ "type": "bug.found", "payload": { "finding": { "id": "<uuid>", "type": "<pattern>", "severity": "<critical|high|medium|low>", "location": { "file": "<path>", "line": <n> }, "description": "<explain>", "suggestedFix": "<optional>" } } }
+
+After scanning all files, write your full markdown bug report to:
+${scratchpad}/bug-hunter-report-${this.sessionId}.md
+
+Important: emit each finding as soon as you find it. Do not batch or wait until the end.`;
   }
-  priceLookup;
-  metaLookup;
-  perSubagent = /* @__PURE__ */ new Map();
-  total = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
-  unsub = new Array();
-  /**
-   * Remove a terminated subagent's data from the aggregator and subtract its
-   * contribution from the running totals. Call this when a subagent is removed
-   * from the fleet so the aggregator doesn't accumulate unbounded data for
-   * entities that will never emit events again.
-   */
-  removeSubagent(subagentId) {
-    const snap = this.perSubagent.get(subagentId);
-    if (!snap) return;
-    this.perSubagent.delete(subagentId);
-    this.total.input -= snap.input;
-    this.total.output -= snap.output;
-    this.total.cacheRead -= snap.cacheRead;
-    this.total.cacheWrite -= snap.cacheWrite;
-    this.total.cost -= snap.cost;
-  }
-  /** Disposes all fleet-bus subscriptions. Call when the aggregator is no longer needed. */
-  dispose() {
-    for (const off of this.unsub) off();
-    this.unsub.length = 0;
+  buildRefactorPlannerTask() {
+    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
+    const bugHunterReportPath = `${scratchpad}/bug-hunter-report-${this.sessionId}.md`;
+    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
+${f.content}`).join("\n\n");
+    return `You are RefactorPlanner. Plan refactorings for the following files.
+
+Target files:
+${fileContents}
+
+Read the BugHunter report at: ${bugHunterReportPath}
+
+For each bug you can address, emit a refactor plan using fleet_emit:
+{ "type": "refactor.plan", "payload": { "plan": { "id": "<uuid>", "basedOnBugIds": ["<bug-id>"], "phases": [{ "number": 1, "title": "<phase>", "tasks": ["<task>"], "risk": "<low|medium|high>" }], "riskScore": "<low|medium|high>", "estimatedChangeCount": <n>, "rollbackStrategy": "<text>" } } }
+
+Also write your full markdown plan to:
+${scratchpad}/refactor-plan-${this.sessionId}.md
+
+Emit each plan immediately. Do not wait until planning is complete.`;
   }
-  /** Live snapshot — safe to call from a tool's execute() body. */
-  snapshot() {
-    return {
-      total: { ...this.total },
-      perSubagent: Object.fromEntries(
-        Array.from(this.perSubagent.entries()).map(([k, v]) => [k, { ...v }])
-      )
-    };
+  buildCriticTask() {
+    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
+    const bugHunterReportPath = `${scratchpad}/bug-hunter-report-${this.sessionId}.md`;
+    const refactorPlanPath = `${scratchpad}/refactor-plan-${this.sessionId}.md`;
+    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
+${f.content}`).join("\n\n");
+    return `You are Critic. Evaluate bug findings and refactor plans.
+
+Target files:
+${fileContents}
+
+Read the BugHunter report at: ${bugHunterReportPath}
+Read the RefactorPlanner report at: ${refactorPlanPath}
+
+For each bug and refactor plan, emit your evaluation using fleet_emit:
+{ "type": "critic.evaluation", "payload": { "evaluation": { "id": "<uuid>", "subjectType": "<bug_finding|refactor_plan>", "subjectId": "<id>", "score": <0-10>, "verdict": "<approve|needs_revision|reject>", "strengths": ["<strength>"], "weaknesses": ["<weakness>"], "concerns": [{ "description": "<concern>", "severity": "<blocking|advisory>" }] } } }
+
+After all evaluations, write your markdown report to:
+${scratchpad}/critic-report-${this.sessionId}.md
+
+Emit each evaluation immediately. Do not wait until you have read all reports.`;
   }
-  ensure(subagentId) {
-    let snap = this.perSubagent.get(subagentId);
-    if (!snap) {
-      const meta = this.metaLookup?.(subagentId);
-      snap = {
-        subagentId,
-        provider: meta?.provider,
-        model: meta?.model,
-        input: 0,
-        output: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-        cost: 0,
-        toolCalls: 0,
-        iterations: 0,
-        startedAt: Date.now(),
-        lastEventAt: Date.now()
+  wireFleetBus() {
+    const dTool = this.fleetBus.filter("tool.executed", (e) => {
+      this.progressBySubagent.set(e.subagentId, (this.progressBySubagent.get(e.subagentId) ?? 0) + 1);
+    });
+    this.disposers.push(dTool);
+    const dBudget = this.fleetBus.filter("budget.threshold_reached", (e) => {
+      const payload = e.payload;
+      const role = this.roleFromSubagentId(e.subagentId);
+      if (!role) return;
+      const btwNotes = this.director.getLeaderBtwNotes();
+      const alert = {
+        sessionId: this.sessionId,
+        subagentId: e.subagentId,
+        role,
+        level: "warning" /* WARNING */,
+        message: `${role} hit ${payload.kind} soft limit (${payload.used}/${payload.limit})`,
+        budgetKind: payload.kind,
+        elapsedMs: payload.timeoutMs,
+        limit: payload.limit,
+        btwNotes
       };
-      this.perSubagent.set(subagentId, snap);
-    }
-    return snap;
-  }
-  onProviderResponse(e) {
-    const snap = this.ensure(e.subagentId);
-    const p = e.payload;
-    const usage = p?.usage;
-    if (!usage) return;
-    snap.input += usage.input ?? 0;
-    snap.output += usage.output ?? 0;
-    snap.cacheRead += usage.cacheRead ?? 0;
-    snap.cacheWrite += usage.cacheWrite ?? 0;
-    this.total.input += usage.input ?? 0;
-    this.total.output += usage.output ?? 0;
-    this.total.cacheRead += usage.cacheRead ?? 0;
-    this.total.cacheWrite += usage.cacheWrite ?? 0;
-    const price = this.priceLookup?.(e.subagentId, snap.provider, snap.model);
-    if (price) {
-      const delta = (usage.input ?? 0) / 1e6 * (price.input ?? 0) + (usage.output ?? 0) / 1e6 * (price.output ?? 0) + (usage.cacheRead ?? 0) / 1e6 * (price.cacheRead ?? 0) + (usage.cacheWrite ?? 0) / 1e6 * (price.cacheWrite ?? 0);
-      snap.cost += delta;
-      this.total.cost += delta;
-    }
-    snap.lastEventAt = e.ts;
-  }
-  onToolExecuted(e) {
-    const snap = this.ensure(e.subagentId);
-    snap.toolCalls += 1;
-    snap.lastEventAt = e.ts;
-  }
-  onIterationStarted(e) {
-    const snap = this.ensure(e.subagentId);
-    snap.iterations += 1;
-    snap.lastEventAt = e.ts;
-  }
-};
-function makeSpawnTool(director, roster) {
-  const inputSchema = {
-    type: "object",
-    properties: {
-      role: { type: "string", description: "Roster role id. When set, the spawn uses the matching config from the roster and ignores other fields." },
-      description: { type: "string", description: "Free-form task description. When `role` is not set, the director uses the smart dispatcher to route this to the best-matching catalog agent. Use this when you don't know the exact role name." },
-      name: { type: "string", description: "Display name for the subagent. Used as a fallback when description-based dispatch does not resolve a role." },
-      provider: { type: "string", description: 'Provider id (e.g. "anthropic", "openai"). Defaults to the leader provider when omitted.' },
-      model: { type: "string", description: "Model id within the provider. Defaults to the leader model when omitted." },
-      systemPromptOverride: { type: "string", description: "Extra prompt text appended after the role-base prompt." },
-      maxIterations: { type: "number", minimum: 1 },
-      maxToolCalls: { type: "number", minimum: 1 },
-      maxCostUsd: { type: "number", minimum: 0 },
-      timeoutMs: { type: "number", minimum: 1, description: "Hard wall-clock cap in milliseconds. Defaults to none (idle timeout is the default reaper)." },
-      idleTimeoutMs: { type: "number", minimum: 1, description: "Idle timeout in ms: reap the subagent after this long with no activity. Resets on every iteration/tool call. Default is role/coordinator-specific." },
-      maxTokens: { type: "number", minimum: 1, description: "Maximum total tokens (input + output) the subagent may use." }
-    },
-    required: []
-  };
-  return {
-    name: "spawn_subagent",
-    description: "Create a new subagent under this director. Returns the subagent id.",
-    usageHint: "Pass `role` (matches the roster), `description` (smart dispatch to best agent), or `name` + `provider`/`model`. Returns `{ subagentId }`.",
-    permission: "auto",
-    mutating: false,
-    inputSchema,
-    async execute(input) {
-      const i = input ?? {};
-      const role = typeof i.role === "string" ? i.role : void 0;
-      const description = typeof i.description === "string" ? i.description : void 0;
-      let cfg;
-      if (role && roster) {
-        const base = roster[role];
-        if (!base) return { error: `unknown role "${role}". roster has: ${Object.keys(roster).join(", ")}` };
-        cfg = instantiateRosterConfig(role, base);
-      } else if (description && !role) {
-        const dispatchResult = await dispatchAgent(description, {
-          classifier: director.dispatchClassifier,
-          catalog: roster
-        });
-        const dispatchRole = dispatchResult.role;
-        if (roster?.[dispatchRole]) {
-          cfg = instantiateRosterConfig(dispatchRole, roster[dispatchRole]);
-        } else {
-          const def = dispatchResult.definition;
-          cfg = {
-            name: def.config.name ?? dispatchRole,
-            role: dispatchRole,
-            provider: def.config.provider,
-            model: def.config.model
-          };
-        }
+      this.alerts.push(alert);
+      this.fleetBus.emit({
+        subagentId: e.subagentId,
+        ts: Date.now(),
+        type: "collab.warning",
+        payload: alert
+      });
+      const decision = this.options.onBudgetWarning?.(alert) ?? "ignore";
+      if (decision === "cancel") {
+        this.cancel(`Director cancelled: ${role} ${payload.kind} threshold`);
+        return;
       }
-      cfg ??= { name: i.name ?? "subagent" };
-      if (typeof i.name === "string") cfg.name = i.name;
-      if (typeof i.provider === "string") cfg.provider = i.provider;
-      if (typeof i.model === "string") cfg.model = i.model;
-      if (typeof i.systemPromptOverride === "string") cfg.systemPromptOverride = i.systemPromptOverride;
-      if (typeof i.maxIterations === "number") cfg.maxIterations = i.maxIterations;
-      if (typeof i.maxToolCalls === "number") cfg.maxToolCalls = i.maxToolCalls;
-      if (typeof i.maxCostUsd === "number") cfg.maxCostUsd = i.maxCostUsd;
-      if (typeof i.timeoutMs === "number") cfg.timeoutMs = i.timeoutMs;
-      if (typeof i.idleTimeoutMs === "number") cfg.idleTimeoutMs = i.idleTimeoutMs;
-      if (typeof i.maxTokens === "number") cfg.maxTokens = i.maxTokens;
-      try {
-        const subagentId = await director.spawn(cfg);
-        return { subagentId, provider: cfg.provider, model: cfg.model, name: cfg.name, role: cfg.role };
-      } catch (err) {
-        if (err instanceof FleetSpawnBudgetError) {
-          return { error: err.message, kind: err.kind, limit: err.limit, observed: err.observed };
-        }
-        if (err instanceof FleetCostCapError) {
-          return { error: err.message, kind: err.kind, limit: err.limit, observed: err.observed };
+      if (payload.kind === "timeout" || payload.kind === "idle_timeout") {
+        const progress = this.progressBySubagent.get(e.subagentId) ?? 0;
+        const lastProgress = this.lastTimeoutProgress.get(e.subagentId) ?? -1;
+        if (progress <= lastProgress) {
+          payload.deny();
+          return;
         }
-        return { error: err instanceof Error ? err.message : String(err) };
+        this.lastTimeoutProgress.set(e.subagentId, progress);
+        const newLimit = Math.min(Math.ceil((payload.timeoutMs ?? payload.limit) * 2), 24 * 60 * 6e4);
+        setImmediate(() => {
+          payload.extend({ timeoutMs: newLimit });
+        });
+        return;
       }
+      if (decision === "extend") {
+        setImmediate(() => {
+          const base = Math.max(payload.limit, payload.used);
+          const extra = {};
+          switch (payload.kind) {
+            case "iterations":
+              extra.maxIterations = Math.min(Math.ceil(base * 1.5), 5e4);
+              break;
+            case "tool_calls":
+              extra.maxToolCalls = Math.min(Math.ceil(base * 1.5), 1e5);
+              break;
+            case "tokens":
+              extra.maxTokens = Math.min(Math.ceil(base * 1.5), 5e6);
+              break;
+            case "cost":
+              extra.maxCostUsd = Math.min(base * 1.5, 100);
+              break;
+          }
+          payload.extend(extra);
+        });
+        return;
+      }
+      if (payload.kind !== "timeout") {
+        setImmediate(() => {
+          const base = Math.max(payload.limit, payload.used);
+          const extra = {};
+          switch (payload.kind) {
+            case "iterations":
+              extra.maxIterations = Math.min(Math.ceil(base * 1.25), 5e4);
+              break;
+            case "tool_calls":
+              extra.maxToolCalls = Math.min(Math.ceil(base * 1.25), 1e5);
+              break;
+            case "tokens":
+              extra.maxTokens = Math.min(Math.ceil(base * 1.25), 5e6);
+              break;
+            case "cost":
+              extra.maxCostUsd = Math.min(base * 1.25, 100);
+              break;
+          }
+          payload.extend(extra);
+        });
+      }
+    });
+    this.disposers.push(dBudget);
+    const dCancel = this.fleetBus.filter("director.cancel_collab", (e) => {
+      const payload = e.payload;
+      if (payload.sessionId !== this.sessionId) return;
+      this.cancelled = true;
+      if (this._timeoutTimer) {
+        clearTimeout(this._timeoutTimer);
+        this._timeoutTimer = void 0;
+      }
+      this.fleetBus.emit({
+        subagentId: this.director.id,
+        ts: Date.now(),
+        type: "collab.cancelled",
+        payload: { sessionId: this.sessionId, reason: payload.reason }
+      });
+    });
+    this.disposers.push(dCancel);
+    const d1 = this.fleetBus.filter("bug.found", (e) => {
+      const payload = e.payload;
+      if (payload?.finding) {
+        this.bugs.set(payload.finding.id, payload.finding);
+        this.emit("bug.found", payload);
+      }
+    });
+    this.disposers.push(d1);
+    const d2 = this.fleetBus.filter("refactor.plan", (e) => {
+      const payload = e.payload;
+      if (payload?.plan) {
+        this.plans.set(payload.plan.id, payload.plan);
+        this.emit("refactor.plan", payload);
+      }
+    });
+    this.disposers.push(d2);
+    const d3 = this.fleetBus.filter("critic.evaluation", (e) => {
+      const payload = e.payload;
+      if (payload?.evaluation) {
+        this.evaluations.set(payload.evaluation.id, payload.evaluation);
+        this.emit("critic.evaluation", payload);
+      }
+    });
+    this.disposers.push(d3);
+  }
+  roleFromSubagentId(subagentId) {
+    for (const [role, id] of this.subagentIds) {
+      if (id === subagentId) return role;
     }
-  };
-}
-function instantiateRosterConfig(role, base) {
-  return {
-    ...base,
-    // Roster entries are templates. A director may spawn several
-    // workers with the same role, so never reuse the template id.
-    id: `${role}-${randomUUID().slice(0, 8)}`
-  };
-}
-function makeAssignTool(director) {
-  const inputSchema = {
-    type: "object",
-    properties: {
-      subagentId: { type: "string", minLength: 1, description: "Target subagent id. Required." },
-      description: { type: "string", minLength: 1, description: "The task in natural language \u2014 what you want this subagent to do." },
-      maxToolCalls: { type: "number", minimum: 1, description: "Optional per-task tool-call budget override." },
-      timeoutMs: { type: "number", minimum: 1, description: "Optional per-task timeout in ms." }
-    },
-    required: ["subagentId", "description"]
-  };
-  return {
-    name: "assign_task",
-    description: "Hand a task to a previously spawned subagent. Returns the task id.",
-    permission: "auto",
-    mutating: false,
-    inputSchema,
-    async execute(input) {
-      const i = input;
-      const task = { id: randomUUID(), description: i.description, subagentId: i.subagentId, maxToolCalls: i.maxToolCalls, timeoutMs: i.timeoutMs };
-      const taskId = await director.assign(task);
-      return { taskId, subagentId: i.subagentId };
-    }
-  };
-}
-function makeAwaitTasksTool(director) {
-  return {
-    name: "await_tasks",
-    description: "Block until every named task completes. Returns the array of TaskResult.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: { type: "object", properties: { taskIds: { type: "array", items: { type: "string" }, description: "One or more task ids returned by `assign_task`." } }, required: ["taskIds"] },
-    async execute(input) {
-      const i = input;
-      const results = await director.awaitTasks(i.taskIds);
-      return { results };
-    }
-  };
-}
-function makeAskTool(director) {
-  return {
-    name: "ask_subagent",
-    description: "Synchronously ask a subagent a question. Blocks until the subagent replies via the bridge.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        subagentId: { type: "string", minLength: 1, description: "Subagent to ask. Must be a previously spawned id." },
-        question: { type: "string", minLength: 1, description: "The question or instruction." },
-        timeoutMs: { type: "number", minimum: 1, description: "Optional timeout in ms (default 30s)." }
+    const match = subagentId.match(/^(bug-hunter|refactor-planner|critic)/);
+    return match?.[1] ?? null;
+  }
+  assembleReport() {
+    const bugList = Array.from(this.bugs.values());
+    const planList = Array.from(this.plans.values());
+    const evalList = Array.from(this.evaluations.values());
+    let disposition = "completed";
+    if (this.cancelled) disposition = "cancelled";
+    const verdictOrder = {
+      approve: 0,
+      needs_revision: 1,
+      reject: 2
+    };
+    const overallVerdict = evalList.reduce(
+      (worst, eval_) => {
+        const w = verdictOrder[worst];
+        const c = verdictOrder[eval_.verdict];
+        return c > w ? eval_.verdict : worst;
       },
-      required: ["subagentId", "question"]
-    },
-    async execute(input) {
-      const i = input;
-      try {
-        const answer = await director.ask(i.subagentId, { question: i.question }, i.timeoutMs);
-        const stored = director.largeAnswerStore.storeAnswer(answer);
-        if (stored.inline) {
-          return { ok: true, answer: stored.summary };
+      "approve"
+    );
+    const summary = this.buildMarkdownSummary(bugList, planList, evalList, overallVerdict, disposition);
+    return {
+      sessionId: this.sessionId,
+      startedAt: this.snapshot.createdAt,
+      completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      targetPaths: this.options.targetPaths,
+      disposition,
+      bugs: bugList,
+      refactorPlans: planList,
+      evaluations: evalList,
+      alerts: [...this.alerts],
+      overallVerdict,
+      summary
+    };
+  }
+  buildMarkdownSummary(bugs, plans, evals, overallVerdict, disposition) {
+    const lines = [
+      `## Collaborative Debugging Report \u2014 ${this.sessionId}`,
+      "",
+      `**Target:** ${this.options.targetPaths.join(", ")}`,
+      `**Disposition:** ${disposition.toUpperCase()}`,
+      `**Overall Verdict:** **${overallVerdict.toUpperCase()}**`,
+      ""
+    ];
+    if (this.alerts.length > 0) {
+      lines.push("### Alerts", "");
+      for (const alert of this.alerts) {
+        lines.push(`- **[${alert.level.toUpperCase()}]** ${alert.role}: ${alert.message}`);
+      }
+      lines.push("");
+    }
+    if (bugs.length > 0) {
+      lines.push("### Bugs Found", "");
+      for (const b of bugs) {
+        lines.push(`- **[${b.severity.toUpperCase()}]** \`${b.location.file}:${b.location.line}\` \u2014 ${b.description}`);
+      }
+      lines.push("");
+    }
+    if (plans.length > 0) {
+      lines.push("### Refactor Plans", "");
+      for (const p of plans) {
+        lines.push(`- **Phase plan** (risk: ${p.riskScore}, ~${p.estimatedChangeCount} changes)`);
+        for (const phase of p.phases) {
+          lines.push(`  - Phase ${phase.number}: ${phase.title} [${phase.risk}]`);
         }
-        return {
-          ok: true,
-          answer: stored.summary,
-          _answerKey: stored.key,
-          _hint: "Response was large and stored. Use ask_result with the key to retrieve it."
-        };
-      } catch (err) {
-        return { ok: false, error: err instanceof Error ? err.message : String(err) };
       }
+      lines.push("");
     }
-  };
-}
-function makeAskResultTool(director) {
-  return {
-    name: "ask_result",
-    description: "Retrieve a large `ask_subagent` response that was stored out-of-context (>2K chars). Returns the full stored value.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        key: {
-          type: "string",
-          minLength: 1,
-          description: "The `_answerKey` returned by `ask_subagent` for a large response."
+    if (evals.length > 0) {
+      lines.push("### Critic Evaluations", "");
+      for (const e of evals) {
+        lines.push(`- [${e.subjectType}] score=${e.score}/10 \u2014 **${e.verdict.toUpperCase()}**`);
+        for (const c of e.concerns) {
+          if (c.severity === "blocking") lines.push(`  - ${c.description}`);
         }
-      },
-      required: ["key"]
-    },
-    async execute(input) {
-      const i = input;
-      const value = director.largeAnswerStore.retrieveAnswer(i.key);
-      if (value === void 0) {
-        return { ok: false, error: `No stored answer found for key "${i.key}" \u2014 it may have been cleared or the key is invalid.` };
       }
-      return { ok: true, value };
+      lines.push("");
     }
-  };
-}
-function makeRollUpTool(director) {
-  return {
-    name: "roll_up",
-    description: "Aggregate completed task results into a single formatted summary.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        taskIds: { type: "array", items: { type: "string" }, description: "Completed task ids to aggregate." },
-        style: { type: "string", enum: ["markdown", "json"], description: "Output flavor \u2014 markdown (default) or json." }
-      },
-      required: ["taskIds"]
-    },
-    async execute(input) {
-      const i = input;
-      const summary = director.rollUp(i.taskIds, i.style ?? "markdown");
-      return { summary, count: i.taskIds.length };
-    }
-  };
+    return lines.join("\n");
+  }
+  cleanup() {
+    for (const dispose of this.disposers) dispose();
+    this.disposers.length = 0;
+  }
+};
+
+// src/coordination/director-prompts.ts
+var DEFAULT_DIRECTOR_PREAMBLE = `You are the Director of a multi-agent fleet. You orchestrate worker
+subagents by spawning them, assigning tasks, awaiting completions, and
+rolling up their outputs into your next decision.
+
+Core fleet tools available to you:
+  - spawn_subagent       \u2014 create a worker with a chosen provider / model / role
+  - assign_task          \u2014 hand a piece of work to a specific subagent
+  - await_tasks          \u2014 block until named task ids complete (parallel-safe)
+  - ask_subagent         \u2014 synchronously query a running subagent via the bridge
+  - roll_up              \u2014 aggregate finished tasks into a markdown/json summary
+  - terminate_subagent   \u2014 abort a stuck worker (use sparingly)
+  - fleet_status         \u2014 snapshot of all subagents and pending tasks
+  - fleet_usage          \u2014 token + cost breakdown per subagent and total
+
+Working rules:
+  1. Decompose first. Before spawning, decide which sub-tasks are
+     independent and can run in parallel. Sequential work doesn't need a
+     subagent \u2014 do it yourself.
+  2. Match worker to job. Cheap/fast model for triage, capable model for
+     synthesis. Different providers per sibling is allowed and encouraged.
+  3. Always pair an assign with an await. Don't fire-and-forget; you owe
+     the user a single coherent answer at the end.
+  4. Roll up before deciding. After await_tasks resolves, call roll_up so
+     the results are folded back into your context in a compact form.
+  5. Budget is real. Check fleet_usage periodically. If a subagent is
+     thrashing, terminate it rather than letting cost climb silently.
+  6. Never claim a subagent's work as your own without verifying it. If a
+     result looks wrong, ask_subagent for clarification before passing it
+     to the user.
+  7. Wind down when satisfied. When the results are good enough, call
+     work_complete \u2014 no new subagents will spawn and queued tasks complete
+     as aborted. Running subagents finish naturally. Call terminate_subagent
+     only for ones you need to stop immediately.`;
+var DEFAULT_SUBAGENT_BASELINE = `You are a subagent operating under a Director. You were spawned to handle
+a specific slice of a larger plan \u2014 do that slice well and report back.
+
+Bridge contract:
+  - You have a parent (the Director). You may call \`request\` on the
+    parent bridge to ask a clarifying question. Use this sparingly; the
+    parent is also working.
+  - You MAY NOT request the parent's system prompt, tool list, or other
+    subagents' context. Those are not yours to read.
+  - Your final task output is what the Director sees. Be concise,
+    structured, and self-contained \u2014 assume the Director will paste your
+    output into its own context.`;
+function composeDirectorPrompt(parts = {}) {
+  const sections = [];
+  const preamble = parts.directorPreamble ?? DEFAULT_DIRECTOR_PREAMBLE;
+  if (preamble && preamble.trim().length > 0) sections.push(preamble.trim());
+  if (parts.rosterSummary && parts.rosterSummary.trim().length > 0) {
+    sections.push(`Available roles you can spawn:
+${parts.rosterSummary.trim()}`);
+  }
+  if (parts.basePrompt && parts.basePrompt.trim().length > 0) {
+    sections.push(parts.basePrompt.trim());
+  }
+  return sections.join("\n\n");
 }
-function makeTerminateTool(director) {
+function composeSubagentPrompt(parts = {}) {
+  const sections = [];
+  const baseline = parts.baseline ?? DEFAULT_SUBAGENT_BASELINE;
+  if (baseline && baseline.trim().length > 0) sections.push(baseline.trim());
+  if (parts.role && parts.role.trim().length > 0) {
+    sections.push(`Role:
+${parts.role.trim()}`);
+  }
+  if (parts.task && parts.task.trim().length > 0) {
+    sections.push(`Task:
+${parts.task.trim()}`);
+  }
+  if (parts.sharedScratchpad && parts.sharedScratchpad.trim().length > 0) {
+    sections.push(
+      `Shared notes:
+A scratchpad shared with the rest of the fleet is mounted at \`${parts.sharedScratchpad.trim()}\`.
+- Write your final findings as markdown files there (e.g. \`findings.md\`, \`security.md\`).
+- Before starting, list the directory and read any sibling files relevant to your task \u2014 they may already contain context you can build on.
+- Use stable filenames (one file per concern); overwrite instead of appending so the Director sees the latest state.`
+    );
+  }
+  if (parts.override && parts.override.trim().length > 0) {
+    sections.push(parts.override.trim());
+  }
+  return sections.join("\n\n");
+}
+function rosterSummaryFromConfigs(roster) {
+  const lines = [];
+  for (const [roleId, cfg] of Object.entries(roster)) {
+    const tag = cfg.provider && cfg.model ? ` (${cfg.provider}/${cfg.model})` : "";
+    const headline = cfg.prompt ? (cfg.prompt.split("\n").find((l) => l.trim().length > 0) ?? "").trim().slice(0, 80) : "";
+    const tail = headline ? ` \u2014 ${headline}` : "";
+    lines.push(`- ${roleId}: ${cfg.name}${tag}${tail}`);
+  }
+  return lines.join("\n");
+}
+function makeSpawnTool(director, roster) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      role: { type: "string", description: "Roster role id. When set, the spawn uses the matching config from the roster and ignores other fields." },
+      description: { type: "string", description: "Free-form task description. When `role` is not set, the director uses the smart dispatcher to route this to the best-matching catalog agent. Use this when you don't know the exact role name." },
+      name: { type: "string", description: "Display name for the subagent. Used as a fallback when description-based dispatch does not resolve a role." },
+      provider: { type: "string", description: 'Provider id (e.g. "anthropic", "openai"). Defaults to the leader provider when omitted.' },
+      model: { type: "string", description: "Model id within the provider. Defaults to the leader model when omitted." },
+      systemPromptOverride: { type: "string", description: "Extra prompt text appended after the role-base prompt." },
+      maxIterations: { type: "number", minimum: 1 },
+      maxToolCalls: { type: "number", minimum: 1 },
+      maxCostUsd: { type: "number", minimum: 0 },
+      timeoutMs: { type: "number", minimum: 1, description: "Hard wall-clock cap in milliseconds. Defaults to none (idle timeout is the default reaper)." },
+      idleTimeoutMs: { type: "number", minimum: 1, description: "Idle timeout in ms: reap the subagent after this long with no activity. Resets on every iteration/tool call. Default is role/coordinator-specific." },
+      maxTokens: { type: "number", minimum: 1, description: "Maximum total tokens (input + output) the subagent may use." }
+    },
+    required: []
+  };
   return {
-    name: "terminate_subagent",
-    description: 'Forcibly abort a subagent. The subagent finishes its current iteration then exits with status "stopped".',
+    name: "spawn_subagent",
+    description: "Create a new subagent under this director. Returns the subagent id.",
+    usageHint: "Pass `role` (matches the roster), `description` (smart dispatch to best agent), or `name` + `provider`/`model`. Returns `{ subagentId }`.",
     permission: "auto",
-    mutating: true,
-    inputSchema: { type: "object", properties: { subagentId: { type: "string", description: "Subagent to abort." } }, required: ["subagentId"] },
+    mutating: false,
+    inputSchema,
     async execute(input) {
-      const i = input;
-      await director.terminate(i.subagentId);
-      return { ok: true };
+      const i = input ?? {};
+      const role = typeof i.role === "string" ? i.role : void 0;
+      const description = typeof i.description === "string" ? i.description : void 0;
+      let cfg;
+      if (role && roster) {
+        const base = roster[role];
+        if (!base) return { error: `unknown role "${role}". roster has: ${Object.keys(roster).join(", ")}` };
+        cfg = instantiateRosterConfig(role, base);
+      } else if (description && !role) {
+        const dispatchResult = await dispatchAgent(description, {
+          classifier: director.dispatchClassifier,
+          catalog: roster
+        });
+        const dispatchRole = dispatchResult.role;
+        if (roster?.[dispatchRole]) {
+          cfg = instantiateRosterConfig(dispatchRole, roster[dispatchRole]);
+        } else {
+          const def = dispatchResult.definition;
+          cfg = {
+            name: def.config.name ?? dispatchRole,
+            role: dispatchRole,
+            provider: def.config.provider,
+            model: def.config.model
+          };
+        }
+      }
+      cfg ??= { name: i.name ?? "subagent" };
+      if (typeof i.name === "string") cfg.name = i.name;
+      if (typeof i.provider === "string") cfg.provider = i.provider;
+      if (typeof i.model === "string") cfg.model = i.model;
+      if (typeof i.systemPromptOverride === "string") cfg.systemPromptOverride = i.systemPromptOverride;
+      if (typeof i.maxIterations === "number") cfg.maxIterations = i.maxIterations;
+      if (typeof i.maxToolCalls === "number") cfg.maxToolCalls = i.maxToolCalls;
+      if (typeof i.maxCostUsd === "number") cfg.maxCostUsd = i.maxCostUsd;
+      if (typeof i.timeoutMs === "number") cfg.timeoutMs = i.timeoutMs;
+      if (typeof i.idleTimeoutMs === "number") cfg.idleTimeoutMs = i.idleTimeoutMs;
+      if (typeof i.maxTokens === "number") cfg.maxTokens = i.maxTokens;
+      try {
+        const subagentId = await director.spawn(cfg);
+        return { subagentId, provider: cfg.provider, model: cfg.model, name: cfg.name, role: cfg.role };
+      } catch (err) {
+        if (err instanceof FleetSpawnBudgetError) {
+          return { error: err.message, kind: err.kind, limit: err.limit, observed: err.observed };
+        }
+        if (err instanceof FleetCostCapError) {
+          return { error: err.message, kind: err.kind, limit: err.limit, observed: err.observed };
+        }
+        return { error: err instanceof Error ? err.message : String(err) };
+      }
     }
   };
 }
-function makeTerminateAllTool(director) {
+function instantiateRosterConfig(role, base) {
   return {
-    name: "terminate_all",
-    description: 'Forcibly stop every subagent in the fleet and drain the pending task queue. In-flight tasks are terminated mid-execution; pending tasks receive "aborted_by_parent" completion immediately. Use this when the fleet is wedged, looping, or you need a clean slate. Compare: work_complete stops spawning but lets running agents finish naturally.',
-    permission: "auto",
-    mutating: true,
-    inputSchema: { type: "object", properties: {}, required: [] },
-    async execute() {
-      await director.terminateAll();
-      return { ok: true, message: `Fleet shutdown complete \u2014 all subagents stopped, pending tasks drained.` };
-    }
+    ...base,
+    // Roster entries are templates. A director may spawn several
+    // workers with the same role, so never reuse the template id.
+    id: `${role}-${randomUUID().slice(0, 8)}`
   };
 }
-function makeFleetStatusTool(director) {
+function makeAssignTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      subagentId: { type: "string", minLength: 1, description: "Target subagent id. Required." },
+      description: { type: "string", minLength: 1, description: "The task in natural language \u2014 what you want this subagent to do." },
+      maxToolCalls: { type: "number", minimum: 1, description: "Optional per-task tool-call budget override." },
+      timeoutMs: { type: "number", minimum: 1, description: "Optional per-task timeout in ms." }
+    },
+    required: ["subagentId", "description"]
+  };
   return {
-    name: "fleet_status",
-    description: "Snapshot of the fleet \u2014 every subagent's current status, coordinator counts (total/running/idle/stopped), pending task descriptions, and usage rollup.",
+    name: "assign_task",
+    description: "Hand a task to a previously spawned subagent. Returns the task id.",
     permission: "auto",
     mutating: false,
-    inputSchema: { type: "object", properties: {}, required: [] },
-    async execute() {
-      const base = director.status();
-      const fm = director.fleetManager;
-      const stats = fm?.getFleetStats();
-      const fleetStatus = fm?.getFleetStatus();
-      return {
-        subagents: base.subagents,
-        coordinatorStats: stats ? { total: stats.total, running: stats.running, idle: stats.idle, stopped: stats.stopped } : void 0,
-        pending: fleetStatus?.pending ?? [],
-        usage: fm?.snapshot()
-      };
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      const task = { id: randomUUID(), description: i.description, subagentId: i.subagentId, maxToolCalls: i.maxToolCalls, timeoutMs: i.timeoutMs };
+      const taskId = await director.assign(task);
+      return { taskId, subagentId: i.subagentId };
     }
   };
 }
-function makeFleetUsageTool(director) {
+function makeAwaitTasksTool(director) {
   return {
-    name: "fleet_usage",
-    description: "Token + cost breakdown across the fleet, per-subagent and totals.",
+    name: "await_tasks",
+    description: "Block until every named task completes. Returns the array of TaskResult.",
     permission: "auto",
     mutating: false,
-    inputSchema: { type: "object", properties: {}, required: [] },
-    async execute() {
-      return director.snapshot();
+    inputSchema: { type: "object", properties: { taskIds: { type: "array", items: { type: "string" }, description: "One or more task ids returned by `assign_task`." } }, required: ["taskIds"] },
+    async execute(input) {
+      const i = input;
+      const results = await director.awaitTasks(i.taskIds);
+      return { results };
     }
   };
 }
-function makeFleetSessionTool(director) {
+function makeAskTool(director) {
   return {
-    name: "fleet_session",
-    description: "Read a subagent's JSONL transcript and extract its last assistant text, stop reason, and tool-use count. Use this to see what a running or timed-out subagent actually produced.",
+    name: "ask_subagent",
+    description: "Synchronously ask a subagent a question. Blocks until the subagent replies via the bridge.",
     permission: "auto",
     mutating: false,
     inputSchema: {
       type: "object",
       properties: {
-        subagentId: { type: "string", description: "Subagent id to read the transcript of." },
-        tail: { type: "number", description: "Number of trailing JSONL lines to return. Omit for the full transcript." }
+        subagentId: { type: "string", minLength: 1, description: "Subagent to ask. Must be a previously spawned id." },
+        question: { type: "string", minLength: 1, description: "The question or instruction." },
+        timeoutMs: { type: "number", minimum: 1, description: "Optional timeout in ms (default 30s)." }
+      },
+      required: ["subagentId", "question"]
+    },
+    async execute(input) {
+      const i = input;
+      try {
+        const answer = await director.ask(i.subagentId, { question: i.question }, i.timeoutMs);
+        const stored = director.largeAnswerStore.storeAnswer(answer);
+        if (stored.inline) {
+          return { ok: true, answer: stored.summary };
+        }
+        return {
+          ok: true,
+          answer: stored.summary,
+          _answerKey: stored.key,
+          _hint: "Response was large and stored. Use ask_result with the key to retrieve it."
+        };
+      } catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+      }
+    }
+  };
+}
+function makeAskResultTool(director) {
+  return {
+    name: "ask_result",
+    description: "Retrieve a large `ask_subagent` response that was stored out-of-context (>2K chars). Returns the full stored value.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: {
+      type: "object",
+      properties: {
+        key: {
+          type: "string",
+          minLength: 1,
+          description: "The `_answerKey` returned by `ask_subagent` for a large response."
+        }
+      },
+      required: ["key"]
+    },
+    async execute(input) {
+      const i = input;
+      const value = director.largeAnswerStore.retrieveAnswer(i.key);
+      if (value === void 0) {
+        return { ok: false, error: `No stored answer found for key "${i.key}" \u2014 it may have been cleared or the key is invalid.` };
+      }
+      return { ok: true, value };
+    }
+  };
+}
+function makeRollUpTool(director) {
+  return {
+    name: "roll_up",
+    description: "Aggregate completed task results into a single formatted summary.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskIds: { type: "array", items: { type: "string" }, description: "Completed task ids to aggregate." },
+        style: { type: "string", enum: ["markdown", "json"], description: "Output flavor \u2014 markdown (default) or json." }
+      },
+      required: ["taskIds"]
+    },
+    async execute(input) {
+      const i = input;
+      const summary = director.rollUp(i.taskIds, i.style ?? "markdown");
+      return { summary, count: i.taskIds.length };
+    }
+  };
+}
+function makeTerminateTool(director) {
+  return {
+    name: "terminate_subagent",
+    description: 'Forcibly abort a subagent. The subagent finishes its current iteration then exits with status "stopped".',
+    permission: "auto",
+    mutating: true,
+    inputSchema: { type: "object", properties: { subagentId: { type: "string", description: "Subagent to abort." } }, required: ["subagentId"] },
+    async execute(input) {
+      const i = input;
+      await director.terminate(i.subagentId);
+      return { ok: true };
+    }
+  };
+}
+function makeTerminateAllTool(director) {
+  return {
+    name: "terminate_all",
+    description: 'Forcibly stop every subagent in the fleet and drain the pending task queue. In-flight tasks are terminated mid-execution; pending tasks receive "aborted_by_parent" completion immediately. Use this when the fleet is wedged, looping, or you need a clean slate. Compare: work_complete stops spawning but lets running agents finish naturally.',
+    permission: "auto",
+    mutating: true,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      await director.terminateAll();
+      return { ok: true, message: `Fleet shutdown complete \u2014 all subagents stopped, pending tasks drained.` };
+    }
+  };
+}
+function makeFleetStatusTool(director) {
+  return {
+    name: "fleet_status",
+    description: "Snapshot of the fleet \u2014 every subagent's current status, coordinator counts (total/running/idle/stopped), pending task descriptions, and usage rollup.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      const base = director.status();
+      const fm = director.fleetManager;
+      const stats = fm?.getFleetStats();
+      const fleetStatus = fm?.getFleetStatus();
+      return {
+        subagents: base.subagents,
+        coordinatorStats: stats ? { total: stats.total, running: stats.running, idle: stats.idle, stopped: stats.stopped } : void 0,
+        pending: fleetStatus?.pending ?? [],
+        usage: fm?.snapshot()
+      };
+    }
+  };
+}
+function makeFleetUsageTool(director) {
+  return {
+    name: "fleet_usage",
+    description: "Token + cost breakdown across the fleet, per-subagent and totals.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      return director.snapshot();
+    }
+  };
+}
+function makeFleetSessionTool(director) {
+  return {
+    name: "fleet_session",
+    description: "Read a subagent's JSONL transcript and extract its last assistant text, stop reason, and tool-use count. Use this to see what a running or timed-out subagent actually produced.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: {
+      type: "object",
+      properties: {
+        subagentId: { type: "string", description: "Subagent id to read the transcript of." },
+        tail: { type: "number", description: "Number of trailing JSONL lines to return. Omit for the full transcript." }
       },
       required: ["subagentId"]
     },
@@ -14403,601 +14728,358 @@ function makeCollabDebugTool(director) {
         targetPaths: i.targetPaths,
         timeoutMs: i.timeoutMs,
         maxTargetFiles: i.maxTargetFiles,
-        contextWindow: i.contextWindow
-      };
-      try {
-        const report = await director.spawnCollab(options);
-        return {
-          sessionId: report.sessionId,
-          overallVerdict: report.overallVerdict,
-          bugCount: report.bugs.length,
-          planCount: report.refactorPlans.length,
-          evaluationCount: report.evaluations.length,
-          summary: report.summary,
-          bugs: report.bugs,
-          refactorPlans: report.refactorPlans,
-          evaluations: report.evaluations
-        };
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return { error: "collab_debug failed: " + msg };
-      }
-    }
-  };
-}
-function makeFleetEmitTool(director) {
-  return {
-    name: "fleet_emit",
-    description: "Emit a structured event on the FleetBus. Any subagent can emit any event type; the Director routes it to all listeners. Use it to stream findings, progress updates, or final results to other agents in real time.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        type: {
-          type: "string",
-          description: "Event type string (e.g. bug.found, refactor.plan, critic.evaluation, progress, result)."
-        },
-        payload: {
-          type: "object",
-          description: "Event payload. Structure depends on event type. Use null if no payload."
-        }
-      },
-      required: ["type"]
-    },
-    async execute(input) {
-      const i = input;
-      director.fleet.emit({
-        subagentId: director.id,
-        ts: Date.now(),
-        type: i.type,
-        payload: i.payload ?? {}
-      });
-      return { ok: true, event: i.type };
-    }
-  };
-}
-function makeWorkCompleteTool(director) {
-  return {
-    name: "work_complete",
-    description: "Signal that the director is satisfied with the results and the fleet should wind down. After calling this, spawn_subagent will refuse with a budget error and assign_task will instantly complete any queued tasks as aborted. Running subagents finish naturally. Call terminate_subagent separately to stop specific subagents immediately.",
-    permission: "auto",
-    mutating: false,
-    inputSchema: { type: "object", properties: {}, required: [] },
-    async execute() {
-      director.workComplete();
-      return { ok: true, message: "Fleet wind-down signaled. No new spawns or task dispatches." };
-    }
-  };
-}
-var DEFAULT_MAX_TARGET_FILES = 30;
-var CollabSession = class extends EventEmitter {
-  sessionId;
-  options;
-  snapshot;
-  director;
-  fleetBus;
-  subagentIds = /* @__PURE__ */ new Map();
-  // role → subagentId
-  bugs = /* @__PURE__ */ new Map();
-  plans = /* @__PURE__ */ new Map();
-  evaluations = /* @__PURE__ */ new Map();
-  disposers = new Array();
-  settled = false;
-  timeoutMs;
-  cancelled = false;
-  alerts = [];
-  /** Tracks tool call counts per subagent for progress-based timeout decisions. */
-  progressBySubagent = /* @__PURE__ */ new Map();
-  /** Last tool call count when a timeout warning was handled. */
-  lastTimeoutProgress = /* @__PURE__ */ new Map();
-  /** Session-level timeout timer handle (cleared on cancel or natural completion). */
-  _timeoutTimer;
-  constructor(director, fleetBus, options) {
-    super();
-    this.sessionId = randomUUID();
-    this.options = options;
-    this.director = director;
-    this.fleetBus = fleetBus;
-    this.timeoutMs = options.timeoutMs ?? 10 * 60 * 1e3;
-    if (options.prebuiltSnapshot) {
-      this.snapshot = options.prebuiltSnapshot;
-    } else {
-      this.snapshot = {
-        id: this.sessionId,
-        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-        files: []
-      };
-    }
-  }
-  get id() {
-    return this.sessionId;
-  }
-  getSessionAlerts() {
-    return [...this.alerts];
-  }
-  isCancelled() {
-    return this.cancelled;
-  }
-  /**
-   * Snapshot of role → subagentId map. The Director calls coordinator.stop()
-   * for each agent when cancelling the session, using this map to enumerate
-   * all three collab agents.
-   */
-  getSubagentIds() {
-    return new Map(this.subagentIds);
-  }
-  /**
-   * Returns the effective file limit for this session.
-   * Priority: explicit `maxTargetFiles` > dynamic from `contextWindow` > `DEFAULT_MAX_TARGET_FILES`.
-   */
-  effectiveFileLimit() {
-    if (this.options.maxTargetFiles !== void 0) {
-      return this.options.maxTargetFiles;
-    }
-    if (this.options.contextWindow !== void 0) {
-      return Math.max(5, Math.floor(this.options.contextWindow * 0.4 / 2e3));
-    }
-    return DEFAULT_MAX_TARGET_FILES;
-  }
-  async buildSnapshot() {
-    if (this.snapshot.files.length > 0) return this.snapshot;
-    const allFiles = [];
-    for (const pattern of this.options.targetPaths) {
-      const expanded = await expandGlob(pattern);
-      allFiles.push(...expanded);
-    }
-    const limit = this.effectiveFileLimit();
-    if (allFiles.length > limit) {
-      const hint = this.options.contextWindow ? `contextWindow=${this.options.contextWindow} \u2192 calculated limit=${limit}` : `default limit=${DEFAULT_MAX_TARGET_FILES}`;
-      throw new Error(
-        `[collab_debug] Target has ${allFiles.length} files, which exceeds the limit (${hint}). Narrow the target or pass maxTargetFiles / contextWindow to override. For large codebases, run package-by-package or module-by-module sessions instead of targeting the entire repo.`
-      );
-    }
-    for (const filePath of allFiles) {
-      try {
-        const content = await fsp3.readFile(filePath, "utf8");
-        const ext = filePath.split(".").pop() ?? "";
-        const language = ext === "ts" || ext === "tsx" ? "typescript" : ext === "js" || ext === "jsx" ? "javascript" : ext === "md" ? "markdown" : ext === "json" ? "json" : void 0;
-        this.snapshot.files.push({ path: filePath, content, language });
-      } catch {
-        this.snapshot.files.push({ path: filePath, content: "", language: void 0 });
-      }
-    }
-    return this.snapshot;
-  }
-  /**
-   * Cancel the session. Emits director.cancel_collab on the FleetBus so all
-   * collab agents finish early. The session-level timeout timer is also cleared.
-   * Safe to call multiple times (idempotent after first call).
-   */
-  cancel(reason = "Director cancelled collab session") {
-    if (this.settled) return;
-    this.cancelled = true;
-    if (this._timeoutTimer) {
-      clearTimeout(this._timeoutTimer);
-      this._timeoutTimer = void 0;
-    }
-    this.fleetBus.emit({
-      subagentId: this.director.id,
-      ts: Date.now(),
-      type: "director.cancel_collab",
-      payload: { sessionId: this.sessionId, reason, cancelledAt: (/* @__PURE__ */ new Date()).toISOString() }
-    });
-    this.fleetBus.emit({
-      subagentId: this.director.id,
-      ts: Date.now(),
-      type: "collab.cancelled",
-      payload: { sessionId: this.sessionId, reason }
-    });
-  }
-  async start() {
-    if (this.settled) throw new Error("session already settled");
-    this.settled = true;
-    await this.buildSnapshot();
-    this.wireFleetBus();
-    const [bugHunterId, refactorPlannerId, criticId] = await Promise.all([
-      this.spawnAgent("bug-hunter", this.buildBugHunterTask()),
-      this.spawnAgent("refactor-planner", this.buildRefactorPlannerTask()),
-      this.spawnAgent("critic", this.buildCriticTask())
-    ]);
-    this.subagentIds.set("bug-hunter", bugHunterId);
-    this.subagentIds.set("refactor-planner", refactorPlannerId);
-    this.subagentIds.set("critic", criticId);
-    const timeout = new Promise((_, reject) => {
-      this._timeoutTimer = setTimeout(() => {
-        this.cancel("Session-level timeout reached");
-        reject(new Error(`CollabSession timed out after ${this.timeoutMs}ms`));
-      }, this.timeoutMs);
-    });
-    let results = null;
-    try {
-      results = await Promise.race([
-        Promise.all([
-          this.director.awaitTasks([bugHunterId]),
-          this.director.awaitTasks([refactorPlannerId]),
-          this.director.awaitTasks([criticId])
-        ]),
-        timeout
-      ]);
-    } catch (err) {
-      if (this._timeoutTimer) {
-        clearTimeout(this._timeoutTimer);
-        this._timeoutTimer = void 0;
-      }
-      this.cleanup();
-      const error = err instanceof Error ? err : new Error(String(err));
-      this.emit("session.error", error);
-      throw error;
-    }
-    for (const result of results.flat()) {
-      await this.parseAndEmit(result);
-    }
-    const report = this.assembleReport();
-    this.cleanup();
-    this.emit("session.done", report);
-    return report;
-  }
-  async parseAndEmit(result) {
-    if (result.status !== "success" || result.result == null) return;
-    const text = typeof result.result === "string" ? result.result : JSON.stringify(result.result);
-    for (const obj of this.extractJsonObjects(text)) {
-      const type = "finding" in obj ? "bug.found" : "plan" in obj ? "refactor.plan" : "evaluation" in obj ? "critic.evaluation" : null;
-      if (!type) continue;
-      this.fleetBus.emit({
-        subagentId: result.subagentId,
-        taskId: result.taskId,
-        ts: Date.now(),
-        type,
-        payload: obj
-      });
-    }
-  }
-  extractJsonObjects(text) {
-    const objects = [];
-    let depth = 0;
-    let start = -1;
-    let inString = false;
-    let escaped = false;
-    for (let i = 0; i < text.length; i++) {
-      const ch = text[i];
-      if (inString) {
-        if (escaped) escaped = false;
-        else if (ch === "\\") escaped = true;
-        else if (ch === '"') inString = false;
-        continue;
-      }
-      if (ch === '"') {
-        inString = true;
-      } else if (ch === "{") {
-        if (depth === 0) start = i;
-        depth++;
-      } else if (ch === "}" && depth > 0) {
-        depth--;
-        if (depth === 0 && start >= 0) {
-          const candidate = text.slice(start, i + 1);
-          try {
-            const parsed = JSON.parse(candidate);
-            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-              objects.push(parsed);
-            }
-          } catch {
-          }
-          start = -1;
-        }
-      }
-    }
-    return objects;
-  }
-  budgetForRole(role) {
-    if (this.options.budgetOverrides?.[role]) {
-      return this.options.budgetOverrides[role];
-    }
-    const defaults = {
-      "bug-hunter": { maxIterations: 2e3, maxToolCalls: 5e3, timeoutMs: 10 * 60 * 1e3 },
-      "refactor-planner": { maxIterations: 1500, maxToolCalls: 4e3, timeoutMs: 8 * 60 * 1e3 },
-      "critic": { maxIterations: 1e3, maxToolCalls: 3e3, timeoutMs: 6 * 60 * 1e3 }
-    };
-    return defaults[role] ?? { maxIterations: 1500, maxToolCalls: 4e3, timeoutMs: 8 * 60 * 1e3 };
-  }
-  async spawnAgent(role, taskBrief) {
-    const budget = this.budgetForRole(role);
-    const cfg = {
-      id: `${role}-${this.sessionId}`,
-      name: role,
-      role,
-      tools: ["fleet_emit", "fleet_status", "read", "grep", "glob", "bash", "write"],
-      maxIterations: budget.maxIterations,
-      maxToolCalls: budget.maxToolCalls,
-      timeoutMs: budget.timeoutMs
-    };
-    const subagentId = await this.director.spawn(cfg);
-    await this.director.assign({ id: randomUUID(), subagentId, description: taskBrief });
-    return subagentId;
-  }
-  buildBugHunterTask() {
-    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
-    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
-${f.content}`).join("\n\n");
-    return `You are BugHunter. Scan the following files for bugs and code smells.
-
-Target files:
-${fileContents}
-
-For each bug found, emit it using the fleet_emit tool immediately:
-{ "type": "bug.found", "payload": { "finding": { "id": "<uuid>", "type": "<pattern>", "severity": "<critical|high|medium|low>", "location": { "file": "<path>", "line": <n> }, "description": "<explain>", "suggestedFix": "<optional>" } } }
-
-After scanning all files, write your full markdown bug report to:
-${scratchpad}/bug-hunter-report-${this.sessionId}.md
-
-Important: emit each finding as soon as you find it. Do not batch or wait until the end.`;
-  }
-  buildRefactorPlannerTask() {
-    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
-    const bugHunterReportPath = `${scratchpad}/bug-hunter-report-${this.sessionId}.md`;
-    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
-${f.content}`).join("\n\n");
-    return `You are RefactorPlanner. Plan refactorings for the following files.
-
-Target files:
-${fileContents}
-
-Read the BugHunter report at: ${bugHunterReportPath}
-
-For each bug you can address, emit a refactor plan using fleet_emit:
-{ "type": "refactor.plan", "payload": { "plan": { "id": "<uuid>", "basedOnBugIds": ["<bug-id>"], "phases": [{ "number": 1, "title": "<phase>", "tasks": ["<task>"], "risk": "<low|medium|high>" }], "riskScore": "<low|medium|high>", "estimatedChangeCount": <n>, "rollbackStrategy": "<text>" } } }
-
-Also write your full markdown plan to:
-${scratchpad}/refactor-plan-${this.sessionId}.md
-
-Emit each plan immediately. Do not wait until planning is complete.`;
-  }
-  buildCriticTask() {
-    const scratchpad = this.director.sharedScratchpadPath ?? "/tmp";
-    const bugHunterReportPath = `${scratchpad}/bug-hunter-report-${this.sessionId}.md`;
-    const refactorPlanPath = `${scratchpad}/refactor-plan-${this.sessionId}.md`;
-    const fileContents = this.snapshot.files.map((f) => `=== ${f.path} ===
-${f.content}`).join("\n\n");
-    return `You are Critic. Evaluate bug findings and refactor plans.
-
-Target files:
-${fileContents}
-
-Read the BugHunter report at: ${bugHunterReportPath}
-Read the RefactorPlanner report at: ${refactorPlanPath}
-
-For each bug and refactor plan, emit your evaluation using fleet_emit:
-{ "type": "critic.evaluation", "payload": { "evaluation": { "id": "<uuid>", "subjectType": "<bug_finding|refactor_plan>", "subjectId": "<id>", "score": <0-10>, "verdict": "<approve|needs_revision|reject>", "strengths": ["<strength>"], "weaknesses": ["<weakness>"], "concerns": [{ "description": "<concern>", "severity": "<blocking|advisory>" }] } } }
-
-After all evaluations, write your markdown report to:
-${scratchpad}/critic-report-${this.sessionId}.md
-
-Emit each evaluation immediately. Do not wait until you have read all reports.`;
-  }
-  wireFleetBus() {
-    const dTool = this.fleetBus.filter("tool.executed", (e) => {
-      this.progressBySubagent.set(e.subagentId, (this.progressBySubagent.get(e.subagentId) ?? 0) + 1);
-    });
-    this.disposers.push(dTool);
-    const dBudget = this.fleetBus.filter("budget.threshold_reached", (e) => {
-      const payload = e.payload;
-      const role = this.roleFromSubagentId(e.subagentId);
-      if (!role) return;
-      const btwNotes = this.director.getLeaderBtwNotes();
-      const alert = {
-        sessionId: this.sessionId,
-        subagentId: e.subagentId,
-        role,
-        level: "warning" /* WARNING */,
-        message: `${role} hit ${payload.kind} soft limit (${payload.used}/${payload.limit})`,
-        budgetKind: payload.kind,
-        elapsedMs: payload.timeoutMs,
-        limit: payload.limit,
-        btwNotes
-      };
-      this.alerts.push(alert);
-      this.fleetBus.emit({
-        subagentId: e.subagentId,
-        ts: Date.now(),
-        type: "collab.warning",
-        payload: alert
-      });
-      const decision = this.options.onBudgetWarning?.(alert) ?? "ignore";
-      if (decision === "cancel") {
-        this.cancel(`Director cancelled: ${role} ${payload.kind} threshold`);
-        return;
-      }
-      if (payload.kind === "timeout" || payload.kind === "idle_timeout") {
-        const progress = this.progressBySubagent.get(e.subagentId) ?? 0;
-        const lastProgress = this.lastTimeoutProgress.get(e.subagentId) ?? -1;
-        if (progress <= lastProgress) {
-          payload.deny();
-          return;
-        }
-        this.lastTimeoutProgress.set(e.subagentId, progress);
-        const newLimit = Math.min(Math.ceil((payload.timeoutMs ?? payload.limit) * 2), 24 * 60 * 6e4);
-        setImmediate(() => {
-          payload.extend({ timeoutMs: newLimit });
-        });
-        return;
-      }
-      if (decision === "extend") {
-        setImmediate(() => {
-          const base = Math.max(payload.limit, payload.used);
-          const extra = {};
-          switch (payload.kind) {
-            case "iterations":
-              extra.maxIterations = Math.min(Math.ceil(base * 1.5), 5e4);
-              break;
-            case "tool_calls":
-              extra.maxToolCalls = Math.min(Math.ceil(base * 1.5), 1e5);
-              break;
-            case "tokens":
-              extra.maxTokens = Math.min(Math.ceil(base * 1.5), 5e6);
-              break;
-            case "cost":
-              extra.maxCostUsd = Math.min(base * 1.5, 100);
-              break;
-          }
-          payload.extend(extra);
-        });
-        return;
-      }
-      if (payload.kind !== "timeout") {
-        setImmediate(() => {
-          const base = Math.max(payload.limit, payload.used);
-          const extra = {};
-          switch (payload.kind) {
-            case "iterations":
-              extra.maxIterations = Math.min(Math.ceil(base * 1.25), 5e4);
-              break;
-            case "tool_calls":
-              extra.maxToolCalls = Math.min(Math.ceil(base * 1.25), 1e5);
-              break;
-            case "tokens":
-              extra.maxTokens = Math.min(Math.ceil(base * 1.25), 5e6);
-              break;
-            case "cost":
-              extra.maxCostUsd = Math.min(base * 1.25, 100);
-              break;
-          }
-          payload.extend(extra);
-        });
-      }
-    });
-    this.disposers.push(dBudget);
-    const dCancel = this.fleetBus.filter("director.cancel_collab", (e) => {
-      const payload = e.payload;
-      if (payload.sessionId !== this.sessionId) return;
-      this.cancelled = true;
-      if (this._timeoutTimer) {
-        clearTimeout(this._timeoutTimer);
-        this._timeoutTimer = void 0;
+        contextWindow: i.contextWindow
+      };
+      try {
+        const report = await director.spawnCollab(options);
+        return {
+          sessionId: report.sessionId,
+          overallVerdict: report.overallVerdict,
+          bugCount: report.bugs.length,
+          planCount: report.refactorPlans.length,
+          evaluationCount: report.evaluations.length,
+          summary: report.summary,
+          bugs: report.bugs,
+          refactorPlans: report.refactorPlans,
+          evaluations: report.evaluations
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { error: "collab_debug failed: " + msg };
       }
-      this.fleetBus.emit({
-        subagentId: this.director.id,
+    }
+  };
+}
+function makeFleetEmitTool(director) {
+  return {
+    name: "fleet_emit",
+    description: "Emit a structured event on the FleetBus. Any subagent can emit any event type; the Director routes it to all listeners. Use it to stream findings, progress updates, or final results to other agents in real time.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          description: "Event type string (e.g. bug.found, refactor.plan, critic.evaluation, progress, result)."
+        },
+        payload: {
+          type: "object",
+          description: "Event payload. Structure depends on event type. Use null if no payload."
+        }
+      },
+      required: ["type"]
+    },
+    async execute(input) {
+      const i = input;
+      director.fleet.emit({
+        subagentId: director.id,
         ts: Date.now(),
-        type: "collab.cancelled",
-        payload: { sessionId: this.sessionId, reason: payload.reason }
+        type: i.type,
+        payload: i.payload ?? {}
       });
+      return { ok: true, event: i.type };
+    }
+  };
+}
+function makeWorkCompleteTool(director) {
+  return {
+    name: "work_complete",
+    description: "Signal that the director is satisfied with the results and the fleet should wind down. After calling this, spawn_subagent will refuse with a budget error and assign_task will instantly complete any queued tasks as aborted. Running subagents finish naturally. Call terminate_subagent separately to stop specific subagents immediately.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      director.workComplete();
+      return { ok: true, message: "Fleet wind-down signaled. No new spawns or task dispatches." };
+    }
+  };
+}
+
+// src/coordination/fleet-bus.ts
+var FleetBus = class {
+  byId = /* @__PURE__ */ new Map();
+  byType = /* @__PURE__ */ new Map();
+  any = /* @__PURE__ */ new Set();
+  /**
+   * Hook a subagent's EventBus into the fleet. Uses `onAny()` (an alias for
+   * `onPattern('*')`) to forward all events with subagent attribution, so
+   * new kernel event types are automatically forwarded without any manual
+   * registration. `subagent.*` events are excluded because they originate
+   * from MultiAgentHost on the parent bus, not the subagent's own bus.
+   *
+   * Returns a disposer that detaches every subscription; call on
+   * subagent teardown so the listeners don't outlive the run.
+   */
+  attach(subagentId, bus, taskId) {
+    const off = bus.onAny((type, payload) => {
+      if (type.startsWith("subagent.")) return;
+      this.emit({ subagentId, taskId, ts: Date.now(), type, payload });
     });
-    this.disposers.push(dCancel);
-    const d1 = this.fleetBus.filter("bug.found", (e) => {
-      const payload = e.payload;
-      if (payload?.finding) {
-        this.bugs.set(payload.finding.id, payload.finding);
-        this.emit("bug.found", payload);
+    return () => {
+      off();
+    };
+  }
+  /** Subscribe to every event from one subagent. */
+  subscribe(subagentId, handler) {
+    let set = this.byId.get(subagentId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.byId.set(subagentId, set);
+    }
+    set.add(handler);
+    return () => {
+      set.delete(handler);
+    };
+  }
+  /** Subscribe to one event type across all subagents. */
+  filter(type, handler) {
+    let set = this.byType.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.byType.set(type, set);
+    }
+    set.add(handler);
+    return () => {
+      set.delete(handler);
+    };
+  }
+  /** Subscribe to literally everything. The fleet roll-up uses this. */
+  onAny(handler) {
+    this.any.add(handler);
+    return () => {
+      this.any.delete(handler);
+    };
+  }
+  emit(event) {
+    const byId = this.byId.get(event.subagentId);
+    if (byId)
+      for (const h of byId) {
+        try {
+          h(event);
+        } catch {
+        }
       }
-    });
-    this.disposers.push(d1);
-    const d2 = this.fleetBus.filter("refactor.plan", (e) => {
-      const payload = e.payload;
-      if (payload?.plan) {
-        this.plans.set(payload.plan.id, payload.plan);
-        this.emit("refactor.plan", payload);
+    const byType = this.byType.get(event.type);
+    if (byType)
+      for (const h of byType) {
+        try {
+          h(event);
+        } catch {
+        }
       }
-    });
-    this.disposers.push(d2);
-    const d3 = this.fleetBus.filter("critic.evaluation", (e) => {
-      const payload = e.payload;
-      if (payload?.evaluation) {
-        this.evaluations.set(payload.evaluation.id, payload.evaluation);
-        this.emit("critic.evaluation", payload);
+    for (const h of this.any) {
+      try {
+        h(event);
+      } catch {
       }
-    });
-    this.disposers.push(d3);
+    }
+  }
+};
+var FleetUsageAggregator = class {
+  constructor(bus, priceLookup, metaLookup) {
+    this.priceLookup = priceLookup;
+    this.metaLookup = metaLookup;
+    this.unsub.push(bus.filter("provider.response", (e) => this.onProviderResponse(e)));
+    this.unsub.push(bus.filter("tool.executed", (e) => this.onToolExecuted(e)));
+    this.unsub.push(bus.filter("iteration.started", (e) => this.onIterationStarted(e)));
+  }
+  priceLookup;
+  metaLookup;
+  perSubagent = /* @__PURE__ */ new Map();
+  total = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+  unsub = new Array();
+  /**
+   * Remove a terminated subagent's data from the aggregator and subtract its
+   * contribution from the running totals. Call this when a subagent is removed
+   * from the fleet so the aggregator doesn't accumulate unbounded data for
+   * entities that will never emit events again.
+   */
+  removeSubagent(subagentId) {
+    const snap = this.perSubagent.get(subagentId);
+    if (!snap) return;
+    this.perSubagent.delete(subagentId);
+    this.total.input -= snap.input;
+    this.total.output -= snap.output;
+    this.total.cacheRead -= snap.cacheRead;
+    this.total.cacheWrite -= snap.cacheWrite;
+    this.total.cost -= snap.cost;
+  }
+  /** Disposes all fleet-bus subscriptions. Call when the aggregator is no longer needed. */
+  dispose() {
+    for (const off of this.unsub) off();
+    this.unsub.length = 0;
+  }
+  /** Live snapshot — safe to call from a tool's execute() body. */
+  snapshot() {
+    return {
+      total: { ...this.total },
+      perSubagent: Object.fromEntries(
+        Array.from(this.perSubagent.entries()).map(([k, v]) => [k, { ...v }])
+      )
+    };
+  }
+  ensure(subagentId) {
+    let snap = this.perSubagent.get(subagentId);
+    if (!snap) {
+      const meta = this.metaLookup?.(subagentId);
+      snap = {
+        subagentId,
+        provider: meta?.provider,
+        model: meta?.model,
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        cost: 0,
+        toolCalls: 0,
+        iterations: 0,
+        startedAt: Date.now(),
+        lastEventAt: Date.now()
+      };
+      this.perSubagent.set(subagentId, snap);
+    }
+    return snap;
+  }
+  onProviderResponse(e) {
+    const snap = this.ensure(e.subagentId);
+    const p = e.payload;
+    const usage = p?.usage;
+    if (!usage) return;
+    snap.input += usage.input ?? 0;
+    snap.output += usage.output ?? 0;
+    snap.cacheRead += usage.cacheRead ?? 0;
+    snap.cacheWrite += usage.cacheWrite ?? 0;
+    this.total.input += usage.input ?? 0;
+    this.total.output += usage.output ?? 0;
+    this.total.cacheRead += usage.cacheRead ?? 0;
+    this.total.cacheWrite += usage.cacheWrite ?? 0;
+    const price = this.priceLookup?.(e.subagentId, snap.provider, snap.model);
+    if (price) {
+      const delta = (usage.input ?? 0) / 1e6 * (price.input ?? 0) + (usage.output ?? 0) / 1e6 * (price.output ?? 0) + (usage.cacheRead ?? 0) / 1e6 * (price.cacheRead ?? 0) + (usage.cacheWrite ?? 0) / 1e6 * (price.cacheWrite ?? 0);
+      snap.cost += delta;
+      this.total.cost += delta;
+    }
+    snap.lastEventAt = e.ts;
+  }
+  onToolExecuted(e) {
+    const snap = this.ensure(e.subagentId);
+    snap.toolCalls += 1;
+    snap.lastEventAt = e.ts;
   }
-  roleFromSubagentId(subagentId) {
-    for (const [role, id] of this.subagentIds) {
-      if (id === subagentId) return role;
-    }
-    const match = subagentId.match(/^(bug-hunter|refactor-planner|critic)/);
-    return match?.[1] ?? null;
+  onIterationStarted(e) {
+    const snap = this.ensure(e.subagentId);
+    snap.iterations += 1;
+    snap.lastEventAt = e.ts;
   }
-  assembleReport() {
-    const bugList = Array.from(this.bugs.values());
-    const planList = Array.from(this.plans.values());
-    const evalList = Array.from(this.evaluations.values());
-    let disposition = "completed";
-    if (this.cancelled) disposition = "cancelled";
-    const verdictOrder = {
-      approve: 0,
-      needs_revision: 1,
-      reject: 2
-    };
-    const overallVerdict = evalList.reduce(
-      (worst, eval_) => {
-        const w = verdictOrder[worst];
-        const c = verdictOrder[eval_.verdict];
-        return c > w ? eval_.verdict : worst;
-      },
-      "approve"
-    );
-    const summary = this.buildMarkdownSummary(bugList, planList, evalList, overallVerdict, disposition);
-    return {
-      sessionId: this.sessionId,
-      startedAt: this.snapshot.createdAt,
-      completedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      targetPaths: this.options.targetPaths,
-      disposition,
-      bugs: bugList,
-      refactorPlans: planList,
-      evaluations: evalList,
-      alerts: [...this.alerts],
-      overallVerdict,
-      summary
-    };
+};
+
+// src/coordination/large-answer-store.ts
+var LargeAnswerStore = class {
+  /**
+   * Responses above this size (in characters) are stored out-of-context.
+   * Below this, the full answer is returned inline (no overhead).
+   * Default: 2000 chars ≈ 400-600 tokens.
+   */
+  sizeThreshold;
+  store = /* @__PURE__ */ new Map();
+  constructor(sizeThreshold = 2e3) {
+    this.sizeThreshold = sizeThreshold;
   }
-  buildMarkdownSummary(bugs, plans, evals, overallVerdict, disposition) {
-    const lines = [
-      `## Collaborative Debugging Report \u2014 ${this.sessionId}`,
-      "",
-      `**Target:** ${this.options.targetPaths.join(", ")}`,
-      `**Disposition:** ${disposition.toUpperCase()}`,
-      `**Overall Verdict:** **${overallVerdict.toUpperCase()}**`,
-      ""
-    ];
-    if (this.alerts.length > 0) {
-      lines.push("### Alerts", "");
-      for (const alert of this.alerts) {
-        lines.push(`- **[${alert.level.toUpperCase()}]** ${alert.role}: ${alert.message}`);
-      }
-      lines.push("");
-    }
-    if (bugs.length > 0) {
-      lines.push("### Bugs Found", "");
-      for (const b of bugs) {
-        lines.push(`- **[${b.severity.toUpperCase()}]** \`${b.location.file}:${b.location.line}\` \u2014 ${b.description}`);
-      }
-      lines.push("");
-    }
-    if (plans.length > 0) {
-      lines.push("### Refactor Plans", "");
-      for (const p of plans) {
-        lines.push(`- **Phase plan** (risk: ${p.riskScore}, ~${p.estimatedChangeCount} changes)`);
-        for (const phase of p.phases) {
-          lines.push(`  - Phase ${phase.number}: ${phase.title} [${phase.risk}]`);
-        }
-      }
-      lines.push("");
+  /**
+   * Store a value, returning a summary + key for inline use.
+   * If the value is below sizeThreshold, returns it as-is (no store entry).
+   */
+  storeAnswer(value) {
+    if (value === void 0 || value === null) {
+      return { summary: String(value), inline: true };
     }
-    if (evals.length > 0) {
-      lines.push("### Critic Evaluations", "");
-      for (const e of evals) {
-        lines.push(`- [${e.subjectType}] score=${e.score}/10 \u2014 **${e.verdict.toUpperCase()}**`);
-        for (const c of e.concerns) {
-          if (c.severity === "blocking") lines.push(`  - ${c.description}`);
-        }
-      }
-      lines.push("");
+    const serialized = typeof value === "string" ? value : JSON.stringify(value);
+    const size = serialized.length;
+    if (size <= this.sizeThreshold) {
+      return { summary: serialized.slice(0, 500), inline: true };
     }
-    return lines.join("\n");
+    const key = `a-${hashStr(serialized)}`;
+    this.store.set(key, {
+      key,
+      value,
+      size,
+      storedAt: Date.now()
+    });
+    return {
+      key,
+      summary: `[stored: ${size} chars \u2014 use roll_up or ask_result tool to retrieve, key=${key}]`,
+      inline: false
+    };
   }
-  cleanup() {
-    for (const dispose of this.disposers) dispose();
-    this.disposers.length = 0;
+  /**
+   * Retrieve a previously stored answer by its key.
+   * Returns undefined if the key is unknown or the store was cleared.
+   */
+  retrieveAnswer(key) {
+    return this.store.get(key)?.value;
+  }
+  /**
+   * Check if a key exists in the store.
+   */
+  hasAnswer(key) {
+    return this.store.has(key);
+  }
+  /** Number of stored entries. */
+  get size() {
+    return this.store.size;
+  }
+  /** Total characters stored. */
+  get totalChars() {
+    let total = 0;
+    for (const e of this.store.values()) total += e.size;
+    return total;
+  }
+  /** Clear all stored entries. Call at the end of a director run. */
+  clear() {
+    this.store.clear();
   }
 };
+function hashStr(s) {
+  let h = 5381;
+  for (let i = 0; i < s.length; i++) {
+    h = h * 33 ^ s.charCodeAt(i);
+  }
+  return (h >>> 0).toString(36);
+}
+
+// src/coordination/model-matrix.ts
+var MATRIX_PHASE_KEYS = Object.keys(AGENTS_BY_PHASE);
+var ROLE_TO_PHASE = (() => {
+  const map = {};
+  for (const [phase, defs] of Object.entries(AGENTS_BY_PHASE)) {
+    for (const def of defs) {
+      const role = def.config.role;
+      if (role) map[role] = phase;
+    }
+  }
+  return map;
+})();
+function phaseForRole(role) {
+  return role ? ROLE_TO_PHASE[role] : void 0;
+}
+function resolveModelMatrix(matrix, role) {
+  if (!matrix) return void 0;
+  if (role && matrix[role]) return matrix[role];
+  const phase = phaseForRole(role);
+  if (phase && matrix[phase]) return matrix[phase];
+  if (matrix["*"]) return matrix["*"];
+  return void 0;
+}
+function matrixKeyKind(key) {
+  if (key === "*") return "default";
+  if (key in AGENT_CATALOG) return "role";
+  if (MATRIX_PHASE_KEYS.includes(key)) return "phase";
+  return "unknown";
+}
+function isValidMatrixKey(key) {
+  return matrixKeyKind(key) !== "unknown";
+}
 
 // src/coordination/director.ts
 var FleetSpawnBudgetError = class extends Error {
@@ -15169,6 +15251,9 @@ var Director = class _Director {
   maxLeaderContextLoad;
   /** Provider's max context window in tokens. */
   maxContext;
+  /** Per-task model matrix (static record or live getter); resolved
+   *  per-spawn when no explicit model is set. */
+  modelMatrix;
   /**
    * When set by `workComplete()`, the director stops dispatching new tasks
    * and terminates all running subagents. Used when the director's LLM decides
@@ -15199,20 +15284,23 @@ var Director = class _Director {
     this.maxBudgetExtensions = opts.maxBudgetExtensions ?? 5;
     this.maxLeaderContextLoad = opts.maxLeaderContextLoad ?? 0.85;
     this.maxContext = opts.maxContext ?? 128e3;
+    this.modelMatrix = opts.modelMatrix;
     this.sessionsRoot = opts.sessionsRoot;
     this.directorRunId = opts.directorRunId ?? this.id;
-    this.stateCheckpoint = opts.stateCheckpointPath ? new DirectorStateCheckpoint(opts.stateCheckpointPath, {
-      directorRunId: this.id,
-      maxSpawns: opts.maxSpawns,
-      spawnDepth: this.spawnDepth,
-      maxSpawnDepth: this.maxSpawnDepth,
-      directorBudget: opts.directorBudget
-    }, opts.checkpointDebounceMs ?? 250) : null;
+    this.stateCheckpoint = opts.stateCheckpointPath ? new DirectorStateCheckpoint(
+      opts.stateCheckpointPath,
+      {
+        directorRunId: this.id,
+        maxSpawns: opts.maxSpawns,
+        spawnDepth: this.spawnDepth,
+        maxSpawnDepth: this.maxSpawnDepth,
+        directorBudget: opts.directorBudget
+      },
+      opts.checkpointDebounceMs ?? 250
+    ) : null;
     this.fleetManager = opts.fleetManager;
     if (this.sharedScratchpadPath) {
-      void fsp3.mkdir(this.sharedScratchpadPath, { recursive: true }).catch(
-        (err) => this.logShutdownError("shared_scratchpad_mkdir", err)
-      );
+      void fsp3.mkdir(this.sharedScratchpadPath, { recursive: true }).catch((err) => this.logShutdownError("shared_scratchpad_mkdir", err));
     }
     this.transport = new InMemoryBridgeTransport();
     this.bridge = new InMemoryAgentBridge(
@@ -15390,7 +15478,12 @@ var Director = class _Director {
    */
   workComplete() {
     this.workCompleteFlag = true;
-    this.fleet.emit({ subagentId: this.id, ts: Date.now(), type: "director.work_complete", payload: {} });
+    this.fleet.emit({
+      subagentId: this.id,
+      ts: Date.now(),
+      type: "director.work_complete",
+      payload: {}
+    });
   }
   /** Returns true if `workComplete()` has been called on this director. */
   isWorkComplete() {
@@ -15522,13 +15615,25 @@ var Director = class _Director {
         "workComplete() has been called \u2014 director closed further spawning"
       );
     }
+    if (!config.model && this.modelMatrix) {
+      const matrix = typeof this.modelMatrix === "function" ? this.modelMatrix() : this.modelMatrix;
+      const entry = resolveModelMatrix(matrix, config.role);
+      if (entry) {
+        config.model = entry.model;
+        if (entry.provider) config.provider = entry.provider;
+      }
+    }
     if (this.fleetManager) {
       const rejection = this.fleetManager.canSpawn(config);
       if (rejection) {
-        if (rejection.kind === "max_spawn_depth") throw new FleetSpawnBudgetError("max_spawn_depth", rejection.limit, rejection.observed);
-        if (rejection.kind === "max_spawns") throw new FleetSpawnBudgetError("max_spawns", rejection.limit, rejection.observed);
-        if (rejection.kind === "max_cost_usd") throw new FleetCostCapError(rejection.limit, rejection.observed);
-        if (rejection.kind === "max_context_load") throw new FleetContextOverflowError(rejection.limit, rejection.observed);
+        if (rejection.kind === "max_spawn_depth")
+          throw new FleetSpawnBudgetError("max_spawn_depth", rejection.limit, rejection.observed);
+        if (rejection.kind === "max_spawns")
+          throw new FleetSpawnBudgetError("max_spawns", rejection.limit, rejection.observed);
+        if (rejection.kind === "max_cost_usd")
+          throw new FleetCostCapError(rejection.limit, rejection.observed);
+        if (rejection.kind === "max_context_load")
+          throw new FleetContextOverflowError(rejection.limit, rejection.observed);
       }
     } else {
       if (this.spawnDepth >= this.maxSpawnDepth) {
@@ -15558,7 +15663,9 @@ var Director = class _Director {
         this.fleetManager.assignNicknameAndRecord(config);
       } else {
         config.name = assignNickname(role, this._usedNicknames);
-        this._usedNicknames.add(config.name.split(" ")[0].toLowerCase().replace(/[^a-z0-9-]/g, "-"));
+        this._usedNicknames.add(
+          config.name.split(" ")[0].toLowerCase().replace(/[^a-z0-9-]/g, "-")
+        );
       }
     }
     result = await this.coordinator.spawn(config);
@@ -15793,7 +15900,11 @@ var Director = class _Director {
         subagentId: taskWithId.subagentId ?? "unassigned",
         taskId: taskWithId.id,
         status: "stopped",
-        error: { kind: "aborted_by_parent", message: "Director called workComplete() \u2014 no further tasks will run", retryable: false },
+        error: {
+          kind: "aborted_by_parent",
+          message: "Director called workComplete() \u2014 no further tasks will run",
+          retryable: false
+        },
         iterations: 0,
         toolCalls: 0,
         durationMs: 0
@@ -22983,22 +23094,24 @@ var ReportGenerator = class {
       medium: "#ca8a04",
       low: "#16a34a"
     };
-    const rows = result.findings.map(
-      (f) => `
+    const rows = result.findings.map((f) => {
+      const sevColor = severityColors[f.severity] ?? "#000000";
+      const loc = `${escapeHtml(f.file)}${f.line ? `:${escapeHtml(String(f.line))}` : ""}`;
+      return `
       <tr>
-        <td style="color: ${severityColors[f.severity]}; font-weight: bold;">${f.severity.toUpperCase()}</td>
-        <td>${f.category}</td>
-        <td>${f.title}</td>
-        <td><code>${f.file}${f.line ? `:${f.line}` : ""}</code></td>
-        <td>${f.remediation}</td>
+        <td style="color: ${escapeHtml(sevColor)}; font-weight: bold;">${escapeHtml(f.severity.toUpperCase())}</td>
+        <td>${escapeHtml(f.category)}</td>
+        <td>${escapeHtml(f.title)}</td>
+        <td><code>${loc}</code></td>
+        <td>${escapeHtml(f.remediation)}</td>
       </tr>
-    `
-    ).join("");
+    `;
+    }).join("");
     return `
 <!DOCTYPE html>
 <html>
 <head>
-  <title>Security Scan Report - ${new Date(result.timestamp).toLocaleDateString()}</title>
+  <title>Security Scan Report - ${escapeHtml(new Date(result.timestamp).toLocaleDateString())}</title>
   <style>
     body { font-family: system-ui, sans-serif; margin: 2rem; }
     table { border-collapse: collapse; width: 100%; }
@@ -23009,9 +23122,9 @@ var ReportGenerator = class {
 </head>
 <body>
   <h1>Security Scan Report</h1>
-  <p><strong>Generated:</strong> ${new Date(result.timestamp).toLocaleString()}</p>
-  <p><strong>Project:</strong> ${result.projectRoot}</p>
-  <p><strong>Tech Stack:</strong> ${result.techStack.stack} (${result.techStack.packageManager})</p>
+  <p><strong>Generated:</strong> ${escapeHtml(new Date(result.timestamp).toLocaleString())}</p>
+  <p><strong>Project:</strong> ${escapeHtml(result.projectRoot)}</p>
+  <p><strong>Tech Stack:</strong> ${escapeHtml(result.techStack.stack)} (${escapeHtml(result.techStack.packageManager)})</p>
 
   <h2>Summary</h2>
   <ul>
@@ -23037,6 +23150,9 @@ var ReportGenerator = class {
     `.trim();
   }
 };
+function escapeHtml(value) {
+  return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
 var defaultReportGenerator = new ReportGenerator();
 
 // src/security-scanner/gitignore-updater.ts
@@ -27048,6 +27164,7 @@ var PhaseOrchestrator = class {
       maxConcurrentPhases: opts.maxConcurrentPhases ?? 1,
       maxConcurrentTasks: opts.maxConcurrentTasks ?? 2,
       maxRetries: opts.maxRetries ?? 2,
+      maxVerifyAttempts: opts.maxVerifyAttempts ?? 2,
       autonomous: opts.autonomous ?? true,
       phaseDelayMs: opts.phaseDelayMs ?? 0,
       stopOnFailure: opts.stopOnFailure ?? true,
@@ -27094,7 +27211,10 @@ var PhaseOrchestrator = class {
   resume() {
     this.paused = false;
     this.tick().catch((err) => {
-      console.error("[phase-orchestrator] tick failed:", err instanceof Error ? err.message : String(err));
+      console.error(
+        "[phase-orchestrator] tick failed:",
+        err instanceof Error ? err.message : String(err)
+      );
     });
   }
   /** Tamamen durdur — aktif fazlar da durdurulur */
@@ -27175,33 +27295,30 @@ var PhaseOrchestrator = class {
         failed: failedTasks
       });
       if (failedTasks > 0 && this.opts.stopOnFailure) {
-        this.updatePhaseStatus(phase, "failed");
-        phase.completedAt = Date.now();
-        phase.actualDurationMs = Date.now() - (phase.startedAt ?? Date.now());
-        this.runningPhases.delete(phase.id);
-        this.graph.activePhaseIds = this.graph.activePhaseIds.filter((id) => id !== phase.id);
-        this.emit("phase.failed", {
-          phaseId: phase.id,
-          name: phase.name,
-          error: `${failedTasks} task(s) failed`
-        });
-        this.ctx.onPhaseFail?.(phase, new Error(`${failedTasks} task(s) failed`));
-        await this.keepWorktreeForReview(phase);
-      } else {
-        this.updatePhaseStatus(phase, "completed");
-        phase.completedAt = Date.now();
-        phase.actualDurationMs = Date.now() - (phase.startedAt ?? Date.now());
-        this.runningPhases.delete(phase.id);
-        this.graph.activePhaseIds = this.graph.activePhaseIds.filter((id) => id !== phase.id);
-        this.graph.completedPhaseIds.push(phase.id);
-        this.emit("phase.completed", {
-          phaseId: phase.id,
-          name: phase.name,
-          durationMs: phase.actualDurationMs
-        });
-        this.ctx.onPhaseComplete?.(phase);
-        await this.commitAndEnqueueMerge(phase);
+        await this.failPhaseAfterTasks(phase, `${failedTasks} task(s) failed`);
+        return;
+      }
+      const verdict = await this.runVerifyGate(phase);
+      if (!verdict.ok) {
+        await this.failPhaseAfterTasks(
+          phase,
+          `verification failed${verdict.output ? `: ${this.truncate(verdict.output)}` : ""}`
+        );
+        return;
       }
+      this.updatePhaseStatus(phase, "completed");
+      phase.completedAt = Date.now();
+      phase.actualDurationMs = Date.now() - (phase.startedAt ?? Date.now());
+      this.runningPhases.delete(phase.id);
+      this.graph.activePhaseIds = this.graph.activePhaseIds.filter((id) => id !== phase.id);
+      this.graph.completedPhaseIds.push(phase.id);
+      this.emit("phase.completed", {
+        phaseId: phase.id,
+        name: phase.name,
+        durationMs: phase.actualDurationMs
+      });
+      this.ctx.onPhaseComplete?.(phase);
+      await this.commitAndEnqueueMerge(phase);
     } catch (error) {
       this.updatePhaseStatus(phase, "failed");
       phase.completedAt = Date.now();
@@ -27218,6 +27335,69 @@ var PhaseOrchestrator = class {
       await this.keepWorktreeForReview(phase);
     }
   }
+  // ─── Verification gate ──────────────────────────────────────────────────────
+  /**
+   * Run the verification gate for a phase whose tasks all succeeded. Verifies in
+   * the phase's worktree; on failure, runs the repair pass and re-verifies, up to
+   * `maxVerifyAttempts` repairs. Returns the final verdict. When no `verifyPhase`
+   * callback is wired the gate is a no-op and always passes.
+   */
+  async runVerifyGate(phase) {
+    if (!this.ctx.verifyPhase) return { ok: true };
+    const env = this.worktreeEnv(phase);
+    for (let attempt = 0; attempt <= this.opts.maxVerifyAttempts; attempt++) {
+      if (this.stopped) return { ok: false, output: "stopped before verification completed" };
+      this.emit("phase.verifying", { phaseId: phase.id, name: phase.name, attempt });
+      let verdict;
+      try {
+        verdict = await this.ctx.verifyPhase(phase, env);
+      } catch (err) {
+        verdict = { ok: false, output: err instanceof Error ? err.message : String(err) };
+      }
+      if (verdict.ok) return { ok: true };
+      this.emit("phase.verifyFailed", {
+        phaseId: phase.id,
+        name: phase.name,
+        attempt,
+        error: verdict.output
+      });
+      if (attempt >= this.opts.maxVerifyAttempts || !this.ctx.repairPhase || this.stopped) {
+        return { ok: false, output: verdict.output };
+      }
+      this.emit("phase.repairing", { phaseId: phase.id, name: phase.name, attempt: attempt + 1 });
+      try {
+        await this.ctx.repairPhase(
+          phase,
+          verdict.output ?? "verification failed",
+          attempt + 1,
+          env
+        );
+      } catch {
+      }
+    }
+    return { ok: false };
+  }
+  /** Worktree env (cwd/branch) for a phase, or undefined if it runs on the shared tree. */
+  worktreeEnv(phase) {
+    const handle = this.phaseWorktrees.get(phase.id);
+    return handle ? { cwd: handle.dir, branch: handle.branch } : void 0;
+  }
+  /** Shared failure bookkeeping for a phase whose tasks ran but the phase failed. */
+  async failPhaseAfterTasks(phase, error) {
+    this.updatePhaseStatus(phase, "failed");
+    phase.completedAt = Date.now();
+    phase.actualDurationMs = Date.now() - (phase.startedAt ?? Date.now());
+    this.runningPhases.delete(phase.id);
+    this.graph.activePhaseIds = this.graph.activePhaseIds.filter((id) => id !== phase.id);
+    this.emit("phase.failed", { phaseId: phase.id, name: phase.name, error });
+    this.ctx.onPhaseFail?.(phase, new Error(error));
+    await this.keepWorktreeForReview(phase);
+  }
+  /** Trim long verifier output so it fits cleanly in an event/error message. */
+  truncate(text, max = 500) {
+    const t2 = text.trim();
+    return t2.length <= max ? t2 : `${t2.slice(0, max)}\u2026 (+${t2.length - max} chars)`;
+  }
   // ─── Worktree integration ───────────────────────────────────────────────────
   /**
    * Commit the phase's worktree changes, then enqueue the merge back into the
@@ -27240,11 +27420,26 @@ var PhaseOrchestrator = class {
     })();
     this.phaseMergePromise.set(phase.id, merged);
   }
-  /** Squash-merge one phase. Conflicts mark the worktree needs-review (run continues). */
+  /**
+   * Squash-merge one phase. When a `resolveConflict` callback is wired, a merge
+   * conflict is handed to it (a resolver subagent) before giving up; only if
+   * that fails does the worktree fall to needs-review and the run continues.
+   */
   async mergeOne(phase, handle) {
     if (!this.worktrees) return;
     try {
-      const result = await this.worktrees.merge(handle, { squash: true });
+      const resolve10 = this.ctx.resolveConflict ? async (info) => {
+        this.emit("phase.conflictResolving", {
+          phaseId: phase.id,
+          name: phase.name,
+          files: info.conflictFiles
+        });
+        return this.ctx.resolveConflict(phase, info);
+      } : void 0;
+      const result = await this.worktrees.merge(handle, { squash: true, resolve: resolve10 });
+      if (result.resolved) {
+        this.emit("phase.conflictResolved", { phaseId: phase.id, name: phase.name });
+      }
       await this.worktrees.release(handle, { keep: !result.ok });
     } catch (err) {
       this.emit("phase.failed", {
@@ -27308,7 +27503,11 @@ var PhaseOrchestrator = class {
     const currentRetries = this.taskRetryCounts.get(taskKey) ?? 0;
     if (currentRetries < this.opts.maxRetries) {
       this.taskRetryCounts.set(taskKey, currentRetries + 1);
-      tracker.updateNodeStatus(task.id, "pending", `Retry ${currentRetries + 1}/${this.opts.maxRetries}`);
+      tracker.updateNodeStatus(
+        task.id,
+        "pending",
+        `Retry ${currentRetries + 1}/${this.opts.maxRetries}`
+      );
       this.emit("phase.taskRetrying", {
         phaseId: phase.id,
         taskId: task.id,
@@ -27317,7 +27516,11 @@ var PhaseOrchestrator = class {
         maxRetries: this.opts.maxRetries
       });
     } else {
-      tracker.updateNodeStatus(task.id, "failed", error instanceof Error ? error.message : String(error));
+      tracker.updateNodeStatus(
+        task.id,
+        "failed",
+        error instanceof Error ? error.message : String(error)
+      );
       this.emit("phase.taskFailed", {
         phaseId: phase.id,
         taskId: task.id,
@@ -28268,6 +28471,10 @@ var WorktreeManager = class {
 ${merged.stderr}`);
       const fromIndex = await this.unmergedFiles();
       const conflictFiles = [.../* @__PURE__ */ new Set([...fromOutput, ...fromIndex])];
+      if (opts.resolve) {
+        const finalized = await this.tryResolveConflict(handle, conflictFiles, opts);
+        if (finalized) return finalized;
+      }
       await this.runGit(["reset", "--hard", "HEAD"], this.projectRoot);
       handle.conflictFiles = conflictFiles;
       this.setStatus(handle, "needs-review", { lastError: merged.stderr });
@@ -28298,6 +28505,52 @@ ${merged.stderr}`);
     });
     return { ok: true };
   }
+  /**
+   * Run the caller-supplied resolver against a conflicted squash-merge, then
+   * commit if it cleared every marker. Returns a successful `MergeResult` on a
+   * clean resolution, or `null` to signal the caller should fall back to the
+   * abort path. Never leaves the base tree committed-but-dirty: a partial or
+   * failed resolution returns `null` and the caller hard-resets.
+   */
+  async tryResolveConflict(handle, conflictFiles, opts) {
+    let resolved = false;
+    try {
+      resolved = await opts.resolve({ conflictFiles, cwd: this.projectRoot });
+    } catch {
+      resolved = false;
+    }
+    if (!resolved) return null;
+    await this.runGit(["add", "-A"], this.projectRoot);
+    if (await this.hasConflictMarkers()) return null;
+    const idArgs = await this.identityArgs(this.projectRoot);
+    const msg = opts.message ?? `merge ${handle.branch} (squash, conflict resolved)`;
+    const commit = await this.runGit([...idArgs, "commit", "-m", msg], this.projectRoot);
+    if (commit.code !== 0 && !/nothing to commit/i.test(commit.stdout + commit.stderr)) {
+      return null;
+    }
+    handle.conflictFiles = conflictFiles;
+    this.setStatus(handle, "merged");
+    this.emit("worktree.merged", {
+      handleId: handle.id,
+      ownerId: handle.ownerId,
+      branch: handle.branch,
+      baseBranch: handle.baseBranch,
+      squash: true
+    });
+    return { ok: true, resolved: true, conflictFiles };
+  }
+  /**
+   * True when staged content still carries conflict markers. `git diff --cached
+   * --check` exits nonzero and prints a "leftover conflict marker" line for each
+   * survivor; whitespace-only errors (also flagged by --check) are ignored so a
+   * clean resolution with unrelated whitespace is not rejected.
+   */
+  async hasConflictMarkers() {
+    const check = await this.runGit(["diff", "--cached", "--check"], this.projectRoot);
+    if (check.code === 0) return false;
+    return /conflict marker/i.test(`${check.stdout}
+${check.stderr}`);
+  }
   /**
    * Remove the worktree + branch. Conflicted/failed handles (or `keep:true`)
    * are left on disk for inspection.
@@ -29700,6 +29953,6 @@ ${formatPlan(updated)}`
   };
 }
 
-export { ACP_AGENTS, AGENTS_BY_PHASE, AGENT_CATALOG, AISpecBuilder, ALL_AGENT_DEFINITIONS, ALL_FLEET_AGENTS, ALL_SYNC_CATEGORIES, AUDIT_LOG_AGENT, Agent, AgentError, AnnotationsStore, AutoApprovePermissionPolicy, AutoCompactionMiddleware, AutoExecutor, AutoPhasePlanner, AutoPhaseRunner, AutonomousRunner, BUG_HUNTER_AGENT, BudgetExceededError, CONTEXT_WINDOW_MODES, CORE_RECONSTRUCT_EVENTS, CheckpointManager, CloudSync, CollaborationBus, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_AUTONOMY_CONFIG, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_CONTEXT_CONFIG, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_DISPATCH_ROLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SESSION_LOGGING_CONFIG, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DEFAULT_TOOLS_CONFIG, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultPromptStore, DefaultProviderRunner, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, Director, DirectorStateCheckpoint, DoneConditionChecker, ERROR_CODES, EternalAutonomyEngine, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FLEET_ROSTER_WITHACP, FleetBus, FleetCostCapError, FleetManager, FleetSpawnBudgetError, FleetUsageAggregator, FsError, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, MAX_JOURNAL_ENTRIES, NULL_FLEET_BUS, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, ParallelEternalEngine, PhaseGraphBuilder, PhaseOrchestrator, PhaseStore, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, REFACTOR_PLANNER_AGENT, RecoveryLock, ReplayLogStore, ReplayProviderRunner, ReportGenerator, RunController, SECURITY_SCANNER_AGENT, SPEC_TEMPLATES, STANDARD_AUDIT_EVENTS, ScopedEventBus, SddParallelRun, SddTaskDecomposer, SecurityScanner, SecurityScannerOrchestrator, SelectiveCompactor, SessionAnalyzer, SessionError, SessionRecovery, SkillGenerator, SkillInstaller, SkillManifestStore, SlashCommandRegistry, SpecDrivenDev, SpecParser, SpecStore, SpecVersioning, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskGraphStore, TaskTracker, TechStackDetector, ToolAuditLog, ToolError, ToolExecutor, ToolRegistry, WorktreeManager, WrongStackError, addPlanItem, allServers, analyzeCriticalPath, appendJournal, applyRosterBudget, asBlocks, asText, assertSafePath, atomicWrite, attachAutoExtend, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildBtwBlock, buildChildEnv, buildGoalPreamble, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, collabInjectMiddleware, collabPauseMiddleware, color, compileGlob, compileUserRegex, completePartialObject, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, consumeBtwNotes, context7Server, contextManagerTool, createAutoExecutor, createAutoPhaseFromTaskGraph, createContextManagerTool, createDefaultPipelines, createDelegateTool, createGitPlugin, createMcpControlTool, createMessage, createObservabilityPlugin, createPlanPlugin, createPromptsPlugin, createSecurityPlugin, createSecuritySlashCommand, createSessionEventBridge, createSkillsPlugin, createSyncPlugin, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, deriveTodosFromPlanItem, detectNewlineStyle, dispatchAgent, downloadGitHubTarball, emptyGoal, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, expandGlob, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatGoal, formatPlan, formatPlanTemplates, formatTodosList, getAgentDefinition, getCalibrationState, getContextWindowMode, getPlanTemplate, getTemplate, githubServer, goalFilePath, googleMapsServer, hashRequest, isAgentError, isConfigError, isContextWindowModeId, isFsError, isImageBlock, isPluginError, isSessionError, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, listContextWindowModes, listPlanTemplates, listTemplates, loadDirectorState, loadGoal, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeAskTool, makeAssignTool, makeAutonomyPromptContributor, makeAwaitTasksTool, makeCollabDebugTool, makeContinueToNextIterationTool, makeDirectorSessionFactory, makeFleetEmitTool, makeFleetHealthTool, makeFleetSessionTool, makeFleetStatusTool, makeFleetUsageTool, makeLLMClassifier, makeRollUpTool, makeSpawnTool, makeTerminateTool, matchAny, matchGlob, mergeModelsPayload, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, parseContinueDirective, parseSkillRef, pendingBtwCount, projectHash, recordActualUsage, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resetCalibration, resolveAuditLevel, resolveContextWindowPolicy, resolveSessionLoggingConfig, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, runProviderWithRetry, safeParse, safeStringify, sanitizeJsonString, saveGoal, savePlan, saveTodosCheckpoint, scoreAgents, securitySlashCommand, sentinelServer, setBtwNote, setPlanItemStatus, slackServer, stableStringify, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, summarizeUsage, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, zaiVisionServer };
+export { ACP_AGENTS, AGENTS_BY_PHASE, AGENT_CATALOG, AISpecBuilder, ALL_AGENT_DEFINITIONS, ALL_FLEET_AGENTS, ALL_SYNC_CATEGORIES, AUDIT_LOG_AGENT, Agent, AgentError, AnnotationsStore, AutoApprovePermissionPolicy, AutoCompactionMiddleware, AutoExecutor, AutoPhasePlanner, AutoPhaseRunner, AutonomousRunner, BUG_HUNTER_AGENT, BudgetExceededError, CONTEXT_WINDOW_MODES, CORE_RECONSTRUCT_EVENTS, CheckpointManager, CloudSync, CollaborationBus, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_AUTONOMY_CONFIG, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_CONTEXT_CONFIG, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_DISPATCH_ROLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SESSION_LOGGING_CONFIG, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DEFAULT_TOOLS_CONFIG, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultPromptStore, DefaultProviderRunner, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, Director, DirectorStateCheckpoint, DoneConditionChecker, ERROR_CODES, EternalAutonomyEngine, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FLEET_ROSTER_WITHACP, FleetBus, FleetCostCapError, FleetManager, FleetSpawnBudgetError, FleetUsageAggregator, FsError, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, MATRIX_PHASE_KEYS, MAX_JOURNAL_ENTRIES, NULL_FLEET_BUS, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, ParallelEternalEngine, PhaseGraphBuilder, PhaseOrchestrator, PhaseStore, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, REFACTOR_PLANNER_AGENT, RecoveryLock, ReplayLogStore, ReplayProviderRunner, ReportGenerator, RunController, SECURITY_SCANNER_AGENT, SPEC_TEMPLATES, STANDARD_AUDIT_EVENTS, ScopedEventBus, SddParallelRun, SddTaskDecomposer, SecurityScanner, SecurityScannerOrchestrator, SelectiveCompactor, SessionAnalyzer, SessionError, SessionRecovery, SkillGenerator, SkillInstaller, SkillManifestStore, SlashCommandRegistry, SpecDrivenDev, SpecParser, SpecStore, SpecVersioning, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskGraphStore, TaskTracker, TechStackDetector, ToolAuditLog, ToolError, ToolExecutor, ToolRegistry, WorktreeManager, WrongStackError, addPlanItem, allServers, analyzeCriticalPath, appendJournal, applyRosterBudget, asBlocks, asText, assertSafePath, atomicWrite, attachAutoExtend, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildBtwBlock, buildChildEnv, buildGoalPreamble, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, collabInjectMiddleware, collabPauseMiddleware, color, compileGlob, compileUserRegex, completePartialObject, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, consumeBtwNotes, context7Server, contextManagerTool, createAutoExecutor, createAutoPhaseFromTaskGraph, createContextManagerTool, createDefaultPipelines, createDelegateTool, createGitPlugin, createMcpControlTool, createMessage, createObservabilityPlugin, createPlanPlugin, createPromptsPlugin, createSecurityPlugin, createSecuritySlashCommand, createSessionEventBridge, createSkillsPlugin, createSyncPlugin, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, deriveTodosFromPlanItem, detectNewlineStyle, dispatchAgent, downloadGitHubTarball, emptyGoal, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, expandGlob, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatGoal, formatPlan, formatPlanTemplates, formatTodosList, getAgentDefinition, getCalibrationState, getContextWindowMode, getPlanTemplate, getTemplate, getTermSize, githubServer, goalFilePath, googleMapsServer, hashRequest, isAgentError, isConfigError, isContextWindowModeId, isFsError, isImageBlock, isInteractive, isPluginError, isSessionError, isStdinTTY, isStdoutTTY, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isValidMatrixKey, isWrongStackError, listContextWindowModes, listPlanTemplates, listTemplates, loadDirectorState, loadGoal, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeAskTool, makeAssignTool, makeAutonomyPromptContributor, makeAwaitTasksTool, makeCollabDebugTool, makeContinueToNextIterationTool, makeDirectorSessionFactory, makeFleetEmitTool, makeFleetHealthTool, makeFleetSessionTool, makeFleetStatusTool, makeFleetUsageTool, makeLLMClassifier, makeRollUpTool, makeSpawnTool, makeTerminateTool, matchAny, matchGlob, matrixKeyKind, mergeModelsPayload, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, onResize, parseContinueDirective, parseSkillRef, pendingBtwCount, phaseForRole, projectHash, recordActualUsage, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resetCalibration, resolveAuditLevel, resolveContextWindowPolicy, resolveModelMatrix, resolveSessionLoggingConfig, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, runProviderWithRetry, safeParse, safeStringify, sanitizeJsonString, saveGoal, savePlan, saveTodosCheckpoint, scoreAgents, securitySlashCommand, sentinelServer, setBtwNote, setPlanItemStatus, setRawMode, slackServer, stableStringify, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, summarizeUsage, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, writeErr, writeOut, zaiVisionServer };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map