@wrongstack/core 0.313.1 → 0.316.1

package/dist/{chunk-T3KGZBU5.js → chunk-S45JPKQN.js}

@@ -5,30 +5,30 @@ import {
   SHADOW_AGENT_SKILLS,
   TOOLS,
   agentPrompt
-} from "./chunk-FHAMQS7Q.js";
+} from "./chunk-FCBTO76Z.js";
+import {
+  safeParse
+} from "./chunk-W5VITDM2.js";
+import {
+  readBundledInstructionText,
+  renderInstructionTemplate
+} from "./chunk-5S437PRC.js";
 import {
   setBtwNote
 } from "./chunk-SQJVFEBV.js";
-import {
-  ToolCapabilities
-} from "./chunk-A455ATZB.js";
 import {
   SECRET_FILE_MODE
-} from "./chunk-H5E77KUJ.js";
+} from "./chunk-6FHWXLPT.js";
 import {
-  ProviderError
-} from "./chunk-NFAYHPRH.js";
-import {
-  safeParse
-} from "./chunk-RPOA7IAE.js";
+  ToolCapabilities
+} from "./chunk-UBGDX6FI.js";
 import {
-  readBundledInstructionText,
-  renderInstructionTemplate
-} from "./chunk-5S437PRC.js";
+  ProviderError
+} from "./chunk-3ECENVHL.js";
 import {
   AgentError,
   ERROR_CODES
-} from "./chunk-WOEZV3Q4.js";
+} from "./chunk-25LSLC3G.js";
 import {
   toErrorMessage
 } from "./chunk-TBRL2RCC.js";
@@ -754,6 +754,7 @@ function makeAgentSubagentRunner(opts) {
     const telemetryRunId = typeof taskContext["telemetryRunId"] === "string" ? taskContext["telemetryRunId"] : void 0;
     const telemetryBoardId = typeof taskContext["telemetryBoardId"] === "string" ? taskContext["telemetryBoardId"] : void 0;
     const agentContext = agent.ctx;
+    const owningSessionId = () => ctx.sessionId ?? agentContext?.activeRunSessionId ?? agentContext?.session?.id ?? taskContext["sessionId"];
     if (agentContext?.meta) {
       agentContext.meta["subagentTaskId"] = task.id;
       const kanbanContext = taskContext["kanban"];
@@ -787,11 +788,7 @@ function makeAgentSubagentRunner(opts) {
         return;
       }
       aborter.abort();
-      budgetError = err instanceof BudgetExceededError ? err : new BudgetExceededError(
-        "tool_calls",
-        0,
-        0
-      );
+      budgetError = err instanceof BudgetExceededError ? err : new BudgetExceededError("tool_calls", 0, 0);
       if (budgetError !== err && err instanceof Error) {
         budgetError.message += ` (caused by: ${err.message})`;
       }
@@ -860,7 +857,9 @@ function makeAgentSubagentRunner(opts) {
         const since = u.iterations - lastSummaryAtIteration;
         if (since >= SUMMARY_INTERVAL) {
           lastSummaryAtIteration = u.iterations;
+          const subagentSessionId = owningSessionId();
           events.emit("subagent.iteration_summary", {
+            ...subagentSessionId ? { sessionId: subagentSessionId } : {},
             subagentId: ctx.subagentId,
             iteration: u.iterations,
             toolCalls: u.toolCalls,
@@ -919,6 +918,30 @@ function makeAgentSubagentRunner(opts) {
         })
       );
     }
+    let reviewerToolCalls = 0;
+    let reviewerPacingTier = 0;
+    const isReviewer = ctx.config.role === "reviewer" || ctx.config.name?.includes("review") || ctx.config.name?.includes("chimera");
+    if (isReviewer) {
+      unsub.push(
+        events.on("tool.completed", () => {
+          reviewerToolCalls++;
+          const elapsedSec = Math.max(1, Math.round((Date.now() - taskStartedAt) / 1e3));
+          if (reviewerPacingTier === 0 && (reviewerToolCalls >= 2 || elapsedSec >= 25)) {
+            reviewerPacingTier = 1;
+            setBtwNote(
+              agent.ctx,
+              `[REVIEW PACE & FOCUS] ${reviewerToolCalls} tool call(s) executed (${elapsedSec}s elapsed). Stay focused strictly on verifying the changed diffs for real bugs. Do not wander into unchanged legacy code or stylistic debt. Wrap up your findings and conclude your report promptly.`
+            );
+          } else if (reviewerPacingTier === 1 && (reviewerToolCalls >= 5 || elapsedSec >= 50)) {
+            reviewerPacingTier = 2;
+            setBtwNote(
+              agent.ctx,
+              `[URGENT: FINISH REVIEW] Review is running long (${elapsedSec}s elapsed, ${reviewerToolCalls} tool calls). Conclude your evaluation of the changed diffs NOW and produce your final severity-ranked report or all-clear block in this turn. No further exploratory tool calls.`
+            );
+          }
+        })
+      );
+    }
     let result;
     try {
       result = await agent.run(format(task, ctx.config), { signal: aborter.signal });
@@ -926,7 +949,9 @@ function makeAgentSubagentRunner(opts) {
       if (finalText2) {
         ctx.reportProgress?.({ text: finalText2, source: "run_result", capturedAt: Date.now() });
       }
+      const subagentSessionId = owningSessionId();
       events.emit("subagent.task_completed", {
+        ...subagentSessionId ? { sessionId: subagentSessionId } : {},
         subagentId: ctx.subagentId,
         taskId: task.id,
         status: result.status === "done" ? "success" : "failed",
@@ -1741,7 +1766,8 @@ async function dispatchAgent(task, opts = {}) {
     const pool = (candidates.length > 0 ? candidates.slice(0, maxCandidates).map((c) => catalog[c.role] ?? FALLBACK_DEFINITION) : Object.values(catalog)).map((d) => ({
       role: d.config.role,
       name: d.config.name,
-      summary: d.capability.summary
+      summary: d.capability.summary,
+      ...d.capability.rationale ? { differentiatesFrom: d.capability.rationale.differentiatesFrom } : {}
     }));
     try {
       const choice = await opts.classifier(task, pool);
@@ -1780,7 +1806,11 @@ async function dispatchAgent(task, opts = {}) {
 }
 function makeLLMClassifier(complete) {
   return async (task, candidates) => {
-    const list = candidates.map((c, i) => `${i + 1}. ${c.role} \u2014 ${c.summary}`).join("\n");
+    const list = candidates.map((c, i) => {
+      const line = `${i + 1}. ${c.role} \u2014 ${c.summary}`;
+      return c.differentiatesFrom ? `${line}
+   vs. siblings: ${c.differentiatesFrom}` : line;
+    }).join("\n");
     const prompt = renderInstructionTemplate(readBundledInstructionText("llm/agent-router.md"), {
       task,
       agents: list
@@ -1934,9 +1964,17 @@ var SHADOW_AGENT = {
   ...defineAgent("shadow-agent", "Shadow"),
   skillNames: [...SHADOW_AGENT_SKILLS]
 };
+var EXPLORE_COMPANION_TOOLS = [
+  ...TOOLS.index,
+  "codebase-impact-analysis",
+  "read",
+  "grep",
+  "glob",
+  "tree"
+];
 var EXPLORE_COMPANION_AGENT = {
   ...defineAgent("explore-companion", "Explore Companion"),
-  tools: [...TOOLS.read, ...TOOLS.index],
+  tools: [...EXPLORE_COMPANION_TOOLS],
   // Read-only, triple-enforced: allowlist has no write/bash, and the
   // disabled list blocks the escape hatches explicitly.
   disabledTools: [
@@ -1948,11 +1986,22 @@ var EXPLORE_COMPANION_AGENT = {
     "exec",
     "delegate",
     "spawn_subagent",
-    "assign_task"
+    "assign_task",
+    "search",
+    "codebase-index",
+    "codebase-ast-replace",
+    "codebase-invariant-check",
+    "codebase-targeted-test"
+  ],
+  allowedCapabilities: [
+    ToolCapabilities.FS_READ,
+    ToolCapabilities.COORDINATION_RESULT_SUBMIT,
+    ToolCapabilities.SESSION_NOTE
   ],
   skillNames: [...ROLE_SKILL_SETS["explore-companion"]],
   spawnBudgetExempt: true,
-  // Findings travel via mailbox + submit_result, not the leader's stream.
+  // Findings travel via submit_result; the host posts a session.note
+  // to the leader. Not the leader's stream.
   textStream: "silent",
   toolStream: "silent"
 };
@@ -2089,6 +2138,7 @@ var FLEET_ROSTER_WITHACP = {
 // src/coordination/multi-agent-coordinator.ts
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
+import { requireSessionId } from "@wrongstack/primitives";
 
 // src/coordination/coordinator/error-classifier.ts
 function classifySubagentError(err, hints = {}) {
@@ -2188,6 +2238,7 @@ async function executeSubagentWithTimeout({
   }
   const start = Date.now();
   let timer = null;
+  let settled = false;
   let PreemptState;
   ((PreemptState2) => {
     PreemptState2["ACTIVE"] = "active";
@@ -2208,6 +2259,7 @@ async function executeSubagentWithTimeout({
       timer = setTimeout(onTick, Math.max(0, ms));
     };
     const scheduleNext = () => {
+      if (settled) return;
       const wallLimit = budget.limits.timeoutMs ?? initialTimeoutMs;
       const wallRemaining = initialTimeoutMs === void 0 ? Number.POSITIVE_INFINITY : wallLimit - (Date.now() - start);
       const idleRemaining = idleLimitMs === void 0 || gracefulFinish !== void 0 && initialTimeoutMs !== void 0 ? Number.POSITIVE_INFINITY : (budget.limits.idleTimeoutMs ?? idleLimitMs) - budget.idleMs();
@@ -2234,10 +2286,10 @@ async function executeSubagentWithTimeout({
             return Promise.resolve("stop");
           }
           return new Promise((resolveDecision) => {
-            let settled = false;
+            let settled2 = false;
             const resolve = (d) => {
-              if (settled) return;
-              settled = true;
+              if (settled2) return;
+              settled2 = true;
               resolveDecision(d);
             };
             const fallback = setTimeout(() => resolve("stop"), DECISION_TIMEOUT_MS);
@@ -2263,6 +2315,7 @@ async function executeSubagentWithTimeout({
       return typeof result === "string" ? result : await result;
     };
     const onTick = async () => {
+      if (settled) return;
       const elapsed = Date.now() - start;
       const wallLimit = initialTimeoutMs === void 0 ? void 0 : budget.limits.timeoutMs ?? initialTimeoutMs;
       const idleLimit = idleLimitMs === void 0 ? void 0 : budget.limits.idleTimeoutMs ?? idleLimitMs;
@@ -2300,6 +2353,7 @@ async function executeSubagentWithTimeout({
         budget.setWatchdogNegotiation(wallLimit);
         try {
           const decision = await negotiateTimeout(elapsed, wallLimit);
+          if (settled) return;
           if (typeof decision !== "string" && decision.extend.timeoutMs !== void 0) {
             budget.patchLimits({ timeoutMs: decision.extend.timeoutMs });
             lastGrantActivityTs = Date.now() - budget.idleMs();
@@ -2347,6 +2401,7 @@ async function executeSubagentWithTimeout({
       budget.setWatchdogNegotiation(limit);
       try {
         const decision = await negotiateTimeout(elapsed, limit);
+        if (settled) return;
         if (decision === "throw") {
           terminate("timeout", limit, elapsed);
           return;
@@ -2372,6 +2427,7 @@ async function executeSubagentWithTimeout({
         terminate("timeout", limit, elapsed);
         return;
       } catch (err) {
+        if (settled) return;
         abortSubagent(ctx.subagentId);
         reject(
           err instanceof BudgetExceededError ? err : new BudgetExceededError("timeout", limit, elapsed)
@@ -2386,11 +2442,13 @@ async function executeSubagentWithTimeout({
   try {
     return await Promise.race([runner(task, ctx), timeoutPromise]);
   } finally {
+    settled = true;
     if (timer) clearTimeout(timer);
   }
 }
 
 // src/coordination/multi-agent-coordinator.ts
+var MAX_COORDINATOR_LISTENERS = 512;
 var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends EventEmitter {
   coordinatorId;
   config;
@@ -2428,7 +2486,7 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
   terminating = /* @__PURE__ */ new Set();
   constructor(config, options = {}) {
     super();
-    this.setMaxListeners(0);
+    this.setMaxListeners(MAX_COORDINATOR_LISTENERS);
     this.coordinatorId = config.coordinatorId;
     this.config = config;
     this.runner = options.runner;
@@ -2436,7 +2494,59 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
   }
   currentSessionId() {
     const value = typeof this.sessionId === "function" ? this.sessionId() : this.sessionId;
-    return typeof value === "string" && value.length > 0 ? value : void 0;
+    return requireSessionId(value, "subagent operation");
+  }
+  /**
+   * The session that owns a subagent — its spawn-time stamp.
+   *
+   * Every per-subagent emission routes through here instead of
+   * `currentSessionId()`. The fallback covers ids the coordinator never
+   * spawned (a caller reporting `completeTask` for an unknown worker); a
+   * subagent this coordinator created always has its own stamp.
+   */
+  sessionOf(subagentId) {
+    const entry = this.subagents.get(subagentId);
+    if (entry) return entry.sessionId;
+    return this.currentSessionId();
+  }
+  /** Every subagent this coordinator holds for one session. */
+  subagentIdsForSession(sessionId) {
+    if (!sessionId) return [];
+    const ids = [];
+    for (const [id, entry] of this.subagents) {
+      if (entry.sessionId === sessionId) ids.push(id);
+    }
+    return ids;
+  }
+  /**
+   * Stop every subagent belonging to ONE session, and drop that session's
+   * still-queued tasks.
+   *
+   * This is what a tab's Stop button needs. `stopAll()` is the wrong tool with
+   * four tabs live — it would kill three other tabs' work — and until subagents
+   * carried a session stamp there was no way to express the narrower intent, so
+   * stopping a run left its workers grinding on in the background.
+   *
+   * Pending tasks pinned to those subagents are drained as aborted so anything
+   * awaiting them (the delegate tool, report-back) resolves instead of hanging.
+   */
+  async stopSession(sessionId) {
+    if (!sessionId) return;
+    const ids = new Set(this.subagentIdsForSession(sessionId));
+    if (ids.size === 0) return;
+    const orphaned = this.pendingTasks.filter(
+      (t) => t.subagentId !== void 0 && ids.has(t.subagentId)
+    );
+    this.pendingTasks = this.pendingTasks.filter(
+      (t) => t.subagentId === void 0 || !ids.has(t.subagentId)
+    );
+    for (const t of orphaned) {
+      this.emitPendingAborted(
+        t,
+        `Session "${sessionId}" was stopped while task "${t.id}" was pending`
+      );
+    }
+    await Promise.allSettled([...ids].map((id) => this.stop(id)));
   }
   /**
    * Replace the runner after construction. Used when the runner depends
@@ -2501,18 +2611,24 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       doneCondition: this.config.doneCondition,
       maxConcurrent: this.config.maxConcurrent ?? 16
     };
+    const sessionId = cfg.originSessionId ?? this.currentSessionId();
     this.subagents.set(id, {
       config: { ...cfg, id },
       context,
       status: "idle",
-      abortController: new AbortController()
+      abortController: new AbortController(),
+      sessionId
+    });
+    this.emit("subagent.started", {
+      subagent: { ...cfg, id },
+      sessionId
     });
-    this.emit("subagent.started", { subagent: { ...cfg, id } });
     this.fleetBus?.emit({
       subagentId: id,
       ts: Date.now(),
       type: "subagent.assigned",
       payload: {
+        sessionId,
         subagentId: id,
         name: subagent.name,
         provider: subagent.provider,
@@ -2552,11 +2668,16 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
     subagent.currentTask = void 0;
     subagent.context.parentBridge = null;
     this.emit("subagent.stopped", { subagentId, reason: "stopped by coordinator" });
+    const sessionId = subagent.sessionId;
     this.fleetBus?.emit({
       subagentId,
       ts: Date.now(),
       type: "subagent.stopped",
-      payload: { subagentId, reason: "stopped by coordinator" }
+      payload: {
+        sessionId,
+        subagentId,
+        reason: "stopped by coordinator"
+      }
     });
     this.emitCoordinatorStats();
   }
@@ -2593,7 +2714,10 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       subagentId: id,
       taskId: s.currentTask ?? "",
       status: s.status,
-      assigned: s.context.parentBridge !== null
+      assigned: s.context.parentBridge !== null,
+      // Each worker's OWN session, so a consumer can split one coordinator's
+      // roster across the tabs that spawned it.
+      sessionId: s.sessionId
     }));
     const sessionId = this.currentSessionId();
     this.fleetBus?.emit({
@@ -2601,7 +2725,7 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       ts: Date.now(),
       type: "coordinator.stats",
       payload: {
-        ...sessionId ? { sessionId } : {},
+        sessionId,
         ...stats,
         subagentStatuses
       }
@@ -2755,9 +2879,7 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       const dispatchable = this.takeNextDispatchableTask();
       if (!dispatchable) {
         if (this.pendingTasks.length > 0 && !this.hasLiveSubagent()) {
-          this.drainPendingAsAborted(
-            "No live subagent available \u2014 all stopped or mid-termination"
-          );
+          this.drainPendingAsAborted("No live subagent available \u2014 all stopped or mid-termination");
         }
         return;
       }
@@ -2887,6 +3009,9 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
     subagent.status = "running";
     subagent.currentTask = task.id;
     task.subagentId = subagentId;
+    if (subagent.sessionId) {
+      task.context = { sessionId: subagent.sessionId, ...task.context ?? {} };
+    }
     subagent.context.tasks.push(task);
     if (subagent.context.tasks.length > _DefaultMultiAgentCoordinator.MAX_SUBAGENT_TASK_HISTORY) {
       subagent.context.tasks.splice(
@@ -2894,12 +3019,17 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
         subagent.context.tasks.length - _DefaultMultiAgentCoordinator.MAX_SUBAGENT_TASK_HISTORY
       );
     }
+    const sessionId = subagent.sessionId;
     this.fleetBus?.emit({
       subagentId,
       taskId: task.id,
       ts: Date.now(),
       type: "subagent.running",
-      payload: { subagentId, taskId: task.id }
+      payload: {
+        sessionId,
+        subagentId,
+        taskId: task.id
+      }
     });
     this.emit("task.assigned", { task, subagentId });
     this.emitCoordinatorStats();
@@ -2923,7 +3053,9 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       },
       "auto",
       {
-        sessionId: () => this.currentSessionId(),
+        // The spawning session, not "whichever tab is in front now": this
+        // worker's token and cost accrual belongs to the tab that started it.
+        sessionId: () => this.sessionOf(subagentId),
         subagentId,
         // Graceful-finish runs own wall-clock enforcement to the watchdog so
         // the notify-then-bound lifecycle cannot be raced by tool.progress
@@ -2943,6 +3075,10 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       config: subagent.config,
       budget,
       signal: subagent.abortController.signal,
+      // The spawning session travels with the run, so the runner stamps its
+      // own events with the tab that owns this worker rather than re-deriving
+      // "the host's current session" when the event happens to fire.
+      sessionId: subagent.sessionId,
       bridge: subagent.context.parentBridge || null,
       reportProgress: (partial) => {
         const text = partial.text.trim();
@@ -3002,7 +3138,7 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       preemptFraction,
       gracefulFinish,
       abortSubagent: (subagentId) => this.subagents.get(subagentId)?.abortController.abort(),
-      currentSessionId: () => this.currentSessionId()
+      currentSessionId: () => this.sessionOf(ctx.subagentId)
     });
   }
   recordCompletion(result) {
@@ -3028,11 +3164,15 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       if (subagent.abortController.signal.aborted) {
         subagent.abortController = new AbortController();
       }
+      const sessionId = subagent.sessionId;
       this.fleetBus?.emit({
         subagentId: result.subagentId,
         ts: Date.now(),
         type: "subagent.idle",
-        payload: { subagentId: result.subagentId }
+        payload: {
+          sessionId,
+          subagentId: result.subagentId
+        }
       });
     }
     this.terminating.delete(result.subagentId);
@@ -3040,12 +3180,14 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       task: subagent?.context.tasks.find((t) => t.id === result.taskId) ?? { id: result.taskId },
       result
     });
+    const completedSessionId = this.sessionOf(result.subagentId);
     this.fleetBus?.emit({
       subagentId: result.subagentId,
       taskId: result.taskId,
       ts: Date.now(),
       type: "subagent.completed",
       payload: {
+        sessionId: completedSessionId,
         subagentId: result.subagentId,
         taskId: result.taskId,
         status: result.status,
@@ -3074,6 +3216,7 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
   async remove(subagentId) {
     const subagent = this.subagents.get(subagentId);
     if (!subagent) return;
+    const removedSessionId = subagent.sessionId;
     if (subagent.status === "running" || subagent.status === "idle") {
       this.terminating.add(subagentId);
       subagent.abortController.abort();
@@ -3098,7 +3241,10 @@ var DefaultMultiAgentCoordinator = class _DefaultMultiAgentCoordinator extends E
       subagentId,
       ts: Date.now(),
       type: "subagent.removed",
-      payload: { subagentId }
+      payload: {
+        sessionId: removedSessionId,
+        subagentId
+      }
     });
     this.emitCoordinatorStats();
   }
@@ -3168,4 +3314,4 @@ export {
   FLEET_ROSTER_WITHACP,
   DefaultMultiAgentCoordinator
 };
-//# sourceMappingURL=chunk-T3KGZBU5.js.map
+//# sourceMappingURL=chunk-S45JPKQN.js.map

package/dist/{chunk-YNCVSFGF.js → chunk-SAFHACFA.js}

@@ -84,6 +84,9 @@ function resolveWstackPaths(opts) {
     profileProviderStatus: (name) => {
       return path.join(globalRoot, "profiles", safeProfileName(name), "provider-status.json");
     },
+    profileProviderAudit: (name) => {
+      return path.join(globalRoot, "profiles", safeProfileName(name), "provider-status-audit.jsonl");
+    },
     profileUpdateCache: (name) => {
       return path.join(globalRoot, "profiles", safeProfileName(name), "update-cache.json");
     },
@@ -146,4 +149,4 @@ export {
   wstackGlobalRoot,
   resolveWstackPaths
 };
-//# sourceMappingURL=chunk-YNCVSFGF.js.map
+//# sourceMappingURL=chunk-SAFHACFA.js.map