@wrongstack/core 0.308.5 → 0.308.7

package/dist/coordination/mail-tools.d.ts

@@ -75,12 +75,12 @@ export declare function makeMailSendTool(opts?: MailToolsOptions): {
         required: string[];
     };
     execute(input: unknown, ctx: Context): Promise<{
-        ok: boolean;
-        error: string;
         messageId?: never;
-        from?: never;
         to?: never;
         summary?: never;
+        ok: boolean;
+        error: string;
+        from?: never;
     } | {
         error?: never;
         ok: boolean;

package/dist/defaults/index.js

@@ -2029,6 +2029,7 @@ function inferRuntimeCapabilities(toolNames) {
 var skillSet = (...names) => names;
 var ROLE_SKILL_SETS = {
   explore: skillSet("research-web", "node-modern", "typescript-strict"),
+  "explore-companion": skillSet("node-modern", "typescript-strict"),
   search: skillSet("bug-hunter", "typescript-strict", "research-web"),
   research: skillSet("research-web", "tech-stack", "security-scanner", "api-design"),
   analyst: skillSet("sdd", "api-design", "testing", "security-scanner"),
@@ -5417,6 +5418,28 @@ var SHADOW_AGENT = {
   ...defineAgent("shadow-agent", "Shadow"),
   skillNames: [...SHADOW_AGENT_SKILLS]
 };
+var EXPLORE_COMPANION_AGENT = {
+  ...defineAgent("explore-companion", "Explore Companion"),
+  tools: [...TOOLS.read, ...TOOLS.index],
+  // Read-only, triple-enforced: allowlist has no write/bash, and the
+  // disabled list blocks the escape hatches explicitly.
+  disabledTools: [
+    "write",
+    "edit",
+    "replace",
+    "patch",
+    "bash",
+    "exec",
+    "delegate",
+    "spawn_subagent",
+    "assign_task"
+  ],
+  skillNames: [...ROLE_SKILL_SETS["explore-companion"]],
+  spawnBudgetExempt: true,
+  // Findings travel via mailbox + submit_result, not the leader's stream.
+  textStream: "silent",
+  toolStream: "silent"
+};
 var CRITIC_AGENT = defineAgent("critic", "Critic");
 var GENERIC_AGENT = defineAgent("generic", "Generic Project Agent");
 function withDispatchMetadata(definition) {
@@ -5435,6 +5458,7 @@ var FLEET_ROSTER = {
   critic: CRITIC_AGENT,
   generic: GENERIC_AGENT,
   "shadow-agent": SHADOW_AGENT,
+  "explore-companion": EXPLORE_COMPANION_AGENT,
   ...Object.fromEntries(
     ALL_AGENT_DEFINITIONS.map((d) => [d.config.role, withDispatchMetadata(d)])
   )
@@ -5458,6 +5482,13 @@ var FLEET_ROSTER_BUDGETS = {
     maxTokens: 96e3,
     maxCostUsd: 0.5
   },
+  "explore-companion": {
+    idleTimeoutMs: DEFAULT_IDLE_TIMEOUT_MS,
+    maxIterations: 3e3,
+    maxToolCalls: 8e3,
+    maxTokens: 96e3,
+    maxCostUsd: 0.5
+  },
   ...Object.fromEntries(
     ALL_AGENT_DEFINITIONS.map((d) => [d.config.role, d.budget])
   )
@@ -8307,7 +8338,7 @@ function buildKanbanFleetTaskPrompt(board, task, lease) {
   const dependencyLines = (task.dependsOn ?? []).map((depId) => board.tasks.find((candidate) => candidate.id === depId)).filter((dep) => Boolean(dep)).map((dep) => `- ${dep.title} [${dep.status}] (${dep.id})`);
   const checks = task.successCriteria?.map((check) => `- ${check.description}`).join("\n");
   const metrics = task.goalMetrics?.map(
-    (metric) => `- ${metric.name}: ${metric.current ?? "n/a"}${metric.target !== void 0 ? ` / ${metric.target}` : ""}${metric.unit ? ` ${metric.unit}` : ""} [${metric.status}]`
+    (metric) => `- ${metric.name}: ${metric.current ?? "n/a"}${metric.target !== void 0 ? ` / ${metric.direction === "at_most" ? "\u2264" : "\u2265"} ${metric.target}` : ""}${metric.unit ? ` ${metric.unit}` : ""} [${metric.status}]`
   ).join("\n");
   const chain = task.chain ? [
     `chainId: ${task.chain.chainId}`,

package/dist/execution/compaction-core.d.ts

@@ -1,6 +1,6 @@
 import { estimateMessageTokens } from '../utils/token-estimate.js';
 export { buildSmartDigest, type ContentScore, extractText, hasLargeToolResult, hasToolUse, scoreMessage, } from './compaction-scoring.js';
-export { type AcknowledgedToolReceiptCollapse, type AcknowledgedToolResultElision, analyzeFileToolLifecycle, collapseAcknowledgedToolReceipts, compactionDebugEnabled, type CompactionMetrics, didFileMutationRun, eliseAcknowledgedToolResults, eliseOldToolResults, type EliseResult, emitCompactionMetrics, extractPathHints, type FileToolLifecycle, findPreserveStart, firstErrorLine, isElidedResultContent, isElidedToolInput, isFileMutationToolName, isReadToolName, normalizePathKey, readPathOf, safeToolResultString, sameFilePath, setCompactionDebugLogger, summarizeToolResultElision, summarizeToolUseInputElision, } from './compaction-elision.js';
+export { collapseAcknowledgedToolReceipts, eliseAcknowledgedToolResults, eliseOldToolResults, type EliseResult, findPreserveStart, isElidedResultContent, isElidedToolInput, normalizePathKey, readPathOf, setCompactionDebugLogger, summarizeToolResultElision, summarizeToolUseInputElision, } from './compaction-elision.js';
 export { buildLosslessDigest, type DedupResult, dedupStaleReads, elideMessageToolIo, enforceHardBudget, findExchangeStart, findSafeBoundary, type HardBudgetResult, hasTextContent, headTailTruncate, truncateMessageText, } from './compaction-budget.js';
 export { CompactionSummaryCache, type CompactionSummaryCacheOptions, compactionSummaryKey, isPlaceholderSummary, PLACEHOLDER_SUMMARIES, } from './compaction-summary-cache.js';
 export declare const estimateMessages: typeof estimateMessageTokens;

package/dist/execution/compaction-elision.d.ts

@@ -11,9 +11,7 @@ export interface CompactionMetrics {
     tokensSaved: number;
     changed: boolean;
 }
-export declare function compactionDebugEnabled(): boolean;
 export declare function setCompactionDebugLogger(logger: Logger | undefined): void;
-export declare function emitCompactionMetrics(event: string, metrics: CompactionMetrics): void;
 export interface EliseResult {
     messages: Message[];
     saved: number;
@@ -30,13 +28,8 @@ export interface FileToolLifecycle {
     activeReadIds: Set<string>;
     staleReadPaths: Map<string, string>;
 }
-export declare function isReadToolName(name: string): boolean;
-export declare function isFileMutationToolName(name: string): boolean;
-export declare function didFileMutationRun(use: ToolUseBlock): boolean;
-export declare function sameFilePath(a: string, b: string): boolean;
 export declare function readPathOf(input: Record<string, unknown> | undefined): string | undefined;
 export declare function normalizePathKey(p: string): string;
-export declare function analyzeFileToolLifecycle(messages: readonly Message[], acknowledgedBefore: number): FileToolLifecycle;
 export declare function isElidedResultContent(content: string): boolean;
 export declare function isElidedToolInput(input: Record<string, unknown> | undefined): boolean;
 export declare function eliseAcknowledgedToolResults(messages: readonly Message[], opts: {
@@ -52,7 +45,4 @@ export declare function eliseOldToolResults(messages: readonly Message[], opts:
 }, findPreserveStartFn?: (messages: readonly Message[], preserveK: number) => number): EliseResult;
 export declare function summarizeToolUseInputElision(block: ToolUseBlock, tokens: number): Record<string, unknown>;
 export declare function summarizeToolResultElision(block: ToolResultBlock, tokens: number): string;
-export declare function safeToolResultString(content: unknown): string;
-export declare function extractPathHints(content: unknown): string[];
-export declare function firstErrorLine(content: unknown): string | undefined;
 //# sourceMappingURL=compaction-elision.d.ts.map

package/dist/execution/index.js

@@ -13481,6 +13481,7 @@ function inferRuntimeCapabilities(toolNames) {
 var skillSet = (...names) => names;
 var ROLE_SKILL_SETS = {
   explore: skillSet("research-web", "node-modern", "typescript-strict"),
+  "explore-companion": skillSet("node-modern", "typescript-strict"),
   search: skillSet("bug-hunter", "typescript-strict", "research-web"),
   research: skillSet("research-web", "tech-stack", "security-scanner", "api-design"),
   analyst: skillSet("sdd", "api-design", "testing", "security-scanner"),
@@ -16937,6 +16938,28 @@ var SHADOW_AGENT = {
   ...defineAgent("shadow-agent", "Shadow"),
   skillNames: [...SHADOW_AGENT_SKILLS]
 };
+var EXPLORE_COMPANION_AGENT = {
+  ...defineAgent("explore-companion", "Explore Companion"),
+  tools: [...TOOLS.read, ...TOOLS.index],
+  // Read-only, triple-enforced: allowlist has no write/bash, and the
+  // disabled list blocks the escape hatches explicitly.
+  disabledTools: [
+    "write",
+    "edit",
+    "replace",
+    "patch",
+    "bash",
+    "exec",
+    "delegate",
+    "spawn_subagent",
+    "assign_task"
+  ],
+  skillNames: [...ROLE_SKILL_SETS["explore-companion"]],
+  spawnBudgetExempt: true,
+  // Findings travel via mailbox + submit_result, not the leader's stream.
+  textStream: "silent",
+  toolStream: "silent"
+};
 var CRITIC_AGENT = defineAgent("critic", "Critic");
 var GENERIC_AGENT = defineAgent("generic", "Generic Project Agent");
 function withDispatchMetadata(definition) {
@@ -16955,6 +16978,7 @@ var FLEET_ROSTER = {
   critic: CRITIC_AGENT,
   generic: GENERIC_AGENT,
   "shadow-agent": SHADOW_AGENT,
+  "explore-companion": EXPLORE_COMPANION_AGENT,
   ...Object.fromEntries(
     ALL_AGENT_DEFINITIONS.map((d) => [d.config.role, withDispatchMetadata(d)])
   )
@@ -16978,6 +17002,13 @@ var FLEET_ROSTER_BUDGETS = {
     maxTokens: 96e3,
     maxCostUsd: 0.5
   },
+  "explore-companion": {
+    idleTimeoutMs: DEFAULT_IDLE_TIMEOUT_MS,
+    maxIterations: 3e3,
+    maxToolCalls: 8e3,
+    maxTokens: 96e3,
+    maxCostUsd: 0.5
+  },
   ...Object.fromEntries(
     ALL_AGENT_DEFINITIONS.map((d) => [d.config.role, d.budget])
   )

package/dist/goal/index.js

@@ -1427,6 +1427,13 @@ var PhaseOrchestrator = class {
   events;
   stopped = false;
   paused = false;
+  /**
+   * Run-wide abort source. stop() aborts it; every in-flight
+   * ctx.executeTask call observes the abort through its per-task signal
+   * (composed from this controller and the task's own timeout controller).
+   * Recreated by start() so a stopped orchestrator can be reused.
+   */
+  stopController = new AbortController();
   runningPhases = /* @__PURE__ */ new Set();
   tickInterval = null;
   trackerCache = /* @__PURE__ */ new Map();
@@ -1469,6 +1476,7 @@ var PhaseOrchestrator = class {
   async start() {
     this.stopped = false;
     this.paused = false;
+    this.stopController = new AbortController();
     this.normalizeForResume();
     this.graph.startedAt = Date.now();
     this.graph.updatedAt = Date.now();
@@ -1528,6 +1536,7 @@ var PhaseOrchestrator = class {
   /** Stop completely, including active phases. */
   stop() {
     this.stopped = true;
+    this.stopController.abort();
     if (this.tickInterval) {
       clearInterval(this.tickInterval);
       this.tickInterval = null;
@@ -1604,6 +1613,7 @@ var PhaseOrchestrator = class {
         return;
       }
       await this.executePhaseTasks(phase);
+      if (this.stopped) return;
       const failedTasks = this.getFailedTaskCount(phase);
       const completedTasks = this.getCompletedTaskCount(phase);
       this.emit("phase.allTasksDone", {
@@ -1763,34 +1773,47 @@ var PhaseOrchestrator = class {
       agentName: task.assignee
     });
     const handle = this.phaseWorktrees.get(phase.id);
-    const taskPromise = this.ctx.executeTask(task, phase.id, {
-      cwd: handle?.dir,
-      branch: handle?.branch
+    const timeoutController = this.opts.taskTimeoutMs > 0 ? new AbortController() : void 0;
+    const signal = timeoutController ? AbortSignal.any([this.stopController.signal, timeoutController.signal]) : this.stopController.signal;
+    const taskPromise = this.ctx.executeTask(
+      task,
+      phase.id,
+      { cwd: handle?.dir, branch: handle?.branch },
+      signal
+    );
+    if (!timeoutController) return taskPromise;
+    const timeoutMs = this.opts.taskTimeoutMs;
+    const timedOut = /* @__PURE__ */ Symbol("timed_out");
+    const result = await Promise.race([
+      taskPromise,
+      new Promise((resolve4) => {
+        const timer = setTimeout(() => {
+          timeoutController.abort();
+          resolve4(timedOut);
+        }, timeoutMs);
+        taskPromise.then(() => clearTimeout(timer)).catch(() => clearTimeout(timer));
+      })
+    ]);
+    if (result !== timedOut) return result;
+    this.emit("phase.taskTimedOut", {
+      phaseId: phase.id,
+      taskId: task.id,
+      taskTitle: task.title,
+      timeoutMs
     });
-    if (this.opts.taskTimeoutMs > 0) {
-      const timeoutMs = this.opts.taskTimeoutMs;
-      const timedOut = /* @__PURE__ */ Symbol("timed_out");
-      const result = await Promise.race([
-        taskPromise,
-        new Promise((resolve4) => {
-          const timer = setTimeout(() => resolve4(timedOut), timeoutMs);
-          taskPromise.then(() => clearTimeout(timer)).catch(() => clearTimeout(timer));
-        })
-      ]);
-      if (result === timedOut) {
-        this.emit("phase.taskTimedOut", {
-          phaseId: phase.id,
-          taskId: task.id,
-          taskTitle: task.title,
-          timeoutMs
-        });
-        throw new Error(
-          `Task "${task.title}" (${task.id}) exceeded timeout of ${timeoutMs} ms`
-        );
-      }
-      return result;
-    }
-    return taskPromise;
+    const settled = taskPromise.then(
+      () => void 0,
+      () => void 0
+    );
+    const grace = new Promise((resolve4) => {
+      const timer = setTimeout(resolve4, 5e3);
+      timer.unref?.();
+      void settled.then(() => clearTimeout(timer));
+    });
+    await Promise.race([settled, grace]);
+    throw new Error(
+      `Task "${task.title}" (${task.id}) exceeded timeout of ${timeoutMs} ms`
+    );
   }
   markTaskCompleted(phase, task) {
     const tracker = this.getTrackerForPhase(phase);
@@ -1805,6 +1828,10 @@ var PhaseOrchestrator = class {
     const tracker = this.getTrackerForPhase(phase);
     const taskKey = `${phase.id}:${task.id}`;
     const currentRetries = this.taskRetryCounts.get(taskKey) ?? 0;
+    if (this.stopped) {
+      tracker.updateNodeStatus(task.id, "pending", "Stopped before completion");
+      return;
+    }
     if (currentRetries < this.opts.maxRetries) {
       this.taskRetryCounts.set(taskKey, currentRetries + 1);
       tracker.updateNodeStatus(

package/dist/goal/phase-orchestrator.d.ts

@@ -19,6 +19,13 @@ export declare class PhaseOrchestrator {
     private events;
     private stopped;
     private paused;
+    /**
+     * Run-wide abort source. stop() aborts it; every in-flight
+     * ctx.executeTask call observes the abort through its per-task signal
+     * (composed from this controller and the task's own timeout controller).
+     * Recreated by start() so a stopped orchestrator can be reused.
+     */
+    private stopController;
     private runningPhases;
     private tickInterval;
     private trackerCache;

package/dist/goal/types.d.ts

@@ -223,7 +223,7 @@ export interface PhaseExecutionContext {
     executeTask: (task: TaskNode, phaseId: string, env?: {
         cwd?: string | undefined;
         branch?: string | undefined;
-    }) => Promise<unknown>;
+    }, signal?: AbortSignal | undefined) => Promise<unknown>;
     /**
      * Optional verification gate. Called after all tasks in a phase finish,
      * but before the phase is marked "completed" and its worktree is merged