reasonix 0.43.0 → 0.44.0

package/dist/cli/{sessions-FH7QVYSY.js → sessions-CKQXCYGP.js}

@@ -1,27 +1,29 @@
 #!/usr/bin/env node
 import { createRequire as __cr } from 'node:module'; if (typeof globalThis.require === 'undefined') { globalThis.require = __cr(import.meta.url); }
-import "./chunk-2R4QCDOZ.js";
-import "./chunk-F3PXYSNN.js";
-import "./chunk-FHOGSSCH.js";
-import "./chunk-6AK4EY3D.js";
-import "./chunk-5JJRUIPA.js";
-import "./chunk-PV55UMTO.js";
-import "./chunk-2KDUS647.js";
+import "./chunk-OPFUUYHL.js";
+import "./chunk-WK3UFQY3.js";
+import "./chunk-C53JQES5.js";
+import "./chunk-XSU4QVFW.js";
+import "./chunk-JNAQYELD.js";
+import "./chunk-6OWJV3YW.js";
+import "./chunk-V26WPN3J.js";
 import "./chunk-25T6CVUP.js";
 import "./chunk-2UQP6H6T.js";
-import "./chunk-O52OLQL3.js";
-import "./chunk-2K65GZBT.js";
-import "./chunk-7O5ALB4C.js";
+import "./chunk-RDRC3XDT.js";
+import "./chunk-TEUDEGX2.js";
+import "./chunk-7CIGMZT3.js";
 import "./chunk-S4XVGLRW.js";
 import {
   listSessions,
   loadSessionMessages,
   sessionPath
 } from "./chunk-6PBZN4VI.js";
-import "./chunk-RE4RAVFF.js";
-import "./chunk-XPDVG52A.js";
-import "./chunk-HFEAY5DT.js";
-import "./chunk-YQ6NTIIE.js";
+import "./chunk-R3CTO2HM.js";
+import "./chunk-ZZYBBX5N.js";
+import {
+  t
+} from "./chunk-CGDR2ELH.js";
+import "./chunk-AVFXO2EZ.js";
 import "./chunk-XXC2BYTV.js";
 import "./chunk-TUK7OWJA.js";
 
@@ -36,9 +38,7 @@ function sessionsCommand(opts) {
 function listAll() {
   const items = listSessions();
   if (items.length === 0) {
-    console.log(
-      "no saved sessions yet \u2014 run `reasonix chat` (sessions are auto-saved unless --no-session)."
-    );
+    console.log(t("sessions.emptyHint"));
     return;
   }
   console.log("Saved sessions (~/.reasonix/sessions/):");
@@ -103,4 +103,4 @@ function truncate(s, max) {
 export {
   sessionsCommand
 };
-//# sourceMappingURL=sessions-FH7QVYSY.js.map
+//# sourceMappingURL=sessions-CKQXCYGP.js.map

package/dist/cli/sessions-CKQXCYGP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/commands/sessions.ts"],"sourcesContent":["import { t } from \"../../i18n/index.js\";\nimport { listSessions, loadSessionMessages, sessionPath } from \"../../index.js\";\nimport type { ChatMessage } from \"../../index.js\";\n\nexport interface SessionsOptions {\n  /** When present, inspect that session instead of listing. */\n  name?: string;\n  /** Include assistant tool-call metadata in the inspect output. */\n  verbose?: boolean;\n}\n\nexport function sessionsCommand(opts: SessionsOptions): void {\n  if (opts.name) {\n    inspectSession(opts.name, !!opts.verbose);\n  } else {\n    listAll();\n  }\n}\n\nfunction listAll(): void {\n  const items = listSessions();\n  if (items.length === 0) {\n    console.log(t(\"sessions.emptyHint\"));\n    return;\n  }\n  console.log(\"Saved sessions (~/.reasonix/sessions/):\");\n  console.log(\"\");\n  console.log(`  ${\"name\".padEnd(22)} ${\"msgs\".padStart(6)}  ${\"size\".padStart(8)}  modified`);\n  console.log(`  ${\"─\".repeat(60)}`);\n  for (const s of items) {\n    const sizeKb = `${(s.size / 1024).toFixed(1)} KB`;\n    const when = s.mtime.toISOString().replace(\"T\", \" \").slice(0, 16);\n    console.log(\n      `  ${s.name.padEnd(22)} ${String(s.messageCount).padStart(6)}  ${sizeKb.padStart(8)}  ${when}`,\n    );\n  }\n  console.log(\"\");\n  console.log(\"Inspect:  reasonix sessions <name>\");\n  console.log(\"Resume:   reasonix chat --session <name>\");\n}\n\nfunction inspectSession(name: string, verbose: boolean): void {\n  const path = sessionPath(name);\n  const messages = loadSessionMessages(name);\n  if (messages.length === 0) {\n    console.error(`no session named \"${name}\" (or it's empty).`);\n    console.error(`looked at: ${path}`);\n    process.exit(1);\n  }\n\n  console.log(`[session] ${name}   ${messages.length} messages   ${path}`);\n  console.log(\"\");\n\n  let turnIndex = 0;\n  for (const msg of messages) {\n    renderMessage(msg, turnIndex, verbose);\n    // Roughly bump \"turn\" after each user message so the reader can follow\n    // the conversation shape without the transcript's richer turn numbering.\n    if (msg.role === \"user\") turnIndex++;\n  }\n}\n\nfunction renderMessage(msg: ChatMessage, turnIdx: number, verbose: boolean): void {\n  const turn = turnIdx > 0 ? `[t${turnIdx}]` : \"[start]\";\n  const content = typeof msg.content === \"string\" ? msg.content : \"\";\n  const flat = oneLine(content);\n\n  if (msg.role === \"user\") {\n    console.log(`${turn} USER: ${flat}`);\n  } else if (msg.role === \"assistant\") {\n    console.log(`${turn} AGENT: ${flat || \"(tool call only)\"}`);\n    if (verbose && msg.tool_calls?.length) {\n      for (const tc of msg.tool_calls) {\n        console.log(\n          `         → call ${tc.function?.name} ${truncate(tc.function?.arguments ?? \"\", 80)}`,\n        );\n      }\n    }\n  } else if (msg.role === \"tool\") {\n    console.log(`${turn} TOOL ${msg.name ?? \"?\"}: ${truncate(flat, 160)}`);\n  } else if (msg.role === \"system\") {\n    if (verbose) console.log(`${turn} SYSTEM: ${truncate(flat, 160)}`);\n    // otherwise suppress — session's system prompt is usually session-wide\n    // boilerplate.\n  }\n}\n\nfunction oneLine(s: string, max = 200): string {\n  const collapsed = s.replace(/\\s+/g, \" \").trim();\n  return collapsed.length > max ? `${collapsed.slice(0, max)}…` : collapsed;\n}\n\nfunction truncate(s: string, max: number): string {\n  return s.length <= max ? s : `${s.slice(0, max)}…`;\n}\n"],"mappings":"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","names":[]}

package/dist/cli/{setup-VDS6SVEP.js → setup-TPAGSVXO.js}

@@ -3,11 +3,11 @@ import { createRequire as __cr } from 'node:module'; if (typeof globalThis.requi
 import {
   MultiSelect,
   SingleSelect
-} from "./chunk-6PZ3CXBP.js";
+} from "./chunk-MRHHQJAQ.js";
 import {
   ThemeProvider,
   useTheme
-} from "./chunk-TJX6BFZZ.js";
+} from "./chunk-AB2RED3C.js";
 import {
   Box_default,
   Text,
@@ -16,7 +16,7 @@ import {
   source_default,
   use_app_default,
   use_input_default
-} from "./chunk-6G3CUUFG.js";
+} from "./chunk-X53B3JIX.js";
 import {
   PRESET_DESCRIPTIONS
 } from "./chunk-2425HK6U.js";
@@ -34,7 +34,7 @@ import {
   onLanguageChange,
   setLanguage,
   t
-} from "./chunk-RE4RAVFF.js";
+} from "./chunk-CGDR2ELH.js";
 import {
   defaultConfigPath,
   isPlausibleKey,
@@ -46,7 +46,7 @@ import {
   redactKey,
   resolveThemePreference,
   writeConfig
-} from "./chunk-XPDVG52A.js";
+} from "./chunk-AVFXO2EZ.js";
 import {
   __toESM
 } from "./chunk-TUK7OWJA.js";
@@ -615,4 +615,4 @@ async function setupCommand(opts = {}) {
 export {
   setupCommand
 };
-//# sourceMappingURL=setup-VDS6SVEP.js.map
+//# sourceMappingURL=setup-TPAGSVXO.js.map

package/dist/cli/{stats-MQVI2XQH.js → stats-DPUBZNVX.js}

@@ -3,12 +3,14 @@ import { createRequire as __cr } from 'node:module'; if (typeof globalThis.requi
 import {
   renderDashboard,
   statsCommand
-} from "./chunk-OSZC7C6F.js";
-import "./chunk-HFEAY5DT.js";
-import "./chunk-YQ6NTIIE.js";
+} from "./chunk-CWZKQ5FE.js";
+import "./chunk-R3CTO2HM.js";
+import "./chunk-ZZYBBX5N.js";
+import "./chunk-CGDR2ELH.js";
+import "./chunk-AVFXO2EZ.js";
 import "./chunk-TUK7OWJA.js";
 export {
   renderDashboard,
   statsCommand
 };
-//# sourceMappingURL=stats-MQVI2XQH.js.map
+//# sourceMappingURL=stats-DPUBZNVX.js.map

package/dist/cli/{version-DAHGZY5N.js → version-2X3BHVVK.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import { createRequire as __cr } from 'node:module'; if (typeof globalThis.require === 'undefined') { globalThis.require = __cr(import.meta.url); }
-import "./chunk-2R4QCDOZ.js";
-import "./chunk-F3PXYSNN.js";
-import "./chunk-FHOGSSCH.js";
-import "./chunk-6AK4EY3D.js";
-import "./chunk-5JJRUIPA.js";
-import "./chunk-PV55UMTO.js";
-import "./chunk-2KDUS647.js";
+import "./chunk-OPFUUYHL.js";
+import "./chunk-WK3UFQY3.js";
+import "./chunk-C53JQES5.js";
+import "./chunk-XSU4QVFW.js";
+import "./chunk-JNAQYELD.js";
+import "./chunk-6OWJV3YW.js";
+import "./chunk-V26WPN3J.js";
 import "./chunk-25T6CVUP.js";
 import "./chunk-2UQP6H6T.js";
-import "./chunk-O52OLQL3.js";
-import "./chunk-2K65GZBT.js";
-import "./chunk-7O5ALB4C.js";
+import "./chunk-RDRC3XDT.js";
+import "./chunk-TEUDEGX2.js";
+import "./chunk-7CIGMZT3.js";
 import "./chunk-S4XVGLRW.js";
 import "./chunk-6PBZN4VI.js";
-import "./chunk-RE4RAVFF.js";
-import "./chunk-XPDVG52A.js";
-import "./chunk-HFEAY5DT.js";
-import "./chunk-YQ6NTIIE.js";
+import "./chunk-R3CTO2HM.js";
+import "./chunk-ZZYBBX5N.js";
+import "./chunk-CGDR2ELH.js";
+import "./chunk-AVFXO2EZ.js";
 import {
   VERSION
 } from "./chunk-XXC2BYTV.js";
@@ -30,4 +30,4 @@ function versionCommand() {
 export {
   versionCommand
 };
-//# sourceMappingURL=version-DAHGZY5N.js.map
+//# sourceMappingURL=version-2X3BHVVK.js.map

package/dist/index.d.ts

@@ -497,6 +497,8 @@ interface TruncationRepairResult {
     repaired: string;
     changed: boolean;
     notes: string[];
+    /** True when all repair attempts failed and the result falls back to "{}" — the original args are unrecoverable. */
+    fallback: boolean;
 }
 declare function repairTruncatedJson(input: string): TruncationRepairResult;
 
@@ -590,6 +592,7 @@ declare class SessionStats {
         cacheMissTokens?: number;
         lastPromptTokens?: number;
     }): void;
+    reset(): void;
     record(turn: number, model: string, usage: Usage): TurnStats;
     get totalCost(): number;
     get totalClaudeEquivalent(): number;
@@ -605,10 +608,10 @@ type EventRole = "assistant_delta" | "assistant_final"
  | "tool_call_delta"
 /** Pre-dispatch ping so the TUI can show a spinner during long tool awaits. */
  | "tool_start" | "tool" | "done" | "error" | "warning"
-/** Loop reached its pause interval; state is on disk under `sessionName`, caller may resume. */
- | "paused"
 /** Transient indicator for silent phases; UI clears on next primary event. */
- | "status";
+ | "status"
+/** Mid-turn steer injected as a user utterance without aborting the current turn. */
+ | "steer";
 interface LoopEvent {
     turn: number;
     role: EventRole;
@@ -630,12 +633,6 @@ interface LoopEvent {
     error?: string;
     /** Display-only — code-mode applier MUST skip SEARCH/REPLACE in forced-summary text. */
     forcedSummary?: boolean;
-    /** Set on `role === "paused"` — the session name caller passes back as `resume_session` to continue. */
-    sessionName?: string;
-    /** Set on `role === "paused"` — iter count consumed before pausing. */
-    pausedAtIter?: number;
-    /** Set on `role === "paused"` — one-shot no-tools summary of progress / remaining / blockers, for the parent's resume decision. */
-    partialSummary?: string;
 }
 
 interface ImmutablePrefixOptions {
@@ -762,7 +759,6 @@ interface CacheFirstLoopOptions {
     prefix: ImmutablePrefix;
     tools?: ToolRegistry;
     model?: string;
-    maxToolIters?: number;
     stream?: boolean;
     reasoningEffort?: "high" | "max";
     autoEscalate?: boolean;
@@ -779,8 +775,6 @@ interface CacheFirstLoopOptions {
     confirmationGate?: PauseGate;
     /** Re-runs the prompt builder (applyMemoryStack / codeSystemPrompt) on /new so REASONIX.md edits take effect without a restart. Accepting a cache miss is the price. */
     rebuildSystem?: () => string;
-    /** What to do when the per-step iter budget is exhausted. "summarize" (default) fires a no-tools call so the user sees an answer — right for top-level chat. "pause" yields a `paused` event leaving the session intact — right for subagents whose parent can decide to resume or accept partial state. */
-    onIterBudgetExhausted?: "summarize" | "pause";
 }
 interface ReconfigurableOptions {
     model?: string;
@@ -794,7 +788,6 @@ declare class CacheFirstLoop {
     readonly client: DeepSeekClient;
     readonly prefix: ImmutablePrefix;
     readonly tools: ToolRegistry;
-    readonly maxToolIters: number;
     readonly log: AppendOnlyLog;
     readonly scratch: VolatileScratch;
     readonly stats: SessionStats;
@@ -807,7 +800,6 @@ declare class CacheFirstLoop {
     /** One-shot 80% warning latch — cleared by setBudget so a bump re-arms at the new boundary. */
     private _budgetWarned;
     sessionName: string | null;
-    readonly onIterBudgetExhausted: "summarize" | "pause";
     hooks: ResolvedHook[];
     hookCwd: string;
     /** PauseGate bridge — defaults to singleton, injectable for tests. */
@@ -821,12 +813,20 @@ declare class CacheFirstLoop {
     private _turnAbort;
     /** Authoritative running-id set — UI cards consult this instead of trusting end-event delivery. Insert at dispatch entry, delete in finally. */
     private readonly _inflight;
+    /** Typeahead steer message set by the UI; step() consumes it at the next iter boundary. */
+    private _steer;
+    /** Set true when a steer was consumed this turn; cleared on next step() entry. */
+    private _steerConsumed;
+    /** UI calls this to inject a mid-turn steer message without aborting the current turn.
+     *  New text resets steerConsumed — a fresh steer hasn't been consumed yet. */
+    steer(text: string | null): void;
+    /** True when a steer was consumed this turn (UI gate to avoid double-submit). */
+    get steerConsumed(): boolean;
     private _proArmedForNextTurn;
     private _escalateThisTurn;
     private readonly _turnFailures;
     private _turnSelfCorrected;
     private _foldedThisTurn;
-    private _toolDispatchesThisStep;
     private context;
     /** Subscribe API so UI hooks can derive `running` from finally-guaranteed insertions. */
     get inflight(): InflightSet;
@@ -850,6 +850,13 @@ declare class CacheFirstLoop {
         archived: string | null;
         systemRebuilt: boolean;
     };
+    /** `/cwd` follow-through — archives the previous session, drops in-memory state, repoints sessionName, and rebuilds the system prompt against whatever the rebuilder closure now resolves (the caller is expected to have already updated the root the closure reads). */
+    switchWorkspace(opts: {
+        sessionName: string;
+    }): {
+        dropped: number;
+        archived: string | null;
+    };
     configure(opts: ReconfigurableOptions): void;
     /** `null` disables the cap; any change re-arms the 80% warning. */
     setBudget(usd: number | null): void;
@@ -1046,6 +1053,31 @@ interface IndexUserConfig {
     maxFileBytes?: number;
 }
 
+/** Plain http:// stays HTTP+SSE for back-compat; Streamable HTTP is opt-in via the `streamable+` URL prefix. */
+interface StdioMcpSpec {
+    transport: "stdio";
+    /** Namespace prefix applied to each registered tool, or null if anonymous. */
+    name: string | null;
+    /** Argv[0]. */
+    command: string;
+    /** Remaining argv. */
+    args: string[];
+}
+interface SseMcpSpec {
+    transport: "sse";
+    name: string | null;
+    /** Fully qualified SSE endpoint URL. */
+    url: string;
+}
+interface StreamableHttpMcpSpec {
+    transport: "streamable-http";
+    name: string | null;
+    /** Fully qualified Streamable HTTP endpoint URL (no `streamable+` prefix). */
+    url: string;
+}
+type McpSpec = StdioMcpSpec | SseMcpSpec | StreamableHttpMcpSpec;
+declare function parseMcpSpec(input: string): McpSpec;
+
 /** Library reads only DEEPSEEK_API_KEY from env; the CLI bridges config.json → env var. */
 
 /** Legacy `fast|smart|max` kept for back-compat with existing config.json files. */
@@ -1069,6 +1101,21 @@ interface SemanticEmbeddingUserConfig {
     ollama?: OllamaEmbeddingUserConfig;
     openaiCompat?: OpenAICompatEmbeddingUserConfig;
 }
+interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport?: "stdio" | "sse" | "streamable-http";
+    url?: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+}
+interface QQBotConfig {
+    appId?: string;
+    appSecret?: string;
+    sandbox?: boolean;
+    enabled?: boolean;
+}
 interface ReasonixConfig {
     apiKey?: string;
     baseUrl?: string;
@@ -1077,11 +1124,15 @@ interface ReasonixConfig {
     editMode?: EditMode;
     editModeHintShown?: boolean;
     mouseClipboardHintShown?: boolean;
+    /** When false, skip the boot splash animation and show the main UI immediately. Default true. */
+    banner?: boolean;
     reasoningEffort?: ReasoningEffort;
     /** Default workspace root for the desktop client. CLI uses cwd. */
     workspaceDir?: string;
     /** Last N workspace paths the desktop client has opened, most recent first. */
     recentWorkspaces?: string[];
+    /** Desktop only — workspace dir per open tab in tab order, persisted so restart restores every tab (issue #933). Empty/absent → boot with a single default tab. */
+    desktopOpenTabs?: string[];
     /** Desktop only — `openWith` value for clicking file links. Empty/undefined = OS default app. Examples: "code", "cursor", "C:\\path\\to\\editor.exe". */
     editor?: string;
     theme?: ThemeName | "auto";
@@ -1091,16 +1142,24 @@ interface ReasonixConfig {
     mcpDisabled?: string[];
     /** Env overlay per MCP server name (matches the `name=` prefix of the spec). Stdio transports merge this over process.env; SSE/HTTP ignore it. */
     mcpEnv?: Record<string, Record<string, string>>;
+    /** Canonical MCP server configuration — merges with and overrides legacy `mcp`/`mcpEnv`/`mcpDisabled`. */
+    mcpServers?: Record<string, McpServerConfig>;
     session?: string | null;
     setupCompleted?: boolean;
     search?: boolean;
-    /** Web search engine backend: "mojeek" (default, scrapes Mojeek) or "searxng" (self-hosted SearXNG). */
-    webSearchEngine?: "mojeek" | "searxng";
+    /** Web search engine backend: "mojeek" (default, scrapes Mojeek), "searxng" (self-hosted SearXNG), or "metaso" (Metaso API). */
+    webSearchEngine?: "mojeek" | "searxng" | "metaso";
     /** Base URL for SearXNG instance (default http://localhost:8080). */
     webSearchEndpoint?: string;
+    /** Metaso API key. Falls back to METASO_API_KEY env var, then a built-in default. */
+    metasoApiKey?: string;
     dashboard?: {
         /** Pin the embedded dashboard to a fixed port — required for stable SSH tunnels. 0/absent → ephemeral. */
         port?: number;
+        /** Bind address (#968). Defaults to 127.0.0.1 (loopback only). Set to 0.0.0.0 / :: / a LAN IP to expose to other devices; the URL token is then the only auth, so keep it secret. */
+        host?: string;
+        /** Stable URL token (#968). If unset, a fresh token is minted each boot. Min 16 chars enforced at load time. */
+        token?: string;
     };
     escalation?: {
         /** Per-turn repair/error signal count required to escalate flash→pro. Defaults to 3. Out-of-range → default. */
@@ -1123,12 +1182,25 @@ interface ReasonixConfig {
             pathAllowed?: string[];
         };
     };
+    /** Issue #259 — user-configurable sensitive-path prefixes and filename patterns.
+     *  Commands touching these paths are demoted to the confirm gate even when allowlisted. */
+    sensitivePaths?: {
+        /** Path prefixes (tilde-relative or absolute) that trigger confirmation. */
+        prefixes?: string[];
+        /** Glob-style filename patterns (matched against basename, case-insensitive). */
+        patterns?: string[];
+    };
     index?: IndexUserConfig;
     semantic?: SemanticEmbeddingUserConfig;
+    skills?: {
+        paths?: string[];
+    };
     /** User-declared extensions to the built-in memory types (#709). Unknown types round-trip even without a declaration; declaring one lets you attach a default priority + lifecycle. */
     memory?: {
         customTypes?: CustomMemoryTypeConfig[];
     };
+    /** QQ Bot configuration */
+    qq?: QQBotConfig;
 }
 interface CustomMemoryTypeConfig {
     name: string;
@@ -1136,6 +1208,7 @@ interface CustomMemoryTypeConfig {
     priority?: "low" | "medium" | "high";
     expires?: "project_end";
 }
+declare function loadMetasoApiKey(path?: string): string;
 declare function defaultConfigPath(): string;
 declare function readConfig(path?: string): ReasonixConfig;
 declare function writeConfig(cfg: ReasonixConfig, path?: string): void;
@@ -1226,7 +1299,10 @@ declare function applyUserMemory(basePrompt: string, opts?: {
     projectRoot?: string;
     cfg?: ReasonixConfig;
 }): string;
-declare function applyMemoryStack(basePrompt: string, rootDir: string): string;
+declare function applyMemoryStack(basePrompt: string, rootDir: string, opts?: {
+    homeDir?: string;
+    cfg?: ReasonixConfig;
+}): string;
 
 /** Native FS tools — sandbox enforced here, not delegated. `edit_file` takes a single SEARCH/REPLACE string. */
 
@@ -1235,8 +1311,8 @@ interface FilesystemToolsOptions {
     rootDir: string;
     /** false → register only read-side tools. Default true. */
     allowWriting?: boolean;
-    /** Per-read byte cap; floor against OOM on a multi-GB blob. */
-    maxReadBytes?: number;
+    /** Files at or under this size get full content; larger go to outline mode. Default 512 KiB. */
+    outlineThresholdBytes?: number;
     /** Cap on total bytes from listing/grep tools — bounds tree-as-one-string accidents. */
     maxListBytes?: number;
 }
@@ -1360,20 +1436,87 @@ interface SubagentEvent {
 interface SubagentSink {
     current: ((ev: SubagentEvent) => void) | null;
 }
+interface SubagentResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    turns: number;
+    toolIters: number;
+    elapsedMs: number;
+    costUsd: number;
+    model: string;
+    skillName?: string;
+    /** Zero-filled when no API calls landed so consumers always see a valid shape. */
+    usage: Usage;
+    /** True when the child terminated via forceSummaryAfterIterLimit (storm-breaker / context-guard) — `output` carries the partial synthesis the model managed to produce; not a full answer. User-abort forced summaries do NOT set this (their content is a UX placeholder, routed to `error`). */
+    forcedSummary?: boolean;
+}
 interface SubagentToolOptions {
     client: DeepSeekClient;
     defaultSystem?: string;
     projectRoot?: string;
     defaultModel?: string;
-    maxToolIters?: number;
     maxResultChars?: number;
     sink?: SubagentSink;
+    /** Fires once per spawn, after `spawnSubagent` returns and before its result is formatted for the parent. Bind a `SubagentTelemetry.record` here for automatic distillation capture. */
+    onSpawnComplete?: (result: SubagentResult) => void;
 }
 /** Library surface only — `reasonix code` uses Skills `runAs: subagent` as the user-facing path. */
 declare function registerSubagentTool(parentRegistry: ToolRegistry, opts: SubagentToolOptions): ToolRegistry;
 /** Plan-mode state propagates — a subagent spawned under `/plan` MUST NOT escape it. */
 declare function forkRegistryExcluding(parent: ToolRegistry, exclude: ReadonlySet<string>): ToolRegistry;
 
+/** Distillation telemetry — measures parent-log growth avoided per spawn. */
+/** Minimum shape `computeSpawnDistillation` needs. `SubagentResult` matches structurally; declaring a local interface avoids a stats ↔ subagent ↔ loop import cycle. */
+interface SubagentResultLike {
+    output: string;
+    costUsd: number;
+    usage: {
+        completionTokens: number;
+    };
+}
+interface SpawnDistillation {
+    completionTokens: number;
+    outputTokens: number;
+    /** `completionTokens − outputTokens`, clamped to 0. Lower bound — ignores tool-result tokens that would also have landed in the parent log inline. */
+    savingsTokens: number;
+    /** `outputTokens / completionTokens`; 1 when completion is 0. Lower is more distilled; ≥1 means writes / passthrough. */
+    compressionRatio: number;
+    /** True iff `output.trim().length > 0`. */
+    hasOutput: boolean;
+    costUsd: number;
+}
+declare function computeSpawnDistillation(result: SubagentResultLike): SpawnDistillation;
+interface SubagentSessionSummary {
+    spawnCount: number;
+    usefulSpawnCount: number;
+    /** `usefulSpawnCount / spawnCount`; 0 when no spawns. */
+    successRate: number;
+    totalCompletionTokens: number;
+    totalOutputTokens: number;
+    totalSavingsTokens: number;
+    /** Weighted by completion tokens — fair vs. naive mean of ratios. */
+    aggregateCompressionRatio: number;
+    totalCostUsd: number;
+}
+declare function summarizeSubagentSession(spawns: SpawnDistillation[]): SubagentSessionSummary;
+declare const DEFAULT_SPAWN_STORM_THRESHOLD = 3;
+declare function countSpawnStorms(spawnsByTurn: ReadonlyArray<ReadonlyArray<SpawnDistillation>>, threshold?: number): number;
+/** Live collector — append every spawn result, query aggregates whenever. Bind `record` and pass as `onSpawnComplete` to `registerSubagentTool` for automatic capture. */
+declare class SubagentTelemetry {
+    private readonly _spawns;
+    private readonly _byTurn;
+    private _currentTurn;
+    /** Bound for ergonomic use as a callback. */
+    readonly record: (result: SubagentResultLike) => SpawnDistillation;
+    /** Mark the start of a new parent turn so subsequent records group into a new bucket — call from the parent loop when its turn counter advances. */
+    startTurn(turn: number): void;
+    get spawns(): readonly SpawnDistillation[];
+    get spawnsByTurn(): ReadonlyArray<ReadonlyArray<SpawnDistillation>>;
+    get summary(): SubagentSessionSummary;
+    stormCount(threshold?: number): number;
+}
+
 /** Background process registry for never-exiting commands; ready-signal detection short-circuits the startup wait. */
 interface JobStartOptions {
     /** Absolute path to cwd for the spawned child. */
@@ -1492,8 +1635,12 @@ declare function quoteForCmdExe(arg: string): string;
 declare function tokenizeCommand(cmd: string): string[];
 /** Up-front detection — without it, `dir | findstr foo` quotes `|` literal and pipe silently fails. */
 declare function detectShellOperator(cmd: string): string | null;
-/** Allowlist match on leading argv tokens; demoted by `RISKY_ARGS` when a destructive flag appears in the tail. */
-declare function isAllowed(cmd: string, extra?: readonly string[]): boolean;
+/** Allowlist match on leading argv tokens; demoted by `RISKY_ARGS` when a destructive flag appears in the tail,
+ *  or by `SENSITIVE_PATHS` when a path argument targets a sensitive location (#259). */
+declare function isAllowed(cmd: string, extra?: readonly string[], projectRoot?: string, sensitivePathConfig?: {
+    prefixes?: readonly string[];
+    patterns?: readonly string[];
+}): boolean;
 
 /** cwd pinned to root; non-allowlisted commands throw to a UI confirm gate; spawn is `shell: false`, tokenized argv only. */
 
@@ -1508,6 +1655,12 @@ interface ShellToolsOptions {
     /** Getter form lets `editMode === "yolo"` flip mid-session without re-registering tools. */
     allowAll?: boolean | (() => boolean);
     jobs?: JobRegistry;
+    /** Fired after `run_background` / `stop_job` mutate the registry — used by the desktop popover for near-real-time updates without polling. */
+    onJobsChanged?: () => void;
+    sensitivePaths?: {
+        prefixes?: readonly string[];
+        patterns?: readonly string[];
+    };
 }
 /** Error thrown by `run_command` when the command isn't allowlisted. */
 declare class NeedsConfirmationError extends Error {
@@ -1541,8 +1694,8 @@ interface WebFetchOptions {
 interface WebSearchOptions {
     topK?: number;
     signal?: AbortSignal;
-    /** Backend engine: "mojeek" (scrapes Mojeek HTML) or "searxng" (self-hosted SearXNG JSON API). */
-    engine?: "mojeek" | "searxng";
+    /** Backend engine: "mojeek" (scrapes Mojeek HTML), "searxng" (self-hosted SearXNG JSON API), or "metaso" (Metaso API). */
+    engine?: "mojeek" | "searxng" | "metaso";
     /** Base URL for SearXNG. Default http://localhost:8080. */
     endpoint?: string;
 }
@@ -1559,8 +1712,8 @@ interface WebToolsOptions {
     defaultTopK?: number;
     /** Byte cap for `web_fetch` extracted text. */
     maxFetchChars?: number;
-    /** Backend engine: "mojeek" (default, scrapes Mojeek) or "searxng" (self-hosted SearXNG). */
-    webSearchEngine?: "mojeek" | "searxng";
+    /** Backend engine: "mojeek" (default, scrapes Mojeek), "searxng" (self-hosted SearXNG), or "metaso" (Metaso API). */
+    webSearchEngine?: "mojeek" | "searxng" | "metaso";
     /** Base URL for SearXNG (default http://localhost:8080). */
     webSearchEndpoint?: string;
 }
@@ -2120,31 +2273,6 @@ declare function truncateForModel(s: string, maxChars: number): string;
 /** Never tokenizes full input — pathological repetitive text (`AAAA…`) costs 30s+ on the pure-TS BPE port. */
 declare function truncateForModelByTokens(s: string, maxTokens: number): string;
 
-/** Plain http:// stays HTTP+SSE for back-compat; Streamable HTTP is opt-in via the `streamable+` URL prefix. */
-interface StdioMcpSpec {
-    transport: "stdio";
-    /** Namespace prefix applied to each registered tool, or null if anonymous. */
-    name: string | null;
-    /** Argv[0]. */
-    command: string;
-    /** Remaining argv. */
-    args: string[];
-}
-interface SseMcpSpec {
-    transport: "sse";
-    name: string | null;
-    /** Fully qualified SSE endpoint URL. */
-    url: string;
-}
-interface StreamableHttpMcpSpec {
-    transport: "streamable-http";
-    name: string | null;
-    /** Fully qualified Streamable HTTP endpoint URL (no `streamable+` prefix). */
-    url: string;
-}
-type McpSpec = StdioMcpSpec | SseMcpSpec | StreamableHttpMcpSpec;
-declare function parseMcpSpec(input: string): McpSpec;
-
 /** Unsupported list methods surface as `{supported:false}` instead of throwing — minimal servers still get a clean report. */
 
 interface InspectionReport {
@@ -2376,4 +2504,4 @@ declare function aggregateUsage(records: UsageRecord[], opts?: AggregateOptions)
 /** File-size helper for the stats header — "1.2 MB" etc. Returns "" if missing. */
 declare function formatLogSize(path?: string): string;
 
-export { AT_MENTION_PATTERN, AT_PICKER_PREFIX, type AggregateOptions, AppendOnlyLog, type AppendUsageInput, type ApplyResult, type ApplyStatus, type AtMentionExpansion, type AtMentionOptions, type BridgeOptions, type BridgeResult, CODE_SYSTEM_PROMPT, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, type ChoiceOption, ChoiceRequestedError, type ChoiceToolOptions, type CodeSystemPromptOptions, DEFAULT_AT_DIR_MAX_ENTRIES, DEFAULT_AT_MENTION_MAX_BYTES, DEFAULT_MAX_RESULT_CHARS, DEFAULT_MAX_RESULT_TOKENS, DEFAULT_PICKER_IGNORE_DIRS, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type DirEntry, type EditBlock, type EditSnapshot, type EventRole, type FileWithStats, type FilesystemToolsOptions, type FlattenDecision, type FlattenOptions, type GetLatestVersionOptions, type GetPromptResult, HOOK_EVENTS, HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME, type HookConfig, type HookEvent, type HookOutcome, type HookPayload, type HookReport, type HookScope, type HookSettings, type HookSpawnInput, type HookSpawnResult, type HookSpawner, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type InspectionReport, type InstallSource, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, LATEST_CACHE_TTL_MS, LATEST_FETCH_TIMEOUT_MS, type ListDirectoryOptions, type ListFilesOptions, type ListPromptsResult, type ListResourcesResult, type ListToolsResult, type LoadHookSettingsOptions, type LoopEvent, MCP_PROTOCOL_VERSION, MEMORY_INDEX_FILE, MEMORY_INDEX_MAX_CHARS, McpClient, type McpClientOptions, type McpContentBlock, type McpProgressHandler, type McpProgressInfo, type McpPrompt, type McpPromptArgument, type McpPromptMessage, type McpPromptResourceBlock, type McpResource, type McpResourceContents, type McpResourceContentsBlob, type McpResourceContentsText, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type MemoryEntry, type MemoryScope, MemoryStore, type MemoryStoreOptions, type MemoryToolsOptions, type MemoryType, type WriteInput as MemoryWriteInput, NeedsConfirmationError, PROJECT_MEMORY_FILE, PROJECT_MEMORY_FILES, PROJECT_MEMORY_MAX_CHARS, type PageContent, type ParsedAtQuery, type PickerCandidate, PlanProposedError, PlanRevisionProposedError, type PlanStep, type PlanStepRisk, type PlanToolOptions, type ProgressNotificationParams, type ProjectMemory, type RankPickerOptions, type ReadResourceResult, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type ResolvedHook, type RetryInfo, type RetryOptions, type Role, type RunCommandResult, type RunHooksOptions, type ScavengeOptions, type ScavengeResult, type SearchResult, type SectionResult, type SessionInfo, SessionStats, type SessionSummary, type ShellToolsOptions, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, type StepCompletion, StormBreaker, type StreamChunk, type StreamWalkOptions, type StreamableHttpMcpSpec, StreamableHttpTransport, type StreamableHttpTransportOptions, type SubagentEvent, type SubagentSink, type SubagentToolOptions, type TodoItem, type TodoStatus, type TodoToolOptions, type ToolCall, type ToolCallContext, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, USER_MEMORY_DIR, Usage, type UsageAggregate, type UsageBucket, type UsageRecord, VERSION, VolatileScratch, type WebFetchOptions, type WebSearchOptions, type WebToolsOptions, aggregateUsage, analyzeSchema, appendSessionMessage, appendUsage, applyEditBlock, applyEditBlocks, applyMemoryStack, applyProjectMemory, applyUserMemory, bridgeMcpTools, bucketCacheHitRatio, bucketSavingsFraction, claudeEquivalentCost, codeSystemPrompt, compareVersions, computeReplayStats, costUsd, decideOutcome, defaultConfigPath, defaultUsageLogPath, deleteSession, detectAtPicker, detectInstallSource, detectNpmInstallPrefix, detectShellOperator, diffTranscripts, expandAtMentions, fetchWithRetry, findProjectMemoryPath, fixToolCallPairing, flattenMcpResult, flattenSchema, forkRegistryExcluding, formatCommandResult, formatHookOutcomeMessage, formatLogSize, formatLoopError, formatSearchResults, getLatestVersion, globalSettingsPath, healLoadedMessages, healLoadedMessagesByTokens, htmlToText, injectPowerShellUtf8, inputCostUsd, inspectMcpServer, isAllowed, isJsonRpcError, isNpxInstall, isPlausibleKey, listDirectory, listFilesSync, listFilesWithStatsAsync, listFilesWithStatsSync, listSessions, loadApiKey, loadBaseUrl, loadDotenv, loadHooks, loadSessionMessages, matchesTool, memoryEnabled, nestArguments, openTranscriptFile, outputCostUsd, parseAtQuery, parseEditBlocks, parseMcpSpec, parseMojeekResults, parseSearxngHtmlResults, parseTranscript, prepareSpawn, projectHash, projectSettingsPath, quoteForCmdExe, rankPickerCandidates, readConfig, readProjectMemory, readTranscript, readUsageLog, recordFromLoopEvent, redactKey, registerChoiceTool, registerFilesystemTools, registerMemoryTools, registerPlanTool, registerShellTools, registerSubagentTool, registerTodoTool, registerWebTools, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, resolveExecutable, resolveProjectMemoryWritePath, restoreSnapshots, runCommand, runHooks, sanitizeMemoryName, sanitizeName as sanitizeSessionName, saveApiKey, saveBaseUrl, scavengeToolCalls, sessionPath, sessionsDir, similarity, snapshotBeforeEdits, stripHallucinatedToolMarkup, tokenizeCommand, truncateForModel, truncateForModelByTokens, walkFilesStream, webFetch, webSearch, withUtf8Codepage, writeConfig, writeMeta, writeRecord };
+export { AT_MENTION_PATTERN, AT_PICKER_PREFIX, type AggregateOptions, AppendOnlyLog, type AppendUsageInput, type ApplyResult, type ApplyStatus, type AtMentionExpansion, type AtMentionOptions, type BridgeOptions, type BridgeResult, CODE_SYSTEM_PROMPT, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, type ChoiceOption, ChoiceRequestedError, type ChoiceToolOptions, type CodeSystemPromptOptions, DEFAULT_AT_DIR_MAX_ENTRIES, DEFAULT_AT_MENTION_MAX_BYTES, DEFAULT_MAX_RESULT_CHARS, DEFAULT_MAX_RESULT_TOKENS, DEFAULT_PICKER_IGNORE_DIRS, DEFAULT_SPAWN_STORM_THRESHOLD, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type DirEntry, type EditBlock, type EditSnapshot, type EventRole, type FileWithStats, type FilesystemToolsOptions, type FlattenDecision, type FlattenOptions, type GetLatestVersionOptions, type GetPromptResult, HOOK_EVENTS, HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME, type HookConfig, type HookEvent, type HookOutcome, type HookPayload, type HookReport, type HookScope, type HookSettings, type HookSpawnInput, type HookSpawnResult, type HookSpawner, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type InspectionReport, type InstallSource, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, LATEST_CACHE_TTL_MS, LATEST_FETCH_TIMEOUT_MS, type ListDirectoryOptions, type ListFilesOptions, type ListPromptsResult, type ListResourcesResult, type ListToolsResult, type LoadHookSettingsOptions, type LoopEvent, MCP_PROTOCOL_VERSION, MEMORY_INDEX_FILE, MEMORY_INDEX_MAX_CHARS, McpClient, type McpClientOptions, type McpContentBlock, type McpProgressHandler, type McpProgressInfo, type McpPrompt, type McpPromptArgument, type McpPromptMessage, type McpPromptResourceBlock, type McpResource, type McpResourceContents, type McpResourceContentsBlob, type McpResourceContentsText, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type MemoryEntry, type MemoryScope, MemoryStore, type MemoryStoreOptions, type MemoryToolsOptions, type MemoryType, type WriteInput as MemoryWriteInput, NeedsConfirmationError, PROJECT_MEMORY_FILE, PROJECT_MEMORY_FILES, PROJECT_MEMORY_MAX_CHARS, type PageContent, type ParsedAtQuery, type PickerCandidate, PlanProposedError, PlanRevisionProposedError, type PlanStep, type PlanStepRisk, type PlanToolOptions, type ProgressNotificationParams, type ProjectMemory, type RankPickerOptions, type ReadResourceResult, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type ResolvedHook, type RetryInfo, type RetryOptions, type Role, type RunCommandResult, type RunHooksOptions, type ScavengeOptions, type ScavengeResult, type SearchResult, type SectionResult, type SessionInfo, SessionStats, type SessionSummary, type ShellToolsOptions, type SpawnDistillation, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, type StepCompletion, StormBreaker, type StreamChunk, type StreamWalkOptions, type StreamableHttpMcpSpec, StreamableHttpTransport, type StreamableHttpTransportOptions, type SubagentEvent, type SubagentResult, type SubagentResultLike, type SubagentSessionSummary, type SubagentSink, SubagentTelemetry, type SubagentToolOptions, type TodoItem, type TodoStatus, type TodoToolOptions, type ToolCall, type ToolCallContext, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, USER_MEMORY_DIR, Usage, type UsageAggregate, type UsageBucket, type UsageRecord, VERSION, VolatileScratch, type WebFetchOptions, type WebSearchOptions, type WebToolsOptions, aggregateUsage, analyzeSchema, appendSessionMessage, appendUsage, applyEditBlock, applyEditBlocks, applyMemoryStack, applyProjectMemory, applyUserMemory, bridgeMcpTools, bucketCacheHitRatio, bucketSavingsFraction, claudeEquivalentCost, codeSystemPrompt, compareVersions, computeReplayStats, computeSpawnDistillation, costUsd, countSpawnStorms, decideOutcome, defaultConfigPath, defaultUsageLogPath, deleteSession, detectAtPicker, detectInstallSource, detectNpmInstallPrefix, detectShellOperator, diffTranscripts, expandAtMentions, fetchWithRetry, findProjectMemoryPath, fixToolCallPairing, flattenMcpResult, flattenSchema, forkRegistryExcluding, formatCommandResult, formatHookOutcomeMessage, formatLogSize, formatLoopError, formatSearchResults, getLatestVersion, globalSettingsPath, healLoadedMessages, healLoadedMessagesByTokens, htmlToText, injectPowerShellUtf8, inputCostUsd, inspectMcpServer, isAllowed, isJsonRpcError, isNpxInstall, isPlausibleKey, listDirectory, listFilesSync, listFilesWithStatsAsync, listFilesWithStatsSync, listSessions, loadApiKey, loadBaseUrl, loadDotenv, loadHooks, loadMetasoApiKey, loadSessionMessages, matchesTool, memoryEnabled, nestArguments, openTranscriptFile, outputCostUsd, parseAtQuery, parseEditBlocks, parseMcpSpec, parseMojeekResults, parseSearxngHtmlResults, parseTranscript, prepareSpawn, projectHash, projectSettingsPath, quoteForCmdExe, rankPickerCandidates, readConfig, readProjectMemory, readTranscript, readUsageLog, recordFromLoopEvent, redactKey, registerChoiceTool, registerFilesystemTools, registerMemoryTools, registerPlanTool, registerShellTools, registerSubagentTool, registerTodoTool, registerWebTools, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, resolveExecutable, resolveProjectMemoryWritePath, restoreSnapshots, runCommand, runHooks, sanitizeMemoryName, sanitizeName as sanitizeSessionName, saveApiKey, saveBaseUrl, scavengeToolCalls, sessionPath, sessionsDir, similarity, snapshotBeforeEdits, stripHallucinatedToolMarkup, summarizeSubagentSession, tokenizeCommand, truncateForModel, truncateForModelByTokens, walkFilesStream, webFetch, webSearch, withUtf8Codepage, writeConfig, writeMeta, writeRecord };