@wrongstack/core 0.24.0 → 0.31.1

package/dist/defaults/index.js

@@ -2,6 +2,7 @@ import * as crypto2 from 'crypto';
 import { randomBytes, randomUUID, createCipheriv, createDecipheriv, createHash } from 'crypto';
 import * as fsp from 'fs/promises';
 import * as path15 from 'path';
+import { isAbsolute, resolve } from 'path';
 import * as fs5 from 'fs';
 import * as os from 'os';
 import { execFile } from 'child_process';
@@ -51,8 +52,8 @@ async function atomicWrite(targetPath, content, opts = {}) {
     }
     let mode;
     try {
-      const stat4 = await fsp.stat(targetPath);
-      mode = stat4.mode & 511;
+      const stat5 = await fsp.stat(targetPath);
+      mode = stat5.mode & 511;
     } catch {
       mode = opts.mode;
     }
@@ -88,7 +89,7 @@ async function renameWithRetry(from, to) {
       if (!code || !TRANSIENT_RENAME_CODES.has(code) || i === delays.length) {
         throw err;
       }
-      await new Promise((resolve3) => setTimeout(resolve3, delays[i]));
+      await new Promise((resolve4) => setTimeout(resolve4, delays[i]));
     }
   }
   throw lastErr;
@@ -446,8 +447,8 @@ var DefaultSessionStore = class {
       return JSON.parse(raw);
     } catch {
       const full = this.sessionPath(id, ".jsonl");
-      const stat4 = await fsp.stat(full);
-      const summary = await this.summarize(id, stat4.mtime.toISOString());
+      const stat5 = await fsp.stat(full);
+      const summary = await this.summarize(id, stat5.mtime.toISOString());
       await atomicWrite(manifest, JSON.stringify(summary), { mode: 384 }).catch((err) => {
         console.warn(
           `[session-store] Failed to write manifest for "${id}":`,
@@ -4297,8 +4298,8 @@ async function streamProviderToResponse(provider, req, signal, ctx, events) {
       try {
         await Promise.race([
           Promise.resolve(iter.return?.()),
-          new Promise((resolve3) => {
-            drainTimer = setTimeout(resolve3, 500);
+          new Promise((resolve4) => {
+            drainTimer = setTimeout(resolve4, 500);
           })
         ]);
       } finally {
@@ -4359,7 +4360,7 @@ async function runProviderWithRetry(opts) {
           description
         });
       }
-      await new Promise((resolve3, reject) => {
+      await new Promise((resolve4, reject) => {
         let settled = false;
         const onAbort = () => {
           if (settled) return;
@@ -4372,7 +4373,7 @@ async function runProviderWithRetry(opts) {
           settled = true;
           clearTimeout(t);
           signal.removeEventListener("abort", onAbort);
-          resolve3();
+          resolve4();
         }, delay);
         if (signal.aborted) {
           onAbort();
@@ -4466,13 +4467,18 @@ function estimateRequestTokens(messages, systemPrompt, tools) {
   for (const t of tools) {
     toolsTokens += estimateToolDefTokens(t);
   }
+  const total = messagesTokens + systemTokens + toolsTokens;
   return {
     messages: messagesTokens,
     systemPrompt: systemTokens,
     tools: toolsTokens,
-    total: messagesTokens + systemTokens + toolsTokens
+    total
   };
 }
+function estimateRequestTokensCalibrated(messages, systemPrompt, tools) {
+  const result = estimateRequestTokens(messages, systemPrompt, tools);
+  return result;
+}
 
 // src/execution/compactor.ts
 var HybridCompactor = class {
@@ -5368,7 +5374,7 @@ var AutoCompactionMiddleware = class _AutoCompactionMiddleware {
   }
   handler() {
     return async (ctx, next) => {
-      const tokens = this._estimator ? this._estimator(ctx) : estimateRequestTokens(ctx.messages, ctx.systemPrompt, ctx.tools ?? []).total;
+      const tokens = this._estimator ? this._estimator(ctx) : estimateRequestTokensCalibrated(ctx.messages, ctx.systemPrompt, ctx.tools ?? []).total;
       const load = tokens / this._maxContext;
       const policy = this.policyProvider?.(ctx);
       const thresholds = policy?.thresholds ?? {
@@ -6740,7 +6746,7 @@ ${recentJournal}` : "No prior iterations.",
   }
 };
 function sleep(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 
 // src/coordination/subagent-budget.ts
@@ -6956,12 +6962,12 @@ var SubagentBudget = class _SubagentBudget {
           if (!bus || !bus.hasListenerFor("budget.threshold_reached")) {
             return Promise.resolve("stop");
           }
-          return new Promise((resolve3) => {
+          return new Promise((resolve4) => {
             let resolved = false;
             const respond = (d) => {
               if (resolved) return;
               resolved = true;
-              resolve3(d);
+              resolve4(d);
             };
             const fallback = setTimeout(
               () => respond("stop"),
@@ -9898,6 +9904,10 @@ var NICKNAME_POOL = {
   "pasteur": { name: "Pasteur", domain: "biology" },
   "hawking": { name: "Hawking", domain: "cosmology" },
   "sagan": { name: "Sagan", domain: "cosmology" },
+  // Exploration & navigation
+  "columbus": { name: "Columbus", domain: "exploration" },
+  "polo": { name: "Polo", domain: "exploration" },
+  "magellan": { name: "Magellan", domain: "exploration" },
   // Chemistry / materials
   "lavoisier": { name: "Lavoisier", domain: "chemistry" },
   "mendeleev": { name: "Mendeleev", domain: "chemistry" }
@@ -9952,7 +9962,7 @@ function formatRole(role) {
 }
 
 // src/coordination/multi-agent-coordinator.ts
-var DefaultMultiAgentCoordinator = class extends EventEmitter {
+var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends EventEmitter {
   coordinatorId;
   config;
   runner;
@@ -9967,8 +9977,12 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
    * names) to memorable ones here — that's what surfaces in the fleet monitor.
    */
   usedNicknames = /* @__PURE__ */ new Set();
+  /** Maps subagentId → nickname key (e.g. 'einstein'). Used to free the slot on remove(). */
+  subagentNicknames = /* @__PURE__ */ new Map();
   pendingTasks = [];
   completedResults = [];
+  /** Prevents completedResults from growing unbounded in long-running coordinators. */
+  static MAX_COMPLETED_RESULTS = 1e4;
   totalIterations = 0;
   inFlight = 0;
   /**
@@ -10023,7 +10037,7 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
    * Explicit, human-chosen names — including nicknames already assigned by
    * `Director.spawn()` — are left untouched, so this never double-assigns.
    */
-  withNickname(subagent) {
+  withNickname(subagent, subagentId) {
     const role = subagent.role ?? "subagent";
     const name = subagent.name?.trim() ?? "";
     const isPlaceholder = name === "" || name.toLowerCase() === role.toLowerCase() || name === "subagent" || name === "adhoc" || name === "generic" || /^slot-/.test(name);
@@ -10031,11 +10045,12 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
     const nickname = assignNickname(role, this.usedNicknames);
     const baseKey = nickname.split(" ")[0].toLowerCase().replace(/[^a-z0-9-]/g, "-");
     this.usedNicknames.add(baseKey);
+    this.subagentNicknames.set(subagentId, baseKey);
     return { ...subagent, name: nickname };
   }
   async spawn(subagent) {
-    subagent = this.withNickname(subagent);
     const id = subagent.id || randomUUID();
+    subagent = this.withNickname(subagent, id);
     if (this.subagents.has(id)) {
       throw new Error(`Subagent id "${id}" already exists \u2014 refusing to overwrite`);
     }
@@ -10179,7 +10194,7 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
       taskIds.map((id) => {
         const cached = this.completedResults.find((r) => r.taskId === id);
         if (cached) return cached;
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           const timeout = setTimeout(() => {
             this.off("task.completed", handler);
             reject(new Error(`awaitTasks timed out waiting for task "${id}"`));
@@ -10188,7 +10203,7 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
             if (result.taskId === id) {
               clearTimeout(timeout);
               this.off("task.completed", handler);
-              resolve3(result);
+              resolve4(result);
             }
           };
           this.on("task.completed", handler);
@@ -10477,6 +10492,12 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
   }
   recordCompletion(result) {
     this.completedResults.push(result);
+    if (this.completedResults.length > _DefaultMultiAgentCoordinator.MAX_COMPLETED_RESULTS) {
+      this.completedResults.splice(
+        0,
+        this.completedResults.length - _DefaultMultiAgentCoordinator.MAX_COMPLETED_RESULTS
+      );
+    }
     this.totalIterations += result.iterations;
     if (this.inFlight > 0) {
       this.inFlight--;
@@ -10546,7 +10567,29 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
     }
     this.subagents.delete(subagentId);
     this.terminating.delete(subagentId);
+    const nicknameKey = this.subagentNicknames.get(subagentId);
+    if (nicknameKey) {
+      this.usedNicknames.delete(nicknameKey);
+      this.subagentNicknames.delete(subagentId);
+    }
+    const orphaned = this.pendingTasks.filter((t) => t.subagentId === subagentId);
     this.pendingTasks = this.pendingTasks.filter((t) => t.subagentId !== subagentId);
+    for (const t of orphaned) {
+      const synthetic = {
+        subagentId,
+        taskId: t.id,
+        status: "stopped",
+        error: {
+          kind: "aborted_by_parent",
+          message: `Subagent "${subagentId}" was removed while task "${t.id}" was pending`,
+          retryable: false
+        },
+        iterations: 0,
+        toolCalls: 0,
+        durationMs: 0
+      };
+      this.recordCompletion(synthetic);
+    }
     this.fleetBus?.emit({
       subagentId,
       ts: Date.now(),
@@ -10663,7 +10706,7 @@ function providerErrorToSubagentError(err, message, cause) {
 
 // src/execution/parallel-eternal-engine.ts
 function sleep2(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 var GOAL_COMPLETE_MARKER2 = /^\s*\[goal[_\s-]?complete\]\s*$/im;
 var ParallelEternalEngine = class {
@@ -11161,6 +11204,80 @@ function buildGoalPreamble(goal) {
 // src/coordination/director.ts
 init_atomic_write();
 
+// 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;
+  }
+  /**
+   * 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 };
+    }
+    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 };
+    }
+    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
+    };
+  }
+  /**
+   * 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/in-memory-transport.ts
 var InMemoryBridgeTransport = class {
   subs = /* @__PURE__ */ new Map();
@@ -11258,7 +11375,7 @@ var InMemoryAgentBridge = class {
       );
     }
     this.inflightGuards.add(correlationId);
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const timer = setTimeout(() => {
         this.inflightGuards.delete(correlationId);
         this.pendingRequests.delete(correlationId);
@@ -11270,7 +11387,7 @@ var InMemoryAgentBridge = class {
         return;
       }
       this.pendingRequests.set(correlationId, {
-        resolve: resolve3,
+        resolve: resolve4,
         reject,
         timer
       });
@@ -11592,9 +11709,12 @@ function makeSpawnTool(director, roster) {
       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" },
-      maxToolCalls: { type: "number" },
-      maxCostUsd: { type: "number" }
+      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: []
   };
@@ -11640,6 +11760,9 @@ function makeSpawnTool(director, roster) {
       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 };
@@ -11667,10 +11790,10 @@ function makeAssignTool(director) {
   const inputSchema = {
     type: "object",
     properties: {
-      subagentId: { type: "string", description: "Target subagent id. Required." },
-      description: { type: "string", description: "The task in natural language \u2014 what you want this subagent to do." },
-      maxToolCalls: { type: "number", description: "Optional per-task tool-call budget override." },
-      timeoutMs: { type: "number", description: "Optional per-task timeout in ms." }
+      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"]
   };
@@ -11711,9 +11834,9 @@ function makeAskTool(director) {
     inputSchema: {
       type: "object",
       properties: {
-        subagentId: { type: "string", description: "Subagent to ask. Must be a previously spawned id." },
-        question: { type: "string", description: "The question or instruction." },
-        timeoutMs: { type: "number", description: "Optional timeout in ms (default 30s)." }
+        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"]
     },
@@ -11721,13 +11844,49 @@ function makeAskTool(director) {
       const i = input;
       try {
         const answer = await director.ask(i.subagentId, { question: i.question }, i.timeoutMs);
-        return { ok: true, answer };
+        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",
@@ -11881,6 +12040,7 @@ function makeCollabDebugTool(director) {
         },
         timeoutMs: {
           type: "number",
+          minimum: 1,
           description: "Timeout in ms. Default: 600000 (10 minutes)."
         }
       },
@@ -11960,6 +12120,122 @@ function makeWorkCompleteTool(director) {
     }
   };
 }
+var GLOB_CHARS = /* @__PURE__ */ new Set(["*", "?", "["]);
+var IS_WINDOWS = process.platform === "win32";
+var SEP = IS_WINDOWS ? "\\" : "/";
+function isGlob(p) {
+  for (const c of p) {
+    if (GLOB_CHARS.has(c)) return true;
+  }
+  return false;
+}
+function globToRegex(pat) {
+  let i = 0, re = "^";
+  while (i < pat.length) {
+    const c = pat[i];
+    if (c === "*") {
+      if (pat[i + 1] === "*") {
+        re += ".*";
+        i += 2;
+        if (pat[i] === "/") i++;
+      } else {
+        re += "[^/\\\\]*";
+        i++;
+      }
+    } else if (c === "?") {
+      re += "[^/\\\\]";
+      i++;
+    } else if (c === "[") {
+      let cls = "[";
+      i++;
+      if (pat[i] === "!" || pat[i] === "^") {
+        cls += "^";
+        i++;
+      }
+      while (i < pat.length && pat[i] !== "]") {
+        const ch = pat[i] ?? "";
+        if (ch === "\\") cls += "\\\\";
+        else if (ch === "]" || ch === "^") cls += `\\${ch}`;
+        else cls += ch;
+        i++;
+      }
+      cls += "]";
+      re += cls;
+      i++;
+    } else {
+      re += c.replace(/[.+^${}()|\\]/g, "\\$&");
+      i++;
+    }
+  }
+  return new RegExp(re + "$");
+}
+function baseDir(pat) {
+  let i = pat.length - 1;
+  while (i >= 0 && !GLOB_CHARS.has(pat[i]) && pat[i] !== SEP && pat[i] !== "/") i--;
+  const cut = i >= 0 ? pat.lastIndexOf(SEP, i) : pat.lastIndexOf("/", i);
+  return cut < 0 ? "." : pat.slice(0, cut);
+}
+async function expandGlob(pattern) {
+  if (!isGlob(pattern)) return [pattern];
+  const results = /* @__PURE__ */ new Set();
+  const abs = isAbsolute(pattern);
+  const base = abs ? baseDir(pattern) : baseDir(pattern);
+  const relPat = base === "." ? pattern : pattern.slice(base.length + 1);
+  async function walk4(dir, pat) {
+    let entries;
+    try {
+      entries = await fsp.readdir(dir);
+    } catch {
+      return;
+    }
+    const firstGlob = pat.search(/[*?[\[]/);
+    if (firstGlob < 0) {
+      const re = globToRegex(pat);
+      for (const e of entries) {
+        if (re.test(e)) {
+          const full = `${dir}${SEP}${e}`;
+          results.add(abs ? resolve(full) : full);
+        }
+      }
+      return;
+    }
+    const before = pat.slice(0, firstGlob);
+    const rest = pat.slice(firstGlob);
+    if (before.endsWith("**")) {
+      await walk4(dir, rest);
+      for (const e of entries) {
+        const full = `${dir}${SEP}${e}`;
+        try {
+          const stat5 = await fsp.stat(full);
+          if (stat5.isDirectory()) await walk4(full, rest);
+        } catch {
+        }
+      }
+    } else if (before === "") {
+      const re = globToRegex(rest);
+      for (const e of entries) {
+        if (re.test(e)) {
+          const full = `${dir}${SEP}${e}`;
+          results.add(abs ? resolve(full) : full);
+        }
+      }
+    } else {
+      const seg = before.replace(/[*?[\]]/g, "").replace(/\/$/, "");
+      if (entries.includes(seg)) {
+        const full = `${dir}${SEP}${seg}`;
+        try {
+          const stat5 = await fsp.stat(full);
+          if (stat5.isDirectory()) await walk4(full, rest);
+        } catch {
+        }
+      }
+    }
+  }
+  await walk4(base === "." ? "." : base, relPat);
+  return [...results];
+}
+
+// src/coordination/collab-debug.ts
 var CollabSession = class extends EventEmitter {
   sessionId;
   options;
@@ -12018,7 +12294,7 @@ var CollabSession = class extends EventEmitter {
   }
   async buildSnapshot() {
     if (this.snapshot.files.length > 0) return this.snapshot;
-    for (const filePath of this.options.targetPaths) {
+    for (const filePath of (await Promise.all(this.options.targetPaths.map((p) => expandGlob(p)))).flat()) {
       try {
         const content = await fsp.readFile(filePath, "utf8");
         const ext = filePath.split(".").pop() ?? "";
@@ -12074,7 +12350,7 @@ var CollabSession = class extends EventEmitter {
         reject(new Error(`CollabSession timed out after ${this.timeoutMs}ms`));
       }, this.timeoutMs);
     });
-    let results;
+    let results = null;
     try {
       results = await Promise.race([
         Promise.all([
@@ -12505,7 +12781,7 @@ var FleetContextOverflowError = class extends Error {
     this.observed = observed;
   }
 };
-var Director = class {
+var Director = class _Director {
   /** Alias for the ICoordinator contract. `id` is retained for backward compatibility. */
   get coordinatorId() {
     return this.id;
@@ -12563,6 +12839,8 @@ var Director = class {
    *  coordinator already fired the event — `awaitTasks(['t-1'])` after
    *  t-1 finished should resolve immediately, not hang. */
   completed = /* @__PURE__ */ new Map();
+  /** Prevents the completed Map from growing unbounded in long-running directors. */
+  static MAX_COMPLETED = 1e4;
   /** Per-subagent provider/model metadata, captured at spawn time so the
    *  FleetUsageAggregator's metaLookup can surface readable rows. */
   subagentMeta = /* @__PURE__ */ new Map();
@@ -12642,6 +12920,8 @@ var Director = class {
   _leaderBtwNotes = [];
   /** Active collab sessions tracked by sessionId (see spawnCollab). */
   _activeCollabSessions = /* @__PURE__ */ new Map();
+  /** Prevents large `ask_subagent` answers from bloating the leader's context window. */
+  largeAnswerStore;
   constructor(opts) {
     this.id = opts.config.coordinatorId || randomUUID();
     this.manifestPath = opts.manifestPath;
@@ -12702,6 +12982,11 @@ var Director = class {
     this.taskCompletedListener = (payload) => {
       const r = payload.result;
       this.completed.set(r.taskId, r);
+      if (this.completed.size > _Director.MAX_COMPLETED) {
+        const toDelete = this.completed.size - _Director.MAX_COMPLETED;
+        const keys = [...this.completed.keys()].slice(0, toDelete);
+        for (const k of keys) this.completed.delete(k);
+      }
       const waiter = this.taskWaiters.get(r.taskId);
       if (waiter) {
         waiter.resolve(r);
@@ -12808,6 +13093,7 @@ var Director = class {
         payload.extend(extra);
       });
     });
+    this.largeAnswerStore = new LargeAnswerStore(2e3);
   }
   /**
    * Record a granted budget extension and broadcast it on the FleetBus so
@@ -13288,11 +13574,11 @@ var Director = class {
         if (cached) return cached;
         const existing = this.taskWaiters.get(id);
         if (existing) return existing.promise;
-        let resolve3;
+        let resolve4;
         const promise = new Promise((res) => {
-          resolve3 = res;
+          resolve4 = res;
         });
-        this.taskWaiters.set(id, { promise, resolve: resolve3 });
+        this.taskWaiters.set(id, { promise, resolve: resolve4 });
         return promise;
       })
     );
@@ -13305,7 +13591,24 @@ var Director = class {
   }
   async remove(subagentId) {
     await this.coordinator.remove(subagentId);
+    const bridge = this.subagentBridges.get(subagentId);
+    if (bridge) {
+      await bridge.stop();
+      this.subagentBridges.delete(subagentId);
+    }
     this.usage.removeSubagent(subagentId);
+    if (this.fleetManager) {
+      this.fleetManager.removeSubagent(subagentId);
+    } else {
+      const entry = this.manifestEntries.get(subagentId);
+      if (entry?.name) {
+        const nicknameKey = entry.name.split(" ")[0].toLowerCase().replace(/[^a-z0-9-]/g, "-");
+        this._usedNicknames.delete(nicknameKey);
+      }
+    }
+    this.manifestEntries.delete(subagentId);
+    this.taskOwners.delete(subagentId);
+    this.taskDescriptions.delete(subagentId);
   }
   status() {
     const base = this.coordinator.getStatus();
@@ -13467,6 +13770,7 @@ var Director = class {
       makeAssignTool(this),
       makeAwaitTasksTool(this),
       makeAskTool(this),
+      makeAskResultTool(this),
       makeRollUpTool(this),
       makeTerminateTool(this),
       makeTerminateAllTool(this),
@@ -13549,15 +13853,33 @@ function createDelegateTool(opts) {
       },
       timeoutMs: {
         type: "number",
+        minimum: 1,
         description: `Wall-clock budget for this delegate in milliseconds. No hard cap \u2014 set as high as the task realistically needs (a monorepo audit can take hours, a single-file lint takes seconds). Default ${Math.round(defaultTimeoutMs / 1e3 / 60)} minutes.`
       },
       maxIterations: {
         type: "number",
+        minimum: 1,
         description: "Maximum LLM iterations the subagent may take. Unset = use the role/coordinator default. Raise this for tasks with many tool-think-tool cycles (deep code analysis, multi-file refactors)."
       },
       maxToolCalls: {
         type: "number",
+        minimum: 1,
         description: "Maximum number of tool invocations the subagent may make. Unset = use the role/coordinator default. Raise this for tasks that touch many files (large grep + read + report)."
+      },
+      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. Unset = use the role/coordinator default."
+      },
+      maxTokens: {
+        type: "number",
+        minimum: 1,
+        description: "Maximum total tokens (input + output) the subagent may use. Unset = use the role/coordinator default."
+      },
+      maxCostUsd: {
+        type: "number",
+        minimum: 0,
+        description: "Maximum estimated USD cost the subagent may incur. Unset = use the role/coordinator default."
       }
     },
     required: ["task"]
@@ -13615,12 +13937,21 @@ function createDelegateTool(opts) {
           };
           cfg = applyRosterBudget({ ...cfg, name: i.name });
         }
-        if (typeof i.maxIterations === "number" && i.maxIterations > 0) {
+        if (typeof i.maxIterations === "number") {
           cfg.maxIterations = i.maxIterations;
         }
-        if (typeof i.maxToolCalls === "number" && i.maxToolCalls > 0) {
+        if (typeof i.maxToolCalls === "number") {
           cfg.maxToolCalls = i.maxToolCalls;
         }
+        if (typeof i.idleTimeoutMs === "number") {
+          cfg.idleTimeoutMs = i.idleTimeoutMs;
+        }
+        if (typeof i.maxTokens === "number") {
+          cfg.maxTokens = i.maxTokens;
+        }
+        if (typeof i.maxCostUsd === "number") {
+          cfg.maxCostUsd = i.maxCostUsd;
+        }
         const SUBAGENT_TIMEOUT_BUFFER_MS = opts.subagentTimeoutBufferMs ?? 6e4;
         if (!cfg.timeoutMs) {
           cfg.timeoutMs = Math.max(3e4, timeoutMs - SUBAGENT_TIMEOUT_BUFFER_MS);
@@ -13632,7 +13963,7 @@ function createDelegateTool(opts) {
           subagentId
         });
         const dir = director;
-        const result = await new Promise((resolve3) => {
+        const result = await new Promise((resolve4) => {
           let settled = false;
           let timer;
           const finish = (value) => {
@@ -13642,7 +13973,7 @@ function createDelegateTool(opts) {
             offTool();
             offIter();
             offProgress();
-            resolve3(value);
+            resolve4(value);
           };
           const arm = () => {
             if (timer) clearTimeout(timer);
@@ -14554,8 +14885,8 @@ async function loadProjectModes(modesDir) {
     for (const entry of entries) {
       if (!entry.endsWith(".md") && !entry.endsWith(".txt")) continue;
       const filePath = path15.join(modesDir, entry);
-      const stat4 = await fsp.stat(filePath);
-      if (!stat4.isFile()) continue;
+      const stat5 = await fsp.stat(filePath);
+      if (!stat5.isFile()) continue;
       const content = await fsp.readFile(filePath, "utf8");
       const id = path15.basename(entry, path15.extname(entry));
       modes.push({
@@ -15898,10 +16229,10 @@ var AISpecBuilder = class {
   async saveSession() {
     if (!this.sessionPath) return;
     try {
-      const fsp15 = await import('fs/promises');
+      const fsp16 = await import('fs/promises');
       const path18 = await import('path');
       const { atomicWrite: atomicWrite2 } = await Promise.resolve().then(() => (init_atomic_write(), atomic_write_exports));
-      await fsp15.mkdir(path18.dirname(this.sessionPath), { recursive: true });
+      await fsp16.mkdir(path18.dirname(this.sessionPath), { recursive: true });
       await atomicWrite2(this.sessionPath, JSON.stringify(this.session, null, 2));
     } catch {
     }
@@ -15910,8 +16241,8 @@ var AISpecBuilder = class {
   async loadSession() {
     if (!this.sessionPath) return false;
     try {
-      const fsp15 = await import('fs/promises');
-      const raw = await fsp15.readFile(this.sessionPath, "utf8");
+      const fsp16 = await import('fs/promises');
+      const raw = await fsp16.readFile(this.sessionPath, "utf8");
       const loaded = JSON.parse(raw);
       if (loaded?.id && loaded?.phase && loaded?.title) {
         this.session = loaded;
@@ -15925,8 +16256,8 @@ var AISpecBuilder = class {
   async deleteSession() {
     if (!this.sessionPath) return;
     try {
-      const fsp15 = await import('fs/promises');
-      await fsp15.unlink(this.sessionPath);
+      const fsp16 = await import('fs/promises');
+      await fsp16.unlink(this.sessionPath);
     } catch {
     }
   }
@@ -17412,9 +17743,9 @@ var DefaultHealthRegistry = class {
   }
   async runOne(check) {
     let timer = null;
-    const timeout = new Promise((resolve3) => {
+    const timeout = new Promise((resolve4) => {
       timer = setTimeout(
-        () => resolve3({ status: "unhealthy", detail: `timeout after ${this.timeoutMs}ms` }),
+        () => resolve4({ status: "unhealthy", detail: `timeout after ${this.timeoutMs}ms` }),
         this.timeoutMs
       );
     });
@@ -17653,14 +17984,14 @@ async function startMetricsServer(opts) {
     const { createServer } = await import('http');
     server = createServer(listener);
   }
-  await new Promise((resolve3, reject) => {
+  await new Promise((resolve4, reject) => {
     const onError = (err) => {
       server.off("listening", onListening);
       reject(err);
     };
     const onListening = () => {
       server.off("error", onError);
-      resolve3();
+      resolve4();
     };
     server.once("error", onError);
     server.once("listening", onListening);
@@ -17672,8 +18003,8 @@ async function startMetricsServer(opts) {
   return {
     port: boundPort,
     url: `${protocol}://${host}:${boundPort}${path18}`,
-    close: () => new Promise((resolve3, reject) => {
-      server.close((err) => err ? reject(err) : resolve3());
+    close: () => new Promise((resolve4, reject) => {
+      server.close((err) => err ? reject(err) : resolve4());
     })
   };
 }