@xopcai/xopc 0.0.28 → 0.0.29

package/dist/src/tui/tui-commands.js

@@ -0,0 +1,165 @@
+//#region src/tui/tui-commands.ts
+function getSlashCommands(_isLocal) {
+	return [
+		{
+			name: "help",
+			description: "Show available commands"
+		},
+		{
+			name: "abort",
+			description: "Abort active run (or press Escape)"
+		},
+		{
+			name: "tools",
+			description: "Toggle tool output expanded/collapsed (or Ctrl+O)"
+		},
+		{
+			name: "thinking",
+			description: "Toggle thinking display (or Ctrl+T)"
+		},
+		{
+			name: "exit",
+			description: "Exit the TUI"
+		},
+		{
+			name: "models",
+			description: "List available models"
+		},
+		{
+			name: "switch",
+			description: "Switch model (e.g. /switch openai/gpt-4o)"
+		},
+		{
+			name: "usage",
+			description: "Show token usage statistics"
+		},
+		{
+			name: "new",
+			description: "Start a new session"
+		},
+		{
+			name: "clear",
+			description: "Clear current session"
+		},
+		{
+			name: "list",
+			description: "List sessions"
+		},
+		{
+			name: "compact",
+			description: "Compact session history"
+		},
+		{
+			name: "think",
+			description: "Set thinking level (e.g. /think high)"
+		},
+		{
+			name: "reasoning",
+			description: "Set reasoning visibility (e.g. /reasoning stream)"
+		},
+		{
+			name: "verbose",
+			description: "Toggle verbose mode"
+		},
+		{
+			name: "status",
+			description: "Show agent status"
+		},
+		{
+			name: "config",
+			description: "Show or update configuration"
+		},
+		{
+			name: "context",
+			description: "Show context budget"
+		},
+		{
+			name: "btw",
+			description: "Side question without saving to session"
+		},
+		{
+			name: "export",
+			description: "Export session (markdown/html/json)"
+		},
+		{
+			name: "settings",
+			description: "Show current settings"
+		},
+		{
+			name: "start",
+			description: "Show welcome message"
+		}
+	];
+}
+function formatTuiHelpText(isLocal) {
+	const commands = getSlashCommands(isLocal);
+	const lines = ["Available commands:"];
+	for (const c of commands) lines.push(`  /${c.name} — ${c.description}`);
+	lines.push("", "Keyboard shortcuts:");
+	lines.push("  Escape — Abort active run");
+	lines.push("  Ctrl+L — Model picker");
+	lines.push("  Ctrl+P — Session picker");
+	lines.push("  Ctrl+O — Toggle tool output");
+	lines.push("  Ctrl+T — Toggle thinking display");
+	lines.push("  Ctrl+C — Clear input; empty line: warn, then press again within 1s to exit");
+	lines.push("  Ctrl+D — Exit");
+	lines.push("  !cmd — Local shell (gated; runs on this machine)");
+	return lines.join("\n");
+}
+function createTuiCommandHandler(deps) {
+	const { state, chatLog, tui, assembler, isLocalMode, abortActive, sendMessage, requestExit, updateFooter } = deps;
+	return (input) => {
+		const [commandName] = input.replace(/^\//, "").trim().split(/\s+/);
+		const normalizedCommand = (commandName ?? "").toLowerCase();
+		switch (normalizedCommand) {
+			case "help":
+				chatLog.addSystem(formatTuiHelpText(isLocalMode));
+				tui.requestRender();
+				return;
+			case "exit":
+			case "quit":
+				requestExit();
+				return;
+			case "abort":
+			case "stop":
+			case "cancel":
+				abortActive().then(() => {
+					chatLog.addSystem("Aborted.");
+					tui.requestRender();
+				});
+				return;
+			case "tools":
+				state.toolsExpanded = !state.toolsExpanded;
+				chatLog.setToolsExpanded(state.toolsExpanded);
+				chatLog.addSystem(`Tools: ${state.toolsExpanded ? "expanded" : "collapsed"}`);
+				tui.requestRender();
+				return;
+			case "thinking":
+				state.showThinking = !state.showThinking;
+				chatLog.addSystem(`Thinking display: ${state.showThinking ? "on" : "off"}`);
+				updateFooter();
+				tui.requestRender();
+				return;
+			default: break;
+		}
+		switch (normalizedCommand) {
+			case "new":
+			case "reset":
+			case "restart":
+			case "clear":
+				abortActive().then(() => {
+					assembler.clear();
+					chatLog.clearAll();
+					tui.requestRender();
+					sendMessage(input);
+				});
+				return;
+			default: break;
+		}
+		sendMessage(input);
+	};
+}
+//#endregion
+export { createTuiCommandHandler, formatTuiHelpText, getSlashCommands };
+
+//# sourceMappingURL=tui-commands.js.map

package/dist/src/tui/tui-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-commands.js","names":[],"sources":["../../../src/tui/tui-commands.ts"],"sourcesContent":["import type { TUI } from '@mariozechner/pi-tui';\n\nimport type { ChatLog } from './components/chat-log.js';\nimport type { StreamAssembler } from './stream-assembler.js';\nimport type { TuiState } from './tui-types.js';\n\ninterface SlashCommandDef {\n  name: string;\n  description: string;\n}\n\nexport function getSlashCommands(_isLocal: boolean): SlashCommandDef[] {\n  return [\n    { name: 'help', description: 'Show available commands' },\n    { name: 'abort', description: 'Abort active run (or press Escape)' },\n    { name: 'tools', description: 'Toggle tool output expanded/collapsed (or Ctrl+O)' },\n    { name: 'thinking', description: 'Toggle thinking display (or Ctrl+T)' },\n    { name: 'exit', description: 'Exit the TUI' },\n    { name: 'models', description: 'List available models' },\n    { name: 'switch', description: 'Switch model (e.g. /switch openai/gpt-4o)' },\n    { name: 'usage', description: 'Show token usage statistics' },\n    { name: 'new', description: 'Start a new session' },\n    { name: 'clear', description: 'Clear current session' },\n    { name: 'list', description: 'List sessions' },\n    { name: 'compact', description: 'Compact session history' },\n    { name: 'think', description: 'Set thinking level (e.g. /think high)' },\n    { name: 'reasoning', description: 'Set reasoning visibility (e.g. /reasoning stream)' },\n    { name: 'verbose', description: 'Toggle verbose mode' },\n    { name: 'status', description: 'Show agent status' },\n    { name: 'config', description: 'Show or update configuration' },\n    { name: 'context', description: 'Show context budget' },\n    { name: 'btw', description: 'Side question without saving to session' },\n    { name: 'export', description: 'Export session (markdown/html/json)' },\n    { name: 'settings', description: 'Show current settings' },\n    { name: 'start', description: 'Show welcome message' },\n  ];\n}\n\nexport function formatTuiHelpText(isLocal: boolean): string {\n  const commands = getSlashCommands(isLocal);\n  const lines = ['Available commands:'];\n  for (const c of commands) {\n    lines.push(`  /${c.name} — ${c.description}`);\n  }\n  lines.push('', 'Keyboard shortcuts:');\n  lines.push('  Escape — Abort active run');\n  lines.push('  Ctrl+L — Model picker');\n  lines.push('  Ctrl+P — Session picker');\n  lines.push('  Ctrl+O — Toggle tool output');\n  lines.push('  Ctrl+T — Toggle thinking display');\n  lines.push('  Ctrl+C — Clear input; empty line: warn, then press again within 1s to exit');\n  lines.push('  Ctrl+D — Exit');\n  lines.push('  !cmd — Local shell (gated; runs on this machine)');\n  return lines.join('\\n');\n}\n\nexport type CommandHandlerDeps = {\n  state: TuiState;\n  chatLog: ChatLog;\n  tui: TUI;\n  assembler: StreamAssembler;\n  isLocalMode: boolean;\n  abortActive: () => Promise<void>;\n  sendMessage: (text: string) => void;\n  requestExit: () => void;\n  updateFooter: () => void;\n};\n\nexport function createTuiCommandHandler(deps: CommandHandlerDeps): (input: string) => void {\n  const {\n    state,\n    chatLog,\n    tui,\n    assembler,\n    isLocalMode,\n    abortActive,\n    sendMessage,\n    requestExit,\n    updateFooter,\n  } = deps;\n\n  return (input: string) => {\n    const trimmed = input.replace(/^\\//, '').trim();\n    const [commandName] = trimmed.split(/\\s+/);\n    const normalizedCommand = (commandName ?? '').toLowerCase();\n\n    switch (normalizedCommand) {\n      case 'help':\n        chatLog.addSystem(formatTuiHelpText(isLocalMode));\n        tui.requestRender();\n        return;\n      case 'exit':\n      case 'quit':\n        requestExit();\n        return;\n      case 'abort':\n      case 'stop':\n      case 'cancel':\n        void abortActive().then(() => {\n          chatLog.addSystem('Aborted.');\n          tui.requestRender();\n        });\n        return;\n      case 'tools':\n        state.toolsExpanded = !state.toolsExpanded;\n        chatLog.setToolsExpanded(state.toolsExpanded);\n        chatLog.addSystem(`Tools: ${state.toolsExpanded ? 'expanded' : 'collapsed'}`);\n        tui.requestRender();\n        return;\n      case 'thinking':\n        state.showThinking = !state.showThinking;\n        chatLog.addSystem(`Thinking display: ${state.showThinking ? 'on' : 'off'}`);\n        updateFooter();\n        tui.requestRender();\n        return;\n      default:\n        break;\n    }\n\n    switch (normalizedCommand) {\n      case 'new':\n      case 'reset':\n      case 'restart':\n      case 'clear': {\n        void abortActive().then(() => {\n          assembler.clear();\n          chatLog.clearAll();\n          tui.requestRender();\n          sendMessage(input);\n        });\n        return;\n      }\n      default:\n        break;\n    }\n\n    sendMessage(input);\n  };\n}\n"],"mappings":";AAWA,SAAgB,iBAAiB,UAAsC;AACrE,QAAO;EACL;GAAE,MAAM;GAAQ,aAAa;GAA2B;EACxD;GAAE,MAAM;GAAS,aAAa;GAAsC;EACpE;GAAE,MAAM;GAAS,aAAa;GAAqD;EACnF;GAAE,MAAM;GAAY,aAAa;GAAuC;EACxE;GAAE,MAAM;GAAQ,aAAa;GAAgB;EAC7C;GAAE,MAAM;GAAU,aAAa;GAAyB;EACxD;GAAE,MAAM;GAAU,aAAa;GAA6C;EAC5E;GAAE,MAAM;GAAS,aAAa;GAA+B;EAC7D;GAAE,MAAM;GAAO,aAAa;GAAuB;EACnD;GAAE,MAAM;GAAS,aAAa;GAAyB;EACvD;GAAE,MAAM;GAAQ,aAAa;GAAiB;EAC9C;GAAE,MAAM;GAAW,aAAa;GAA2B;EAC3D;GAAE,MAAM;GAAS,aAAa;GAAyC;EACvE;GAAE,MAAM;GAAa,aAAa;GAAqD;EACvF;GAAE,MAAM;GAAW,aAAa;GAAuB;EACvD;GAAE,MAAM;GAAU,aAAa;GAAqB;EACpD;GAAE,MAAM;GAAU,aAAa;GAAgC;EAC/D;GAAE,MAAM;GAAW,aAAa;GAAuB;EACvD;GAAE,MAAM;GAAO,aAAa;GAA2C;EACvE;GAAE,MAAM;GAAU,aAAa;GAAuC;EACtE;GAAE,MAAM;GAAY,aAAa;GAAyB;EAC1D;GAAE,MAAM;GAAS,aAAa;GAAwB;EACvD;;AAGH,SAAgB,kBAAkB,SAA0B;CAC1D,MAAM,WAAW,iBAAiB,QAAQ;CAC1C,MAAM,QAAQ,CAAC,sBAAsB;AACrC,MAAK,MAAM,KAAK,SACd,OAAM,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,cAAc;AAE/C,OAAM,KAAK,IAAI,sBAAsB;AACrC,OAAM,KAAK,8BAA8B;AACzC,OAAM,KAAK,0BAA0B;AACrC,OAAM,KAAK,4BAA4B;AACvC,OAAM,KAAK,gCAAgC;AAC3C,OAAM,KAAK,qCAAqC;AAChD,OAAM,KAAK,+EAA+E;AAC1F,OAAM,KAAK,kBAAkB;AAC7B,OAAM,KAAK,qDAAqD;AAChE,QAAO,MAAM,KAAK,KAAK;;AAezB,SAAgB,wBAAwB,MAAmD;CACzF,MAAM,EACJ,OACA,SACA,KACA,WACA,aACA,aACA,aACA,aACA,iBACE;AAEJ,SAAQ,UAAkB;EAExB,MAAM,CAAC,eADS,MAAM,QAAQ,OAAO,GAAG,CAAC,MACZ,CAAC,MAAM,MAAM;EAC1C,MAAM,qBAAqB,eAAe,IAAI,aAAa;AAE3D,UAAQ,mBAAR;GACE,KAAK;AACH,YAAQ,UAAU,kBAAkB,YAAY,CAAC;AACjD,QAAI,eAAe;AACnB;GACF,KAAK;GACL,KAAK;AACH,iBAAa;AACb;GACF,KAAK;GACL,KAAK;GACL,KAAK;AACE,iBAAa,CAAC,WAAW;AAC5B,aAAQ,UAAU,WAAW;AAC7B,SAAI,eAAe;MACnB;AACF;GACF,KAAK;AACH,UAAM,gBAAgB,CAAC,MAAM;AAC7B,YAAQ,iBAAiB,MAAM,cAAc;AAC7C,YAAQ,UAAU,UAAU,MAAM,gBAAgB,aAAa,cAAc;AAC7E,QAAI,eAAe;AACnB;GACF,KAAK;AACH,UAAM,eAAe,CAAC,MAAM;AAC5B,YAAQ,UAAU,qBAAqB,MAAM,eAAe,OAAO,QAAQ;AAC3E,kBAAc;AACd,QAAI,eAAe;AACnB;GACF,QACE;;AAGJ,UAAQ,mBAAR;GACE,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;AACE,iBAAa,CAAC,WAAW;AAC5B,eAAU,OAAO;AACjB,aAAQ,UAAU;AAClB,SAAI,eAAe;AACnB,iBAAY,MAAM;MAClB;AACF;GAEF,QACE;;AAGJ,cAAY,MAAM"}

package/dist/src/tui/tui-lifecycle.d.ts

@@ -0,0 +1,26 @@
+/** Suppress duplicate backspace bursts from some terminals (openclaw-aligned). */
+export declare function createBackspaceDeduper(params?: {
+    dedupeWindowMs?: number;
+    now?: () => number;
+}): (data: string) => string;
+export declare function isIgnorableTuiStopError(error: unknown): boolean;
+export declare function stopTuiSafely(stop: () => void): void;
+export type DrainableTui = {
+    stop: () => void;
+    terminal?: {
+        drainInput?: (maxMs?: number, idleMs?: number) => Promise<void>;
+    };
+};
+export declare function drainAndStopTuiSafely(tui: DrainableTui): Promise<void>;
+type CtrlCAction = 'clear' | 'warn' | 'exit';
+/** Double Ctrl+C within `exitWindowMs` to exit when the input line is empty (openclaw semantics). */
+export declare function resolveCtrlCAction(params: {
+    hasInput: boolean;
+    now: number;
+    lastCtrlCAt: number;
+    exitWindowMs?: number;
+}): {
+    action: CtrlCAction;
+    nextLastCtrlCAt: number;
+};
+export {};

package/dist/src/tui/tui-lifecycle.js

@@ -0,0 +1,57 @@
+import { Key, matchesKey } from "@mariozechner/pi-tui";
+//#region src/tui/tui-lifecycle.ts
+/** Suppress duplicate backspace bursts from some terminals (openclaw-aligned). */
+function createBackspaceDeduper(params) {
+	const dedupeWindowMs = Math.max(0, Math.floor(params?.dedupeWindowMs ?? 8));
+	const now = params?.now ?? (() => Date.now());
+	let lastBackspaceAt = -1;
+	return (data) => {
+		if (data !== "\b" && !matchesKey(data, Key.backspace)) return data;
+		const ts = now();
+		if (lastBackspaceAt >= 0 && ts - lastBackspaceAt <= dedupeWindowMs) return "";
+		lastBackspaceAt = ts;
+		return data;
+	};
+}
+function isIgnorableTuiStopError(error) {
+	if (!error || typeof error !== "object") return false;
+	const err = error;
+	const code = typeof err.code === "string" ? err.code : "";
+	const syscall = typeof err.syscall === "string" ? err.syscall : "";
+	const message = typeof err.message === "string" ? err.message : "";
+	if (code === "EBADF" && syscall === "setRawMode") return true;
+	return /setRawMode/i.test(message) && /EBADF/i.test(message);
+}
+function stopTuiSafely(stop) {
+	try {
+		stop();
+	} catch (error) {
+		if (!isIgnorableTuiStopError(error)) throw error;
+	}
+}
+async function drainAndStopTuiSafely(tui) {
+	if (typeof tui.terminal?.drainInput === "function") try {
+		await tui.terminal.drainInput();
+	} catch {}
+	stopTuiSafely(() => tui.stop());
+}
+/** Double Ctrl+C within `exitWindowMs` to exit when the input line is empty (openclaw semantics). */
+function resolveCtrlCAction(params) {
+	const exitWindowMs = Math.max(1, Math.floor(params.exitWindowMs ?? 1e3));
+	if (params.hasInput) return {
+		action: "clear",
+		nextLastCtrlCAt: params.now
+	};
+	if (params.now - params.lastCtrlCAt <= exitWindowMs) return {
+		action: "exit",
+		nextLastCtrlCAt: params.lastCtrlCAt
+	};
+	return {
+		action: "warn",
+		nextLastCtrlCAt: params.now
+	};
+}
+//#endregion
+export { createBackspaceDeduper, drainAndStopTuiSafely, isIgnorableTuiStopError, resolveCtrlCAction, stopTuiSafely };
+
+//# sourceMappingURL=tui-lifecycle.js.map

package/dist/src/tui/tui-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-lifecycle.js","names":[],"sources":["../../../src/tui/tui-lifecycle.ts"],"sourcesContent":["import { Key, matchesKey } from '@mariozechner/pi-tui';\n\n/** Suppress duplicate backspace bursts from some terminals (openclaw-aligned). */\nexport function createBackspaceDeduper(params?: { dedupeWindowMs?: number; now?: () => number }) {\n  const dedupeWindowMs = Math.max(0, Math.floor(params?.dedupeWindowMs ?? 8));\n  const now = params?.now ?? (() => Date.now());\n  let lastBackspaceAt = -1;\n\n  return (data: string): string => {\n    if (data !== '\\x08' && !matchesKey(data, Key.backspace)) {\n      return data;\n    }\n    const ts = now();\n    if (lastBackspaceAt >= 0 && ts - lastBackspaceAt <= dedupeWindowMs) {\n      return '';\n    }\n    lastBackspaceAt = ts;\n    return data;\n  };\n}\n\nexport function isIgnorableTuiStopError(error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const err = error as { code?: unknown; syscall?: unknown; message?: unknown };\n  const code = typeof err.code === 'string' ? err.code : '';\n  const syscall = typeof err.syscall === 'string' ? err.syscall : '';\n  const message = typeof err.message === 'string' ? err.message : '';\n  if (code === 'EBADF' && syscall === 'setRawMode') {\n    return true;\n  }\n  return /setRawMode/i.test(message) && /EBADF/i.test(message);\n}\n\nexport function stopTuiSafely(stop: () => void): void {\n  try {\n    stop();\n  } catch (error) {\n    if (!isIgnorableTuiStopError(error)) {\n      throw error;\n    }\n  }\n}\n\nexport type DrainableTui = {\n  stop: () => void;\n  terminal?: {\n    drainInput?: (maxMs?: number, idleMs?: number) => Promise<void>;\n  };\n};\n\nexport async function drainAndStopTuiSafely(tui: DrainableTui): Promise<void> {\n  if (typeof tui.terminal?.drainInput === 'function') {\n    try {\n      await tui.terminal.drainInput();\n    } catch {\n      // Best-effort only.\n    }\n  }\n  stopTuiSafely(() => tui.stop());\n}\n\ntype CtrlCAction = 'clear' | 'warn' | 'exit';\n\n/** Double Ctrl+C within `exitWindowMs` to exit when the input line is empty (openclaw semantics). */\nexport function resolveCtrlCAction(params: {\n  hasInput: boolean;\n  now: number;\n  lastCtrlCAt: number;\n  exitWindowMs?: number;\n}): { action: CtrlCAction; nextLastCtrlCAt: number } {\n  const exitWindowMs = Math.max(1, Math.floor(params.exitWindowMs ?? 1000));\n  if (params.hasInput) {\n    return { action: 'clear', nextLastCtrlCAt: params.now };\n  }\n  if (params.now - params.lastCtrlCAt <= exitWindowMs) {\n    return { action: 'exit', nextLastCtrlCAt: params.lastCtrlCAt };\n  }\n  return { action: 'warn', nextLastCtrlCAt: params.now };\n}\n"],"mappings":";;;AAGA,SAAgB,uBAAuB,QAA0D;CAC/F,MAAM,iBAAiB,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,kBAAkB,EAAE,CAAC;CAC3E,MAAM,MAAM,QAAQ,cAAc,KAAK,KAAK;CAC5C,IAAI,kBAAkB;AAEtB,SAAQ,SAAyB;AAC/B,MAAI,SAAS,QAAU,CAAC,WAAW,MAAM,IAAI,UAAU,CACrD,QAAO;EAET,MAAM,KAAK,KAAK;AAChB,MAAI,mBAAmB,KAAK,KAAK,mBAAmB,eAClD,QAAO;AAET,oBAAkB;AAClB,SAAO;;;AAIX,SAAgB,wBAAwB,OAAyB;AAC/D,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO;CAET,MAAM,MAAM;CACZ,MAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO;CACvD,MAAM,UAAU,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;CAChE,MAAM,UAAU,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;AAChE,KAAI,SAAS,WAAW,YAAY,aAClC,QAAO;AAET,QAAO,cAAc,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ;;AAG9D,SAAgB,cAAc,MAAwB;AACpD,KAAI;AACF,QAAM;UACC,OAAO;AACd,MAAI,CAAC,wBAAwB,MAAM,CACjC,OAAM;;;AAYZ,eAAsB,sBAAsB,KAAkC;AAC5E,KAAI,OAAO,IAAI,UAAU,eAAe,WACtC,KAAI;AACF,QAAM,IAAI,SAAS,YAAY;SACzB;AAIV,qBAAoB,IAAI,MAAM,CAAC;;;AAMjC,SAAgB,mBAAmB,QAKkB;CACnD,MAAM,eAAe,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,gBAAgB,IAAK,CAAC;AACzE,KAAI,OAAO,SACT,QAAO;EAAE,QAAQ;EAAS,iBAAiB,OAAO;EAAK;AAEzD,KAAI,OAAO,MAAM,OAAO,eAAe,aACrC,QAAO;EAAE,QAAQ;EAAQ,iBAAiB,OAAO;EAAa;AAEhE,QAAO;EAAE,QAAQ;EAAQ,iBAAiB,OAAO;EAAK"}

package/dist/src/tui/tui-local-shell.d.ts

@@ -0,0 +1,28 @@
+import { spawn } from 'node:child_process';
+import type { Component } from '@mariozechner/pi-tui';
+type LocalShellDeps = {
+    chatLog: {
+        addSystem: (line: string) => void;
+    };
+    tui: {
+        requestRender: () => void;
+        setFocus: (c: Component) => void;
+    };
+    editor: Component;
+    openOverlay: (component: Component) => void;
+    closeOverlay: () => void;
+    spawnCommand?: typeof spawn;
+    getCwd?: () => string;
+    env?: NodeJS.ProcessEnv;
+    maxOutputChars?: number;
+    /** Pause stdout/stderr filtering before handing the terminal to a child (`stdio: 'inherit'`). */
+    pauseStdioFilter?: () => void;
+    resumeStdioFilter?: () => void;
+    /** Wrap work while the TUI is stopped (full-screen subprocess). */
+    runWithInheritedStdio?: (work: () => Promise<void>) => Promise<void>;
+};
+/** `!command` runs on the local machine (gated by in-session consent). `!!command` uses inherited stdio. */
+export declare function createLocalShellRunner(deps: LocalShellDeps): {
+    runLocalShellLine: (line: string) => Promise<void>;
+};
+export {};

package/dist/src/tui/tui-local-shell.js

@@ -0,0 +1,147 @@
+import { selectListTheme } from "./theme.js";
+import { spawn } from "node:child_process";
+import { SelectList } from "@mariozechner/pi-tui";
+//#region src/tui/tui-local-shell.ts
+/** `!command` runs on the local machine (gated by in-session consent). `!!command` uses inherited stdio. */
+function createLocalShellRunner(deps) {
+	let localExecAsked = false;
+	let localExecAllowed = false;
+	const spawnCommand = deps.spawnCommand ?? spawn;
+	const getCwd = deps.getCwd ?? (() => process.cwd());
+	const env = deps.env ?? process.env;
+	const maxChars = deps.maxOutputChars ?? 4e4;
+	const ensureLocalExecAllowed = async () => {
+		if (localExecAllowed) return true;
+		if (localExecAsked) return false;
+		localExecAsked = true;
+		return await new Promise((resolve) => {
+			deps.chatLog.addSystem("Allow local shell commands for this session?");
+			deps.chatLog.addSystem("Runs on YOUR machine (not the gateway); may delete files or expose secrets.");
+			deps.chatLog.addSystem("↑/↓ + Enter to choose, Esc to cancel.");
+			const selector = new SelectList([{
+				value: "no",
+				label: "No"
+			}, {
+				value: "yes",
+				label: "Yes"
+			}], 2, selectListTheme);
+			selector.onSelect = (item) => {
+				deps.closeOverlay();
+				if (item.value === "yes") {
+					localExecAllowed = true;
+					deps.chatLog.addSystem("local shell: enabled for this session");
+					resolve(true);
+				} else {
+					deps.chatLog.addSystem("local shell: not enabled");
+					resolve(false);
+				}
+				deps.tui.requestRender();
+			};
+			selector.onCancel = () => {
+				deps.closeOverlay();
+				deps.chatLog.addSystem("local shell: cancelled");
+				deps.tui.requestRender();
+				resolve(false);
+			};
+			deps.openOverlay(selector);
+			deps.tui.requestRender();
+		});
+	};
+	const runLocalShellLine = async (line) => {
+		let cmd = line.slice(1);
+		if (cmd === "") return;
+		let inheritStdio = false;
+		if (cmd.startsWith("!")) {
+			inheritStdio = true;
+			cmd = cmd.slice(1);
+			if (cmd === "") {
+				deps.chatLog.addSystem("[local] !! requires a command (e.g. !!vim file)");
+				deps.tui.requestRender();
+				return;
+			}
+		}
+		if (localExecAsked && !localExecAllowed) {
+			deps.chatLog.addSystem("local shell: not enabled for this session");
+			deps.tui.requestRender();
+			return;
+		}
+		if (!await ensureLocalExecAllowed()) return;
+		deps.chatLog.addSystem(`[local] $ ${cmd}${inheritStdio ? " (inherited stdio)" : ""}`);
+		deps.tui.requestRender();
+		const appendWithCap = (text, chunk) => {
+			const combined = text + chunk;
+			return combined.length > maxChars ? combined.slice(-maxChars) : combined;
+		};
+		if (inheritStdio && deps.runWithInheritedStdio && deps.pauseStdioFilter && deps.resumeStdioFilter) {
+			deps.pauseStdioFilter();
+			try {
+				await deps.runWithInheritedStdio(async () => {
+					await new Promise((resolve, reject) => {
+						const child = spawnCommand(cmd, {
+							shell: true,
+							cwd: getCwd(),
+							env: {
+								...env,
+								XOPC_SHELL: "tui-local"
+							},
+							stdio: "inherit"
+						});
+						child.on("close", (code, signal) => {
+							deps.chatLog.addSystem(`[local] exit ${code ?? "?"}${signal ? ` (signal ${signal})` : ""}`);
+							resolve();
+						});
+						child.on("error", (err) => {
+							deps.chatLog.addSystem(`[local] error: ${String(err)}`);
+							reject(err);
+						});
+					});
+				});
+			} catch {} finally {
+				deps.resumeStdioFilter();
+				deps.tui.setFocus(deps.editor);
+				deps.tui.requestRender();
+			}
+			return;
+		}
+		if (inheritStdio && !deps.runWithInheritedStdio) {
+			deps.chatLog.addSystem("[local] inherited stdio requires full TUI wiring; use single ! instead.");
+			deps.tui.requestRender();
+			return;
+		}
+		await new Promise((resolve) => {
+			const child = spawnCommand(cmd, {
+				shell: true,
+				cwd: getCwd(),
+				env: {
+					...env,
+					XOPC_SHELL: "tui-local"
+				}
+			});
+			let stdout = "";
+			let stderr = "";
+			child.stdout?.on("data", (buf) => {
+				stdout = appendWithCap(stdout, buf.toString("utf8"));
+			});
+			child.stderr?.on("data", (buf) => {
+				stderr = appendWithCap(stderr, buf.toString("utf8"));
+			});
+			child.on("close", (code, signal) => {
+				const combined = (stdout + (stderr ? (stdout ? "\n" : "") + stderr : "")).slice(0, maxChars).trimEnd();
+				if (combined) for (const lineChunk of combined.split("\n")) deps.chatLog.addSystem(`[local] ${lineChunk}`);
+				deps.chatLog.addSystem(`[local] exit ${code ?? "?"}${signal ? ` (signal ${signal})` : ""}`);
+				deps.tui.requestRender();
+				resolve();
+			});
+			child.on("error", (err) => {
+				deps.chatLog.addSystem(`[local] error: ${String(err)}`);
+				deps.tui.requestRender();
+				resolve();
+			});
+		});
+	};
+	return { runLocalShellLine };
+}
+//#endregion
+export { createLocalShellRunner };
+
+//# sourceMappingURL=tui-local-shell.js.map

package/dist/src/tui/tui-local-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-local-shell.js","names":[],"sources":["../../../src/tui/tui-local-shell.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\n\nimport type { Component } from '@mariozechner/pi-tui';\nimport { SelectList } from '@mariozechner/pi-tui';\n\nimport { selectListTheme } from './theme.js';\n\ntype LocalShellDeps = {\n  chatLog: { addSystem: (line: string) => void };\n  tui: { requestRender: () => void; setFocus: (c: Component) => void };\n  editor: Component;\n  openOverlay: (component: Component) => void;\n  closeOverlay: () => void;\n  spawnCommand?: typeof spawn;\n  getCwd?: () => string;\n  env?: NodeJS.ProcessEnv;\n  maxOutputChars?: number;\n  /** Pause stdout/stderr filtering before handing the terminal to a child (`stdio: 'inherit'`). */\n  pauseStdioFilter?: () => void;\n  resumeStdioFilter?: () => void;\n  /** Wrap work while the TUI is stopped (full-screen subprocess). */\n  runWithInheritedStdio?: (work: () => Promise<void>) => Promise<void>;\n};\n\n/** `!command` runs on the local machine (gated by in-session consent). `!!command` uses inherited stdio. */\nexport function createLocalShellRunner(deps: LocalShellDeps) {\n  let localExecAsked = false;\n  let localExecAllowed = false;\n  const spawnCommand = deps.spawnCommand ?? spawn;\n  const getCwd = deps.getCwd ?? (() => process.cwd());\n  const env = deps.env ?? process.env;\n  const maxChars = deps.maxOutputChars ?? 40_000;\n\n  const ensureLocalExecAllowed = async (): Promise<boolean> => {\n    if (localExecAllowed) {\n      return true;\n    }\n    if (localExecAsked) {\n      return false;\n    }\n    localExecAsked = true;\n\n    return await new Promise<boolean>((resolve) => {\n      deps.chatLog.addSystem('Allow local shell commands for this session?');\n      deps.chatLog.addSystem(\n        'Runs on YOUR machine (not the gateway); may delete files or expose secrets.',\n      );\n      deps.chatLog.addSystem('↑/↓ + Enter to choose, Esc to cancel.');\n      const selector = new SelectList(\n        [\n          { value: 'no', label: 'No' },\n          { value: 'yes', label: 'Yes' },\n        ],\n        2,\n        selectListTheme,\n      );\n      selector.onSelect = (item) => {\n        deps.closeOverlay();\n        if (item.value === 'yes') {\n          localExecAllowed = true;\n          deps.chatLog.addSystem('local shell: enabled for this session');\n          resolve(true);\n        } else {\n          deps.chatLog.addSystem('local shell: not enabled');\n          resolve(false);\n        }\n        deps.tui.requestRender();\n      };\n      selector.onCancel = () => {\n        deps.closeOverlay();\n        deps.chatLog.addSystem('local shell: cancelled');\n        deps.tui.requestRender();\n        resolve(false);\n      };\n      deps.openOverlay(selector);\n      deps.tui.requestRender();\n    });\n  };\n\n  const runLocalShellLine = async (line: string) => {\n    let cmd = line.slice(1);\n    if (cmd === '') {\n      return;\n    }\n\n    let inheritStdio = false;\n    if (cmd.startsWith('!')) {\n      inheritStdio = true;\n      cmd = cmd.slice(1);\n      if (cmd === '') {\n        deps.chatLog.addSystem('[local] !! requires a command (e.g. !!vim file)');\n        deps.tui.requestRender();\n        return;\n      }\n    }\n\n    if (localExecAsked && !localExecAllowed) {\n      deps.chatLog.addSystem('local shell: not enabled for this session');\n      deps.tui.requestRender();\n      return;\n    }\n\n    const allowed = await ensureLocalExecAllowed();\n    if (!allowed) {\n      return;\n    }\n\n    deps.chatLog.addSystem(`[local] $ ${cmd}${inheritStdio ? ' (inherited stdio)' : ''}`);\n    deps.tui.requestRender();\n\n    const appendWithCap = (text: string, chunk: string) => {\n      const combined = text + chunk;\n      return combined.length > maxChars ? combined.slice(-maxChars) : combined;\n    };\n\n    if (\n      inheritStdio &&\n      deps.runWithInheritedStdio &&\n      deps.pauseStdioFilter &&\n      deps.resumeStdioFilter\n    ) {\n      deps.pauseStdioFilter();\n      try {\n        await deps.runWithInheritedStdio(async () => {\n          await new Promise<void>((resolve, reject) => {\n            const child = spawnCommand(cmd, {\n              shell: true,\n              cwd: getCwd(),\n              env: { ...env, XOPC_SHELL: 'tui-local' },\n              stdio: 'inherit',\n            });\n            child.on('close', (code, signal) => {\n              deps.chatLog.addSystem(\n                `[local] exit ${code ?? '?'}${signal ? ` (signal ${signal})` : ''}`,\n              );\n              resolve();\n            });\n            child.on('error', (err) => {\n              deps.chatLog.addSystem(`[local] error: ${String(err)}`);\n              reject(err);\n            });\n          });\n        });\n      } catch {\n        // logged above\n      } finally {\n        deps.resumeStdioFilter();\n        deps.tui.setFocus(deps.editor);\n        deps.tui.requestRender();\n      }\n      return;\n    }\n\n    if (inheritStdio && !deps.runWithInheritedStdio) {\n      deps.chatLog.addSystem('[local] inherited stdio requires full TUI wiring; use single ! instead.');\n      deps.tui.requestRender();\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const child = spawnCommand(cmd, {\n        shell: true,\n        cwd: getCwd(),\n        env: { ...env, XOPC_SHELL: 'tui-local' },\n      });\n\n      let stdout = '';\n      let stderr = '';\n      child.stdout?.on('data', (buf) => {\n        stdout = appendWithCap(stdout, buf.toString('utf8'));\n      });\n      child.stderr?.on('data', (buf) => {\n        stderr = appendWithCap(stderr, buf.toString('utf8'));\n      });\n\n      child.on('close', (code, signal) => {\n        const combined = (stdout + (stderr ? (stdout ? '\\n' : '') + stderr : ''))\n          .slice(0, maxChars)\n          .trimEnd();\n\n        if (combined) {\n          for (const lineChunk of combined.split('\\n')) {\n            deps.chatLog.addSystem(`[local] ${lineChunk}`);\n          }\n        }\n        deps.chatLog.addSystem(\n          `[local] exit ${code ?? '?'}${signal ? ` (signal ${signal})` : ''}`,\n        );\n        deps.tui.requestRender();\n        resolve();\n      });\n\n      child.on('error', (err) => {\n        deps.chatLog.addSystem(`[local] error: ${String(err)}`);\n        deps.tui.requestRender();\n        resolve();\n      });\n    });\n  };\n\n  return { runLocalShellLine };\n}\n"],"mappings":"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"}

package/dist/src/tui/tui-overlays.d.ts

@@ -0,0 +1,8 @@
+import type { Component, TUI } from '@mariozechner/pi-tui';
+type OverlayHost = Pick<TUI, 'showOverlay' | 'hideOverlay' | 'hasOverlay' | 'setFocus'>;
+/** Focus management for pi-tui overlays (openclaw pattern). */
+export declare function createOverlayHandlers(host: OverlayHost, fallbackFocus: Component): {
+    openOverlay: (component: Component) => void;
+    closeOverlay: () => void;
+};
+export {};

package/dist/src/tui/tui-overlays.js

@@ -0,0 +1,22 @@
+//#region src/tui/tui-overlays.ts
+/** Focus management for pi-tui overlays (openclaw pattern). */
+function createOverlayHandlers(host, fallbackFocus) {
+	const openOverlay = (component) => {
+		host.showOverlay(component);
+	};
+	const closeOverlay = () => {
+		if (host.hasOverlay()) {
+			host.hideOverlay();
+			return;
+		}
+		host.setFocus(fallbackFocus);
+	};
+	return {
+		openOverlay,
+		closeOverlay
+	};
+}
+//#endregion
+export { createOverlayHandlers };
+
+//# sourceMappingURL=tui-overlays.js.map

package/dist/src/tui/tui-overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-overlays.js","names":[],"sources":["../../../src/tui/tui-overlays.ts"],"sourcesContent":["import type { Component, TUI } from '@mariozechner/pi-tui';\n\ntype OverlayHost = Pick<TUI, 'showOverlay' | 'hideOverlay' | 'hasOverlay' | 'setFocus'>;\n\n/** Focus management for pi-tui overlays (openclaw pattern). */\nexport function createOverlayHandlers(host: OverlayHost, fallbackFocus: Component) {\n  const openOverlay = (component: Component) => {\n    host.showOverlay(component);\n  };\n\n  const closeOverlay = () => {\n    if (host.hasOverlay()) {\n      host.hideOverlay();\n      return;\n    }\n    host.setFocus(fallbackFocus);\n  };\n\n  return { openOverlay, closeOverlay };\n}\n"],"mappings":";;AAKA,SAAgB,sBAAsB,MAAmB,eAA0B;CACjF,MAAM,eAAe,cAAyB;AAC5C,OAAK,YAAY,UAAU;;CAG7B,MAAM,qBAAqB;AACzB,MAAI,KAAK,YAAY,EAAE;AACrB,QAAK,aAAa;AAClB;;AAEF,OAAK,SAAS,cAAc;;AAG9B,QAAO;EAAE;EAAa;EAAc"}

package/dist/src/tui/tui-picker-overlay.d.ts

@@ -0,0 +1,26 @@
+import type { Component, TUI } from '@mariozechner/pi-tui';
+import type { TuiBackend } from './tui-backend.js';
+export type PickerServices = {
+    tui: TUI;
+    editor: Component;
+    openOverlay: (c: Component) => void;
+    closeOverlay: () => void;
+    chatLog: {
+        addSystem: (t: string) => void;
+    };
+    client: TuiBackend;
+    sendMessage: (text: string) => void;
+    refreshSessionInfo: () => Promise<void>;
+    updateHeader: () => void;
+    state: {
+        currentSessionKey: string;
+    };
+    setSessionKey: (key: string) => void;
+    clearChatForSessionSwitch: () => void;
+    /** Load transcript after switching session or on connect. */
+    loadSessionHistory: () => Promise<void>;
+};
+/** Ctrl+L — pick model, sends `/switch provider/id`. */
+export declare function openModelPickerOverlay(svc: PickerServices): Promise<void>;
+/** Ctrl+P — switch session key and reload transcript when available. */
+export declare function openSessionPickerOverlay(svc: PickerServices): Promise<void>;

package/dist/src/tui/tui-picker-overlay.js

@@ -0,0 +1,69 @@
+import { searchableSelectListTheme, theme } from "./theme.js";
+import { SearchableSelectList } from "./components/searchable-select-list.js";
+//#region src/tui/tui-picker-overlay.ts
+function openSearchableOverlay(svc, list, title) {
+	list.onCancel = () => {
+		svc.closeOverlay();
+		svc.tui.setFocus(svc.editor);
+		svc.tui.requestRender();
+	};
+	svc.openOverlay(list);
+	svc.chatLog.addSystem(theme.dim(`${title} (↑/↓ ctrl+n ctrl+p · type to filter · Esc)`));
+	svc.tui.requestRender();
+}
+/** Ctrl+L — pick model, sends `/switch provider/id`. */
+async function openModelPickerOverlay(svc) {
+	const models = await svc.client.listModels();
+	if (models.length === 0) {
+		svc.chatLog.addSystem("No models available from gateway.");
+		svc.tui.requestRender();
+		return;
+	}
+	const items = models.map((m) => ({
+		value: `${m.provider}/${m.id}`,
+		label: m.name || m.id,
+		description: m.provider,
+		searchText: `${m.provider} ${m.id} ${m.name ?? ""}`
+	}));
+	const list = new SearchableSelectList(items, Math.min(10, items.length), searchableSelectListTheme);
+	list.onSelect = (item) => {
+		svc.closeOverlay();
+		svc.tui.setFocus(svc.editor);
+		svc.sendMessage(`/switch ${item.value}`);
+		svc.tui.requestRender();
+	};
+	openSearchableOverlay(svc, list, "Select model");
+}
+/** Ctrl+P — switch session key and reload transcript when available. */
+async function openSessionPickerOverlay(svc) {
+	const sessions = await svc.client.listSessions();
+	if (sessions.length === 0) {
+		svc.chatLog.addSystem("No sessions listed.");
+		svc.tui.requestRender();
+		return;
+	}
+	const items = [...sessions].sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0)).slice(0, 80).map((s) => ({
+		value: s.key,
+		label: s.displayName || s.key,
+		description: s.model ? String(s.model) : void 0,
+		searchText: `${s.key} ${s.displayName ?? ""} ${s.model ?? ""}`
+	}));
+	const list = new SearchableSelectList(items, Math.min(10, items.length), searchableSelectListTheme);
+	list.onSelect = (item) => {
+		svc.closeOverlay();
+		svc.tui.setFocus(svc.editor);
+		svc.setSessionKey(item.value);
+		svc.clearChatForSessionSwitch();
+		svc.chatLog.addSystem(`Session: ${item.value}`);
+		svc.refreshSessionInfo().then(() => svc.loadSessionHistory()).then(() => {
+			svc.updateHeader();
+			svc.tui.requestRender();
+		});
+		svc.tui.requestRender();
+	};
+	openSearchableOverlay(svc, list, "Select session");
+}
+//#endregion
+export { openModelPickerOverlay, openSessionPickerOverlay };
+
+//# sourceMappingURL=tui-picker-overlay.js.map

package/dist/src/tui/tui-picker-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-picker-overlay.js","names":[],"sources":["../../../src/tui/tui-picker-overlay.ts"],"sourcesContent":["import type { Component, SelectItem, TUI } from '@mariozechner/pi-tui';\n\nimport type { TuiBackend } from './tui-backend.js';\nimport { SearchableSelectList } from './components/searchable-select-list.js';\nimport { searchableSelectListTheme, theme } from './theme.js';\n\nexport type PickerServices = {\n  tui: TUI;\n  editor: Component;\n  openOverlay: (c: Component) => void;\n  closeOverlay: () => void;\n  chatLog: { addSystem: (t: string) => void };\n  client: TuiBackend;\n  sendMessage: (text: string) => void;\n  refreshSessionInfo: () => Promise<void>;\n  updateHeader: () => void;\n  state: { currentSessionKey: string };\n  setSessionKey: (key: string) => void;\n  clearChatForSessionSwitch: () => void;\n  /** Load transcript after switching session or on connect. */\n  loadSessionHistory: () => Promise<void>;\n};\n\nfunction openSearchableOverlay(svc: PickerServices, list: SearchableSelectList, title: string) {\n  list.onCancel = () => {\n    svc.closeOverlay();\n    svc.tui.setFocus(svc.editor);\n    svc.tui.requestRender();\n  };\n  svc.openOverlay(list);\n  svc.chatLog.addSystem(theme.dim(`${title} (↑/↓ ctrl+n ctrl+p · type to filter · Esc)`));\n  svc.tui.requestRender();\n}\n\n/** Ctrl+L — pick model, sends `/switch provider/id`. */\nexport async function openModelPickerOverlay(svc: PickerServices): Promise<void> {\n  const models = await svc.client.listModels();\n  if (models.length === 0) {\n    svc.chatLog.addSystem('No models available from gateway.');\n    svc.tui.requestRender();\n    return;\n  }\n  const items: SelectItem[] = models.map((m) => ({\n    value: `${m.provider}/${m.id}`,\n    label: m.name || m.id,\n    description: m.provider,\n    searchText: `${m.provider} ${m.id} ${m.name ?? ''}`,\n  }));\n  const list = new SearchableSelectList(items, Math.min(10, items.length), searchableSelectListTheme);\n  list.onSelect = (item) => {\n    svc.closeOverlay();\n    svc.tui.setFocus(svc.editor);\n    svc.sendMessage(`/switch ${item.value}`);\n    svc.tui.requestRender();\n  };\n  openSearchableOverlay(svc, list, 'Select model');\n}\n\n/** Ctrl+P — switch session key and reload transcript when available. */\nexport async function openSessionPickerOverlay(svc: PickerServices): Promise<void> {\n  const sessions = await svc.client.listSessions();\n  if (sessions.length === 0) {\n    svc.chatLog.addSystem('No sessions listed.');\n    svc.tui.requestRender();\n    return;\n  }\n  const sorted = [...sessions].sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));\n  const items: SelectItem[] = sorted.slice(0, 80).map((s) => ({\n    value: s.key,\n    label: s.displayName || s.key,\n    description: s.model ? String(s.model) : undefined,\n    searchText: `${s.key} ${s.displayName ?? ''} ${s.model ?? ''}`,\n  }));\n  const list = new SearchableSelectList(items, Math.min(10, items.length), searchableSelectListTheme);\n  list.onSelect = (item) => {\n    svc.closeOverlay();\n    svc.tui.setFocus(svc.editor);\n    svc.setSessionKey(item.value);\n    svc.clearChatForSessionSwitch();\n    svc.chatLog.addSystem(`Session: ${item.value}`);\n    void svc\n      .refreshSessionInfo()\n      .then(() => svc.loadSessionHistory())\n      .then(() => {\n        svc.updateHeader();\n        svc.tui.requestRender();\n      });\n    svc.tui.requestRender();\n  };\n  openSearchableOverlay(svc, list, 'Select session');\n}\n"],"mappings":";;;AAuBA,SAAS,sBAAsB,KAAqB,MAA4B,OAAe;AAC7F,MAAK,iBAAiB;AACpB,MAAI,cAAc;AAClB,MAAI,IAAI,SAAS,IAAI,OAAO;AAC5B,MAAI,IAAI,eAAe;;AAEzB,KAAI,YAAY,KAAK;AACrB,KAAI,QAAQ,UAAU,MAAM,IAAI,GAAG,MAAM,6CAA6C,CAAC;AACvF,KAAI,IAAI,eAAe;;;AAIzB,eAAsB,uBAAuB,KAAoC;CAC/E,MAAM,SAAS,MAAM,IAAI,OAAO,YAAY;AAC5C,KAAI,OAAO,WAAW,GAAG;AACvB,MAAI,QAAQ,UAAU,oCAAoC;AAC1D,MAAI,IAAI,eAAe;AACvB;;CAEF,MAAM,QAAsB,OAAO,KAAK,OAAO;EAC7C,OAAO,GAAG,EAAE,SAAS,GAAG,EAAE;EAC1B,OAAO,EAAE,QAAQ,EAAE;EACnB,aAAa,EAAE;EACf,YAAY,GAAG,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,QAAQ;EAChD,EAAE;CACH,MAAM,OAAO,IAAI,qBAAqB,OAAO,KAAK,IAAI,IAAI,MAAM,OAAO,EAAE,0BAA0B;AACnG,MAAK,YAAY,SAAS;AACxB,MAAI,cAAc;AAClB,MAAI,IAAI,SAAS,IAAI,OAAO;AAC5B,MAAI,YAAY,WAAW,KAAK,QAAQ;AACxC,MAAI,IAAI,eAAe;;AAEzB,uBAAsB,KAAK,MAAM,eAAe;;;AAIlD,eAAsB,yBAAyB,KAAoC;CACjF,MAAM,WAAW,MAAM,IAAI,OAAO,cAAc;AAChD,KAAI,SAAS,WAAW,GAAG;AACzB,MAAI,QAAQ,UAAU,sBAAsB;AAC5C,MAAI,IAAI,eAAe;AACvB;;CAGF,MAAM,QADS,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,OAAO,EAAE,aAAa,MAAM,EAAE,aAAa,GAC/C,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,OAAO;EAC1D,OAAO,EAAE;EACT,OAAO,EAAE,eAAe,EAAE;EAC1B,aAAa,EAAE,QAAQ,OAAO,EAAE,MAAM,GAAG,KAAA;EACzC,YAAY,GAAG,EAAE,IAAI,GAAG,EAAE,eAAe,GAAG,GAAG,EAAE,SAAS;EAC3D,EAAE;CACH,MAAM,OAAO,IAAI,qBAAqB,OAAO,KAAK,IAAI,IAAI,MAAM,OAAO,EAAE,0BAA0B;AACnG,MAAK,YAAY,SAAS;AACxB,MAAI,cAAc;AAClB,MAAI,IAAI,SAAS,IAAI,OAAO;AAC5B,MAAI,cAAc,KAAK,MAAM;AAC7B,MAAI,2BAA2B;AAC/B,MAAI,QAAQ,UAAU,YAAY,KAAK,QAAQ;AAC1C,MACF,oBAAoB,CACpB,WAAW,IAAI,oBAAoB,CAAC,CACpC,WAAW;AACV,OAAI,cAAc;AAClB,OAAI,IAAI,eAAe;IACvB;AACJ,MAAI,IAAI,eAAe;;AAEzB,uBAAsB,KAAK,MAAM,iBAAiB"}

package/dist/src/tui/tui-stdio-filter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * While pi-tui owns the screen, strip whole-line pino JSON from stdout/stderr.
+ * ANSI chunks must pass through immediately (see runTui).
+ *
+ * Longer-term (openclaw-style): prefer routing logger transports away from stdout when the TUI
+ * is active (e.g. file-only + explicit subsystem tags) instead of patching stdio here.
+ */
+export declare function isLikelyPinoJsonLogLine(line: string): boolean;
+export type TuiStdioFilterHandle = {
+    restore: () => void;
+    /** Restore native stdio writes temporarily (e.g. inherited child process). */
+    pause: () => void;
+    /** Re-apply filtering after `pause()`. */
+    resume: () => void;
+};
+/** Patch process stdout/stderr; call `restore()` before exiting the TUI. */
+export declare function installTuiStdioFilter(): TuiStdioFilterHandle;