@xopcai/xopc 0.0.167 → 0.0.169

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

@@ -1,6 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { openXopcDatabase } from "../../storage/sqlite/connection.js";
+import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
@@ -77,6 +78,12 @@ var EmbeddedBackend = class {
 	get connectionLabel() {
 		return "local embedded";
 	}
+	async getComposerInputHistory() {
+		return listComposerInputHistory();
+	}
+	async recordComposerInputHistory(text) {
+		return appendComposerInputHistory(text).item;
+	}
 	start() {
 		if (this.running) return;
 		this.running = true;
@@ -122,6 +129,7 @@ var EmbeddedBackend = class {
 		}
 	}
 	async createAgent(config, sessionIndex) {
+		await this.refreshXopcCloudModels();
 		const { AgentService } = await import("../../agent/service.js");
 		const workspace = this.workspace || getWorkspacePath(config);
 		const modelId = getAgentDefaultModelRef(config);
@@ -143,6 +151,20 @@ var EmbeddedBackend = class {
 		await agent.start();
 		return agent;
 	}
+	async refreshXopcCloudModels() {
+		try {
+			const { XopcCloudModelSource } = await import("../../providers/xopc-cloud-model-source.js");
+			const result = await new XopcCloudModelSource().refresh();
+			if (result.status === "updated") log.info({ modelCount: result.modelCount }, `XOPC Cloud model catalog refreshed: ${result.modelCount} models`);
+		} catch (err) {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			log.warn({
+				err,
+				errorMessage,
+				phase: "model_catalog_refresh"
+			}, `XOPC Cloud model catalog refresh failed: ${errorMessage}`);
+		}
+	}
 	stop() {
 		this.running = false;
 		this.chatAbort?.abort();
@@ -419,9 +441,10 @@ var EmbeddedBackend = class {
 		}
 	}
 	async getSessionStats(sessionKey) {
-		if (!this.agent) return computeTuiSessionStats([]);
+		const store = this.agent?.sessionStore ?? this.sessionIndex?.getStore();
+		if (!store) return computeTuiSessionStats([]);
 		try {
-			return computeTuiSessionStats(await this.agent.sessionStore.loadTranscriptRows(sessionKey));
+			return computeTuiSessionStats(await store.loadTranscriptRows(sessionKey));
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
@@ -485,9 +508,10 @@ var EmbeddedBackend = class {
 		}
 	}
 	async deleteSession(sessionKey) {
-		if (!this.agent) return { ok: false };
+		const store = this.agent?.sessionStore ?? this.sessionIndex?.getStore();
+		if (!store) return { ok: false };
 		try {
-			return { ok: await this.agent.sessionStore.deleteSession(sessionKey) };
+			return { ok: await store.deleteSession(sessionKey) };
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
@@ -535,6 +559,9 @@ var EmbeddedBackend = class {
 			contextWindow: model.contextWindow
 		}));
 	}
+	async refreshModels() {
+		await this.refreshXopcCloudModels();
+	}
 	async resetSession(sessionKey) {
 		if (!this.agent) return;
 		await this.agent.resetSession(sessionKey);
@@ -542,11 +569,6 @@ var EmbeddedBackend = class {
 	async patchSession(sessionKey, patch) {
 		const agent = await this.ensureAgent();
 		const projectId = typeof patch.projectId === "string" ? patch.projectId.trim() : "";
-		if (projectId) {
-			await this.sessionIndexReady;
-			await this.sessionIndex?.getStore().resolveTranscriptPath(sessionKey);
-			new ProjectService().attachSession(sessionKey, projectId);
-		}
 		const result = await agent.sessionConfig.patch(sessionKey, {
 			model: typeof patch.model === "string" ? patch.model : void 0,
 			thinkingLevel: typeof patch.thinkingLevel === "string" ? patch.thinkingLevel : void 0,
@@ -555,6 +577,28 @@ var EmbeddedBackend = class {
 			workingDirectory: typeof patch.workingDirectory === "string" ? patch.workingDirectory : void 0
 		});
 		if (!result.ok) throw new Error(result.error);
+		if (projectId) {
+			await this.sessionIndexReady;
+			await this.sessionIndex?.getStore().resolveTranscriptPath(sessionKey);
+			new ProjectService().attachSession(sessionKey, projectId);
+		}
+		const hiddenFromSessionList = typeof patch.hiddenFromSessionList === "boolean" ? patch.hiddenFromSessionList : void 0;
+		const customData = patch.customData && typeof patch.customData === "object" && !Array.isArray(patch.customData) ? patch.customData : void 0;
+		if (hiddenFromSessionList !== void 0 || customData !== void 0) {
+			await this.sessionIndexReady;
+			const store = this.sessionIndex?.getStore();
+			if (store) {
+				await store.resolveTranscriptPath(sessionKey);
+				const existing = getSessionMetadata(sessionKey);
+				if (existing && existing.messageCount === 0) await store.updateMetadata(sessionKey, {
+					...hiddenFromSessionList !== void 0 ? { hiddenFromSessionList } : {},
+					...customData ? { customData: {
+						...existing.customData ?? {},
+						...customData
+					} } : {}
+				});
+			}
+		}
 	}
 	async compactSession(sessionKey, options) {
 		if (!this.agent) return {

package/dist/src/tui/backends/gateway-sse-backend.d.ts

@@ -1,6 +1,6 @@
 import type { ExportFormat } from '../../session/types.js';
 import type { SessionTimelineItem } from '../../session/transcript-outline.js';
-import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiStartupResources, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry, TuiWorkflowRunStartRequest, TuiWorkflowRunStartResult, TuiStartupProjectResult } from '../tui-backend.js';
+import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiComposerHistoryItem, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiStartupResources, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry, TuiWorkflowRunStartRequest, TuiWorkflowRunStartResult, TuiStartupProjectResult } from '../tui-backend.js';
 import type { SessionInfo } from '../tui-types.js';
 import type { ReviewContext } from '../../review/review-git.js';
 import { type GatewayCredential } from '../../gateway/credential.js';
@@ -33,6 +33,8 @@ export declare class GatewaySseBackend implements TuiBackend {
     start(): void;
     stop(): void;
     getActiveSignal(): AbortSignal | undefined;
+    getComposerInputHistory(): Promise<TuiComposerHistoryItem[]>;
+    recordComposerInputHistory(text: string): Promise<TuiComposerHistoryItem>;
     sendChat(opts: ChatSendOptions): Promise<{
         runId: string;
     }>;

package/dist/src/tui/backends/gateway-sse-backend.js

@@ -80,6 +80,19 @@ var GatewaySseBackend = class {
 		const signal = this.chatAbort?.signal;
 		return signal && !signal.aborted ? signal : void 0;
 	}
+	async getComposerInputHistory() {
+		const res = await gatewayFetch(this.baseUrl, "/api/composer-history", this.credential);
+		if (!res.ok) throw new Error(`Failed to load composer history (${res.status})`);
+		return (await res.json()).items ?? [];
+	}
+	async recordComposerInputHistory(text) {
+		const res = await gatewayFetch(this.baseUrl, "/api/composer-history", this.credential, {
+			method: "POST",
+			body: JSON.stringify({ text })
+		});
+		if (!res.ok) throw new Error(`Failed to save composer history (${res.status})`);
+		return (await res.json()).item;
+	}
 	async sendChat(opts) {
 		this.chatAbort?.abort();
 		this.chatAbort = new AbortController();
@@ -793,13 +806,20 @@ var GatewaySseBackend = class {
 		const json = await res.json().catch(() => ({}));
 		if (!res.ok || json.ok === false) throw new Error(json.error ?? `Session config patch failed (${res.status})`);
 		const projectId = typeof patch.projectId === "string" ? patch.projectId.trim() : "";
-		if (projectId) {
+		const hiddenFromSessionList = typeof patch.hiddenFromSessionList === "boolean" ? patch.hiddenFromSessionList : void 0;
+		const customData = patch.customData && typeof patch.customData === "object" && !Array.isArray(patch.customData) ? patch.customData : void 0;
+		if (projectId || hiddenFromSessionList !== void 0 || customData !== void 0) {
+			const metadataPatch = {
+				...projectId ? { projectId } : {},
+				...hiddenFromSessionList !== void 0 ? { hiddenFromSessionList } : {},
+				...customData ? { customData } : {}
+			};
 			const metaRes = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}`, this.credential, {
 				method: "PATCH",
-				body: JSON.stringify({ projectId })
+				body: JSON.stringify(metadataPatch)
 			});
 			const metaJson = await metaRes.json().catch(() => ({}));
-			if (!metaRes.ok || metaJson.ok === false) throw new Error(metaJson.error ?? `Session project patch failed (${metaRes.status})`);
+			if (!metaRes.ok || metaJson.ok === false) throw new Error(metaJson.error ?? `Session metadata patch failed (${metaRes.status})`);
 		}
 	}
 	async renameSession(sessionKey, name) {

package/dist/src/tui/components/custom-editor.d.ts

@@ -13,5 +13,6 @@ export declare class CustomEditor extends Editor {
     onExtensionShortcut?: (data: string) => boolean;
     constructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: EditorOptions);
     onAction(action: XopcTuiAppKeybinding, handler: () => void): void;
+    replaceHistory(itemsNewestFirst: string[]): void;
     handleInput(data: string): void;
 }

package/dist/src/tui/components/custom-editor.js

@@ -18,6 +18,12 @@ var CustomEditor = class extends Editor {
 	onAction(action, handler) {
 		this.actionHandlers.set(action, handler);
 	}
+	replaceHistory(itemsNewestFirst) {
+		const internals = this;
+		internals.history = itemsNewestFirst.slice(0, 100);
+		internals.historyIndex = -1;
+		internals.historyDraft = "";
+	}
 	handleInput(data) {
 		if (this.onExtensionShortcut?.(data)) return;
 		if (this.keybindings.matches(data, "app.clipboard.pasteImage")) {

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

@@ -25,6 +25,11 @@ export interface TuiEvent {
     data: unknown;
     source?: TuiEventSource;
 }
+export interface TuiComposerHistoryItem {
+    id: number;
+    text: string;
+    createdAt: number;
+}
 /** Minimal session list item. */
 export interface TuiSessionItem {
     key: string;
@@ -180,6 +185,10 @@ export interface TuiBackend {
     stop(): void;
     /** Current active chat abort signal, if a run is in progress. */
     getActiveSignal?(): AbortSignal | undefined;
+    /** Global composer history, shared across sessions and clients. */
+    getComposerInputHistory(): Promise<TuiComposerHistoryItem[]>;
+    /** Persist one submitted chat input. */
+    recordComposerInputHistory(text: string): Promise<TuiComposerHistoryItem>;
     /** Send a chat message, returns the run id. */
     sendChat(opts: ChatSendOptions): Promise<{
         runId: string;
@@ -255,6 +264,8 @@ export interface TuiBackend {
     getSessionInfo(sessionKey: string): Promise<SessionInfo>;
     /** List available models. */
     listModels(): Promise<TuiModelChoice[]>;
+    /** Refresh dynamic model catalogs after credentials change. */
+    refreshModels?(): Promise<void>;
     /** Reset / create new session. */
     resetSession(sessionKey: string): Promise<void>;
     /** Rename session display name. */

package/dist/src/tui/tui-empty-session-cleanup.d.ts

@@ -0,0 +1,11 @@
+import type { TuiBackend } from './tui-backend.js';
+export declare const GENERATED_TUI_SESSION_SHELL_PATCH: {
+    readonly hiddenFromSessionList: true;
+    readonly customData: {
+        readonly genericNewChatShell: true;
+    };
+};
+export declare function isGeneratedTuiSessionKey(sessionKey: string): boolean;
+export declare function deleteGeneratedTuiSessionIfEmpty(client: Pick<TuiBackend, 'getSessionStats' | 'deleteSession'>, sessionKey: string): Promise<boolean>;
+export declare function cleanupAbandonedTuiSessions(client: Pick<TuiBackend, 'listSessions' | 'getSessionStats' | 'deleteSession'>, currentSessionKey: string, nowMs?: number): Promise<string[]>;
+export declare function hideLegacyEmptyTuiSessions(client: Pick<TuiBackend, 'listSessions' | 'patchSession'>): Promise<string[]>;

package/dist/src/tui/tui-empty-session-cleanup.js

@@ -0,0 +1,37 @@
+import { parseAgentSessionKey } from "../routing/session-key-utils.js";
+import { init_agent_session_key } from "../routing/agent-session-key.js";
+//#region src/tui/tui-empty-session-cleanup.ts
+init_agent_session_key();
+const GENERATED_TUI_SUFFIX_RE = /^tui-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const ABANDONED_SESSION_AGE_MS = 60 * 6e4;
+const GENERATED_TUI_SESSION_SHELL_PATCH = {
+	hiddenFromSessionList: true,
+	customData: { genericNewChatShell: true }
+};
+function isGeneratedTuiSessionKey(sessionKey) {
+	const parsed = parseAgentSessionKey(sessionKey);
+	return parsed ? GENERATED_TUI_SUFFIX_RE.test(parsed.rest) : false;
+}
+async function deleteGeneratedTuiSessionIfEmpty(client, sessionKey) {
+	if (!isGeneratedTuiSessionKey(sessionKey)) return false;
+	if ((await client.getSessionStats(sessionKey)).totalMessages > 0) return false;
+	return (await client.deleteSession(sessionKey)).ok;
+}
+async function cleanupAbandonedTuiSessions(client, currentSessionKey, nowMs = Date.now()) {
+	const candidates = (await client.listSessions()).filter((session) => session.key !== currentSessionKey && session.messageCount === 0 && typeof session.updatedAt === "number" && session.updatedAt <= nowMs - ABANDONED_SESSION_AGE_MS && isGeneratedTuiSessionKey(session.key));
+	const deleted = [];
+	for (const session of candidates) if (await deleteGeneratedTuiSessionIfEmpty(client, session.key)) deleted.push(session.key);
+	return deleted;
+}
+async function hideLegacyEmptyTuiSessions(client) {
+	const sessions = await client.listSessions();
+	const hidden = [];
+	for (const session of sessions) {
+		if (session.messageCount !== 0 || !isGeneratedTuiSessionKey(session.key)) continue;
+		await client.patchSession(session.key, GENERATED_TUI_SESSION_SHELL_PATCH);
+		hidden.push(session.key);
+	}
+	return hidden;
+}
+//#endregion
+export { GENERATED_TUI_SESSION_SHELL_PATCH, cleanupAbandonedTuiSessions, deleteGeneratedTuiSessionIfEmpty, hideLegacyEmptyTuiSessions, isGeneratedTuiSessionKey };

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

@@ -7,6 +7,7 @@ export declare function createEditorSubmitHandler(params: {
         setText: (value: string) => void;
         addToHistory: (value: string) => void;
     };
+    recordChatHistory?: (value: string) => void;
     handleCommand: (value: string) => void | Promise<void>;
     sendMessage: (value: string) => void | Promise<void>;
     handleBangLine: (value: string) => void | Promise<void>;

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

@@ -36,7 +36,7 @@ function createEditorSubmitHandler(params) {
 			params.handleBangLine(raw);
 			return;
 		}
-		params.editor.addToHistory(value);
+		if (rawTrimmed) (params.recordChatHistory ?? params.editor.addToHistory)(rawTrimmed);
 		if (value.startsWith("/")) {
 			params.handleCommand(value);
 			return;

package/dist/src/tui/tui.js

@@ -27,6 +27,7 @@ import { transcriptTreeEntryIdToRowNumber } from "./tui-transcript-tree.js";
 import { formatTuiCompactionResult, formatTuiShareResult } from "./tui-command-formatters.js";
 import { formatTuiStartupText } from "./tui-startup-text.js";
 import { createTuiCommandHandler, getSlashCommands } from "./tui-commands.js";
+import { GENERATED_TUI_SESSION_SHELL_PATCH, cleanupAbandonedTuiSessions, deleteGeneratedTuiSessionIfEmpty, hideLegacyEmptyTuiSessions, isGeneratedTuiSessionKey } from "./tui-empty-session-cleanup.js";
 import { extensionCustomMessageContentToText, extensionCustomMessageToTurnText, extensionUserMessageContentToText } from "./tui-extension-user-message.js";
 import { resolveFdPath } from "./tui-fd-path.js";
 import { drainFollowUpQueue, restoreQueuedMessages } from "./tui-follow-up-queue.js";
@@ -197,6 +198,9 @@ async function runTui(opts) {
 	let tuiSettings = loadTuiSettings();
 	initTuiTheme({ themeId: opts.theme ?? tuiSettings.theme });
 	const state = createInitialState(startup.sessionKey);
+	const generatedStartupSessionKey = !opts.session?.trim() && isGeneratedTuiSessionKey(startup.sessionKey) ? startup.sessionKey : null;
+	const generatedStartupSessionKeys = new Set(generatedStartupSessionKey ? [generatedStartupSessionKey] : []);
+	let startupSessionHadUserTurn = false;
 	const startupWorkingDirectory = resolveStartupWorkingDirectory(opts, isLocalMode);
 	const implicitTrustedWorkspace = startupWorkingDirectory ?? (isLocalMode ? process.cwd() : void 0);
 	const projectTrustStore = new ProjectTrustStore();
@@ -356,6 +360,7 @@ async function runTui(opts) {
 		paddingX: tuiSettings.editorPaddingX,
 		autocompleteMaxVisible: tuiSettings.autocompleteMaxVisible
 	});
+	let composerHistoryTexts = [];
 	let editor = defaultEditor;
 	let editorComponentFactory;
 	const editorContainer = new Container();
@@ -417,6 +422,7 @@ async function runTui(opts) {
 			nextEditor.setAutocompleteProvider?.(extensionRuntime.autocompleteProvider);
 			copyDefaultEditorAppHandlers(nextEditor);
 			editor = nextEditor;
+			for (const text of composerHistoryTexts.slice().reverse()) editor.addToHistory?.(text);
 		} else {
 			defaultEditor.setText(currentText);
 			editor = defaultEditor;
@@ -947,14 +953,21 @@ async function runTui(opts) {
 			clearInterval(streamWatchdogId);
 			streamWatchdogId = null;
 		}
-		client.stop();
 		tui.terminal.setProgress(false);
-		drainAndStopTuiSafely(tui).then(() => {
+		(async () => {
+			const removedEmptyStartupSessions = /* @__PURE__ */ new Set();
+			if (!state.activeRunId) for (const sessionKey of generatedStartupSessionKeys) {
+				if (sessionKey === state.currentSessionKey && startupSessionHadUserTurn) continue;
+				if (await deleteGeneratedTuiSessionIfEmpty(client, sessionKey).catch(() => false)) removedEmptyStartupSessions.add(sessionKey);
+			}
+			client.stop();
+			await drainAndStopTuiSafely(tui);
 			restoreStdio();
-			if (options?.showResumeHint !== false) process.stdout.write(`\nTo resume this session: ${formatTuiResumeCommand(opts, state.currentSessionKey)}\n`);
+			const currentSessionWasRemoved = removedEmptyStartupSessions.has(state.currentSessionKey);
+			if (options?.showResumeHint !== false && !currentSessionWasRemoved) process.stdout.write(`\nTo resume this session: ${formatTuiResumeCommand(opts, state.currentSessionKey)}\n`);
 			finishTui?.();
 			process.exit(0);
-		});
+		})();
 	};
 	const { refreshSessionInfo, loadHistory: loadSessionHistory, loadHistoryWindow, setSession, abortActive, resetCurrentSession, clearChatForSessionSwitch } = createSessionActions({
 		client,
@@ -1001,7 +1014,10 @@ async function runTui(opts) {
 	const applyStartupWorkingDirectory = async () => {
 		if (startupWorkingDirectoryApplied || !startupWorkingDirectory) return;
 		startupWorkingDirectoryApplied = true;
-		await client.patchSession(state.currentSessionKey, { workingDirectory: startupWorkingDirectory });
+		await client.patchSession(state.currentSessionKey, {
+			workingDirectory: startupWorkingDirectory,
+			...isGeneratedTuiSessionKey(state.currentSessionKey) ? GENERATED_TUI_SESSION_SHELL_PATCH : {}
+		});
 		state.sessionInfo.effectiveWorkspacePath = startupWorkingDirectory;
 		state.sessionInfo.workingDirectoryLocked = true;
 	};
@@ -1018,15 +1034,22 @@ async function runTui(opts) {
 		const projectAgentId = result.project.defaultAgentId?.trim() ? normalizeAgentId(result.project.defaultAgentId) : void 0;
 		const currentParsed = parseAgentSessionKey(state.currentSessionKey);
 		if (!opts.agentId?.trim() && currentParsed?.rest && projectAgentId && projectAgentId !== currentAgentId) {
-			await setSession(`agent:${projectAgentId}:${currentParsed.rest}`);
+			const targetSessionKey = `agent:${projectAgentId}:${currentParsed.rest}`;
+			await setSession(targetSessionKey);
+			if (isGeneratedTuiSessionKey(targetSessionKey)) generatedStartupSessionKeys.add(targetSessionKey);
 			currentAgentId = projectAgentId;
+			if (isGeneratedTuiSessionKey(state.currentSessionKey)) await client.patchSession(state.currentSessionKey, GENERATED_TUI_SESSION_SHELL_PATCH);
 			await client.patchSession(state.currentSessionKey, {
 				projectId: result.project.id,
-				workingDirectory: startupWorkingDirectory
+				workingDirectory: startupWorkingDirectory,
+				...isGeneratedTuiSessionKey(state.currentSessionKey) ? GENERATED_TUI_SESSION_SHELL_PATCH : {}
 			});
 			state.sessionInfo.effectiveWorkspacePath = startupWorkingDirectory;
 			state.sessionInfo.workingDirectoryLocked = true;
-		} else await client.patchSession(state.currentSessionKey, { projectId: result.project.id });
+		} else await client.patchSession(state.currentSessionKey, {
+			projectId: result.project.id,
+			...isGeneratedTuiSessionKey(state.currentSessionKey) ? GENERATED_TUI_SESSION_SHELL_PATCH : {}
+		});
 		const verb = result.created ? "Created project" : "Using project";
 		chatLog.addStatus(theme.dim(`${verb}: ${result.project.name}`));
 	};
@@ -1458,6 +1481,7 @@ async function runTui(opts) {
 			return;
 		}
 		chatLog.addUser(userDisplayContentForAttachments(text, attachments));
+		startupSessionHadUserTurn = true;
 		sessionSnapshot.appendMessage("user", messageText);
 		lastRetryMessageText = messageText;
 		markRunSending(state);
@@ -1682,14 +1706,18 @@ async function runTui(opts) {
 			getEntry: () => projectTrustStore.getEntry(process.cwd()),
 			getSessionDecision: () => projectTrustSessionDecision
 		},
-		runLogin: (provider) => runTuiOAuthLogin(provider, {
-			chatLog,
-			tui,
-			editor,
-			openOverlay: openCommandOverlay,
-			closeOverlay: closeCommandOverlay,
-			keybindings
-		})
+		runLogin: async (provider) => {
+			await runTuiOAuthLogin(provider, {
+				chatLog,
+				tui,
+				editor,
+				openOverlay: openCommandOverlay,
+				closeOverlay: closeCommandOverlay,
+				keybindings
+			});
+			await client.refreshModels?.();
+			await refreshModelChoices();
+		}
 	});
 	const { runLocalShellLine } = createLocalShellRunner({
 		chatLog,
@@ -1736,12 +1764,48 @@ async function runTui(opts) {
 		updateFooter();
 		tui.requestRender();
 	};
+	let composerHistory = [];
+	let composerHistoryWriteQueue = Promise.resolve();
+	const applyComposerHistory = (next) => {
+		composerHistory = next.slice(0, 100);
+		composerHistoryTexts = composerHistory.map((item) => item.text);
+		if (editor === defaultEditor) {
+			defaultEditor.replaceHistory(composerHistory.map((item) => item.text));
+			return;
+		}
+		for (const item of composerHistory.slice().reverse()) editor.addToHistory?.(item.text);
+	};
+	const refreshComposerHistory = async () => {
+		try {
+			await composerHistoryWriteQueue;
+			applyComposerHistory(await client.getComposerInputHistory());
+		} catch {}
+	};
+	const recordChatHistory = (value) => {
+		const text = value.trim();
+		if (!text) return;
+		editor.addToHistory?.(text);
+		if (composerHistory[0]?.text !== text) {
+			composerHistory = [{
+				id: 0,
+				text,
+				createdAt: Date.now()
+			}, ...composerHistory].slice(0, 100);
+			composerHistoryTexts = composerHistory.map((item) => item.text);
+		}
+		composerHistoryWriteQueue = composerHistoryWriteQueue.then(async () => {
+			const item = await client.recordComposerInputHistory(text);
+			const optimisticIndex = composerHistory.findIndex((entry) => entry.id === 0 && entry.text === item.text);
+			if (optimisticIndex >= 0) composerHistory[optimisticIndex] = item;
+		}).catch(() => {});
+	};
 	const submitBurst = createSubmitBurstCoalescer({
 		submit: createEditorSubmitHandler({
 			editor: {
 				setText: (value) => editor.setText(value),
 				addToHistory: (value) => editor.addToHistory?.(value)
 			},
+			recordChatHistory: (value) => recordChatHistory(value),
 			handleCommand,
 			sendMessage,
 			handleBangLine: runLocalShellLine,
@@ -1772,7 +1836,7 @@ async function runTui(opts) {
 				tui.requestRender();
 				return;
 			}
-			editor.addToHistory(text);
+			recordChatHistory(text);
 			state.messageFollowUpQueue.push(text);
 			editor.setText("");
 			chatLog.addSystem(theme.dim(`Queued follow-up (${state.messageFollowUpQueue.length} in queue). ${tuiSettings.followUpMode === "all" ? "All queued messages send together when this reply finishes." : "Next sends when this reply finishes."}`));
@@ -2026,6 +2090,23 @@ async function runTui(opts) {
 	};
 	client.onEvent = (evt) => {
 		const data = evt.data ?? {};
+		if (evt.event === "composer-history.appended") {
+			const item = data;
+			if (typeof item.text === "string" && typeof item.id === "number") {
+				const optimisticIndex = composerHistory.findIndex((entry) => entry.id === 0 && entry.text === item.text);
+				if (optimisticIndex >= 0) composerHistory[optimisticIndex] = item;
+				else if (composerHistory[0]?.text !== item.text) {
+					composerHistory = [item, ...composerHistory].slice(0, 100);
+					composerHistoryTexts = composerHistory.map((entry) => entry.text);
+					editor.addToHistory?.(item.text);
+				} else composerHistory[0] = item;
+			}
+			return;
+		}
+		if (evt.event === "composer-history.cleared") {
+			applyComposerHistory([]);
+			return;
+		}
 		if (evt.event === "workflow.run.updated" && handleWorkflowRunUpdated(data)) return;
 		dispatchAgentEvent(evt.event, data, state, chatLog, tui, setActivityStatus, touchStreamingActivity, onAgentRunEnded, (message) => sessionSnapshot.appendMessage("assistant", assistantMessagePlainText(message)), evt.source);
 	};
@@ -2035,6 +2116,7 @@ async function runTui(opts) {
 		setConnectionStatus(isLocalMode ? "local ready" : "gateway connected");
 		touchStreamingActivity();
 		(async () => {
+			await refreshComposerHistory();
 			if (opts.openSessionPickerOnStart && !startupSessionPickerOpened) {
 				startupSessionPickerOpened = true;
 				await openSessionPickerOverlay(pickerSvc, {
@@ -2064,6 +2146,7 @@ async function runTui(opts) {
 			await refreshSessionInfoWithBorder();
 			await refreshModelChoices();
 			await loadSessionHistory({ merge: true });
+			cleanupAbandonedTuiSessions(client, state.currentSessionKey).then(() => hideLegacyEmptyTuiSessions(client)).catch(() => {});
 			showStartupCardOnce();
 			refreshStartupResources().then(() => {
 				updateFooter();
@@ -2098,6 +2181,7 @@ async function runTui(opts) {
 		setConnectionStatus(`event gap: expected ${info.expected}, got ${info.received}`);
 		if (state.activeRunId) recoverActiveRunFromHistory("broadcast event gap");
 		else loadSessionHistory({ merge: true });
+		refreshComposerHistory();
 		tui.requestRender();
 	};
 	const sigintHandler = () => handleCtrlC();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.167",
+  "version": "0.0.169",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",