@wrongstack/tui 0.236.0 → 0.255.0

package/dist/index.d.ts

@@ -338,8 +338,8 @@ interface RunTuiOptions {
      * visible bar without a round-trip. The initial value is loaded from
      * the config file before App mounts.
      */
-    statuslineHiddenItems: Array<'todos' | 'plan' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>;
-    setStatuslineHiddenItems: (items: Array<'todos' | 'plan' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>) => void;
+    statuslineHiddenItems: Array<'todos' | 'plan' | 'tasks' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>;
+    setStatuslineHiddenItems: (items: Array<'todos' | 'plan' | 'tasks' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>) => void;
     /**
      * Controller for the agents monitor overlay. App installs a dispatch-backed
      * setter on mount so the `/agents on|off` slash command can toggle the
@@ -417,6 +417,12 @@ interface RunTuiOptions {
      * Used by the TUI to display and auto-submit next steps in 'auto' mode.
      */
     getSuggestions?: (() => string[]) | undefined;
+    /**
+     * Write parsed next steps into the shared suggestion store.
+     * Called by the Entry component after parsing each assistant message
+     * so /next 1 and the auto-submit countdown can access them.
+     */
+    setSuggestions?: ((steps: string[]) => void) | undefined;
     /**
      * Messages restored from a previous session. When provided (non-empty),
      * the TUI renders the prior conversation as history entries so a resumed
@@ -531,4 +537,46 @@ declare function parseInline(text: string): InlineToken[];
  */
 declare function replaySessionEvents(events: SessionEvent[], startId: number): HistoryEntry[];
 
-export { type RunTuiOptions, type Settings, parseInline, replaySessionEvents, runTui };
+/**
+ * Unified next-steps suggestion parser.
+ *
+ * Three code paths feed into the suggestion store:
+ *   1. TUI rendering  — entry.tsx parses "💡 Next steps" from assistant output
+ *   2. REPL store     — repl.ts parses "💡 Next steps" from final agent output
+ *   3. /suggest output — suggest.ts parses LLM-generated numbered lists
+ *
+ * Heading mode (`requireHeading = true`):
+ *   strict=true  — only 💡 emoji heading (TUI rendering)
+ *   strict=false — 💡, ##, plain "Next steps" headings (REPL store)
+ *
+ * Raw mode (`requireHeading = false`):
+ *   Parses numbered/bullet items from anywhere in text (subagent /suggest output).
+ */
+interface ParsedNextStep {
+    index: number;
+    text: string;
+}
+interface ParseNextStepsResult {
+    /** Matched steps with their original index and stripped text. */
+    steps: ParsedNextStep[];
+    /** Flat string array — what gets stored in the suggestion store. */
+    texts: string[];
+    /**
+     * Content with the entire "💡 Next steps" block removed.
+     * Used by entry.tsx to strip suggestions from the rendered message body.
+     */
+    stripped: string;
+}
+/**
+ * Parse "💡 Next steps" blocks from assistant output (or raw numbered lines).
+ *
+ * @param content        — raw assistant message text or subagent output
+ * @param strict        — when true, only the 💡 emoji heading is accepted (TUI rendering).
+ *                        when false, also accepts ## / plain "Next steps" headings (REPL store).
+ * @param requireHeading — when true, a heading must precede the item list.
+ *                        when false, numbered/bullet items are parsed from anywhere in text
+ *                        (used by /suggest subagent output which has no heading).
+ */
+declare function parseNextSteps(content: string, strict?: boolean, requireHeading?: boolean): ParseNextStepsResult;
+
+export { type ParseNextStepsResult, type ParsedNextStep, type RunTuiOptions, type Settings, parseInline, parseNextSteps, replaySessionEvents, runTui };

package/dist/index.js

@@ -1,6 +1,7 @@
-import { writeErr, resolveWstackPaths, loadGoal, InputBuilder, DefaultSessionRewinder, writeOut, formatTodosList, buildGoalPreamble, expectDefined as expectDefined$1, wstackGlobalRoot, shouldEnhance, enhanceUserPrompt, recentTextTurns, normalizedEqual, buildChildEnv } from '@wrongstack/core';
+import { writeErr, resolveProjectDir, wstackGlobalRoot, GlobalMailbox, resolveWstackPaths, loadGoal, InputBuilder, DefaultSessionRewinder, writeOut, formatTodosList, buildGoalPreamble, expectDefined as expectDefined$1, shouldEnhance, enhanceUserPrompt, recentTextTurns, normalizedEqual, buildChildEnv } from '@wrongstack/core';
 export { buildGoalPreamble } from '@wrongstack/core';
 import { Box as Box$1, useInput, useStdin, useStdout, Text as Text$1, render, useApp, measureElement, Static } from 'ink';
+import { randomUUID } from 'crypto';
 import * as path4 from 'path';
 import React5, { forwardRef, useState, useEffect, useMemo, memo, useRef, useCallback, useReducer, useLayoutEffect } from 'react';
 import * as fs2 from 'fs/promises';
@@ -86,6 +87,27 @@ var Box = forwardRef(function Box2({ borderColor, backgroundColor, ...rest }, re
     }
   );
 });
+function useTokenCounterRefresh(tokenCounter, events) {
+  const [data, setData] = useState(
+    () => tokenCounter ? {
+      usage: tokenCounter.total(),
+      cost: tokenCounter.estimateCost(),
+      cacheStats: tokenCounter.cacheStats()
+    } : void 0
+  );
+  useEffect(() => {
+    if (!tokenCounter || !events) return;
+    const off = events.on("token.accounted", () => {
+      setData({
+        usage: tokenCounter.total(),
+        cost: tokenCounter.estimateCost(),
+        cacheStats: tokenCounter.cacheStats()
+      });
+    });
+    return off;
+  }, [tokenCounter, events]);
+  return data;
+}
 var MODE_ICONS = {
   teach: "\u{1F9D1}\u200D\u{1F3EB}",
   brief: "\u26A1",
@@ -131,6 +153,7 @@ function StatusBar({
   processCount,
   context,
   hiddenItems,
+  events,
   eternalStage,
   goalSummary,
   indexState,
@@ -155,9 +178,10 @@ function StatusBar({
   const isCompact = termWidth < COMPACT_THRESHOLD;
   const isComfortable = termWidth >= COMFORTABLE_THRESHOLD;
   const hiddenSet = new Set(hiddenItems);
-  const usage = tokenCounter?.total();
-  const cost = tokenCounter?.estimateCost();
-  const cache2 = tokenCounter?.cacheStats();
+  const tokenData = useTokenCounterRefresh(tokenCounter, events);
+  const usage = tokenData?.usage;
+  const cost = tokenData?.cost;
+  const cache2 = tokenData?.cacheStats;
   const [elapsedMs, setElapsedMs] = useState(startedAt ? Date.now() - startedAt : 0);
   useEffect(() => {
     if (startedAt == null) return;
@@ -295,6 +319,9 @@ function StatusBar({
                 "/",
                 indexState.totalFiles
               ] })
+            ] }) : indexState?.circuit?.state === "open" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }),
+              /* @__PURE__ */ jsx(Text, { color: "red", children: "\u2699 index paused (/reindex)" })
             ] }) : null
           ] })
         ) }),
@@ -552,7 +579,22 @@ function StatusBar({
           /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
             "\u{1F465} ",
             mailbox.onlineAgents,
-            " online"
+            " agent",
+            mailbox.onlineAgents === 1 ? "" : "s",
+            mailbox.onlineClients.tui + mailbox.onlineClients.webui + mailbox.onlineClients.repl > 0 ? /* @__PURE__ */ jsxs(Text, { color: "green", children: [
+              mailbox.onlineClients.tui > 0 ? /* @__PURE__ */ jsxs(Text, { color: "green", children: [
+                " \xB7 \u{1F5A5} TUI",
+                mailbox.onlineClients.tui > 1 ? `\xD7${mailbox.onlineClients.tui}` : ""
+              ] }) : null,
+              mailbox.onlineClients.webui > 0 ? /* @__PURE__ */ jsxs(Text, { color: "green", children: [
+                " \xB7 \u{1F310} WebUI",
+                mailbox.onlineClients.webui > 1 ? `\xD7${mailbox.onlineClients.webui}` : ""
+              ] }) : null,
+              mailbox.onlineClients.repl > 0 ? /* @__PURE__ */ jsxs(Text, { color: "green", children: [
+                " \xB7 \u2328 REPL",
+                mailbox.onlineClients.repl > 1 ? `\xD7${mailbox.onlineClients.repl}` : ""
+              ] }) : null
+            ] }) : null
           ] }),
           mailbox.lastSubject ? /* @__PURE__ */ jsxs(Fragment, { children: [
             /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }),
@@ -3756,19 +3798,107 @@ function Banner({
     ] })
   ] });
 }
-var NEXT_STEPS_RE = /💡\s*Next steps?\s*\n+((?:\d+\.\s+.+\n?)+)/i;
-function parseNextSteps(content) {
-  const match = NEXT_STEPS_RE.exec(content);
-  if (!match?.[1]) return { steps: [], stripped: content };
-  const block = match[1];
+
+// src/components/suggestions.ts
+var STRICT_HEADING_RE = /💡\s*Next steps?\s*\n+/i;
+var PERMISSIVE_HEADING_PATTERNS = [
+  { re: /💡\s*Next steps?\s*\n+/i, label: "emoji" },
+  { re: /##?\s*Next steps?\s*\n+/i, label: "markdown" },
+  { re: /\n{1,2}Next steps?\s*\n+/i, label: "plain" }
+];
+var ITEM_RE = /^(?:(\d+)[.)]\s*|[-*•]\s*)(.+)$/;
+var MAX_STEPS = 6;
+function parseNextSteps(content, strict = false, requireHeading = true) {
+  if (requireHeading) {
+    return parseWithHeading(content, strict);
+  }
+  return parseRawNumbered(content);
+}
+function parseRawNumbered(content) {
+  const lines = content.split("\n");
   const steps = [];
-  const lines = block.split("\n").filter(Boolean);
-  for (const line of lines) {
-    const m = /^(\d+)\.\s+(.+)$/.exec(line.trim());
-    if (m) steps.push({ index: Number.parseInt(m[1], 10), text: m[2].trim() });
+  const seenNumbers = /* @__PURE__ */ new Set();
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line) continue;
+    const m = ITEM_RE.exec(line);
+    if (!m) continue;
+    const numPart = m[1];
+    let text = m[2].trim();
+    let index;
+    if (numPart !== void 0) {
+      index = Number.parseInt(numPart, 10);
+    } else {
+      index = steps.length + 1;
+    }
+    if (seenNumbers.has(index)) continue;
+    if (text.length < 3) continue;
+    seenNumbers.add(index);
+    steps.push({ index, text });
+    if (steps.length >= MAX_STEPS) break;
+  }
+  return { steps, texts: steps.map((s2) => s2.text), stripped: content };
+}
+function parseWithHeading(content, strict) {
+  const headingRe = strict ? STRICT_HEADING_RE : buildPermissiveHeadingRe();
+  const headingMatch = headingRe.exec(content);
+  if (!headingMatch) {
+    return { steps: [], texts: [], stripped: content };
+  }
+  const headingEnd = headingMatch.index + headingMatch[0].length;
+  const afterHeading = content.slice(headingEnd);
+  const lines = afterHeading.split("\n");
+  const steps = [];
+  const seenNumbers = /* @__PURE__ */ new Set();
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line) continue;
+    const m = ITEM_RE.exec(line);
+    if (!m) break;
+    const numPart = m[1];
+    let text = m[2].trim();
+    let index;
+    if (numPart !== void 0) {
+      index = Number.parseInt(numPart, 10);
+    } else {
+      index = steps.length + 1;
+    }
+    if (seenNumbers.has(index)) continue;
+    if (text.length < 3) continue;
+    seenNumbers.add(index);
+    steps.push({ index, text });
+    if (steps.length >= MAX_STEPS) break;
+  }
+  if (steps.length === 0) {
+    return { steps: [], texts: [], stripped: content };
+  }
+  const texts = steps.map((s2) => s2.text);
+  const blockStart = headingMatch.index;
+  const blockEnd = headingEnd + findBlockEnd(afterHeading, steps.length);
+  const stripped = (content.slice(0, blockStart) + content.slice(blockStart + blockEnd)).replace(/\n{3,}/g, "\n\n").trim();
+  return { steps, texts, stripped };
+}
+function buildPermissiveHeadingRe() {
+  const variants = PERMISSIVE_HEADING_PATTERNS.map(({ re }) => `(?:${re.source})`).join("|");
+  return new RegExp(variants, "i");
+}
+function findBlockEnd(afterHeading, stepCount) {
+  const lines = afterHeading.split("\n");
+  let consumed = 0;
+  let found = 0;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line) {
+      consumed += rawLine.length + 1;
+      continue;
+    }
+    const m = ITEM_RE.exec(line);
+    if (!m) break;
+    consumed += rawLine.length + 1;
+    found++;
+    if (found >= stepCount) break;
   }
-  const stripped = content.replace(NEXT_STEPS_RE, "").replace(/\n{3,}/g, "\n\n").trim();
-  return { steps: steps.slice(0, 6), stripped };
+  return consumed;
 }
 function brainStatusStyle(status) {
   switch (status) {
@@ -3798,12 +3928,19 @@ function brainRiskColor(risk) {
 }
 var Entry = React5.memo(function Entry2({
   entry,
-  termWidth
+  termWidth,
+  setSuggestions
 }) {
   const nextSteps = useMemo(() => {
     if (entry.kind !== "assistant") return { steps: [], stripped: "" };
-    return parseNextSteps(entry.text);
+    return parseNextSteps(entry.text, true);
   }, [entry.kind, entry.text]);
+  useEffect(() => {
+    if (!setSuggestions) return;
+    const text = entry.text ?? "";
+    const { texts } = parseNextSteps(text, true);
+    if (texts.length > 0) setSuggestions(texts);
+  }, [entry.kind, entry.text, setSuggestions]);
   switch (entry.kind) {
     case "user":
       return /* @__PURE__ */ jsx(
@@ -4044,7 +4181,7 @@ var Entry = React5.memo(function Entry2({
     }
   }
 });
-function History({ entries, generation, streamingText, toolStream }) {
+function History({ entries, generation, streamingText, toolStream, setSuggestions }) {
   const { stdout } = useStdout();
   const [termSize, setTermSize] = useState({
     columns: stdout?.columns ?? 80,
@@ -4062,7 +4199,7 @@ function History({ entries, generation, streamingText, toolStream }) {
   const termWidth = termSize.columns;
   const tail = streamingText ? tailForDisplay(streamingText, MAX_STREAM_DISPLAY_CHARS) : "";
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(Static, { items: entries, children: (entry) => /* @__PURE__ */ jsx(Box, { marginBottom: entry.kind === "turn-summary" ? 1 : 0, children: /* @__PURE__ */ jsx(Entry, { entry, termWidth }) }, entry.id) }, generation ?? 0),
+    /* @__PURE__ */ jsx(Static, { items: entries, children: (entry) => /* @__PURE__ */ jsx(Box, { marginBottom: entry.kind === "turn-summary" ? 1 : 0, children: /* @__PURE__ */ jsx(Entry, { entry, termWidth, setSuggestions }) }, entry.id) }, generation ?? 0),
     /* @__PURE__ */ jsx(Box, { flexGrow: 1, children: tail ? /* @__PURE__ */ jsx(AssistantTail, { text: tail, termWidth }) : null })
   ] });
 }
@@ -4111,7 +4248,8 @@ function ScrollableHistory({
   viewportRows,
   totalLines,
   onMeasure,
-  maxWidth
+  maxWidth,
+  setSuggestions
 }) {
   const { stdout } = useStdout();
   const rawWidth = stdout?.columns ?? 80;
@@ -4150,7 +4288,7 @@ function ScrollableHistory({
             flexShrink: 0,
             children: [
               hiddenCount > 0 ? /* @__PURE__ */ jsx(Box, { flexShrink: 0, children: /* @__PURE__ */ jsx(Text, { dimColor: true, italic: true, children: `  \u2191 ${hiddenCount} earlier ${hiddenCount === 1 ? "entry" : "entries"} (scroll lives in this session; full log on disk)` }) }) : null,
-              shown.map((entry) => /* @__PURE__ */ jsx(Box, { marginBottom: entry.kind === "turn-summary" ? 1 : 0, flexShrink: 0, children: /* @__PURE__ */ jsx(Entry, { entry, termWidth }) }, entry.id)),
+              shown.map((entry) => /* @__PURE__ */ jsx(Box, { marginBottom: entry.kind === "turn-summary" ? 1 : 0, flexShrink: 0, children: /* @__PURE__ */ jsx(Entry, { entry, termWidth, setSuggestions }) }, entry.id)),
               tail ? /* @__PURE__ */ jsx(AssistantTail, { text: tail, termWidth }) : null,
               toolTail && toolStream ? /* @__PURE__ */ jsx(
                 ToolStreamBox,
@@ -4209,6 +4347,15 @@ function startHeapWatchdog(opts = {}) {
     }).catch(() => void 0);
   };
   const tick = () => {
+    let userTimings = 0;
+    try {
+      userTimings = performance.getEntriesByType("mark").length + performance.getEntriesByType("measure").length;
+      if (userTimings > 0) {
+        performance.clearMarks();
+        performance.clearMeasures();
+      }
+    } catch {
+    }
     const s2 = takeHeapSample();
     if (s2.load >= criticalAt && criticalArmed) {
       criticalArmed = false;
@@ -4237,7 +4384,7 @@ function startHeapWatchdog(opts = {}) {
         extras = opts.collectStats?.() ?? {};
       } catch {
       }
-      append(JSON.stringify({ pid: process.pid, ...s2, ...extras }));
+      append(JSON.stringify({ pid: process.pid, ...s2, userTimings, ...extras }));
     }
   };
   const timer = setInterval(tick, sampleEveryMs);
@@ -5396,7 +5543,7 @@ var MODE_DESC = {
   suggest: "Shows next-step suggestions after each turn",
   auto: "Self-driving \u2014 agent continues automatically"
 };
-var SETTINGS_FIELD_COUNT = 24;
+var SETTINGS_FIELD_COUNT = 25;
 var CONFIG_SCOPES = ["global", "project"];
 function SettingsPicker({
   field,
@@ -6832,6 +6979,7 @@ function useSessionEvents(events, dispatch, onClearHistory) {
     const offRewound = events.on("session.rewound", () => {
       dispatch({ type: "sessionRewound", toPromptIndex: 0 });
       dispatch({ type: "clearHistory" });
+      dispatch({ type: "resetContextChip" });
       onClearHistory?.(dispatch);
     });
     return () => {
@@ -7756,20 +7904,20 @@ function reducer(state, action) {
         const enext = (ebase + action.delta + ENHANCE_DELAY_PRESETS.length) % ENHANCE_DELAY_PRESETS.length;
         return { ...state, settingsPicker: { ...sp, enhanceDelayMs: expectDefined$1(ENHANCE_DELAY_PRESETS[enext]), hint: void 0 } };
       }
-      if (f === 20) return { ...state, settingsPicker: { ...sp, debugStream: !sp.debugStream, hint: void 0 } };
-      if (f === 21) {
-        const i = CONFIG_SCOPES.indexOf(sp.configScope);
-        const base = i < 0 ? 0 : i;
-        const next = (base + action.delta + CONFIG_SCOPES.length) % CONFIG_SCOPES.length;
-        return { ...state, settingsPicker: { ...sp, configScope: expectDefined$1(CONFIG_SCOPES[next]), hint: void 0 } };
-      }
-      if (f === 22) return { ...state, settingsPicker: { ...sp, enhanceEnabled: !sp.enhanceEnabled, hint: void 0 } };
-      if (f === 23) {
+      if (f === 21) return { ...state, settingsPicker: { ...sp, enhanceEnabled: !sp.enhanceEnabled, hint: void 0 } };
+      if (f === 22) {
         const i = ENHANCE_LANGUAGES.indexOf(sp.enhanceLanguage);
         const base = i < 0 ? 0 : i;
         const next = (base + action.delta + ENHANCE_LANGUAGES.length) % ENHANCE_LANGUAGES.length;
         return { ...state, settingsPicker: { ...sp, enhanceLanguage: expectDefined$1(ENHANCE_LANGUAGES[next]), hint: void 0 } };
       }
+      if (f === 23) return { ...state, settingsPicker: { ...sp, debugStream: !sp.debugStream, hint: void 0 } };
+      if (f === 24) {
+        const i = CONFIG_SCOPES.indexOf(sp.configScope);
+        const base = i < 0 ? 0 : i;
+        const next = (base + action.delta + CONFIG_SCOPES.length) % CONFIG_SCOPES.length;
+        return { ...state, settingsPicker: { ...sp, configScope: expectDefined$1(CONFIG_SCOPES[next]), hint: void 0 } };
+      }
       return state;
     }
     case "settingsHint":
@@ -8610,6 +8758,7 @@ function App({
   predictNext,
   onSuggestionsParsed,
   getSuggestions,
+  setSuggestions,
   switchAutonomy,
   effectiveMaxContext,
   onExit,
@@ -9048,7 +9197,8 @@ function App({
   }, [getLiveSessions]);
   const [mailboxStatus, setMailboxStatus] = useState({
     unread: 0,
-    onlineAgents: 0
+    onlineAgents: 0,
+    onlineClients: { tui: 0, webui: 0, repl: 0 }
   });
   useEffect(() => {
     const seenAgents = /* @__PURE__ */ new Set();
@@ -9074,11 +9224,25 @@ function App({
       if (p?.agentId) seenAgents.add(p.agentId);
       setMailboxStatus((prev) => ({ ...prev, onlineAgents: seenAgents.size }));
     });
+    const unsub5 = events.onPattern("mailbox.sync_clients", (_e, payload) => {
+      const p = payload;
+      if (p) {
+        setMailboxStatus((prev) => ({
+          ...prev,
+          onlineClients: {
+            tui: p.tui ?? 0,
+            webui: p.webui ?? 0,
+            repl: p.repl ?? 0
+          }
+        }));
+      }
+    });
     return () => {
       unsub1();
       unsub2();
       unsub3();
       unsub4();
+      unsub5();
     };
   }, [events]);
   const [mailboxPanelOpen, setMailboxPanelOpen] = useState(false);
@@ -10639,14 +10803,14 @@ function App({
           return;
         }
         if (item.kind === "project") {
-          onProjectSelect?.(item.key, item.kind);
+          await onProjectSelect?.(item.key, item.kind);
           dispatch({ type: "projectPickerClose" });
           requestExit?.(42);
           return;
         }
         dispatch({ type: "projectPickerClose" });
         if (item.key === "new-session") {
-          onProjectSelect?.(item.key, item.kind);
+          await onProjectSelect?.(item.key, item.kind);
           requestExit?.(42);
         } else if (item.key === "prev-sessions") {
           void submit("/resume");
@@ -11887,7 +12051,8 @@ User message:
         scrollOffset: state.scrollOffset,
         viewportRows: state.viewportRows,
         totalLines: state.totalLines,
-        onMeasure: (totalLines) => dispatch({ type: "setMeasuredLines", totalLines })
+        onMeasure: (totalLines) => dispatch({ type: "setMeasuredLines", totalLines }),
+        setSuggestions
       }
     ) : /* @__PURE__ */ jsx(
       History,
@@ -11895,7 +12060,8 @@ User message:
         entries: state.entries,
         generation: state.historyGen,
         streamingText: state.streamingText,
-        toolStream: state.toolStream
+        toolStream: state.toolStream,
+        setSuggestions
       }
     ),
     /* @__PURE__ */ jsxs(Box, { flexDirection: "column", flexShrink: 0, ref: bottomRegionRef, children: [
@@ -12146,6 +12312,7 @@ User message:
           subagentCount: Object.keys(state.fleet).length,
           processCount: getProcessRegistry().activeCount,
           hiddenItems,
+          events,
           eternalStage: state.eternalStage,
           goalSummary: state.goalSummary,
           indexState,
@@ -12421,6 +12588,7 @@ async function runTui(opts) {
   const cleanup = () => {
     if (cleaned) return;
     cleaned = true;
+    unregisterTuiClient();
     unsilenceTerminal();
     try {
       stopTitle();
@@ -12447,6 +12615,64 @@ async function runTui(opts) {
     }
     process.off("exit", exitHandler);
   };
+  let clientHeartbeatTimer = null;
+  let clientSyncTimer = null;
+  const CLIENT_HEARTBEAT_MS = 15e3;
+  const CLIENT_SYNC_MS = 3e4;
+  const registerTuiClient = async () => {
+    if (!opts.projectRoot) return null;
+    try {
+      const projectDir = resolveProjectDir(opts.projectRoot, wstackGlobalRoot());
+      const mailbox = new GlobalMailbox(projectDir, opts.events);
+      const clientId = `tui@${randomUUID().slice(0, 8)}`;
+      await mailbox.registerClient({
+        clientId,
+        sessionId: opts.projectRoot,
+        name: `TUI [${path4.basename(opts.projectRoot)}]`,
+        source: "tui",
+        pid: process.pid
+      });
+      clientHeartbeatTimer = setInterval(() => {
+        mailbox.clientHeartbeat({ clientId }).catch(() => {
+        });
+      }, CLIENT_HEARTBEAT_MS);
+      clientHeartbeatTimer.unref();
+      const syncClients = async () => {
+        try {
+          const statuses = await mailbox.getClientStatuses();
+          const counts = { tui: 0, webui: 0, repl: 0 };
+          for (const s2 of statuses) {
+            if (s2.online && s2.source in counts) {
+              counts[s2.source]++;
+            }
+          }
+          opts.events.emitCustom("mailbox.sync_clients", counts);
+        } catch {
+        }
+      };
+      setTimeout(() => {
+        void syncClients();
+      }, 5e3);
+      clientSyncTimer = setInterval(() => {
+        void syncClients();
+      }, CLIENT_SYNC_MS);
+      clientSyncTimer.unref();
+      return clientId;
+    } catch {
+      return null;
+    }
+  };
+  const unregisterTuiClient = () => {
+    if (clientHeartbeatTimer) {
+      clearInterval(clientHeartbeatTimer);
+      clientHeartbeatTimer = null;
+    }
+    if (clientSyncTimer) {
+      clearInterval(clientSyncTimer);
+      clientSyncTimer = null;
+    }
+  };
+  registerTuiClient();
   return new Promise((resolve) => {
     let exitCode = 0;
     let hardExitTimer = null;
@@ -12751,6 +12977,6 @@ function eventToEntry(ev, pendingTools, completedTools) {
   }
 }
 
-export { parseInline, replaySessionEvents, runTui };
+export { parseInline, parseNextSteps, replaySessionEvents, runTui };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map