@wrongstack/core 0.5.5 → 0.5.7

package/dist/index.js

@@ -12,6 +12,13 @@ import { Readable } from 'stream';
 import { pipeline } from 'stream/promises';
 import { spawn } from 'child_process';
 
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/types/errors.ts
 var WrongStackError = class extends Error {
   code;
@@ -3748,11 +3755,11 @@ function validateAgainstSchema(value, schema) {
   walk2(value, schema, "", errors);
   return { ok: errors.length === 0, errors };
 }
-function walk2(value, schema, path24, errors) {
+function walk2(value, schema, path25, errors) {
   if (schema.enum !== void 0) {
     if (!schema.enum.some((e) => deepEqual(e, value))) {
       errors.push({
-        path: path24 || "<root>",
+        path: path25 || "<root>",
         message: `expected one of ${JSON.stringify(schema.enum)}, got ${JSON.stringify(value)}`
       });
       return;
@@ -3761,7 +3768,7 @@ function walk2(value, schema, path24, errors) {
   if (typeof schema.type === "string") {
     if (!checkType(value, schema.type)) {
       errors.push({
-        path: path24 || "<root>",
+        path: path25 || "<root>",
         message: `expected ${schema.type}, got ${describeType(value)}`
       });
       return;
@@ -3771,19 +3778,19 @@ function walk2(value, schema, path24, errors) {
     const obj = value;
     for (const req of schema.required ?? []) {
       if (!(req in obj)) {
-        errors.push({ path: joinPath(path24, req), message: "required property missing" });
+        errors.push({ path: joinPath(path25, req), message: "required property missing" });
       }
     }
     if (schema.properties) {
       for (const [key, subSchema] of Object.entries(schema.properties)) {
         if (key in obj) {
-          walk2(obj[key], subSchema, joinPath(path24, key), errors);
+          walk2(obj[key], subSchema, joinPath(path25, key), errors);
         }
       }
     }
   }
   if (schema.type === "array" && Array.isArray(value) && schema.items) {
-    value.forEach((item, i) => walk2(item, schema.items, `${path24}[${i}]`, errors));
+    value.forEach((item, i) => walk2(item, schema.items, `${path25}[${i}]`, errors));
   }
 }
 function checkType(value, type) {
@@ -5341,9 +5348,149 @@ function matchIndex(plan, idOrIndex) {
   const lower = idOrIndex.toLowerCase();
   return plan.items.findIndex((it) => it.title.toLowerCase().includes(lower));
 }
+function deriveTodosFromPlanItem(plan, idOrIndex, subtasks) {
+  const idx = matchIndex(plan, idOrIndex);
+  if (idx === -1) return null;
+  const item = plan.items[idx];
+  if (!item) return null;
+  let updatedPlan = plan;
+  if (item.status !== "done") {
+    updatedPlan = setPlanItemStatus(plan, idOrIndex, "in_progress");
+  }
+  const todos = [];
+  todos.push({
+    id: `todo_${Date.now()}_plan`,
+    content: item.title,
+    status: "in_progress",
+    activeForm: item.title
+  });
+  if (subtasks && subtasks.length > 0) {
+    for (const st of subtasks) {
+      todos.push({
+        id: `todo_${Date.now()}_${randomUUID().slice(0, 6)}`,
+        content: st,
+        status: "pending"
+      });
+    }
+  }
+  return { plan: updatedPlan, todos };
+}
 function attachPlanCheckpoint(_state, _filePath, _sessionId) {
   return () => void 0;
 }
+
+// src/storage/plan-templates.ts
+var templates = {
+  "new-feature": {
+    name: "new-feature",
+    description: "Standard workflow for adding a new feature",
+    category: "development",
+    items: [
+      { title: "Write specification / design doc", details: "Define scope, acceptance criteria, edge cases" },
+      { title: "Set up feature branch", details: "git checkout -b feature/..." },
+      { title: "Implement core logic", details: "TDD preferred \u2014 write tests first" },
+      { title: "Add unit tests", details: ">= 80% coverage for new code" },
+      { title: "Add integration tests", details: "End-to-end happy path + error paths" },
+      { title: "Update documentation", details: "README, API docs, changelog" },
+      { title: "Code review", details: "Self-review before requesting review" },
+      { title: "Merge and deploy", details: "CI green, tag release" }
+    ]
+  },
+  "bug-fix": {
+    name: "bug-fix",
+    description: "Systematic approach to fixing bugs",
+    category: "maintenance",
+    items: [
+      { title: "Reproduce the bug", details: "Minimal reproduction case" },
+      { title: "Root cause analysis", details: "Trace through logs, debugger" },
+      { title: "Write failing test", details: "Test must fail before fix" },
+      { title: "Implement fix", details: "Smallest possible change" },
+      { title: "Verify fix", details: "Test passes, reproduction no longer fails" },
+      { title: "Regression test", details: "Ensure no related tests broken" },
+      { title: "Document in changelog", details: "Brief description + issue link" }
+    ]
+  },
+  "refactor": {
+    name: "refactor",
+    description: "Safe refactoring workflow",
+    category: "maintenance",
+    items: [
+      { title: "Identify refactoring target", details: "Code smell, performance bottleneck, or tech debt" },
+      { title: "Ensure test coverage", details: "Existing tests must pass before and after" },
+      { title: "Write characterization tests", details: "Capture current behavior if tests weak" },
+      { title: "Apply refactoring", details: "Small steps, frequent commits" },
+      { title: "Run full test suite", details: "All tests must pass" },
+      { title: "Performance check", details: "Ensure no regression" },
+      { title: "Code review", details: "Explain the why, not just the what" }
+    ]
+  },
+  "release": {
+    name: "release",
+    description: "Preparing a new release",
+    category: "release",
+    items: [
+      { title: "Version bump", details: "package.json, lockfiles, tags" },
+      { title: "Update changelog", details: "All changes since last release" },
+      { title: "Run full test suite", details: "Unit + integration + e2e" },
+      { title: "Build artifacts", details: "Docker images, bundles, binaries" },
+      { title: "Staging smoke tests", details: "Deploy to staging, verify" },
+      { title: "Production deploy", details: "Blue-green or canary" },
+      { title: "Post-deploy verification", details: "Health checks, error rates" },
+      { title: "Announce release", details: "Slack, email, GitHub release notes" }
+    ]
+  },
+  "security-audit": {
+    name: "security-audit",
+    description: "Security review and hardening",
+    category: "infrastructure",
+    items: [
+      { title: "Dependency audit", details: "npm audit, Snyk, Dependabot alerts" },
+      { title: "Secret scan", details: "git-secrets, truffleHog, manual review" },
+      { title: "Access control review", details: "IAM, roles, least privilege" },
+      { title: "Input validation audit", details: "SQL injection, XSS, path traversal" },
+      { title: "Authentication review", details: "Session management, MFA, password policy" },
+      { title: "Logging and monitoring", details: "PII in logs, audit trails" },
+      { title: "Incident response plan", details: "Runbooks, contacts, escalation" }
+    ]
+  },
+  "onboarding": {
+    name: "onboarding",
+    description: "New developer onboarding checklist",
+    category: "infrastructure",
+    items: [
+      { title: "Repository access", details: "GitHub/GitLab permissions" },
+      { title: "Local environment setup", details: "Docker, dependencies, env files" },
+      { title: "Run tests locally", details: "Verify green suite" },
+      { title: "Read architecture docs", details: "ADR, README, onboarding guide" },
+      { title: "First commit", details: "Docs fix or small improvement" },
+      { title: "Pair programming session", details: "Walk through codebase with buddy" },
+      { title: "Deploy to staging", details: "Verify CI/CD access" }
+    ]
+  }
+};
+function listPlanTemplates() {
+  return Object.values(templates);
+}
+function getPlanTemplate(name) {
+  return templates[name];
+}
+function formatPlanTemplates() {
+  const cats = /* @__PURE__ */ new Map();
+  for (const t2 of Object.values(templates)) {
+    const arr = cats.get(t2.category) ?? [];
+    arr.push(t2);
+    cats.set(t2.category, arr);
+  }
+  const lines = ["Available plan templates:"];
+  for (const [cat, items] of cats) {
+    lines.push(`
+${cat}:`);
+    for (const t2 of items) {
+      lines.push(`  ${t2.name.padEnd(18)} \u2014 ${t2.description}`);
+    }
+  }
+  return lines.join("\n");
+}
 async function loadDirectorState(filePath) {
   let raw;
   try {
@@ -5359,15 +5506,48 @@ async function loadDirectorState(filePath) {
     return null;
   }
 }
+async function acquireDirectorStateLock(lockPath, processId = process.pid) {
+  let existing;
+  try {
+    existing = await fsp2.readFile(lockPath, "utf8");
+  } catch {
+  }
+  if (existing) {
+    try {
+      const lock2 = JSON.parse(existing);
+      try {
+        process.kill(lock2.pid, 0);
+        return false;
+      } catch {
+      }
+    } catch {
+    }
+  }
+  const lock = {
+    pid: processId,
+    hostname: __require("os").hostname(),
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await atomicWrite(lockPath, JSON.stringify(lock), { mode: 384 });
+  return true;
+}
+async function releaseDirectorStateLock(lockPath) {
+  try {
+    await fsp2.unlink(lockPath);
+  } catch {
+  }
+}
 var DirectorStateCheckpoint = class {
   snapshot;
   filePath;
+  lockPath;
   timer = null;
   debounceMs;
   writing = false;
   rewriteRequested = false;
   constructor(filePath, init, debounceMs = 250) {
     this.filePath = filePath;
+    this.lockPath = `${filePath}.lock`;
     this.debounceMs = debounceMs;
     this.snapshot = {
       version: 1,
@@ -5377,10 +5557,36 @@ var DirectorStateCheckpoint = class {
       maxSpawns: init.maxSpawns,
       spawnDepth: init.spawnDepth,
       maxSpawnDepth: init.maxSpawnDepth,
+      directorBudget: init.directorBudget,
       subagents: [],
       tasks: []
     };
   }
+  /**
+   * Attempt to acquire the lock for this checkpoint. Call this before
+   * resuming a crashed director run. If it returns false, another
+   * director process is still running this fleet — do not resume.
+   */
+  async acquireLock() {
+    return acquireDirectorStateLock(this.lockPath);
+  }
+  /**
+   * Release the lock on graceful shutdown. Call `flush()` first to ensure
+   * the final checkpoint state is on disk before removing the lock.
+   * Without this, the next resume will see a stale-lock and refuse.
+   */
+  async releaseLock() {
+    return releaseDirectorStateLock(this.lockPath);
+  }
+  /**
+   * Resume from a snapshot previously loaded via `loadDirectorState()`.
+   * Use this when `--resume <runId>` is triggered — the snapshot has
+   * the full fleet state (subagents, tasks) from before the crash; the
+   * checkpoint continues from there.
+   */
+  resume(snapshot) {
+    this.snapshot = snapshot;
+  }
   current() {
     return this.snapshot;
   }
@@ -6864,6 +7070,14 @@ var DoneConditionChecker = class {
           };
         }
         break;
+      case "directive":
+        if (this.condition.maxIterations && state.iterations >= this.condition.maxIterations) {
+          return { done: true, reason: `max iterations (${this.condition.maxIterations}) reached`, ...state };
+        }
+        if (this.condition.maxToolCalls && state.toolCalls >= this.condition.maxToolCalls) {
+          return { done: true, reason: `max tool calls (${this.condition.maxToolCalls}) reached`, ...state };
+        }
+        break;
     }
     return { done: false, iterations: state.iterations, toolCalls: state.toolCalls };
   }
@@ -6883,10 +7097,16 @@ var AutonomousRunner = class {
     const offToolExecuted = this.opts.agent.events?.on?.("tool.executed", () => {
       this.toolCalls++;
     });
+    const offIterationCompleted = this.opts.agent.events?.on?.("iteration.completed", () => {
+      if (this.opts.enableAutonomousContinue && this.opts.doneCondition.type === "directive") {
+        this.iterations++;
+      }
+    });
     try {
       return await this.runLoop();
     } finally {
       offToolExecuted?.();
+      offIterationCompleted?.();
     }
   }
   async runLoop() {
@@ -6910,12 +7130,14 @@ var AutonomousRunner = class {
       const ctrl = new AbortController();
       const timeout = setTimeout(() => ctrl.abort(), this.opts.iterationTimeoutMs ?? 3e4);
       try {
+        const isDirectiveMode = this.opts.doneCondition.type === "directive" && this.opts.enableAutonomousContinue;
         const result = await this.opts.agent.run("", {
           signal: ctrl.signal,
-          maxIterations: 1,
-          executionStrategy: "sequential"
+          maxIterations: isDirectiveMode ? this.opts.doneCondition.maxIterations ?? 100 : 1,
+          executionStrategy: "sequential",
+          autonomousContinue: isDirectiveMode ? true : void 0
         });
-        this.iterations++;
+        if (!isDirectiveMode) this.iterations++;
         if (result.status === "done") {
           this.lastOutput = result.finalText;
         }
@@ -8112,7 +8334,10 @@ function makeSpawnTool(director, roster) {
         const subagentId = await director.spawn(cfg);
         return { subagentId, provider: cfg.provider, model: cfg.model, name: cfg.name };
       } catch (err) {
-        if (err instanceof DirectorBudgetError) {
+        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) };
@@ -8252,9 +8477,68 @@ function makeFleetUsageTool(director) {
     }
   };
 }
+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." },
+        /** Number of trailing lines to return (last N JSONL lines). Default: all. */
+        tail: { type: "number", description: "Number of trailing JSONL lines to return. Omit for the full transcript." }
+      },
+      required: ["subagentId"]
+    },
+    async execute(input) {
+      const i = input;
+      const result = await director.readSession(i.subagentId, i.tail);
+      if (!result) {
+        return {
+          error: `fleet_session: transcript unavailable for "${i.subagentId}". Is sessionsRoot configured?`
+        };
+      }
+      return result;
+    }
+  };
+}
+function makeFleetHealthTool(director) {
+  return {
+    name: "fleet_health",
+    description: "Per-subagent health report: budget pressure (pct of limits consumed), last activity timestamp, and current status. Use to decide whether to assign more work to a subagent or spawn a fresh one.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      const status = director.status();
+      const snapshot = director.snapshot();
+      const subagents = status.subagents ?? [];
+      const perSubagent = snapshot.perSubagent ?? {};
+      return {
+        subagents: subagents.map((s) => {
+          const usage = perSubagent[s.id];
+          return {
+            id: s.id,
+            status: s.status,
+            lastEventAt: usage?.lastEventAt,
+            // Budget pressure: fraction of each limit consumed if we have it.
+            // BudgetWarning events carry used/limit ratios; surface them here.
+            budgetPressure: {
+              iterations: usage?.iterations,
+              toolCalls: usage?.toolCalls,
+              costUsd: usage?.cost
+            }
+          };
+        })
+      };
+    }
+  };
+}
 
 // src/coordination/director.ts
-var DirectorBudgetError = class extends Error {
+var FleetSpawnBudgetError = class extends Error {
   kind;
   limit;
   observed;
@@ -8262,16 +8546,48 @@ var DirectorBudgetError = class extends Error {
     super(
       kind === "max_spawns" ? `Director spawn budget exceeded: tried to spawn #${observed} but maxSpawns is ${limit}` : `Director spawn depth budget exceeded: this director is at depth ${observed} and maxSpawnDepth is ${limit}`
     );
-    this.name = "DirectorBudgetError";
+    this.name = "FleetSpawnBudgetError";
     this.kind = kind;
     this.limit = limit;
     this.observed = observed;
   }
 };
+var FleetCostCapError = class extends Error {
+  kind;
+  limit;
+  observed;
+  constructor(limit, observed) {
+    super(
+      `Director cost cap exceeded: total fleet spend ${observed.toFixed(4)} exceeds maxCostUsd ${limit.toFixed(4)}`
+    );
+    this.name = "FleetCostCapError";
+    this.kind = "max_cost_usd";
+    this.limit = limit;
+    this.observed = observed;
+  }
+};
 var Director = class {
+  /** Alias for the ICoordinator contract. `id` is retained for backward compatibility. */
+  get coordinatorId() {
+    return this.id;
+  }
   id;
+  /**
+   * The fleet event bus. Backed by `fleetManager?.fleet` when a FleetManager
+   * is injected; otherwise own FleetBus instance (preserves existing behavior).
+   */
   fleet;
+  /**
+   * Usage rollup. Backed by `fleetManager?.usage` when a FleetManager is
+   * injected; otherwise own FleetUsageAggregator.
+   */
   usage;
+  /**
+   * Optional fleet-level policy container. When provided the Director
+   * delegates spawn budgeting, manifest entries, and checkpointing to it
+   * instead of managing those internally. All other behavior is unchanged.
+   */
+  fleetManager;
   /**
    * Director-side bridge endpoint. Subagents are wired to the same
    * in-memory transport so the director can `ask()` them synchronously
@@ -8322,6 +8638,14 @@ var Director = class {
   /** Debounce timer for periodic manifest writes. */
   manifestTimer = null;
   manifestDebounceMs;
+  /** Fleet-wide cost cap (entire fleet total, distinct from SubagentBudget limits). Infinity means no cap. */
+  maxFleetCostUsd;
+  /** Max auto-extensions per subagent per budget kind before denying. */
+  maxBudgetExtensions;
+  /** Sessions root for direct subagent JSONL reads (fleet_session tool). */
+  sessionsRoot;
+  /** Director run id for JSONL path resolution. */
+  directorRunId;
   /** Resolves task descriptions back from `assign()` so completion events
    *  can also carry a human-readable title. */
   taskDescriptions = /* @__PURE__ */ new Map();
@@ -8348,12 +8672,18 @@ var Director = class {
     this.spawnDepth = opts.spawnDepth ?? 0;
     this.sessionWriter = opts.sessionWriter ?? null;
     this.manifestDebounceMs = opts.manifestDebounceMs ?? 2e3;
+    this.maxFleetCostUsd = opts.directorBudget?.maxCostUsd ?? Number.POSITIVE_INFINITY;
+    this.maxBudgetExtensions = opts.maxBudgetExtensions ?? 2;
+    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
-    }) : null;
+      maxSpawnDepth: this.maxSpawnDepth,
+      directorBudget: opts.directorBudget
+    }, opts.checkpointDebounceMs ?? 250) : null;
+    this.fleetManager = opts.fleetManager;
     if (this.sharedScratchpadPath) {
       void fsp2.mkdir(this.sharedScratchpadPath, { recursive: true }).catch(() => void 0);
     }
@@ -8362,12 +8692,17 @@ var Director = class {
       { agentId: this.id, coordinatorId: this.id },
       this.transport
     );
-    this.fleet = new FleetBus();
-    this.usage = new FleetUsageAggregator(
-      this.fleet,
-      (id) => this.priceLookups.get(id),
-      (id) => this.subagentMeta.get(id)
-    );
+    if (this.fleetManager) {
+      this.fleet = this.fleetManager.fleet;
+      this.usage = this.fleetManager.usage;
+    } else {
+      this.fleet = new FleetBus();
+      this.usage = new FleetUsageAggregator(
+        this.fleet,
+        (id) => this.priceLookups.get(id),
+        (id) => this.subagentMeta.get(id)
+      );
+    }
     this.coordinator = new DefaultMultiAgentCoordinator(
       { ...opts.config, coordinatorId: this.id },
       { runner: opts.runner }
@@ -8414,7 +8749,7 @@ var Director = class {
       const payload = e.payload;
       const guardKey = `${e.subagentId}:${payload.kind}`;
       const prior = extendCounts.get(guardKey) ?? 0;
-      if (prior >= 2) {
+      if (prior >= this.maxBudgetExtensions) {
         payload.deny();
         extendCounts.delete(guardKey);
         return;
@@ -8469,52 +8804,73 @@ var Director = class {
    * it the `cost` column in `usage.snapshot()` stays at 0.
    */
   async spawn(config, priceLookup) {
-    if (this.spawnDepth >= this.maxSpawnDepth) {
-      throw new DirectorBudgetError("max_spawn_depth", this.maxSpawnDepth, this.spawnDepth);
-    }
-    if (this.spawnCount >= this.maxSpawns) {
-      throw new DirectorBudgetError("max_spawns", this.maxSpawns, this.spawnCount + 1);
+    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);
+      }
+    } else {
+      if (this.spawnDepth >= this.maxSpawnDepth) {
+        throw new FleetSpawnBudgetError("max_spawn_depth", this.maxSpawnDepth, this.spawnDepth);
+      }
+      if (this.spawnCount >= this.maxSpawns) {
+        throw new FleetSpawnBudgetError("max_spawns", this.maxSpawns, this.spawnCount + 1);
+      }
+      if (this.maxFleetCostUsd < Number.POSITIVE_INFINITY) {
+        const totalCost = this.usage.snapshot().total?.cost ?? 0;
+        if (totalCost >= this.maxFleetCostUsd) {
+          throw new FleetCostCapError(this.maxFleetCostUsd, totalCost);
+        }
+      }
     }
     const result = await this.coordinator.spawn(config);
-    this.spawnCount += 1;
-    this.subagentMeta.set(result.subagentId, {
-      provider: config.provider,
-      model: config.model
-    });
-    if (priceLookup) this.priceLookups.set(result.subagentId, priceLookup);
+    if (this.fleetManager) {
+      this.fleetManager.recordSpawn(result.subagentId, config, priceLookup);
+    } else {
+      this.spawnCount += 1;
+      this.subagentMeta.set(result.subagentId, {
+        provider: config.provider,
+        model: config.model
+      });
+      if (priceLookup) this.priceLookups.set(result.subagentId, priceLookup);
+    }
     const subagentBridge = new InMemoryAgentBridge(
       { agentId: result.subagentId, coordinatorId: this.id },
       this.transport
     );
     this.coordinator.setSubagentBridge(result.subagentId, subagentBridge);
     this.subagentBridges.set(result.subagentId, subagentBridge);
-    this.manifestEntries.set(result.subagentId, {
-      subagentId: result.subagentId,
-      name: config.name,
-      role: config.role,
-      provider: config.provider,
-      model: config.model,
-      taskIds: []
-    });
-    const spawnedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.stateCheckpoint?.recordSpawn(
-      {
-        id: result.subagentId,
+    if (!this.fleetManager) {
+      this.manifestEntries.set(result.subagentId, {
+        subagentId: result.subagentId,
         name: config.name,
         role: config.role,
         provider: config.provider,
         model: config.model,
-        spawnedAt
-      },
-      this.spawnCount
-    );
-    void this.appendSessionEvent({
-      type: "agent_spawned",
-      ts: spawnedAt,
-      agentId: result.subagentId,
-      role: config.role ?? config.name
-    });
-    this.scheduleManifest();
+        taskIds: []
+      });
+      const spawnedAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.stateCheckpoint?.recordSpawn(
+        {
+          id: result.subagentId,
+          name: config.name,
+          role: config.role,
+          provider: config.provider,
+          model: config.model,
+          spawnedAt
+        },
+        this.spawnCount
+      );
+      void this.appendSessionEvent({
+        type: "agent_spawned",
+        ts: spawnedAt,
+        agentId: result.subagentId,
+        role: config.role ?? config.name
+      });
+      this.scheduleManifest();
+    }
     return result.subagentId;
   }
   /**
@@ -8654,6 +9010,7 @@ var Director = class {
     if (this.stateCheckpoint) {
       this.stateCheckpoint.setUsage(this.usage.snapshot());
       await this.stateCheckpoint.flush().catch((err) => this.logShutdownError("state_checkpoint_flush", err));
+      await this.stateCheckpoint.releaseLock().catch((err) => this.logShutdownError("state_checkpoint_lock_release", err));
     }
   }
   /**
@@ -8680,8 +9037,12 @@ var Director = class {
   async assign(task) {
     const taskWithId = task.id ? task : { ...task, id: randomUUID() };
     if (task.subagentId) {
-      const entry = this.manifestEntries.get(task.subagentId);
-      if (entry) entry.taskIds.push(taskWithId.id);
+      if (this.fleetManager) {
+        this.fleetManager.addTaskToSubagent(task.subagentId, taskWithId.id);
+      } else {
+        const entry = this.manifestEntries.get(task.subagentId);
+        if (entry) entry.taskIds.push(taskWithId.id);
+      }
     }
     await this.coordinator.assign(taskWithId);
     this.taskDescriptions.set(taskWithId.id, taskWithId.description);
@@ -8757,6 +9118,58 @@ var Director = class {
   completedResults() {
     return Array.from(this.completed.values());
   }
+  /**
+   * Inject a previously-saved checkpoint snapshot. Call this right after
+   * constructing a Director during a `--resume` run so the in-memory state
+   * (subagents, tasks, waiters) reflects the pre-crash reality instead of
+   * starting from a blank slate. The director then resumes from there —
+   * completing any in-flight tasks and ignoring tasks that already reached
+   * a terminal state in the prior run.
+   */
+  setCheckpointState(snapshot) {
+    this.stateCheckpoint?.resume(snapshot);
+  }
+  /**
+   * Read a subagent's JSONL transcript directly from disk (no bridge
+   * round-trip needed). Returns the last assistant text, stop reason,
+   * tool-use count, and line count — or null if the file is unavailable.
+   * Requires `sessionsRoot` to be set on construction.
+   */
+  async readSession(subagentId, tail) {
+    if (!this.sessionsRoot) return null;
+    const filePath = path6.join(this.sessionsRoot, this.directorRunId, `${subagentId}.jsonl`);
+    let raw;
+    try {
+      raw = await fsp2.readFile(filePath, "utf8");
+    } catch {
+      return null;
+    }
+    const lines = raw.split("\n").filter((l) => l.trim());
+    const targetLines = tail ? lines.slice(-tail) : lines;
+    let lastAssistantText;
+    let lastStopReason;
+    let toolUses = 0;
+    for (const line of targetLines) {
+      try {
+        const ev = JSON.parse(line);
+        if (ev.type === "assistant" && typeof ev.text === "string") {
+          lastAssistantText = ev.text;
+        } else if (ev.type === "stop" && ev.stopReason) {
+          lastStopReason = ev.stopReason;
+        } else if (ev.type === "tool_use") {
+          toolUses++;
+        }
+      } catch {
+      }
+    }
+    return {
+      lastAssistantText,
+      lastStopReason,
+      toolUsesObserved: toolUses,
+      events: targetLines.length,
+      path: filePath
+    };
+  }
   snapshot() {
     return this.usage.snapshot();
   }
@@ -8827,18 +9240,37 @@ var Director = class {
    * still permission-checked normally.
    */
   tools(roster) {
+    const effectiveRoster = roster ?? this.roster;
     const t2 = [
-      makeSpawnTool(this, roster),
+      makeSpawnTool(this, effectiveRoster),
       makeAssignTool(this),
       makeAwaitTasksTool(this),
       makeAskTool(this),
       makeRollUpTool(this),
       makeTerminateTool(this),
       makeFleetStatusTool(this),
-      makeFleetUsageTool(this)
+      makeFleetUsageTool(this),
+      makeFleetSessionTool(this),
+      makeFleetHealthTool(this)
     ];
     return t2;
   }
+  /**
+   * Attempt to acquire the checkpoint lock. Must be called before
+   * resuming — if another director process is alive, this returns
+   * false and the caller should not proceed with the resume.
+   */
+  async acquireCheckpointLock() {
+    return this.stateCheckpoint ? this.stateCheckpoint.acquireLock() : true;
+  }
+  /**
+   * Resume from a prior checkpoint snapshot (loaded via
+   * `loadDirectorState()`). Re-attach to the fleet mid-flight so
+   * subsequent spawn/assign calls update the checkpoint normally.
+   */
+  resumeFromCheckpoint(snapshot) {
+    this.stateCheckpoint?.resume(snapshot);
+  }
 };
 function createDelegateTool(opts) {
   const defaultTimeoutMs = opts.defaultTimeoutMs ?? 4 * 60 * 60 * 1e3;
@@ -8944,7 +9376,7 @@ function createDelegateTool(opts) {
         if (typeof i.maxToolCalls === "number" && i.maxToolCalls > 0) {
           cfg.maxToolCalls = i.maxToolCalls;
         }
-        const SUBAGENT_TIMEOUT_BUFFER_MS = 3e4;
+        const SUBAGENT_TIMEOUT_BUFFER_MS = opts.subagentTimeoutBufferMs ?? 3e4;
         const desiredSubTimeout = Math.max(3e4, timeoutMs - SUBAGENT_TIMEOUT_BUFFER_MS);
         if (!cfg.timeoutMs || cfg.timeoutMs > desiredSubTimeout) {
           cfg.timeoutMs = desiredSubTimeout;
@@ -8996,7 +9428,7 @@ function createDelegateTool(opts) {
           toolCalls: result.toolCalls,
           durationMs: result.durationMs,
           ...partial ? { partial } : {},
-          ...hintForKind(errorKind, retryable, backoffMs) ? { hint: hintForKind(errorKind, retryable, backoffMs) } : {}
+          ...hintForKind(errorKind, retryable, backoffMs, partial) ? { hint: hintForKind(errorKind, retryable, backoffMs, partial) } : {}
         };
       } catch (err) {
         return {
@@ -9016,7 +9448,7 @@ function instantiateRosterConfig2(role, base) {
     id: `${role}-${randomUUID().slice(0, 8)}`
   };
 }
-function hintForKind(kind, retryable, backoffMs) {
+function hintForKind(kind, retryable, backoffMs, partial) {
   if (!kind) return void 0;
   switch (kind) {
     case "provider_rate_limit":
@@ -9032,16 +9464,40 @@ function hintForKind(kind, retryable, backoffMs) {
     case "budget_iterations":
     case "budget_tool_calls":
     case "budget_tokens":
-    case "budget_cost":
-      return "Subagent exhausted its budget. The coordinator may auto-extend; otherwise raise the matching `max*` field (e.g. maxToolCalls: 600) on the next delegate, or split the task.";
-    case "budget_timeout":
-      return "Subagent hit its wall-clock budget. Raise `timeoutMs` on the next delegate or split the task.";
+    case "budget_cost": {
+      const base = "Subagent exhausted its budget. The coordinator may auto-extend; otherwise raise the matching `max*` field (e.g. maxToolCalls: 600) on the next delegate, or split the task.";
+      if (partial?.lastAssistantText) {
+        return `${base}
+
+Partial output produced before budget hit:
+${partial.lastAssistantText}`;
+      }
+      return base;
+    }
+    case "budget_timeout": {
+      const base = "Subagent hit its wall-clock budget. Raise `timeoutMs` on the next delegate or split the task.";
+      if (partial?.lastAssistantText) {
+        return `${base}
+
+Partial output produced before timeout:
+${partial.lastAssistantText}`;
+      }
+      return base;
+    }
     case "aborted_by_parent":
       return "Subagent was aborted (user Ctrl+C, parent unwound, or sibling failure cascade). Not retryable until the abort condition is resolved.";
     case "empty_response":
       return "Subagent ended its turn with no text and no tool calls. Almost always a prompt / config issue \u2014 clarify the task or check the model.";
-    case "tool_failed":
-      return "A tool inside the subagent returned ok:false. Inspect `partial.lastAssistantText` for the agent reasoning, then retry with corrected inputs.";
+    case "tool_failed": {
+      const base = "A tool inside the subagent returned ok:false. Retry with corrected inputs.";
+      if (partial?.lastAssistantText) {
+        return `${base}
+
+Agent reasoning before failure:
+${partial.lastAssistantText}`;
+      }
+      return base;
+    }
     case "bridge_failed":
       return "Parent-child bridge transport failed. This is rare \u2014 restart the session and retry.";
     default:
@@ -9252,6 +9708,9 @@ function makeDirectorSessionFactory(opts) {
     }
   };
 }
+
+// src/coordination/null-fleet-bus.ts
+var NULL_FLEET_BUS = new FleetBus();
 var DefaultModeStore = class {
   activeModeId = null;
   modes;
@@ -10577,10 +11036,10 @@ var AISpecBuilder = class {
   async saveSession() {
     if (!this.sessionPath) return;
     try {
-      const fsp14 = await import('fs/promises');
-      const path24 = await import('path');
-      await fsp14.mkdir(path24.dirname(this.sessionPath), { recursive: true });
-      await fsp14.writeFile(this.sessionPath, JSON.stringify(this.session, null, 2), "utf8");
+      const fsp15 = await import('fs/promises');
+      const path25 = await import('path');
+      await fsp15.mkdir(path25.dirname(this.sessionPath), { recursive: true });
+      await fsp15.writeFile(this.sessionPath, JSON.stringify(this.session, null, 2), "utf8");
     } catch {
     }
   }
@@ -10588,8 +11047,8 @@ var AISpecBuilder = class {
   async loadSession() {
     if (!this.sessionPath) return false;
     try {
-      const fsp14 = await import('fs/promises');
-      const raw = await fsp14.readFile(this.sessionPath, "utf8");
+      const fsp15 = await import('fs/promises');
+      const raw = await fsp15.readFile(this.sessionPath, "utf8");
       const loaded = JSON.parse(raw);
       if (loaded?.id && loaded?.phase && loaded?.title) {
         this.session = loaded;
@@ -10603,8 +11062,8 @@ var AISpecBuilder = class {
   async deleteSession() {
     if (!this.sessionPath) return;
     try {
-      const fsp14 = await import('fs/promises');
-      await fsp14.unlink(this.sessionPath);
+      const fsp15 = await import('fs/promises');
+      await fsp15.unlink(this.sessionPath);
     } catch {
     }
   }
@@ -11282,15 +11741,15 @@ function computeCriticalPath(graph, topoOrder, blockedByMap) {
       maxId = id;
     }
   }
-  const path24 = [];
+  const path25 = [];
   let current = maxId;
   const visited = /* @__PURE__ */ new Set();
   while (current && !visited.has(current)) {
     visited.add(current);
-    path24.unshift(current);
+    path25.unshift(current);
     current = prev.get(current) ?? null;
   }
-  return path24;
+  return path25;
 }
 function computeParallelGroups(graph, blockedByMap) {
   const groups = [];
@@ -12000,7 +12459,7 @@ async function startMetricsServer(opts) {
   const tls = opts.tls;
   const useHttps = !!(tls?.cert && tls?.key);
   const host = opts.host ?? "127.0.0.1";
-  const path24 = opts.path ?? "/metrics";
+  const path25 = opts.path ?? "/metrics";
   const healthPath = opts.healthPath ?? "/healthz";
   const healthRegistry = opts.healthRegistry;
   const listener = (req, res) => {
@@ -12010,7 +12469,7 @@ async function startMetricsServer(opts) {
       return;
     }
     const url = req.url.split("?")[0];
-    if (url === path24) {
+    if (url === path25) {
       let body;
       try {
         body = renderPrometheus(opts.sink.snapshot());
@@ -12074,7 +12533,7 @@ async function startMetricsServer(opts) {
   const protocol = useHttps ? "https" : "http";
   return {
     port: boundPort,
-    url: `${protocol}://${host}:${boundPort}${path24}`,
+    url: `${protocol}://${host}:${boundPort}${path25}`,
     close: () => new Promise((resolve5, reject) => {
       server.close((err) => err ? reject(err) : resolve5());
     })
@@ -14182,8 +14641,8 @@ var ReportGenerator = class {
     try {
       await stat(this.options.outputDir);
     } catch {
-      const { mkdir: mkdir10 } = await import('fs/promises');
-      await mkdir10(this.options.outputDir, { recursive: true });
+      const { mkdir: mkdir11 } = await import('fs/promises');
+      await mkdir11(this.options.outputDir, { recursive: true });
     }
   }
   generateMarkdown(result) {
@@ -15084,16 +15543,16 @@ Use \`/security report <number>\` to view a specific report.` };
     }
     const index = parseInt(reportId, 10) - 1;
     if (!isNaN(index) && reports[index]) {
-      const { readFile: readFile27 } = await import('fs/promises');
-      const content = await readFile27(join(reportsDir, reports[index]), "utf-8");
+      const { readFile: readFile28 } = await import('fs/promises');
+      const content = await readFile28(join(reportsDir, reports[index]), "utf-8");
       return { message: `# Security Report
 
 ${content}` };
     }
     const match = reports.find((r) => r.includes(reportId));
     if (match) {
-      const { readFile: readFile27 } = await import('fs/promises');
-      const content = await readFile27(join(reportsDir, match), "utf-8");
+      const { readFile: readFile28 } = await import('fs/promises');
+      const content = await readFile28(join(reportsDir, match), "utf-8");
       return { message: `# Security Report
 
 ${content}` };
@@ -15143,6 +15602,202 @@ function getHelpMessage() {
 `;
 }
 var securitySlashCommand = createSecuritySlashCommand();
+var FleetManager = class {
+  /** The fleet-wide event bus. */
+  fleet;
+  /** Usage rollup across all subagents. */
+  usage;
+  manifestPath;
+  sessionsRoot;
+  directorRunId;
+  /** Spawn cap (lifetime total). Infinity means unlimited. */
+  maxSpawns;
+  /** Nesting cap. */
+  maxSpawnDepth;
+  /** This director's depth in a director chain. Root = 0. */
+  spawnDepth;
+  /** Live spawn counter. */
+  spawnCount = 0;
+  stateCheckpoint;
+  sessionWriter;
+  manifestTimer = null;
+  manifestDebounceMs;
+  /** Fleet-wide cost cap. Infinity = no cap. Distinct from SubagentBudget limits,
+   *  which track per-subagent spend — this field caps the entire fleet total. */
+  maxFleetCostUsd;
+  manifestEntries = /* @__PURE__ */ new Map();
+  /** Pending tasks with their descriptions — populated by `addPendingTask`
+   *  and cleared by `removePendingTask`. Replaces the host-side `pending`
+   *  Map so task descriptions live in one place (FleetManager). */
+  pendingTasks = /* @__PURE__ */ new Map();
+  subagentMeta = /* @__PURE__ */ new Map();
+  priceLookups = /* @__PURE__ */ new Map();
+  constructor(opts = {}) {
+    this.manifestPath = opts.manifestPath;
+    this.sessionsRoot = opts.sessionsRoot;
+    this.directorRunId = opts.directorRunId ?? randomUUID();
+    this.maxSpawns = opts.maxSpawns ?? Number.POSITIVE_INFINITY;
+    this.maxSpawnDepth = opts.maxSpawnDepth ?? 2;
+    this.spawnDepth = opts.spawnDepth ?? 0;
+    this.sessionWriter = opts.sessionWriter ?? null;
+    this.manifestDebounceMs = opts.manifestDebounceMs ?? 2e3;
+    this.maxFleetCostUsd = opts.directorBudget?.maxCostUsd ?? Number.POSITIVE_INFINITY;
+    this.stateCheckpoint = opts.stateCheckpointPath ? new DirectorStateCheckpoint(
+      opts.stateCheckpointPath,
+      {
+        directorRunId: this.directorRunId,
+        maxSpawns: opts.maxSpawns,
+        spawnDepth: this.spawnDepth,
+        maxSpawnDepth: this.maxSpawnDepth,
+        directorBudget: opts.directorBudget
+      },
+      opts.checkpointDebounceMs ?? 250
+    ) : null;
+    this.fleet = new FleetBus();
+    this.usage = new FleetUsageAggregator(
+      this.fleet,
+      (id) => this.priceLookups.get(id),
+      (id) => this.subagentMeta.get(id)
+    );
+  }
+  // -----------------------------------------------------------------------
+  // IFleetManager surface
+  // -----------------------------------------------------------------------
+  get fleetBus() {
+    return this.fleet;
+  }
+  snapshot() {
+    return this.usage.snapshot();
+  }
+  getSubagentMeta(id) {
+    return this.subagentMeta.get(id);
+  }
+  /**
+   * Returns null if the spawn is allowed, or an object describing
+   * which cap was exceeded. Does NOT throw — the caller decides
+   * how to surface the rejection.
+   */
+  canSpawn(config) {
+    if (this.spawnDepth >= this.maxSpawnDepth) {
+      return { kind: "max_spawn_depth", limit: this.maxSpawnDepth, observed: this.spawnDepth };
+    }
+    if (this.spawnCount >= this.maxSpawns) {
+      return { kind: "max_spawns", limit: this.maxSpawns, observed: this.spawnCount + 1 };
+    }
+    if (this.maxFleetCostUsd < Number.POSITIVE_INFINITY) {
+      const totalCost = this.usage.snapshot().total?.cost ?? 0;
+      if (totalCost >= this.maxFleetCostUsd) {
+        return { kind: "max_cost_usd", limit: this.maxFleetCostUsd, observed: totalCost };
+      }
+    }
+    return null;
+  }
+  /**
+   * Records a spawn: increments counter, stores metadata, updates state checkpoint,
+   * and schedules a debounced manifest write. Call AFTER the coordinator
+   * has successfully spawned the subagent.
+   *
+   * @param subagentId The subagent's id (from coordinator.spawn result)
+   * @param config The SubagentConfig that was used
+   * @param priceLookup Optional per-subagent pricing data
+   */
+  recordSpawn(subagentId, config, priceLookup) {
+    this.spawnCount += 1;
+    this.subagentMeta.set(subagentId, {
+      provider: config.provider,
+      model: config.model
+    });
+    if (priceLookup) this.priceLookups.set(subagentId, priceLookup);
+    this.manifestEntries.set(subagentId, {
+      subagentId,
+      name: config.name,
+      role: config.role,
+      provider: config.provider,
+      model: config.model,
+      taskIds: []
+    });
+    this.stateCheckpoint?.recordSpawn({
+      id: subagentId,
+      name: config.name,
+      role: config.role,
+      provider: config.provider,
+      model: config.model,
+      spawnedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }, this.spawnCount);
+    void this.appendSessionEvent({
+      type: "agent_spawned",
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      agentId: subagentId,
+      role: config.role ?? config.name
+    });
+    this.scheduleManifest();
+  }
+  async writeManifest() {
+    if (!this.manifestPath) return null;
+    const manifest = {
+      version: 1,
+      directorRunId: this.directorRunId,
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      children: Array.from(this.manifestEntries.values()).map((entry) => ({
+        id: entry.subagentId,
+        name: entry.name,
+        role: entry.role,
+        provider: entry.provider,
+        model: entry.model,
+        taskIds: entry.taskIds
+      })),
+      usage: this.usage.snapshot()
+    };
+    await fsp2.mkdir(path6.dirname(this.manifestPath), { recursive: true });
+    await fsp2.writeFile(this.manifestPath, JSON.stringify(manifest, null, 2), { mode: 384 });
+    return this.manifestPath;
+  }
+  /**
+   * Attach task ids to an already-spawned subagent. Called by
+   * `Director.assign()` after the coordinator assigns a task.
+   */
+  addTaskToSubagent(subagentId, taskId) {
+    const entry = this.manifestEntries.get(subagentId);
+    if (entry) entry.taskIds.push(taskId);
+  }
+  /**
+   * Debounced manifest write. Call after any state mutation
+   * (spawn, assign, complete) so a burst collapses into one write.
+   */
+  scheduleManifest() {
+    if (!this.manifestPath || this.manifestDebounceMs <= 0) return;
+    if (this.manifestTimer) return;
+    this.manifestTimer = setTimeout(() => {
+      this.manifestTimer = null;
+      void this.writeManifest().catch(() => void 0);
+    }, this.manifestDebounceMs);
+  }
+  /** Best-effort session event writer. Swallows failures. */
+  async appendSessionEvent(event) {
+    if (!this.sessionWriter) return;
+    try {
+      await this.sessionWriter.append(event);
+    } catch {
+    }
+  }
+  // -----------------------------------------------------------------------
+  // Pending task management — eliminates host-side state duplication
+  // -----------------------------------------------------------------------
+  addPendingTask(taskId, subagentId, description) {
+    this.pendingTasks.set(taskId, { subagentId, description });
+  }
+  removePendingTask(taskId) {
+    this.pendingTasks.delete(taskId);
+  }
+  getFleetStatus() {
+    const pending = Array.from(this.pendingTasks.entries()).map(([taskId, v]) => ({
+      taskId,
+      description: v.description,
+      subagentId: v.subagentId
+    }));
+    return { pending, live: [] };
+  }
+};
 
 // src/extension/registry.ts
 var ExtensionRegistry = class {
@@ -15352,6 +16007,50 @@ var ExtensionRegistry = class {
   }
 };
 
+// src/core/continue-to-next-iteration.ts
+function parseContinueDirective(text) {
+  const LINE_MARKERS = /^\s*\[(continue|next step|proceed|done)\]\s*$/gim;
+  let match;
+  let lastDirective = "none";
+  while ((match = LINE_MARKERS.exec(text)) !== null) {
+    const value = (match[1] ?? "").toLowerCase();
+    if (value === "continue" || value === "next step" || value === "proceed") {
+      lastDirective = "continue";
+    } else if (value === "done") {
+      lastDirective = "stop";
+    }
+  }
+  return lastDirective;
+}
+var META_KEY = "_autonomousContinue";
+function setAutonomousContinue(ctx) {
+  ctx.meta[META_KEY] = true;
+}
+function consumeAutonomousContinue(ctx) {
+  const val = ctx.meta[META_KEY] === true;
+  delete ctx.meta[META_KEY];
+  return val;
+}
+function makeContinueToNextIterationTool() {
+  const inputSchema = {
+    type: "object",
+    properties: {},
+    required: [],
+    description: "Signal that the agent should continue to the next iteration immediately, without waiting for user input. Use this when you have completed a step and want to proceed automatically to the next step in your plan."
+  };
+  return {
+    name: "continue_to_next_iteration",
+    description: "Continue to the next iteration without returning to the user. Call this when you have finished a step and want to keep working autonomously.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(_input, ctx) {
+      setAutonomousContinue(ctx);
+      return { continue: true };
+    }
+  };
+}
+
 // src/core/iteration-limit.ts
 function requestLimitExtension(opts) {
   const { events, currentIterations, currentLimit, autoExtend, timeoutMs = 3e4 } = opts;
@@ -15430,6 +16129,8 @@ var Agent = class {
   plugins = [];
   toolExecutor;
   autoExtendLimit;
+  /** Enables autonomous continue: model can signal `[continue]` or call continue_to_next_iteration() to re-run. */
+  autonomousContinue;
   tracer;
   extensions;
   constructor(init) {
@@ -15444,6 +16145,7 @@ var Agent = class {
     this.executionStrategy = init.executionStrategy ?? "smart";
     this.perIterationOutputCapBytes = init.perIterationOutputCapBytes ?? 1e5;
     this.autoExtendLimit = init.autoExtendLimit ?? true;
+    this.autonomousContinue = init.autonomousContinue ?? false;
     this.tracer = init.tracer;
     this.extensions = init.extensions ?? new ExtensionRegistry();
     this.extensions.setLogger(this.container.resolve(TOKENS.Logger));
@@ -15592,6 +16294,9 @@ var Agent = class {
       if (controller.signal.aborted) {
         return { status: "aborted", iterations };
       }
+      if (this.autonomousContinue) {
+        consumeAutonomousContinue(this.ctx);
+      }
       const limitCheck = await this.checkIterationLimit(
         i,
         effectiveLimit,
@@ -15668,12 +16373,32 @@ var Agent = class {
       const toolUses = res.content.filter(isToolUseBlock);
       if (toolUses.length === 0) {
         this.events.emit("iteration.completed", { ctx: this.ctx, index: i });
+        if (this.autonomousContinue && responseResult.directive === "continue") {
+          await this.compactContextIfNeeded();
+          await this.extensions.runAfterIteration(this.ctx, i);
+          continue;
+        }
+        if (this.autonomousContinue && responseResult.directive === "stop") {
+          return { status: "done", iterations, finalText };
+        }
         return { status: "done", iterations, finalText };
       }
       await this.executeTools(toolUses);
+      if (this.autonomousContinue && consumeAutonomousContinue(this.ctx)) {
+        this.events.emit("iteration.completed", { ctx: this.ctx, index: i });
+        await this.compactContextIfNeeded();
+        await this.extensions.runAfterIteration(this.ctx, i);
+        continue;
+      }
       this.events.emit("iteration.completed", { ctx: this.ctx, index: i });
       await this.compactContextIfNeeded();
       await this.extensions.runAfterIteration(this.ctx, i);
+      if (this.autonomousContinue && responseResult.directive === "continue") {
+        continue;
+      }
+      if (this.autonomousContinue && responseResult.directive === "stop") {
+        return { status: "done", iterations, finalText };
+      }
     }
   }
   /**
@@ -15760,7 +16485,11 @@ var Agent = class {
         if (!streamed) this.renderer?.write(rendered);
       }
     }
-    return { finalText, aborted: false, done: false };
+    let directive = "none";
+    if (this.autonomousContinue && finalText) {
+      directive = parseContinueDirective(finalText);
+    }
+    return { finalText, aborted: false, done: false, directive };
   }
   /**
    * Execute tools and append tool results to context.
@@ -17353,6 +18082,6 @@ function wrapApiForCapabilityCheck(plugin, api, log, enforce = false) {
   });
 }
 
-export { AISpecBuilder, ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, Agent, AgentError, AutoApprovePermissionPolicy, AutoCompactionMiddleware, AutoExecutor, AutonomousRunner, BUG_HUNTER_AGENT, BudgetExceededError, CONTEXT_WINDOW_MODES, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultProviderRunner, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, Director, DirectorBudgetError, DirectorStateCheckpoint, DoneConditionChecker, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FleetBus, FleetUsageAggregator, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, REFACTOR_PLANNER_AGENT, RecoveryLock, ReportGenerator, RunController, SECURITY_SCANNER_AGENT, SPEC_TEMPLATES, ScopedEventBus, SecurityScanner, SecurityScannerOrchestrator, SelectiveCompactor, SessionAnalyzer, SessionError, SkillGenerator, SkillInstaller, SkillManifestStore, SlashCommandRegistry, SpecDrivenDev, SpecParser, SpecStore, SpecVersioning, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskGraphStore, TaskTracker, TechStackDetector, ToolError, ToolExecutor, ToolRegistry, WrongStackError, addPlanItem, allServers, analyzeCriticalPath, applyRosterBudget, asBlocks, asText, atomicWrite, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildChildEnv, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, color, compileGlob, compileUserRegex, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, context7Server, contextManagerTool, createAutoExecutor, createContextManagerTool, createDefaultPipelines, createDelegateTool, createMessage, createSecuritySlashCommand, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, detectNewlineStyle, downloadGitHubTarball, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatPlan, formatTodosList, getContextWindowMode, getTemplate, githubServer, googleMapsServer, isAgentError, isConfigError, isContextWindowModeId, isImageBlock, isPluginError, isSessionError, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, listContextWindowModes, listTemplates, loadDirectorState, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeDirectorSessionFactory, matchAny, matchGlob, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, parseSkillRef, projectHash, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resolveContextWindowPolicy, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, savePlan, saveTodosCheckpoint, securitySlashCommand, sentinelServer, setPlanItemStatus, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, zaiVisionServer };
+export { AISpecBuilder, ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, Agent, AgentError, AutoApprovePermissionPolicy, AutoCompactionMiddleware, AutoExecutor, AutonomousRunner, BUG_HUNTER_AGENT, BudgetExceededError, CONTEXT_WINDOW_MODES, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultProviderRunner, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, Director, DirectorStateCheckpoint, DoneConditionChecker, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FleetBus, FleetManager, FleetSpawnBudgetError, FleetUsageAggregator, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, NULL_FLEET_BUS, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, REFACTOR_PLANNER_AGENT, RecoveryLock, ReportGenerator, RunController, SECURITY_SCANNER_AGENT, SPEC_TEMPLATES, ScopedEventBus, SecurityScanner, SecurityScannerOrchestrator, SelectiveCompactor, SessionAnalyzer, SessionError, SkillGenerator, SkillInstaller, SkillManifestStore, SlashCommandRegistry, SpecDrivenDev, SpecParser, SpecStore, SpecVersioning, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskGraphStore, TaskTracker, TechStackDetector, ToolError, ToolExecutor, ToolRegistry, WrongStackError, addPlanItem, allServers, analyzeCriticalPath, applyRosterBudget, asBlocks, asText, atomicWrite, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildChildEnv, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, color, compileGlob, compileUserRegex, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, context7Server, contextManagerTool, createAutoExecutor, createContextManagerTool, createDefaultPipelines, createDelegateTool, createMessage, createSecuritySlashCommand, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, deriveTodosFromPlanItem, detectNewlineStyle, downloadGitHubTarball, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatPlan, formatPlanTemplates, formatTodosList, getContextWindowMode, getPlanTemplate, getTemplate, githubServer, googleMapsServer, isAgentError, isConfigError, isContextWindowModeId, isImageBlock, isPluginError, isSessionError, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, listContextWindowModes, listPlanTemplates, listTemplates, loadDirectorState, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeContinueToNextIterationTool, makeDirectorSessionFactory, matchAny, matchGlob, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, parseContinueDirective, parseSkillRef, projectHash, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resolveContextWindowPolicy, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, savePlan, saveTodosCheckpoint, securitySlashCommand, sentinelServer, setPlanItemStatus, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, zaiVisionServer };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map