@xopcai/xopc 0.0.27 → 0.0.29

package/dist/src/tui/tui-agent-events.js

@@ -0,0 +1,103 @@
+//#region src/tui/tui-agent-events.ts
+const pendingToolCallIds = /* @__PURE__ */ new Map();
+function clearPendingToolCallIds() {
+	pendingToolCallIds.clear();
+}
+const STREAM_TOUCH_EVENTS = new Set([
+	"status",
+	"token",
+	"thinking",
+	"tool_start",
+	"tool_end",
+	"progress"
+]);
+function dispatchAgentSSE(event, data, state, chatLog, assembler, tui, setActivityStatus, touchStreamingActivity) {
+	if (STREAM_TOUCH_EVENTS.has(event)) touchStreamingActivity?.();
+	const runId = state.activeRunId ?? "default";
+	switch (event) {
+		case "status":
+			state.activeRunId = typeof data.runId === "string" ? data.runId : runId;
+			setActivityStatus("waiting");
+			break;
+		case "token": {
+			const content = typeof data.content === "string" ? data.content : typeof data.delta === "string" ? data.delta : typeof data.text === "string" ? data.text : "";
+			if (!content) break;
+			setActivityStatus("streaming");
+			const display = assembler.ingestToken(runId, content, state.showThinking);
+			if (display !== null) {
+				chatLog.updateAssistant(display, runId);
+				tui.requestRender();
+			}
+			break;
+		}
+		case "thinking": {
+			const thinkContent = String(data.content ?? "");
+			const isDelta = Boolean(data.delta);
+			if (data.status === "started") break;
+			setActivityStatus("streaming");
+			const display = assembler.ingestThinking(runId, thinkContent, isDelta, state.showThinking);
+			if (display !== null) {
+				chatLog.updateAssistant(display, runId);
+				tui.requestRender();
+			}
+			break;
+		}
+		case "thinking_end":
+		case "message_end": break;
+		case "tool_start": {
+			const toolName = String(data.toolName ?? "unknown");
+			const toolCallId = String(data.toolCallId || crypto.randomUUID());
+			const stack = pendingToolCallIds.get(toolName) ?? [];
+			stack.push(toolCallId);
+			pendingToolCallIds.set(toolName, stack);
+			setActivityStatus("running");
+			chatLog.startTool(toolCallId, toolName, data.args, runId);
+			tui.requestRender();
+			break;
+		}
+		case "tool_end": {
+			const toolName = String(data.toolName ?? "");
+			let toolCallId = typeof data.toolCallId === "string" && data.toolCallId ? data.toolCallId : "";
+			if (!toolCallId && toolName) {
+				const stack = pendingToolCallIds.get(toolName);
+				if (stack && stack.length > 0) {
+					toolCallId = stack.shift();
+					if (stack.length === 0) pendingToolCallIds.delete(toolName);
+				}
+			}
+			const resultText = String(data.result ?? "");
+			const isError = Boolean(data.isError);
+			if (toolCallId) chatLog.updateToolResult(toolCallId, resultText, isError);
+			setActivityStatus("streaming");
+			tui.requestRender();
+			break;
+		}
+		case "error": {
+			const errorContent = String(data.content ?? "Unknown error");
+			const finalText = assembler.finalize(runId, state.showThinking);
+			if (finalText) chatLog.finalizeAssistant(finalText, runId);
+			chatLog.addSystem(`❌ ${errorContent}`);
+			state.activeRunId = null;
+			setActivityStatus("idle");
+			tui.requestRender();
+			break;
+		}
+		case "result": {
+			const finalText = assembler.finalize(runId, state.showThinking);
+			if (finalText) chatLog.finalizeAssistant(finalText, runId);
+			state.activeRunId = null;
+			setActivityStatus("idle");
+			tui.requestRender();
+			break;
+		}
+		case "progress":
+			setActivityStatus("running");
+			break;
+		default: break;
+	}
+}
+const DEFAULT_STREAMING_WATCHDOG_MS = 3e4;
+//#endregion
+export { DEFAULT_STREAMING_WATCHDOG_MS, clearPendingToolCallIds, dispatchAgentSSE };
+
+//# sourceMappingURL=tui-agent-events.js.map

package/dist/src/tui/tui-agent-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-agent-events.js","names":[],"sources":["../../../src/tui/tui-agent-events.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\nconst pendingToolCallIds = new Map<string, string[]>();\n\nexport function clearPendingToolCallIds(): void {\n  pendingToolCallIds.clear();\n}\n\nconst STREAM_TOUCH_EVENTS = new Set([\n  'status',\n  'token',\n  'thinking',\n  'tool_start',\n  'tool_end',\n  'progress',\n]);\n\nexport function dispatchAgentSSE(\n  event: string,\n  data: Record<string, unknown>,\n  state: TuiState,\n  chatLog: ChatLog,\n  assembler: StreamAssembler,\n  tui: TUI,\n  setActivityStatus: (status: string) => void,\n  touchStreamingActivity?: () => void,\n): void {\n  if (STREAM_TOUCH_EVENTS.has(event)) {\n    touchStreamingActivity?.();\n  }\n\n  const runId = state.activeRunId ?? 'default';\n\n  switch (event) {\n    case 'status': {\n      const newRunId = typeof data.runId === 'string' ? data.runId : runId;\n      state.activeRunId = newRunId;\n      setActivityStatus('waiting');\n      break;\n    }\n    case 'token': {\n      const content =\n        typeof data.content === 'string'\n          ? data.content\n          : typeof data.delta === 'string'\n            ? data.delta\n            : typeof data.text === 'string'\n              ? data.text\n              : '';\n      if (!content) break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestToken(runId, content, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking': {\n      const thinkContent = String(data.content ?? '');\n      const isDelta = Boolean(data.delta);\n      if (data.status === 'started') break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestThinking(runId, thinkContent, isDelta, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking_end':\n    case 'message_end':\n      break;\n    case 'tool_start': {\n      const toolName = String(data.toolName ?? 'unknown');\n      const toolCallId = String(data.toolCallId || crypto.randomUUID());\n      const stack = pendingToolCallIds.get(toolName) ?? [];\n      stack.push(toolCallId);\n      pendingToolCallIds.set(toolName, stack);\n      setActivityStatus('running');\n      chatLog.startTool(toolCallId, toolName, data.args, runId);\n      tui.requestRender();\n      break;\n    }\n    case 'tool_end': {\n      const toolName = String(data.toolName ?? '');\n      let toolCallId = typeof data.toolCallId === 'string' && data.toolCallId ? data.toolCallId : '';\n      if (!toolCallId && toolName) {\n        const stack = pendingToolCallIds.get(toolName);\n        if (stack && stack.length > 0) {\n          toolCallId = stack.shift()!;\n          if (stack.length === 0) pendingToolCallIds.delete(toolName);\n        }\n      }\n      const resultText = String(data.result ?? '');\n      const isError = Boolean(data.isError);\n      if (toolCallId) {\n        chatLog.updateToolResult(toolCallId, resultText, isError);\n      }\n      setActivityStatus('streaming');\n      tui.requestRender();\n      break;\n    }\n    case 'error': {\n      const errorContent = String(data.content ?? 'Unknown error');\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      chatLog.addSystem(`❌ ${errorContent}`);\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      tui.requestRender();\n      break;\n    }\n    case 'result': {\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      tui.requestRender();\n      break;\n    }\n    case 'progress': {\n      setActivityStatus('running');\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nexport const DEFAULT_STREAMING_WATCHDOG_MS = 30_000;\n"],"mappings":"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"}

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

@@ -0,0 +1,80 @@
+import type { ClientHistoryMessage } from '../session/client-history.js';
+import type { SessionInfo } from './tui-types.js';
+/** Options for sending a chat message. */
+export interface ChatSendOptions {
+    sessionKey: string;
+    message: string;
+    thinking?: string;
+}
+/** SSE event from the agent stream or broadcast channel. */
+export interface TuiEvent {
+    event: string;
+    data: unknown;
+}
+/** Minimal session list item. */
+export interface TuiSessionItem {
+    key: string;
+    updatedAt?: number | null;
+    model?: string | null;
+    totalTokens?: number | null;
+    displayName?: string;
+}
+/** Model choice for the selector overlay. */
+export interface TuiModelChoice {
+    id: string;
+    name: string;
+    provider: string;
+}
+/**
+ * Abstraction over the gateway (SSE) or embedded agent backend.
+ *
+ * Both implementations expose the same surface so the TUI core stays
+ * transport-agnostic.
+ */
+export interface TuiBackend {
+    /** Connection metadata (for header display). */
+    readonly connectionLabel: string;
+    /** Lifecycle callbacks wired by the TUI. */
+    onEvent?: (evt: TuiEvent) => void;
+    onConnected?: () => void;
+    onDisconnected?: (reason: string) => void;
+    /** Broadcast SSE sequence gap (if the gateway emits `gap` events). */
+    onGap?: (info: {
+        expected: number;
+        received: number;
+    }) => void;
+    /** Start the backend (open SSE streams / start agent service). */
+    start(): void;
+    /** Stop the backend. */
+    stop(): void;
+    /** Send a chat message, returns the run id. */
+    sendChat(opts: ChatSendOptions): Promise<{
+        runId: string;
+    }>;
+    /** Abort an active run. */
+    abortChat(opts: {
+        sessionKey: string;
+        runId: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    /** Load chat history for a session. */
+    loadHistory(opts: {
+        sessionKey: string;
+        limit?: number;
+    }): Promise<{
+        messages: HistoryMessage[];
+    }>;
+    /** List sessions. */
+    listSessions(): Promise<TuiSessionItem[]>;
+    /** Fetch session info (model, tokens, thinking). */
+    getSessionInfo(sessionKey: string): Promise<SessionInfo>;
+    /** List available models. */
+    listModels(): Promise<TuiModelChoice[]>;
+    /** Reset / create new session. */
+    resetSession(sessionKey: string): Promise<void>;
+    /** Patch session settings (e.g. model). */
+    patchSession(sessionKey: string, patch: Record<string, unknown>): Promise<void>;
+}
+/** A single message in chat history (aligned with `ClientHistoryMessage`). */
+export type HistoryMessage = ClientHistoryMessage;

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,23 @@
+import type { TUI } from '@mariozechner/pi-tui';
+import type { ChatLog } from './components/chat-log.js';
+import type { StreamAssembler } from './stream-assembler.js';
+import type { TuiState } from './tui-types.js';
+interface SlashCommandDef {
+    name: string;
+    description: string;
+}
+export declare function getSlashCommands(_isLocal: boolean): SlashCommandDef[];
+export declare function formatTuiHelpText(isLocal: boolean): string;
+export type CommandHandlerDeps = {
+    state: TuiState;
+    chatLog: ChatLog;
+    tui: TUI;
+    assembler: StreamAssembler;
+    isLocalMode: boolean;
+    abortActive: () => Promise<void>;
+    sendMessage: (text: string) => void;
+    requestExit: () => void;
+    updateFooter: () => void;
+};
+export declare function createTuiCommandHandler(deps: CommandHandlerDeps): (input: string) => void;
+export {};

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 {};