@wrongstack/core 0.7.5 → 0.7.7

package/dist/index.js

@@ -5,7 +5,7 @@ import { readFile, readdir, stat, mkdir } from 'fs/promises';
 import * as path6 from 'path';
 import { join, extname, relative } from 'path';
 import * as fs2 from 'fs';
-import * as os4 from 'os';
+import * as os5 from 'os';
 import { execFile, spawn } from 'child_process';
 import { promisify } from 'util';
 import { EventEmitter } from 'events';
@@ -93,7 +93,7 @@ async function renameWithRetry(from, to) {
       if (!code || !TRANSIENT_RENAME_CODES.has(code) || i === delays.length) {
         throw err;
       }
-      await new Promise((resolve5) => setTimeout(resolve5, delays[i]));
+      await new Promise((resolve6) => setTimeout(resolve6, delays[i]));
     }
   }
   throw lastErr;
@@ -1048,7 +1048,9 @@ var DefaultSecretVault = class {
     try {
       const buf = fs2.readFileSync(this.keyFile);
       if (buf.length !== KEY_BYTES) {
-        throw new Error(`SecretVault: key file ${this.keyFile} has wrong size`);
+        throw new Error(
+          `SecretVault: key file ${this.keyFile} is ${buf.length} bytes (expected ${KEY_BYTES}). Remove it manually to generate a new key.`
+        );
       }
       this.key = buf;
       return this.key;
@@ -1063,7 +1065,9 @@ var DefaultSecretVault = class {
       if (err.code !== "EEXIST") throw err;
       const buf = fs2.readFileSync(this.keyFile);
       if (buf.length !== KEY_BYTES) {
-        throw new Error(`SecretVault: key file ${this.keyFile} has wrong size`);
+        throw new Error(
+          `SecretVault: key file ${this.keyFile} is ${buf.length} bytes (expected ${KEY_BYTES}). Remove it manually to generate a new key.`
+        );
       }
       this.key = buf;
       return this.key;
@@ -1124,10 +1128,7 @@ async function rewriteConfigEncrypted(configPath, vault, patch) {
   const encrypted = encryptConfigSecrets(merged, vault);
   await fsp2.mkdir(path6.dirname(configPath), { recursive: true });
   await atomicWrite(configPath, JSON.stringify(encrypted, null, 2), { mode: 384 });
-  try {
-    await fsp2.chmod(configPath, 384);
-  } catch {
-  }
+  await restrictFilePermissions(configPath);
 }
 async function migratePlaintextSecrets(configPath, vault) {
   let raw;
@@ -1146,12 +1147,26 @@ async function migratePlaintextSecrets(configPath, vault) {
   const migrated = walkCount(parsed, vault, counter);
   if (counter.n === 0) return { migrated: 0, file: configPath };
   await atomicWrite(configPath, JSON.stringify(migrated, null, 2), { mode: 384 });
-  try {
-    await fsp2.chmod(configPath, 384);
-  } catch {
-  }
+  await restrictFilePermissions(configPath);
   return { migrated: counter.n, file: configPath };
 }
+async function restrictFilePermissions(filePath) {
+  if (process.platform === "win32") {
+    try {
+      const { execFile: execFile2 } = await import('child_process');
+      const { promisify: promisify2 } = await import('util');
+      const execFileAsync = promisify2(execFile2);
+      await execFileAsync("icacls", [filePath, "/inheritance:r", "/grant:r", `${process.env.USERNAME}:(F)`]);
+    } catch {
+      console.warn(`[secret-vault] Could not restrict permissions on ${filePath} \u2014 config file may be readable by other users on this system.`);
+    }
+  } else {
+    try {
+      await fsp2.chmod(filePath, 384);
+    } catch {
+    }
+  }
+}
 function walkCount(node, vault, counter) {
   if (node === null || node === void 0) return node;
   if (typeof node !== "object") return node;
@@ -2654,7 +2669,7 @@ var InMemoryAgentBridge = class {
       );
     }
     this.inflightGuards.add(correlationId);
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const timer = setTimeout(() => {
         this.inflightGuards.delete(correlationId);
         this.pendingRequests.delete(correlationId);
@@ -2666,7 +2681,7 @@ var InMemoryAgentBridge = class {
         return;
       }
       this.pendingRequests.set(correlationId, {
-        resolve: resolve5,
+        resolve: resolve6,
         reject,
         timer
       });
@@ -3802,7 +3817,7 @@ function projectHash(absRoot) {
   return createHash("sha256").update(path6.resolve(absRoot)).digest("hex").slice(0, 12);
 }
 function resolveWstackPaths(opts) {
-  const home = opts.userHome ?? os4.homedir();
+  const home = opts.userHome ?? os5.homedir();
   const globalRoot = opts.globalRoot ?? path6.join(home, ".wrongstack");
   const hash = projectHash(opts.projectRoot);
   const projectDir = path6.join(globalRoot, "projects", hash);
@@ -3825,7 +3840,12 @@ function resolveWstackPaths(opts) {
     projectLocalConfig: path6.join(projectDir, "config.local.json"),
     inProjectAgentsFile: path6.join(opts.projectRoot, ".wrongstack", "AGENTS.md"),
     inProjectSkills: path6.join(opts.projectRoot, ".wrongstack", "skills"),
-    projectHash: hash
+    projectHash: hash,
+    projectGoal: path6.join(projectDir, "goal.json"),
+    projectSpecs: path6.join(projectDir, "specs"),
+    projectTaskGraphs: path6.join(projectDir, "task-graphs"),
+    projectSddSession: path6.join(projectDir, "sdd-session.json"),
+    projectPlan: path6.join(projectDir, "plan.json")
   };
 }
 
@@ -4921,7 +4941,7 @@ function walk3(node, vault, transform) {
   if (Array.isArray(node)) {
     return node.map((item) => walk3(item, vault, transform));
   }
-  const out = {};
+  const out = /* @__PURE__ */ Object.create(null);
   for (const [k, v] of Object.entries(node)) {
     if (typeof v === "string" && isSecretField2(k)) {
       out[k] = transform(v, k);
@@ -5219,7 +5239,7 @@ var RecoveryLock = class {
   constructor(opts) {
     this.file = path6.join(opts.dir, LOCK_FILE);
     this.pid = opts.pid ?? process.pid;
-    this.hostname = opts.hostname ?? os4.hostname();
+    this.hostname = opts.hostname ?? os5.hostname();
     this.maxAgeMs = opts.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
     this.sessionStore = opts.sessionStore;
     this.probe = opts.isPidAlive ?? defaultIsPidAlive;
@@ -6496,8 +6516,8 @@ async function streamProviderToResponse(provider, req, signal, ctx, events) {
       try {
         await Promise.race([
           Promise.resolve(iter.return?.()),
-          new Promise((resolve5) => {
-            drainTimer = setTimeout(resolve5, 500);
+          new Promise((resolve6) => {
+            drainTimer = setTimeout(resolve6, 500);
           })
         ]);
       } finally {
@@ -6558,7 +6578,7 @@ async function runProviderWithRetry(opts) {
           description
         });
       }
-      await new Promise((resolve5, reject) => {
+      await new Promise((resolve6, reject) => {
         let settled = false;
         const onAbort = () => {
           if (settled) return;
@@ -6571,7 +6591,7 @@ async function runProviderWithRetry(opts) {
           settled = true;
           clearTimeout(t2);
           signal.removeEventListener("abort", onAbort);
-          resolve5();
+          resolve6();
         }, delay);
         if (signal.aborted) {
           onAbort();
@@ -7500,7 +7520,8 @@ var AutonomousRunner = class {
 init_atomic_write();
 var MAX_JOURNAL_ENTRIES = 500;
 function goalFilePath(projectRoot) {
-  return path6.join(projectRoot, ".wrongstack", "goal.json");
+  const hash = createHash("sha256").update(path6.resolve(projectRoot)).digest("hex").slice(0, 12);
+  return path6.join(os5.homedir(), ".wrongstack", "projects", hash, "goal.json");
 }
 async function loadGoal(filePath) {
   let raw;
@@ -8172,7 +8193,7 @@ ${recentJournal}` : "No prior iterations.",
   }
 };
 function sleep(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
 
 // src/coordination/subagent-budget.ts
@@ -8309,12 +8330,12 @@ var SubagentBudget = class _SubagentBudget {
           if (!bus || !bus.hasListenerFor("budget.threshold_reached")) {
             return Promise.resolve("stop");
           }
-          return new Promise((resolve5) => {
+          return new Promise((resolve6) => {
             let resolved = false;
             const respond = (d) => {
               if (resolved) return;
               resolved = true;
-              resolve5(d);
+              resolve6(d);
             };
             const fallback = setTimeout(
               () => respond("stop"),
@@ -11312,7 +11333,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((resolve5, reject) => {
+        return new Promise((resolve6, reject) => {
           const timeout = setTimeout(() => {
             this.off("task.completed", handler);
             reject(new Error(`awaitTasks timed out waiting for task "${id}"`));
@@ -11321,7 +11342,7 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
             if (result.taskId === id) {
               clearTimeout(timeout);
               this.off("task.completed", handler);
-              resolve5(result);
+              resolve6(result);
             }
           };
           this.on("task.completed", handler);
@@ -11722,7 +11743,7 @@ function providerErrorToSubagentError(err, message, cause) {
 
 // src/execution/parallel-eternal-engine.ts
 function sleep2(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
 var GOAL_COMPLETE_MARKER2 = /^\s*\[goal[_\s-]?complete\]\s*$/im;
 var ParallelEternalEngine = class {
@@ -13307,11 +13328,11 @@ var Director = class {
         if (cached) return cached;
         const existing = this.taskWaiters.get(id);
         if (existing) return existing.promise;
-        let resolve5;
+        let resolve6;
         const promise = new Promise((res) => {
-          resolve5 = res;
+          resolve6 = res;
         });
-        this.taskWaiters.set(id, { promise, resolve: resolve5 });
+        this.taskWaiters.set(id, { promise, resolve: resolve6 });
         return promise;
       })
     );
@@ -13627,7 +13648,7 @@ function createDelegateTool(opts) {
           subagentId
         });
         const dir = director;
-        const result = await new Promise((resolve5) => {
+        const result = await new Promise((resolve6) => {
           let settled = false;
           let timer;
           const finish = (value) => {
@@ -13636,7 +13657,7 @@ function createDelegateTool(opts) {
             if (timer) clearTimeout(timer);
             offTool();
             offIter();
-            resolve5(value);
+            resolve6(value);
           };
           const arm = () => {
             if (timer) clearTimeout(timer);
@@ -16354,6 +16375,276 @@ function createAutoExecutor(opts) {
   });
 }
 
+// src/sdd/sdd-task-decomposer.ts
+var SddTaskDecomposer = class {
+  constructor(tracker, graph, opts = {}) {
+    this.tracker = tracker;
+    this.graph = graph;
+    this.slots = Math.min(16, Math.max(1, opts.parallelSlots ?? 4));
+  }
+  tracker;
+  graph;
+  slots;
+  wave = 0;
+  // -------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------
+  /**
+   * Return the next batch of runnable tasks.
+   * Returns `allDone: true` when every node is completed.
+   * Returns `deadlocked: true` when no batch can be produced because
+   * all remaining tasks are blocked by failed nodes.
+   */
+  nextBatch() {
+    if (this.isDone()) {
+      return { tasks: [], wave: this.wave, allDone: true, deadlocked: false };
+    }
+    const pending = this.pendingReadyNodes();
+    if (pending.length === 0) {
+      const hasBlockedTasks = this.hasAnyBlockedTasks();
+      return { tasks: [], wave: this.wave, allDone: false, deadlocked: hasBlockedTasks };
+    }
+    const batch = pending.slice(0, this.slots);
+    return { tasks: batch, wave: this.wave, allDone: false, deadlocked: false };
+  }
+  /**
+   * Advance the wave counter after a batch completes.
+   * Call this once per `nextBatch()` result that was fan-out.
+   */
+  acknowledgeBatch(_completedTaskIds) {
+    this.wave++;
+  }
+  /**
+   * True when every node in the graph is completed.
+   * Use this to exit the fan-out loop after `isDone() || deadlocked`.
+   */
+  isDone() {
+    const progress = this.tracker.getProgress();
+    return progress.total > 0 && progress.completed === progress.total;
+  }
+  /**
+   * Total waves produced so far.
+   */
+  getWaveCount() {
+    return this.wave;
+  }
+  // -------------------------------------------------------------------
+  // Internal helpers
+  // -------------------------------------------------------------------
+  /**
+   * Return pending nodes whose blockers are all completed.
+   * Sorted by priority (critical first), then by creation time.
+   */
+  pendingReadyNodes() {
+    const allPending = this.tracker.getAllNodes({ status: ["pending"] });
+    const ready = [];
+    for (const node of allPending) {
+      if (this.tracker.canStart(node.id)) {
+        ready.push(node);
+      }
+    }
+    const priorityRank = {
+      critical: 0,
+      high: 1,
+      medium: 2,
+      low: 3
+    };
+    ready.sort((a, b) => {
+      const pr = priorityRank[a.priority] - priorityRank[b.priority];
+      if (pr !== 0) return pr;
+      return a.createdAt - b.createdAt;
+    });
+    return ready;
+  }
+  /** True when at least one non-completed, non-failed task is blocked. */
+  hasAnyBlockedTasks() {
+    const nodes = this.tracker.getAllNodes({
+      status: ["pending", "in_progress", "blocked"]
+    });
+    return nodes.some((n) => n.status === "blocked");
+  }
+};
+var SddParallelRun = class {
+  constructor(opts) {
+    this.opts = opts;
+    this.slots = Math.min(16, Math.max(1, opts.parallelSlots ?? 4));
+    this.timeoutMs = opts.taskTimeoutMs ?? 3e5;
+    this.decomposer = new SddTaskDecomposer(opts.tracker, opts.graph, { parallelSlots: this.slots });
+  }
+  opts;
+  slots;
+  timeoutMs;
+  decomposer;
+  coordinator = null;
+  stopRequested = false;
+  // -------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------
+  /** Trigger stop — causes run() to abort after the current wave. */
+  stop() {
+    this.stopRequested = true;
+    this.coordinator?.stopAll();
+  }
+  /** Execute all waves until completion or deadlock. Returns final summary. */
+  async run() {
+    this.stopRequested = false;
+    const startTime = Date.now();
+    let totalCompleted = 0;
+    let totalFailed = 0;
+    let totalWaves = 0;
+    this.buildCoordinator();
+    while (!this.stopRequested && !this.decomposer.isDone()) {
+      const batch = this.decomposer.nextBatch();
+      if (batch.deadlocked) {
+        break;
+      }
+      if (batch.tasks.length === 0 && batch.allDone) {
+        break;
+      }
+      const waveResult = await this.executeWave(batch);
+      totalWaves++;
+      totalCompleted += waveResult.successCount;
+      totalFailed += waveResult.failCount;
+      this.decomposer.acknowledgeBatch(batch.tasks.map((t2) => t2.id));
+      this.opts.onWave?.(waveResult);
+      const progress = this.buildProgress();
+      this.opts.onProgress?.(progress);
+      if (this.stopRequested) break;
+    }
+    const finalProgress = this.opts.tracker.getProgress();
+    return {
+      totalWaves,
+      totalCompleted,
+      totalFailed,
+      totalDurationMs: Date.now() - startTime,
+      deadlocked: !this.decomposer.isDone() && this.stopRequested === false,
+      stopRequested: this.stopRequested,
+      finalProgress
+    };
+  }
+  // -------------------------------------------------------------------
+  // Internal
+  // -------------------------------------------------------------------
+  buildCoordinator() {
+    const config = {
+      coordinatorId: `sdd-parallel-${randomUUID().slice(0, 8)}`,
+      maxConcurrent: this.slots,
+      doneCondition: { type: "all_tasks_done" }
+    };
+    this.coordinator = new DefaultMultiAgentCoordinator(config);
+    const runner = makeAgentSubagentRunner({ factory: this.opts.subagentFactory ?? this.defaultFactory() });
+    this.coordinator.setRunner?.(runner);
+  }
+  defaultFactory() {
+    return async (config) => ({
+      agent: this.opts.agent,
+      events: this.opts.agent.events
+    });
+  }
+  async executeWave(batch) {
+    const wave = batch.wave;
+    const tasks = batch.tasks;
+    const waveStart = Date.now();
+    for (const task of tasks) {
+      this.opts.tracker.updateNodeStatus(task.id, "in_progress");
+    }
+    const progress = computeTaskProgress(this.opts.graph);
+    const taskIds = tasks.map(() => randomUUID());
+    const subagentIds = tasks.map((_, i) => `sdd-wave${wave}-${i}`);
+    const directivePreamble = [
+      "\u2550\u2550\u2550 SDD PARALLEL EXECUTION \u2550\u2550\u2550",
+      "",
+      `Wave ${wave + 1} of ~${Math.ceil(progress.total / this.slots)}`,
+      `Graph: ${this.opts.graph.title}`,
+      `Parallel slots: ${tasks.length}`,
+      "",
+      "\u2500\u2500 EXECUTION PROTOCOL \u2500\u2500",
+      "\u2022 Execute the assigned SDD task end-to-end using multiple tool calls.",
+      "\u2022 Mark the task [done] in the tracker when complete.",
+      "\u2022 Do not ask for confirmation.",
+      "\u2022 Keep output concise \u2014 summarize changes, do not transcribe files."
+    ].join("\n");
+    const spawns = subagentIds.map(
+      (subagentId) => this.coordinator.spawn({
+        id: subagentId,
+        name: subagentId,
+        role: "executor",
+        timeoutMs: this.timeoutMs
+      })
+    );
+    const spawnResults = await Promise.all(spawns);
+    if (!spawnResults.every((r) => r.subagentId)) {
+      throw new Error("One or more subagent spawns failed");
+    }
+    const assignPromises = tasks.map((task, i) => {
+      const spec = {
+        id: taskIds[i],
+        description: [
+          directivePreamble,
+          "",
+          `\u2500\u2500 TASK ${i + 1}/${tasks.length} \u2500\u2500`,
+          `[${task.priority.toUpperCase()}] ${task.title}`,
+          "",
+          task.description
+        ].join("\n"),
+        subagentId: subagentIds[i],
+        timeoutMs: this.timeoutMs
+      };
+      return this.coordinator.assign(spec);
+    });
+    await Promise.all(assignPromises);
+    let results;
+    try {
+      results = await this.coordinator.awaitTasks(taskIds);
+    } catch (err) {
+      results = taskIds.map((id) => ({
+        subagentId: "",
+        taskId: id,
+        status: "failed",
+        error: { kind: "unknown", message: String(err), retryable: false },
+        iterations: 0,
+        toolCalls: 0,
+        durationMs: 0
+      }));
+    }
+    const successCount = results.filter((r) => r.status === "success").length;
+    const failCount = results.length - successCount;
+    for (let i = 0; i < results.length; i++) {
+      const result = results[i];
+      const taskId = taskIds[i];
+      if (result.status === "success") {
+        this.opts.tracker.updateNodeStatus(taskId, "completed");
+      } else {
+        const errMsg = result.error?.kind ? `${result.error.kind}: ${result.error.message}` : result.error?.message ?? "unknown error";
+        this.opts.tracker.updateNodeStatus(taskId, "failed", errMsg);
+      }
+    }
+    return {
+      wave,
+      batch,
+      results,
+      successCount,
+      failCount,
+      durationMs: Date.now() - waveStart,
+      stopRequested: this.stopRequested
+    };
+  }
+  buildProgress() {
+    const gp = this.opts.tracker.getProgress();
+    return {
+      wave: this.decomposer.getWaveCount(),
+      total: gp.total,
+      completed: gp.completed,
+      inProgress: gp.inProgress,
+      failed: gp.failed,
+      blocked: gp.blocked,
+      pending: gp.pending,
+      percent: gp.percentComplete,
+      deadlocked: false
+    };
+  }
+};
+
 // src/observability/metrics.ts
 var RESERVOIR_SIZE = 1024;
 function labelKey(labels) {
@@ -16513,9 +16804,9 @@ var DefaultHealthRegistry = class {
   }
   async runOne(check) {
     let timer = null;
-    const timeout = new Promise((resolve5) => {
+    const timeout = new Promise((resolve6) => {
       timer = setTimeout(
-        () => resolve5({ status: "unhealthy", detail: `timeout after ${this.timeoutMs}ms` }),
+        () => resolve6({ status: "unhealthy", detail: `timeout after ${this.timeoutMs}ms` }),
         this.timeoutMs
       );
     });
@@ -16754,14 +17045,14 @@ async function startMetricsServer(opts) {
     const { createServer } = await import('http');
     server = createServer(listener);
   }
-  await new Promise((resolve5, reject) => {
+  await new Promise((resolve6, reject) => {
     const onError = (err) => {
       server.off("listening", onListening);
       reject(err);
     };
     const onListening = () => {
       server.off("error", onError);
-      resolve5();
+      resolve6();
     };
     server.once("error", onError);
     server.once("listening", onListening);
@@ -16773,8 +17064,8 @@ async function startMetricsServer(opts) {
   return {
     port: boundPort,
     url: `${protocol}://${host}:${boundPort}${path26}`,
-    close: () => new Promise((resolve5, reject) => {
-      server.close((err) => err ? reject(err) : resolve5());
+    close: () => new Promise((resolve6, reject) => {
+      server.close((err) => err ? reject(err) : resolve6());
     })
   };
 }
@@ -17438,7 +17729,7 @@ async function downloadGitHubTarball(parsed) {
       `Tarball too large (${(Number.parseInt(contentLength, 10) / 1024 / 1024).toFixed(1)}MB). Max: ${MAX_TARBALL_SIZE / 1024 / 1024}MB`
     );
   }
-  const tempDir = await fsp2.mkdtemp(path6.join(os4.tmpdir(), "wskill-"));
+  const tempDir = await fsp2.mkdtemp(path6.join(os5.tmpdir(), "wskill-"));
   try {
     if (!response.body) {
       throw new Error("Empty response body from GitHub API");
@@ -19169,7 +19460,7 @@ var SecurityScannerOrchestrator = class {
       const delay = Math.round(policy.delayMs(attempt));
       const status = isProviderErr ? err.status : 0;
       console.warn(`[SecurityScanner] retry ${attempt + 1} after ${delay}ms (status=${status}) \u2014 ${errAsErr.message}`);
-      await new Promise((resolve5) => setTimeout(resolve5, delay));
+      await new Promise((resolve6) => setTimeout(resolve6, delay));
       return this.completeWithRetry(provider, request, abortController, attempt + 1);
     }
   }
@@ -20509,6 +20800,39 @@ var ExtensionRegistry = class {
   }
 };
 
+// src/core/btw.ts
+var META_KEY = "_btwNotes";
+function readQueue(ctx) {
+  const raw = ctx.meta[META_KEY];
+  return Array.isArray(raw) ? raw : [];
+}
+function setBtwNote(ctx, text) {
+  const trimmed = text.trim();
+  if (!trimmed) return readQueue(ctx).length;
+  const next = [...readQueue(ctx), trimmed].slice(-20);
+  ctx.meta[META_KEY] = next;
+  return next.length;
+}
+function pendingBtwCount(ctx) {
+  return readQueue(ctx).length;
+}
+function consumeBtwNotes(ctx) {
+  const notes = readQueue(ctx);
+  if (notes.length > 0) delete ctx.meta[META_KEY];
+  return notes;
+}
+function buildBtwBlock(notes) {
+  const body = notes.map((n) => `- ${n}`).join("\n");
+  return [
+    "[BY THE WAY \u2014 the user added this while you were working. Fold it into",
+    "your current task; do not restart from scratch unless it contradicts the",
+    "goal:",
+    "",
+    body,
+    "]"
+  ].join("\n");
+}
+
 // src/core/continue-to-next-iteration.ts
 function parseContinueDirective(text) {
   const LINE_MARKERS = /^\s*\[(continue|next step|proceed|done)\]\s*$/gim;
@@ -20524,13 +20848,13 @@ function parseContinueDirective(text) {
   }
   return lastDirective;
 }
-var META_KEY = "_autonomousContinue";
+var META_KEY2 = "_autonomousContinue";
 function setAutonomousContinue(ctx) {
-  ctx.meta[META_KEY] = true;
+  ctx.meta[META_KEY2] = true;
 }
 function consumeAutonomousContinue(ctx) {
-  const val = ctx.meta[META_KEY] === true;
-  delete ctx.meta[META_KEY];
+  const val = ctx.meta[META_KEY2] === true;
+  delete ctx.meta[META_KEY2];
   return val;
 }
 function makeContinueToNextIterationTool() {
@@ -20556,12 +20880,12 @@ function makeContinueToNextIterationTool() {
 // src/core/iteration-limit.ts
 function requestLimitExtension(opts) {
   const { events, currentIterations, currentLimit, autoExtend, timeoutMs = 3e4 } = opts;
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let resolved = false;
     const timerFired = () => {
       if (!resolved) {
         resolved = true;
-        resolve5(0);
+        resolve6(0);
       }
     };
     const timer = setTimeout(timerFired, timeoutMs);
@@ -20570,14 +20894,14 @@ function requestLimitExtension(opts) {
       if (!resolved) {
         resolved = true;
         clearTimeout(timer);
-        resolve5(0);
+        resolve6(0);
       }
     };
     const grant = (extra) => {
       if (!resolved) {
         resolved = true;
         clearTimeout(timer);
-        resolve5(Math.max(0, extra));
+        resolve6(Math.max(0, extra));
       }
     };
     events.emit("iteration.limit_reached", {
@@ -20591,7 +20915,7 @@ function requestLimitExtension(opts) {
         if (!resolved) {
           resolved = true;
           clearTimeout(timer);
-          resolve5(100);
+          resolve6(100);
         }
       });
     }
@@ -20813,6 +21137,7 @@ var Agent = class {
         }
         await this.extensions.runBeforeIteration(this.ctx, i);
         this.events.emit("iteration.started", { ctx: this.ctx, index: i });
+        this.injectPendingBtwNotes();
         const req = await this.buildAndRunRequestPipeline(opts);
         let res;
         try {
@@ -21136,14 +21461,36 @@ var Agent = class {
     });
     await this.extensions.runAfterToolExecution(this.ctx, outputs);
   }
+  /**
+   * Fold any pending `/btw` notes into the conversation. Called at the top of
+   * each iteration so a note set mid-run reaches the model on its next turn.
+   *
+   * To stay valid across all provider wire families we never create two
+   * consecutive user messages: if the last message is a user turn (e.g. the
+   * tool_result block from the previous iteration) we append the note as an
+   * extra text block on that turn; otherwise we add a fresh user message.
+   */
+  injectPendingBtwNotes() {
+    const notes = consumeBtwNotes(this.ctx);
+    if (notes.length === 0) return;
+    const block = { type: "text", text: buildBtwBlock(notes) };
+    const messages = this.ctx.messages;
+    const last = messages[messages.length - 1];
+    if (last && last.role === "user") {
+      const content = typeof last.content === "string" ? [{ type: "text", text: last.content }, block] : [...last.content, block];
+      this.ctx.state.replaceMessages([...messages.slice(0, -1), { ...last, content }]);
+    } else {
+      this.ctx.state.appendMessage({ role: "user", content: [block] });
+    }
+  }
   waitForConfirm(info) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       this.events.emit("tool.confirm_needed", {
         tool: info.tool,
         input: info.input,
         toolUseId: info.toolUseId,
         suggestedPattern: info.suggestedPattern,
-        resolve: resolve5
+        resolve: resolve6
       });
     });
   }
@@ -21791,7 +22138,7 @@ summarize it, and let the tool result hold only the summary.`);
     const cached = this.envCacheByRoot.get(ctx.projectRoot);
     if (cached) return cached;
     const today = this.opts.todayIso ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const platform2 = `${os4.platform()} ${os4.release()}`;
+    const platform2 = `${os5.platform()} ${os5.release()}`;
     const shell = process.env.SHELL ?? process.env.ComSpec ?? "unknown";
     const node = process.version;
     const isGit = await this.dirExists(path6.join(ctx.projectRoot, ".git"));
@@ -21860,12 +22207,12 @@ ${mem}`);
     }
   }
   async gitStatus(root) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       let settled = false;
       const finish = (s) => {
         if (settled) return;
         settled = true;
-        resolve5(s);
+        resolve6(s);
       };
       let proc;
       const timer = setTimeout(() => {
@@ -22617,6 +22964,6 @@ function wrapApiForCapabilityCheck(plugin, api, log, enforce = false) {
   });
 }
 
-export { AGENTS_BY_PHASE, AGENT_CATALOG, AISpecBuilder, ALL_AGENT_DEFINITIONS, 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_CONFIG, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_DISPATCH_ROLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DEFAULT_TOOLS_CONFIG, 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, ERROR_CODES, EternalAutonomyEngine, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FleetBus, FleetManager, FleetSpawnBudgetError, FleetUsageAggregator, FsError, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, MAX_JOURNAL_ENTRIES, NULL_FLEET_BUS, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, ParallelEternalEngine, 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, appendJournal, applyRosterBudget, asBlocks, asText, atomicWrite, attachAutoExtend, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildChildEnv, buildGoalPreamble, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, color, compileGlob, compileUserRegex, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, context7Server, contextManagerTool, createAutoExecutor, createContextManagerTool, createDefaultPipelines, createDelegateTool, createMcpControlTool, createMessage, createSecuritySlashCommand, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, deriveTodosFromPlanItem, detectNewlineStyle, dispatchAgent, downloadGitHubTarball, emptyGoal, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatGoal, formatPlan, formatPlanTemplates, formatTodosList, getAgentDefinition, getContextWindowMode, getPlanTemplate, getTemplate, githubServer, goalFilePath, googleMapsServer, isAgentError, isConfigError, isContextWindowModeId, isFsError, isImageBlock, isPluginError, isSessionError, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, listContextWindowModes, listPlanTemplates, listTemplates, loadDirectorState, loadGoal, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeAutonomyPromptContributor, makeContinueToNextIterationTool, makeDirectorSessionFactory, makeLLMClassifier, matchAny, matchGlob, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, parseContinueDirective, parseSkillRef, projectHash, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resolveContextWindowPolicy, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, saveGoal, savePlan, saveTodosCheckpoint, scoreAgents, securitySlashCommand, sentinelServer, setPlanItemStatus, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, summarizeUsage, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, zaiVisionServer };
+export { AGENTS_BY_PHASE, AGENT_CATALOG, AISpecBuilder, ALL_AGENT_DEFINITIONS, 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_CONFIG, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_DISPATCH_ROLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_RECOVERY_STRATEGIES, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DEFAULT_TOOLS_CONFIG, 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, ERROR_CODES, EternalAutonomyEngine, EventBus, ExtensionRegistry, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FleetBus, FleetManager, FleetSpawnBudgetError, FleetUsageAggregator, FsError, GitignoreUpdater, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, MAX_JOURNAL_ENTRIES, NULL_FLEET_BUS, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, ParallelEternalEngine, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, REFACTOR_PLANNER_AGENT, RecoveryLock, ReportGenerator, RunController, SECURITY_SCANNER_AGENT, SPEC_TEMPLATES, ScopedEventBus, SddParallelRun, SddTaskDecomposer, 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, appendJournal, applyRosterBudget, asBlocks, asText, atomicWrite, attachAutoExtend, attachPlanCheckpoint, attachTodosCheckpoint, awsServer, blockServer, braveSearchServer, buildBtwBlock, buildChildEnv, buildGoalPreamble, buildOtlpMetricsRequest, buildOtlpTracesRequest, buildRecoveryStrategies, classifyFamily, clearPlan, color, compileGlob, compileUserRegex, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, consumeBtwNotes, context7Server, contextManagerTool, createAutoExecutor, createContextManagerTool, createDefaultPipelines, createDelegateTool, createMcpControlTool, createMessage, createSecuritySlashCommand, createToolOutputSerializer, decryptConfigSecrets, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, deriveTodosFromPlanItem, detectNewlineStyle, dispatchAgent, downloadGitHubTarball, emptyGoal, emptyPlan, encryptConfigSecrets, ensureDir, estimateRequestTokens, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, formatContextWindowModeList, formatGoal, formatPlan, formatPlanTemplates, formatTodosList, getAgentDefinition, getContextWindowMode, getPlanTemplate, getTemplate, githubServer, goalFilePath, googleMapsServer, isAgentError, isConfigError, isContextWindowModeId, isFsError, isImageBlock, isPluginError, isSessionError, isTextBlock, isThinkingBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, listContextWindowModes, listPlanTemplates, listTemplates, loadDirectorState, loadGoal, loadPlan, loadPlugins, loadProjectModes, loadTodosCheckpoint, loadUserModes, makeAgentSubagentRunner, makeAutonomyPromptContributor, makeContinueToNextIterationTool, makeDirectorSessionFactory, makeLLMClassifier, matchAny, matchGlob, migratePlaintextSecrets, miniMaxVisionServer, normalizeToLf, parseContinueDirective, parseSkillRef, pendingBtwCount, projectHash, removePlanItem, renderProgress, renderPrometheus, renderSpecAnalysis, renderTaskGraph, renderTaskList, repairToolUseAdjacency, resolveContextWindowPolicy, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, saveGoal, savePlan, saveTodosCheckpoint, scoreAgents, securitySlashCommand, sentinelServer, setBtwNote, setPlanItemStatus, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, summarizeUsage, templateToMarkdown, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState, zaiVisionServer };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map