@bastani/atomic 0.9.51-alpha.1 → 0.9.52-alpha.1

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [0.9.51] - 2026-10-29
+
+Windows sessions resume as printed, and stay open.
+
+- **Resume commands that work in cmd.exe:** the command Atomic prints on exit quotes paths for Windows shells, so pasting it into `cmd.exe` or PowerShell resumes the session instead of failing to open the session store ([#4095](https://github.com/bastani-inc/atomic/issues/4095))
+- **No exits from stray signals:** a Ctrl+C signal that another process sends to the console no longer clears the editor or ends an idle session; it can still interrupt work that is running ([#4096](https://github.com/bastani-inc/atomic/issues/4096))
+
+### Fixed
+
+- The resume command printed on exit quotes paths for the shell on Windows: none for a plain path, double quotes for one with spaces, never single quotes, which `cmd.exe` passed through as part of the path ([#4095](https://github.com/bastani-inc/atomic/issues/4095))
+- A SIGINT signal that didn't come from the keyboard, such as a console control event another process in the same Windows console raises, no longer clears the editor or counts toward the double-Ctrl+C exit while the terminal is in raw mode; it still interrupts a running response, bash command, compaction or retry ([#4096](https://github.com/bastani-inc/atomic/issues/4096))
+
 ## [0.9.51-alpha.1] - 2026-10-29
 
 Windows sessions resume as printed, and stay open.

package/dist/builtin/intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/intercom",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "private": true,
   "description": "Atomic extension providing a private coordination channel between parent and child agent sessions. Fork of: https://github.com/nicobailon/pi-intercom",
   "contributors": [

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "private": true,
   "description": "Atomic's pi-compatible MCP integration for server connections, OAuth, tools, resources, and terminal management.",
   "contributors": [

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with parallel execution. Fork of: https://github.com/nicobailon/pi-subagents",
   "contributors": [

package/dist/builtin/web-access/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.9.52-alpha.1] - 2026-10-29
+
+### Fixed
+
+- `web_search` no longer ends with `Search curation cancelled (stale).` when the search curator is enabled but cannot open (for example on a machine with no desktop browser), or when the session has no human to answer it, such as a subagent or workflow stage. It returns the raw results, with a note that points to `/curator off` when the curator failed to open. When no search provider is reachable, the error now names the `EXA_API_KEY`, `PERPLEXITY_API_KEY`, and `GEMINI_API_KEY` environment variables, the `exaApiKey`, `perplexityApiKey`, and `geminiApiKey` fields in `~/.atomic/web-search.json`, and `/curator` ([#4087](https://github.com/bastani-inc/atomic/issues/4087)).
+
 ## [0.9.40] - 2026-10-20
 
 ### Changed

package/dist/builtin/web-access/index.bundle.mjs

@@ -96673,6 +96673,14 @@ function normalizeSearchProvider(value) {
   const normalized = typeof value === "string" ? value.trim().toLowerCase() : "";
   return normalized === "auto" || normalized === "perplexity" || normalized === "gemini" || normalized === "exa" ? normalized : "auto";
 }
+function providerSetupHint() {
+  return `To configure a search provider, either:
+` + `  1. Set EXA_API_KEY, PERPLEXITY_API_KEY, or GEMINI_API_KEY in the environment
+` + `  2. Add exaApiKey, perplexityApiKey, or geminiApiKey to ~/${CONFIG_DIR_NAME4}/web-search.json
+` + "  3. Sign into gemini.google.com in a supported Chromium-based browser and allow browser cookies " + `(allowBrowserCookies: true in ~/${CONFIG_DIR_NAME4}/web-search.json)
+` + `Without a key, Exa's keyless fallback needs network access to mcp.exa.ai.
+` + "/curator only toggles the interactive review browser; it does not add a search provider. " + "Run /curator off if the curator keeps failing to open.";
+}
 function errorMessage3(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -96776,13 +96784,11 @@ async function search(query, options = {}) {
   if (fallbackErrors.length > 0) {
     throw new Error(`Auto provider search failed:
   - ${fallbackErrors.join(`
-  - `)}`);
+  - `)}
+${providerSetupHint()}`);
   }
-  throw new Error(`No search provider available. Either:
-` + `  1. Set perplexityApiKey in ~/${CONFIG_DIR_NAME4}/web-search.json
-` + `  2. Set EXA_API_KEY (or exaApiKey) in ~/${CONFIG_DIR_NAME4}/web-search.json
-` + `  3. Set GEMINI_API_KEY in ~/${CONFIG_DIR_NAME4}/web-search.json
-` + "  4. Sign into gemini.google.com in a supported Chromium-based browser");
+  throw new Error(`No search provider available.
+${providerSetupHint()}`);
 }
 async function searchWithGeminiApi(query, options = {}) {
   const apiKey = getApiKey2();
@@ -97739,8 +97745,11 @@ async function openCuratorBrowser(deps, pc, searchesComplete = true) {
     const message = err instanceof Error ? err.message : String(err);
     if (!reportOwnedWebDiagnostic())
       console.error(`Failed to open curator UI: ${message}`);
-    if (deps.state.pendingCurate === pc || handle && deps.state.activeCurator === handle) {
-      deps.closeCurator();
+    if (deps.state.pendingCurate === pc)
+      pc.curatorUnavailable(message);
+    if (handle && deps.state.activeCurator === handle) {
+      deps.state.activeCurator = null;
+      handle.close();
     }
   }
 }
@@ -98150,7 +98159,8 @@ function registerWebSearchTool(pi, deps) {
       const rawQueryList = Array.isArray(params.queries) ? params.queries : params.query !== undefined ? [params.query] : [];
       const queryList = normalizeQueryList(rawQueryList);
       const configWorkflow = loadConfigForExtensionInit().workflow;
-      const workflow = resolveWorkflow(configWorkflow, ctx?.hasUI !== false);
+      const canCurate = ctx?.hasUI !== false && ctx?.hasHumanInput !== false;
+      const workflow = resolveWorkflow(configWorkflow, canCurate);
       const shouldCurate = workflow !== "none";
       if (queryList.length === 0) {
         return {
@@ -98183,6 +98193,7 @@ function registerWebSearchTool(pi, deps) {
         const searchAbort = new AbortController;
         const searchSignal = signal ? AbortSignal.any([signal, searchAbort.signal]) : searchAbort.signal;
         let cancelled = false;
+        let curatorFailure;
         const bootstrap = await loadCuratorBootstrap(params.provider);
         const availableProviders = bootstrap.availableProviders;
         const defaultProvider = bootstrap.defaultProvider;
@@ -98216,7 +98227,8 @@ function registerWebSearchTool(pi, deps) {
               searchAbort.abort();
           },
           finish: () => {},
-          cancel: () => {}
+          cancel: () => {},
+          curatorUnavailable: () => {}
         };
         const onAbort = () => deps.closeCurator();
         const finish = (value) => {
@@ -98233,8 +98245,16 @@ function registerWebSearchTool(pi, deps) {
             return;
           finish(buildCurationCancelledReturn(reason));
         };
+        const curatorUnavailable = (reason) => {
+          if (cancelled)
+            return;
+          curatorFailure = reason;
+          if (deps.state.pendingCurate === pc)
+            deps.state.pendingCurate = null;
+        };
         pc.finish = finish;
         pc.cancel = cancel;
+        pc.curatorUnavailable = curatorUnavailable;
         deps.state.pendingCurate = pc;
         signal?.addEventListener("abort", onAbort, { once: true });
         pc.browserPromise = deps.openCuratorBrowser(pc, false);
@@ -98282,6 +98302,25 @@ function registerWebSearchTool(pi, deps) {
           return promise;
         }
         await pc.browserPromise;
+        if (curatorFailure !== undefined) {
+          const all = collectAllResultsAndUrls(searchResults);
+          const raw = await deps.buildSearchReturn({
+            queryList: all.results.map((r) => r.query),
+            results: all.results,
+            urls: all.urls,
+            includeContent,
+            inlineContent: allInlineContent.length > 0 ? allInlineContent : undefined
+          });
+          const note = `Note: the search curator could not open (${curatorFailure}), so these are raw results. ` + "Run /curator off to stop opening it.";
+          const [first, ...rest] = raw.content;
+          finish({
+            content: [{ type: "text", text: `${note}
+
+${first?.text ?? ""}`.trim() }, ...rest],
+            details: { ...raw.details, curatorUnavailable: curatorFailure }
+          });
+          return promise;
+        }
         if (deps.state.activeCurator) {
           deps.state.activeCurator.searchesDone();
           pc.onUpdate?.({

package/dist/builtin/web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/web-access",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "private": true,
   "description": "Atomic extension for web search, URL fetching, GitHub repo cloning, PDF/video extraction. Fork of: https://github.com/nicobailon/pi-web-access",
   "contributors": [

package/dist/builtin/workflows/CHANGELOG.md

@@ -6,6 +6,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.9.52-alpha.1] - 2026-10-29
+
+Stage chats show their own status lines, and web search keeps its results.
+
+- **A stage chat's own status lines:** an attached stage chat's footer shows the extension statuses its stage's session writes, such as a tokens-per-second counter, and no longer the main session's ([#4094](https://github.com/bastani-inc/atomic/issues/4094))
+- **Web search results that arrive:** `web_search` returns its results when the search curator can't open or nobody can answer it, instead of `Search curation cancelled (stale).`, and says which keys or settings to configure when no search provider works ([#4087](https://github.com/bastani-inc/atomic/issues/4087))
+
+### Fixed
+
+- An attached stage chat's footer now shows the extension status lines (such as a tokens-per-second counter) written by that stage's own session, and no longer shows the main session's. Status writes from a stage's extensions used to be dropped, while the chat footer displayed the main chat's statuses: a sleeping stage showed a live counter driven by the main agent, and a streaming stage showed a stale one. The main chat footer keeps showing only the main session's statuses ([#4094](https://github.com/bastani-inc/atomic/issues/4094))
+
 ## [0.9.46] - 2026-10-27
 
 ### Added

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [

package/dist/builtin/workflows/src/extension/index.bundle.mjs

@@ -5041,9 +5041,49 @@ class StageUiBroker {
   resolvedPromptIds = new Map;
   resolvedListeners = new Set;
   registeredListeners = new Set;
+  statuses = new Map;
+  statusListeners = new Set;
   constructor(store = currentWorkflowStore()) {
     this.store = store;
   }
+  setStageStatus(runId, stageId, statusKey, text) {
+    const stageKey = key(runId, stageId);
+    const current = this.statuses.get(stageKey);
+    if (text === undefined) {
+      if (!current?.delete(statusKey))
+        return;
+      if (current.size === 0)
+        this.statuses.delete(stageKey);
+    } else {
+      if (current?.get(statusKey) === text)
+        return;
+      if (current)
+        current.set(statusKey, text);
+      else
+        this.statuses.set(stageKey, new Map([[statusKey, text]]));
+    }
+    this.notifyStatusesChanged();
+  }
+  getStageStatuses(runId, stageId) {
+    return this.statuses.get(key(runId, stageId)) ?? EMPTY_STATUSES;
+  }
+  clearStageStatuses(runId, stageId) {
+    if (this.statuses.delete(key(runId, stageId)))
+      this.notifyStatusesChanged();
+  }
+  onStageStatusesChanged(listener) {
+    this.statusListeners.add(listener);
+    return () => {
+      this.statusListeners.delete(listener);
+    };
+  }
+  notifyStatusesChanged() {
+    for (const listener of this.statusListeners) {
+      try {
+        listener();
+      } catch {}
+    }
+  }
   provideStagePrompt(runId, stageId, adapter) {
     const hostKey = key(runId, stageId);
     this.adapters.set(hostKey, adapter);
@@ -5270,10 +5310,11 @@ function adoptStageUiBroker(scope, preserveCurrentWhenTargetExists = false, stor
 function currentStageUiBroker() {
   return singleton3.current();
 }
-var SESSION_KEY3 = "workflows:stage-ui:v1", singleton3, stageUiBroker;
+var EMPTY_STATUSES, SESSION_KEY3 = "workflows:stage-ui:v1", singleton3, stageUiBroker;
 var init_stage_ui_broker = __esm(() => {
   init_session_scoped_singleton();
   init_store_factory();
+  EMPTY_STATUSES = new Map;
   singleton3 = createSessionScopedSingleton(SESSION_KEY3, () => new StageUiBroker);
   stageUiBroker = singleton3.facade;
 });
@@ -12360,9 +12401,9 @@ function makeStageExtensionUiContext(ui, meta, broker, inheritedBindingRevision,
     onTerminalInput: ui.onTerminalInput ?? (() => () => {
       return;
     }),
-    setStatus: ui.setStatus ?? (() => {
+    setStatus: meta === undefined ? ui.setStatus ?? (() => {
       return;
-    }),
+    }) : (statusKey, text) => broker.setStageStatus(meta.runId, meta.stageId, statusKey, text),
     setWorkingMessage: ui.setWorkingMessage ?? (() => {
       return;
     }),
@@ -12497,6 +12538,8 @@ function buildRuntimeAdapters(builtWith, options = {}) {
         if (meta?.isFallbackAttempt && inheritedOptions.model && inheritedOptions.isFallbackModelAllowed?.(inheritedOptions.model, inheritedOptions.thinkingLevel) === false)
           throw new Error("Workflow stage fallback model unavailable under inherited policy.");
         const sessionOptions = withWorkflowStageSessionOptions(inheritedOptions, meta, pi);
+        if (meta !== undefined)
+          broker.clearStageStatuses(meta.runId, meta.stageId);
         const stageUi = shouldBindStageUiContext(pi, meta) ? makeStageExtensionUiContext(pi.ui ?? {}, meta, broker, inheritedOptions.extensionBindings?.humanInput === undefined ? 0 : 1, stageOptions.extensionBindings?.humanInput !== undefined) : undefined;
         if (stageUi)
           sessionOptions.extensionBindings = {
@@ -79686,6 +79729,7 @@ function createWorkflowStageFactory(input) {
         stageSnapshot.artifacts = artifacts;
       input.activeStore.recordStageEnd(input.runId, stageSnapshot);
       input.stageUiBroker.cancelStagePrompt(input.runId, stageId, new Error(`atomic-workflows: stage ${stageId} completed with pending custom UI`));
+      input.stageUiBroker.clearStageStatuses(input.runId, stageId);
       if (input.opts.onStageEnd) {
         await runCallback3({ kind: "workflow.stage_adapter", name: `onStageEnd:${name}`, runId: input.runId, stageId }, () => input.opts.onStageEnd(input.runId, stageSnapshot));
       }
@@ -90223,7 +90267,10 @@ function editorRuleColor(ctx, disabled, agentSession, state) {
 
 // dist/builtin/workflows/src/tui/stage-chat-view-state.ts
 init_stage_ui_broker();
-import { ChatSessionHost, classifyChatCommand } from "@bastani/atomic";
+import {
+  ChatSessionHost,
+  classifyChatCommand
+} from "@bastani/atomic";
 import { Editor } from "@earendil-works/pi-tui";
 
 // dist/builtin/workflows/src/tui/prompt-card-input.ts
@@ -91064,8 +91111,8 @@ function initializeStageChatView(ctx, opts) {
   ctx.piEditorFactory = opts.piEditorFactory;
   ctx.getToolsExpanded = opts.getToolsExpanded;
   ctx.setToolsExpanded = opts.setToolsExpanded;
-  ctx.footerData = opts.footerData;
   ctx.stageUiBroker = opts.stageUiBroker ?? stageUiBroker;
+  ctx.footerData = opts.footerData && stageFooterData(opts.footerData, ctx.stageUiBroker, opts.runId, opts.stageId);
   ctx.canSubmitPrompt = opts.canSubmitPrompt;
   ctx.mountedCustomUi = null;
   ctx.mountingRequestId = null;
@@ -91113,7 +91160,12 @@ function initializeStageChatView(ctx, opts) {
   if (initialChatIsTerminal)
     ctx.chatHost.clearBusyForTerminalWorkflowStage();
   ctx._unsubscribeStore = subscribeStoreInvalidation(ctx.store, () => handleStoreUpdate(ctx));
-  ctx._unsubscribeFooterData = ctx.footerData?.onBranchChange(() => ctx.requestRender?.()) ?? null;
+  const unsubscribeBranch = ctx.footerData?.onBranchChange(() => ctx.requestRender?.());
+  const unsubscribeStatuses = ctx.footerData ? ctx.stageUiBroker.onStageStatusesChanged(() => ctx.requestRender?.()) : undefined;
+  ctx._unsubscribeFooterData = () => {
+    unsubscribeBranch?.();
+    unsubscribeStatuses?.();
+  };
   if (ctx.handle) {
     ctx._unsubscribeDeliveryActivity = subscribeStageChatDeliveryActivity(ctx);
     ctx._unsubscribeHandle = ctx.handle.subscribe((event) => applyStageChatLiveHandleEvent(ctx, event));
@@ -91163,6 +91215,14 @@ function installFocusHold(ctx) {
       ctx.requestFocus?.();
   }, 150);
 }
+function stageFooterData(hostFooterData, broker, runId, stageId) {
+  return {
+    getGitBranch: (cwd) => hostFooterData.getGitBranch(cwd),
+    getAvailableProviderCount: () => hostFooterData.getAvailableProviderCount(),
+    onBranchChange: (callback, cwd) => hostFooterData.onBranchChange(callback, cwd),
+    getExtensionStatuses: () => broker.getStageStatuses(runId, stageId)
+  };
+}
 function createChatHost(ctx, opts) {
   return new ChatSessionHost({
     taskRowsInChat: false,
@@ -91266,7 +91326,7 @@ function createChatHost(ctx, opts) {
     editorFactory: opts.piEditorFactory,
     editorTheme: editorThemeFromGraphTheme(ctx.theme),
     getChatRenderSettings: () => stageChatRenderSettings(ctx, opts),
-    footerData: opts.footerData,
+    footerData: ctx.footerData,
     renderExtraEntry: (entry) => noticeRow(entry, ctx.theme)
   });
 }

package/dist/builtin/workflows/src/extension/local-worker-entry.mjs

@@ -9246,9 +9246,49 @@ class StageUiBroker {
   resolvedPromptIds = new Map;
   resolvedListeners = new Set;
   registeredListeners = new Set;
+  statuses = new Map;
+  statusListeners = new Set;
   constructor(store = currentWorkflowStore()) {
     this.store = store;
   }
+  setStageStatus(runId, stageId, statusKey, text) {
+    const stageKey = key(runId, stageId);
+    const current = this.statuses.get(stageKey);
+    if (text === undefined) {
+      if (!current?.delete(statusKey))
+        return;
+      if (current.size === 0)
+        this.statuses.delete(stageKey);
+    } else {
+      if (current?.get(statusKey) === text)
+        return;
+      if (current)
+        current.set(statusKey, text);
+      else
+        this.statuses.set(stageKey, new Map([[statusKey, text]]));
+    }
+    this.notifyStatusesChanged();
+  }
+  getStageStatuses(runId, stageId) {
+    return this.statuses.get(key(runId, stageId)) ?? EMPTY_STATUSES;
+  }
+  clearStageStatuses(runId, stageId) {
+    if (this.statuses.delete(key(runId, stageId)))
+      this.notifyStatusesChanged();
+  }
+  onStageStatusesChanged(listener) {
+    this.statusListeners.add(listener);
+    return () => {
+      this.statusListeners.delete(listener);
+    };
+  }
+  notifyStatusesChanged() {
+    for (const listener of this.statusListeners) {
+      try {
+        listener();
+      } catch {}
+    }
+  }
   provideStagePrompt(runId, stageId, adapter) {
     const hostKey = key(runId, stageId);
     this.adapters.set(hostKey, adapter);
@@ -9442,10 +9482,11 @@ class StageUiBroker {
 function currentStageUiBroker() {
   return singleton2.current();
 }
-var SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
+var EMPTY_STATUSES, SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
 var init_stage_ui_broker = __esm(() => {
   init_session_scoped_singleton();
   init_store_factory();
+  EMPTY_STATUSES = new Map;
   singleton2 = createSessionScopedSingleton(SESSION_KEY2, () => new StageUiBroker);
   stageUiBroker = singleton2.facade;
 });
@@ -9851,9 +9892,9 @@ function makeStageExtensionUiContext(ui, meta, broker, inheritedBindingRevision,
     onTerminalInput: ui.onTerminalInput ?? (() => () => {
       return;
     }),
-    setStatus: ui.setStatus ?? (() => {
+    setStatus: meta === undefined ? ui.setStatus ?? (() => {
       return;
-    }),
+    }) : (statusKey, text) => broker.setStageStatus(meta.runId, meta.stageId, statusKey, text),
     setWorkingMessage: ui.setWorkingMessage ?? (() => {
       return;
     }),
@@ -9988,6 +10029,8 @@ function buildRuntimeAdapters(builtWith, options = {}) {
         if (meta?.isFallbackAttempt && inheritedOptions.model && inheritedOptions.isFallbackModelAllowed?.(inheritedOptions.model, inheritedOptions.thinkingLevel) === false)
           throw new Error("Workflow stage fallback model unavailable under inherited policy.");
         const sessionOptions = withWorkflowStageSessionOptions(inheritedOptions, meta, pi);
+        if (meta !== undefined)
+          broker.clearStageStatuses(meta.runId, meta.stageId);
         const stageUi = shouldBindStageUiContext(pi, meta) ? makeStageExtensionUiContext(pi.ui ?? {}, meta, broker, inheritedOptions.extensionBindings?.humanInput === undefined ? 0 : 1, stageOptions.extensionBindings?.humanInput !== undefined) : undefined;
         if (stageUi)
           sessionOptions.extensionBindings = {
@@ -77524,6 +77567,7 @@ function createWorkflowStageFactory(input) {
         stageSnapshot.artifacts = artifacts;
       input.activeStore.recordStageEnd(input.runId, stageSnapshot);
       input.stageUiBroker.cancelStagePrompt(input.runId, stageId, new Error(`atomic-workflows: stage ${stageId} completed with pending custom UI`));
+      input.stageUiBroker.clearStageStatuses(input.runId, stageId);
       if (input.opts.onStageEnd) {
         await runCallback3({ kind: "workflow.stage_adapter", name: `onStageEnd:${name}`, runId: input.runId, stageId }, () => input.opts.onStageEnd(input.runId, stageSnapshot));
       }

package/dist/builtin/workflows/src/index.js

@@ -6556,9 +6556,49 @@ class StageUiBroker {
   resolvedPromptIds = new Map;
   resolvedListeners = new Set;
   registeredListeners = new Set;
+  statuses = new Map;
+  statusListeners = new Set;
   constructor(store = currentWorkflowStore()) {
     this.store = store;
   }
+  setStageStatus(runId, stageId, statusKey, text) {
+    const stageKey = key(runId, stageId);
+    const current = this.statuses.get(stageKey);
+    if (text === undefined) {
+      if (!current?.delete(statusKey))
+        return;
+      if (current.size === 0)
+        this.statuses.delete(stageKey);
+    } else {
+      if (current?.get(statusKey) === text)
+        return;
+      if (current)
+        current.set(statusKey, text);
+      else
+        this.statuses.set(stageKey, new Map([[statusKey, text]]));
+    }
+    this.notifyStatusesChanged();
+  }
+  getStageStatuses(runId, stageId) {
+    return this.statuses.get(key(runId, stageId)) ?? EMPTY_STATUSES;
+  }
+  clearStageStatuses(runId, stageId) {
+    if (this.statuses.delete(key(runId, stageId)))
+      this.notifyStatusesChanged();
+  }
+  onStageStatusesChanged(listener) {
+    this.statusListeners.add(listener);
+    return () => {
+      this.statusListeners.delete(listener);
+    };
+  }
+  notifyStatusesChanged() {
+    for (const listener of this.statusListeners) {
+      try {
+        listener();
+      } catch {}
+    }
+  }
   provideStagePrompt(runId, stageId, adapter) {
     const hostKey = key(runId, stageId);
     this.adapters.set(hostKey, adapter);
@@ -6752,10 +6792,11 @@ class StageUiBroker {
 function currentStageUiBroker() {
   return singleton2.current();
 }
-var SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
+var EMPTY_STATUSES, SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
 var init_stage_ui_broker = __esm(() => {
   init_session_scoped_singleton();
   init_store_factory();
+  EMPTY_STATUSES = new Map;
   singleton2 = createSessionScopedSingleton(SESSION_KEY2, () => new StageUiBroker);
   stageUiBroker = singleton2.facade;
 });
@@ -7161,9 +7202,9 @@ function makeStageExtensionUiContext(ui, meta, broker, inheritedBindingRevision,
     onTerminalInput: ui.onTerminalInput ?? (() => () => {
       return;
     }),
-    setStatus: ui.setStatus ?? (() => {
+    setStatus: meta === undefined ? ui.setStatus ?? (() => {
       return;
-    }),
+    }) : (statusKey, text) => broker.setStageStatus(meta.runId, meta.stageId, statusKey, text),
     setWorkingMessage: ui.setWorkingMessage ?? (() => {
       return;
     }),
@@ -7298,6 +7339,8 @@ function buildRuntimeAdapters(builtWith, options = {}) {
         if (meta?.isFallbackAttempt && inheritedOptions.model && inheritedOptions.isFallbackModelAllowed?.(inheritedOptions.model, inheritedOptions.thinkingLevel) === false)
           throw new Error("Workflow stage fallback model unavailable under inherited policy.");
         const sessionOptions = withWorkflowStageSessionOptions(inheritedOptions, meta, pi);
+        if (meta !== undefined)
+          broker.clearStageStatuses(meta.runId, meta.stageId);
         const stageUi = shouldBindStageUiContext(pi, meta) ? makeStageExtensionUiContext(pi.ui ?? {}, meta, broker, inheritedOptions.extensionBindings?.humanInput === undefined ? 0 : 1, stageOptions.extensionBindings?.humanInput !== undefined) : undefined;
         if (stageUi)
           sessionOptions.extensionBindings = {
@@ -77504,6 +77547,7 @@ function createWorkflowStageFactory(input) {
         stageSnapshot.artifacts = artifacts;
       input.activeStore.recordStageEnd(input.runId, stageSnapshot);
       input.stageUiBroker.cancelStagePrompt(input.runId, stageId, new Error(`atomic-workflows: stage ${stageId} completed with pending custom UI`));
+      input.stageUiBroker.clearStageStatuses(input.runId, stageId);
       if (input.opts.onStageEnd) {
         await runCallback3({ kind: "workflow.stage_adapter", name: `onStageEnd:${name}`, runId: input.runId, stageId }, () => input.opts.onStageEnd(input.runId, stageSnapshot));
       }

package/dist/builtin/workflows/src/local-worker-entry.mjs

@@ -9246,9 +9246,49 @@ class StageUiBroker {
   resolvedPromptIds = new Map;
   resolvedListeners = new Set;
   registeredListeners = new Set;
+  statuses = new Map;
+  statusListeners = new Set;
   constructor(store = currentWorkflowStore()) {
     this.store = store;
   }
+  setStageStatus(runId, stageId, statusKey, text) {
+    const stageKey = key(runId, stageId);
+    const current = this.statuses.get(stageKey);
+    if (text === undefined) {
+      if (!current?.delete(statusKey))
+        return;
+      if (current.size === 0)
+        this.statuses.delete(stageKey);
+    } else {
+      if (current?.get(statusKey) === text)
+        return;
+      if (current)
+        current.set(statusKey, text);
+      else
+        this.statuses.set(stageKey, new Map([[statusKey, text]]));
+    }
+    this.notifyStatusesChanged();
+  }
+  getStageStatuses(runId, stageId) {
+    return this.statuses.get(key(runId, stageId)) ?? EMPTY_STATUSES;
+  }
+  clearStageStatuses(runId, stageId) {
+    if (this.statuses.delete(key(runId, stageId)))
+      this.notifyStatusesChanged();
+  }
+  onStageStatusesChanged(listener) {
+    this.statusListeners.add(listener);
+    return () => {
+      this.statusListeners.delete(listener);
+    };
+  }
+  notifyStatusesChanged() {
+    for (const listener of this.statusListeners) {
+      try {
+        listener();
+      } catch {}
+    }
+  }
   provideStagePrompt(runId, stageId, adapter) {
     const hostKey = key(runId, stageId);
     this.adapters.set(hostKey, adapter);
@@ -9442,10 +9482,11 @@ class StageUiBroker {
 function currentStageUiBroker() {
   return singleton2.current();
 }
-var SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
+var EMPTY_STATUSES, SESSION_KEY2 = "workflows:stage-ui:v1", singleton2, stageUiBroker;
 var init_stage_ui_broker = __esm(() => {
   init_session_scoped_singleton();
   init_store_factory();
+  EMPTY_STATUSES = new Map;
   singleton2 = createSessionScopedSingleton(SESSION_KEY2, () => new StageUiBroker);
   stageUiBroker = singleton2.facade;
 });
@@ -9851,9 +9892,9 @@ function makeStageExtensionUiContext(ui, meta, broker, inheritedBindingRevision,
     onTerminalInput: ui.onTerminalInput ?? (() => () => {
       return;
     }),
-    setStatus: ui.setStatus ?? (() => {
+    setStatus: meta === undefined ? ui.setStatus ?? (() => {
       return;
-    }),
+    }) : (statusKey, text) => broker.setStageStatus(meta.runId, meta.stageId, statusKey, text),
     setWorkingMessage: ui.setWorkingMessage ?? (() => {
       return;
     }),
@@ -9988,6 +10029,8 @@ function buildRuntimeAdapters(builtWith, options = {}) {
         if (meta?.isFallbackAttempt && inheritedOptions.model && inheritedOptions.isFallbackModelAllowed?.(inheritedOptions.model, inheritedOptions.thinkingLevel) === false)
           throw new Error("Workflow stage fallback model unavailable under inherited policy.");
         const sessionOptions = withWorkflowStageSessionOptions(inheritedOptions, meta, pi);
+        if (meta !== undefined)
+          broker.clearStageStatuses(meta.runId, meta.stageId);
         const stageUi = shouldBindStageUiContext(pi, meta) ? makeStageExtensionUiContext(pi.ui ?? {}, meta, broker, inheritedOptions.extensionBindings?.humanInput === undefined ? 0 : 1, stageOptions.extensionBindings?.humanInput !== undefined) : undefined;
         if (stageUi)
           sessionOptions.extensionBindings = {
@@ -77524,6 +77567,7 @@ function createWorkflowStageFactory(input) {
         stageSnapshot.artifacts = artifacts;
       input.activeStore.recordStageEnd(input.runId, stageSnapshot);
       input.stageUiBroker.cancelStagePrompt(input.runId, stageId, new Error(`atomic-workflows: stage ${stageId} completed with pending custom UI`));
+      input.stageUiBroker.clearStageStatuses(input.runId, stageId);
       if (input.opts.onStageEnd) {
         await runCallback3({ kind: "workflow.stage_adapter", name: `onStageEnd:${name}`, runId: input.runId, stageId }, () => input.opts.onStageEnd(input.runId, stageSnapshot));
       }

package/docs/web-access.md

@@ -1,8 +1,46 @@
-# Fetching web content
+# Web access
+
+Atomic bundles `web_search` for searching the web and `fetch_content` for reading pages. `web_search` works with no setup; the sections below cover how it picks a provider and how to configure one.
+
+## Searching with `web_search`
+
+Pass `query`, or `queries` for several angles at once. `provider` can be `auto` (the default), `exa`, `perplexity`, or `gemini`.
+
+With `auto`, Atomic uses the first provider that works:
+
+1. **Exa**: with a key it calls the Exa API; without one it uses Exa's free keyless MCP endpoint (`mcp.exa.ai`), so an unconfigured machine with network access still gets results.
+2. **Perplexity**, with a key.
+3. **Gemini API**, with a key.
+4. **Gemini Web**, using your signed-in Chromium-based browser. Browser cookie access is off by default; enable it with `allowBrowserCookies: true` or `ATOMIC_ALLOW_BROWSER_COOKIES=1`.
+
+Keys come from the environment or from `~/.atomic/web-search.json`:
+
+| Provider | Environment variable | `web-search.json` field |
+| --- | --- | --- |
+| Exa | `EXA_API_KEY` | `exaApiKey` |
+| Perplexity | `PERPLEXITY_API_KEY` | `perplexityApiKey` |
+| Gemini API | `GEMINI_API_KEY` | `geminiApiKey` |
+
+```json
+{
+  "exaApiKey": "your-key",
+  "provider": "auto"
+}
+```
+
+`provider` sets the default provider. When no provider can be reached, the error names these settings.
+
+### The search curator
+
+By default `web_search` returns raw results. `/curator on` (or `"workflow": "summary-review"` in `web-search.json`) opens a browser page where you review the results and approve a summary before the agent sees them; `/curator off` turns it back off. The curator changes how results are reviewed, not which provider is used.
+
+It needs an interactive session with a person at a browser. Subagents, workflow stages, and non-interactive runs skip it and return raw results. If the page cannot open, for example on a machine with no desktop browser, `web_search` returns raw results with a note instead of failing; run `/curator off` to stop trying.
+
+## Fetching with `fetch_content`
 
 Atomic's bundled `fetch_content` tool reads webpages, PDFs, GitHub repositories, YouTube videos, and local video files.
 
-## Arguments
+### Arguments
 
 Always pass the lowercase `urls` field as a nonempty array of strings, even for one URL:
 
@@ -38,7 +76,7 @@ Existing prompts or integrations using `{"url": "..."}` must change to `{"urls":
 
 Atomic can normalize a scalar `urls` string into a one-item array. Always use the documented array form in prompts and integrations; the legacy `url` field is not normalized.
 
-## Troubleshooting
+### Troubleshooting
 
 If argument validation fails, check that:
 

package/docs/workflows/operations.md

@@ -211,7 +211,7 @@ Surface behavior:
 - **Wheel and trackpad** - While the workflow graph is active, vertical wheel/trackpad gestures pan it up and down, and horizontal gestures pan wide graphs left and right when the terminal exposes horizontal wheel events. Focused graph and stage-chat overlays receive those gestures through the fullscreen application route, so scrolling stays inside the active workflow surface instead of falling through to terminal or main-chat scrollback.
 - **Selection and copying** - Graph panning, stage scrolling, click-to-attach, and drag or multi-click selection work without a separate selection mode. Copy uses OSC 52; if the terminal blocks it, use its Shift/Option modifier-drag bypass. `ctrl+t` retains the host thinking toggle, not a workflow action.
 - **Tool and node detail** - Attached stage chats match main chat's tool-detail expansion behavior while keeping expansion state local to the workflow UI context. Press Ctrl+O (the configurable `app.tools.expand` binding) to expand every visible workflow node and tool card, including single, parallel, and nested subagent progress, current tool activity, and artifact paths; press it again to collapse them. The toggle works for active, completed, and archived stage views, including at the supported 40-column terminal minimum. A mounted prompt, custom question, or other input-owning overlay keeps the key instead of changing it.
-- **Footer context** - An attached live stage chat shows its own current folder and Git branch and mirrors live extension status lines such as the MCP server indicator. Branch changes trigger a repaint through the host's cached footer provider. The compact `/tasks` picker retains this context and the stage's model and reasoning level even while its foreground turn streams; detail, transcript, input, and confirmation pages remain fullscreen.
+- **Footer context** - An attached live stage chat shows its own current folder and Git branch and shows the live extension status lines that the stage's own session sets, such as the MCP server indicator, never the main chat's. Branch changes trigger a repaint through the host's cached footer provider. The compact `/tasks` picker retains this context and the stage's model and reasoning level even while its foreground turn streams; detail, transcript, input, and confirmation pages remain fullscreen.
 - **Working indicator** - Stage chat shows `∀` during accepted prompt startup and active work, including retained-session follow-ups. Retry, fallback, compaction, cancellation, and errors take precedence. `NO_COLOR` removes foreground colors; `ATOMIC_REDUCED_MOTION=1` makes the indicator static.
 - **Subagent statusline** - If a subagent is running while the fullscreen workflow graph is open, the graph statusline mirrors its summary so the run remains visible; hide the graph with `h`, leave it with `ctrl+x`, or reconnect later to return to the full below-editor widget.
 - **Run control** - Use `pause` and `resume` for resumable live work. Pause holds a stage's queued steering and follow-up items in place without dequeuing them or starting continuation; `resume` releases those items once in their existing per-queue order, but queue release alone does not start a model turn. `resume` on a non-paused run reopens the saved snapshot or overlay. Use `quit` to pause a live run gracefully while preserving it for `/workflow resume`. `/workflow pause` selects the active run by default, accepts a full run id or `--all`, and does not open a stage picker. `/workflow pause <run-id> <stage>` pauses only that stage, named by id, name or unique prefix as `/workflow attach` resolves it, and `/workflow resume <run-id> <stage>` resumes it. The workflow tool's `stageId` does the same and also targets tool nodes.

package/npm-shrinkwrap.json

@@ -1,16 +1,16 @@
 {
 	"name": "@bastani/atomic",
-	"version": "0.9.51-alpha.1",
+	"version": "0.9.52-alpha.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@bastani/atomic",
-			"version": "0.9.51-alpha.1",
+			"version": "0.9.52-alpha.1",
 			"license": "MIT",
 			"dependencies": {
-				"@bastani/atomic-natives": "0.9.51-alpha.1",
-				"@bastani/pi-ai": "0.9.51-alpha.1",
+				"@bastani/atomic-natives": "0.9.52-alpha.1",
+				"@bastani/pi-ai": "0.9.52-alpha.1",
 				"@earendil-works/pi-agent-core": "1.4.0",
 				"@earendil-works/pi-codemode": "1.4.0",
 				"@earendil-works/pi-tui": "1.4.0",
@@ -427,18 +427,18 @@
 			}
 		},
 		"node_modules/@bastani/atomic-natives": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives/-/atomic-natives-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives/-/atomic-natives-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"optionalDependencies": {
-				"@bastani/atomic-natives-darwin-arm64": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-darwin-x64": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-linux-arm64-gnu": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-linux-arm64-musl": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-linux-x64-gnu": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-linux-x64-musl": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-win32-arm64-msvc": "0.9.51-alpha.1",
-				"@bastani/atomic-natives-win32-x64-msvc": "0.9.51-alpha.1"
+				"@bastani/atomic-natives-darwin-arm64": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-darwin-x64": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-linux-arm64-gnu": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-linux-arm64-musl": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-linux-x64-gnu": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-linux-x64-musl": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-win32-arm64-msvc": "0.9.52-alpha.1",
+				"@bastani/atomic-natives-win32-x64-msvc": "0.9.52-alpha.1"
 			},
 			"engines": {
 				"bun": ">=1.4.2",
@@ -446,8 +446,8 @@
 			}
 		},
 		"node_modules/@bastani/atomic-natives-darwin-arm64": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-arm64/-/atomic-natives-darwin-arm64-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-arm64/-/atomic-natives-darwin-arm64-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"darwin"
@@ -458,8 +458,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-darwin-x64": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-x64/-/atomic-natives-darwin-x64-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-x64/-/atomic-natives-darwin-x64-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"darwin"
@@ -470,8 +470,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-arm64-gnu": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-gnu/-/atomic-natives-linux-arm64-gnu-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-gnu/-/atomic-natives-linux-arm64-gnu-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -485,8 +485,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-arm64-musl": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-musl/-/atomic-natives-linux-arm64-musl-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-musl/-/atomic-natives-linux-arm64-musl-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -500,8 +500,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-x64-gnu": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-gnu/-/atomic-natives-linux-x64-gnu-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-gnu/-/atomic-natives-linux-x64-gnu-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -515,8 +515,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-x64-musl": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-musl/-/atomic-natives-linux-x64-musl-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-musl/-/atomic-natives-linux-x64-musl-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -530,8 +530,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-win32-arm64-msvc": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-arm64-msvc/-/atomic-natives-win32-arm64-msvc-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-arm64-msvc/-/atomic-natives-win32-arm64-msvc-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"win32"
@@ -542,8 +542,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-win32-x64-msvc": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-x64-msvc/-/atomic-natives-win32-x64-msvc-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-x64-msvc/-/atomic-natives-win32-x64-msvc-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"win32"
@@ -554,8 +554,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/pi-ai": {
-			"version": "0.9.51-alpha.1",
-			"resolved": "https://registry.npmjs.org/@bastani/pi-ai/-/pi-ai-0.9.51-alpha.1.tgz",
+			"version": "0.9.52-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/pi-ai/-/pi-ai-0.9.52-alpha.1.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.129.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.9.51-alpha.1",
+  "version": "0.9.52-alpha.1",
   "description": "Atomic coding agent CLI with read, bash, edit, write tools and session management",
   "type": "module",
   "atomicConfig": {
@@ -89,8 +89,8 @@
     "prepublishOnly": "bun run clean && bun run build && bun run shrinkwrap"
   },
   "dependencies": {
-    "@bastani/atomic-natives": "0.9.51-alpha.1",
-    "@bastani/pi-ai": "0.9.51-alpha.1",
+    "@bastani/atomic-natives": "0.9.52-alpha.1",
+    "@bastani/pi-ai": "0.9.52-alpha.1",
     "@earendil-works/pi-agent-core": "1.4.0",
     "@earendil-works/pi-codemode": "1.4.0",
     "@earendil-works/pi-tui": "1.4.0",