@aiwayds/dsh-tui-pi 2.19.0 → 2.20.0

package/lib/index.js

@@ -12,6 +12,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { hardExit } from "./hard-exit.js";
 /** Mirrors dsh-skill's bundled-skill rank (a non-load-bearing ordering hint;
  *  the constant is hardcoded there too). Local copy — see the type-import
  *  note above for why dsh-skill is not loaded at runtime here. */
@@ -27,7 +28,8 @@ import { AGENT_TICK_MS, LiveWidgets } from "./live-widgets.js";
 import { displayPermissionPreset } from "./permission.js";
 import { pickEffort, pickModel, pickPermission, pickPreset, pickTheme } from "./selectors.js";
 import { DshSessionBridge, persistDefaultModel, stashSessionIdForReload, takeStashedSessionId } from "./session.js";
-import { currentCacheHitMode, currentRememberPreset, currentThemePreference, readAskUserExplicit, readFooterHintsPreference, readIconSetPreference, readPanelHeightPreference, readRememberPreset, readSessionManagementExplicit, readSubagentLimits, readThemePreference, registerThemeSettings, writeThemePreference, } from "./theme-settings.js";
+import { currentCacheHitMode, currentRememberPreset, currentThemePreference, readAskUserExplicit, readFooterHintsPreference, readIconSetPreference, readLanguagePreference, readPanelHeightPreference, readRememberPreset, readSessionManagementExplicit, readSubagentLimits, readThemePreference, registerThemeSettings, writeLanguagePreference, writeThemePreference, } from "./theme-settings.js";
+import { currentLocale, initI18n, listLocales, setLocale, t } from "./i18n/index.js";
 import { loadWorkspacePresets, rememberedPresetFor, saveWorkspacePresets, withRememberedPreset, workspacePresetsPath, } from "./workspace-presets.js";
 import { applyIconSet, resolveIconSet, stopIcon } from "./icons.js";
 import { readAgentMaxRounds } from "./agent-runtime.js";
@@ -52,9 +54,9 @@ import { openSubagentViewer } from "./subagent-viewer.js";
 import { openHistoryBrowser } from "./history.js";
 import { openForkAtTurnDialog } from "./history-fork.js";
 import { commandUsagePath, CommandUsageTracker } from "./usage.js";
-import { buildUserPrompt, decideSubmitPath, deliverToAgent, promotePending, removeFromInbox, STEER_UNAVAILABLE_NOTICE, TURN_ENDED_QUEUED_NOTICE, } from "./steer-flow.js";
+import { buildUserPrompt, decideSubmitPath, deliverToAgent, promotePending, removeFromInbox, steerUnavailableNotice, turnEndedQueuedNotice, } from "./steer-flow.js";
 import { openSubmitRouteDialog } from "./route-dialog.js";
-import { BtwController, BTW_IDLE_NOTICE, BTW_USAGE, buildBtwSnapshot, parseBtwInput, resolveSnapshotLimit, } from "./btw.js";
+import { BtwController, btwIdleNotice, btwUsage, buildBtwSnapshot, parseBtwInput, resolveSnapshotLimit, } from "./btw.js";
 import { BtwOverlayWire } from "./btw-overlay.js";
 import { openPendingQueuePanel } from "./queue-panel.js";
 import { ansiFg, BOLD, RESET, resolveTheme } from "./theme/index.js";
@@ -68,6 +70,7 @@ import { currentPreset, fetchPresetRoster, findPresetByName, formatPresetLabel,
 import { completedTurnSeed, openPresetConfirmDialog, performPresetSwitch } from "./preset-dialog.js";
 import { openStopConfirmDialog } from "./stop-dialog.js";
 import { registerAskUserProvider, resolveAskUserTimeouts } from "./ask-user.js";
+import { askLanguageChoice } from "./language-ask.js";
 import { checkHostSupport } from "./host-version.js";
 export const name = 'dsh-tui-pi';
 /**
@@ -99,7 +102,7 @@ const SKILL_RESOURCE_BASE = {
 };
 const SKILL_INVOCATION = { modelInvocable: true, userInvocable: true };
 /** Routing description; must stay identical to the SKILL.md frontmatter (asserted in tests). */
-const SKILL_DESCRIPTION = 'dsh TUI 增强套件（@aiwayds/dsh-tui-pi）使用与配置指南。凡涉及 TUI 主题/面板/footer、子代理并发与轮数限制、模型收藏与隐藏、会话保留清理与 /resume 过滤、ask_user_question 超时、preset 记忆，或要配置 dsh-tui 段时先读本指南：settings.yaml 顶层 `dsh-tui:` 段 17 键（theme/panelHeight/maxAgents/maxRounds/maxRoundsGrace/disableSubagent/registeredOnly/footerHints/cacheHitMode/iconSet/rememberPreset/favoriteModels/hiddenModels/retention/resume/askUser）、DSH_TUI_* 环境变量、快速上手向导、keybindings.json 与 /hotkeys。触发词：tui、主题、theme、面板、footer、收藏模型、隐藏模型、保留策略、panelHeight、resume、preset。';
+const SKILL_DESCRIPTION = 'dsh TUI 增强套件使用与配置指南。凡涉及 TUI 主题/面板/footer、界面语言、子代理并发与轮数限制、模型收藏与隐藏、会话保留与 /resume 过滤、ask_user 超时、preset 记忆，或要配置 dsh-tui 段时先读本指南：settings.yaml 顶层 `dsh-tui:` 段 18 键（language/theme/panelHeight/maxAgents/maxRounds/maxRoundsGrace/disableSubagent/registeredOnly/footerHints/cacheHitMode/iconSet/rememberPreset/favoriteModels/hiddenModels/retention/resume/askUser）、DSH_TUI_* 环境变量、快速上手向导、keybindings.json 与 /hotkeys。触发词：tui、主题、theme、面板、footer、语言、language、收藏模型、隐藏模型、保留策略、panelHeight、resume、preset。';
 const SKILL_CANDIDATE = {
     name: SKILL_PROVIDER_NAME,
     description: SKILL_DESCRIPTION,
@@ -164,7 +167,7 @@ export function apply(ctx) {
         const check = checkHostSupport();
         if (!check.ok) {
             console.warn(check.message);
-            process.exit(1);
+            hardExit(1);
         }
         if (check.version === undefined) {
             console.warn('[dsh-tui-pi] could not resolve the dsh host version next to the plugin; skipping the host floor check.');
@@ -247,7 +250,8 @@ export function apply(ctx) {
         // setTheme replay that follows already renders at that new height.
         // applyTheme carries the theme-bundle identity guard, so a height-only
         // commit never triggers a second rebuild.
-        registerThemeSettings(ctx, (pref, height, footerHints, iconSet) => {
+        registerThemeSettings(ctx, (pref, height, footerHints, iconSet, language) => {
+            setLocale(language);
             applyPanelHeightRef?.(height);
             applyThemeRef?.(pref);
             applyFooterHintsRef?.(footerHints);
@@ -286,6 +290,12 @@ export function apply(ctx) {
         const themePreference = await readThemePreference(ctx);
         const panelHeight = await readPanelHeightPreference(ctx);
         const footerHints = await readFooterHintsPreference(ctx);
+        // UI language (`dsh-tui.language`, default 'en'): discover the language
+        // files and activate the persisted id BEFORE the TUI's first frame, so
+        // the boot UI speaks it from the start. The registration's watch hook
+        // re-applies later commits live via setLocale. An unknown id degrades to
+        // 'en' inside initI18n.
+        initI18n({ id: await readLanguagePreference(ctx), warn: message => emitNotice(message) });
         // Icon-set self-adaptation: probe the platform once at startup (the
         // memoised snapshot shared with every later 'auto' resolution), resolve
         // the persisted mode against it and push the result into src/icons.ts
@@ -401,7 +411,7 @@ export function apply(ctx) {
                         // so a stray Esc can never kill a running task. The notice keeps
                         // the armed first press from feeling dead and states the
                         // contract explicitly.
-                        renderer.renderNotice('Press Esc again to stop all LLM work', 'info');
+                        renderer.renderNotice(t('tui.esc.armStop'), 'info');
                         break;
                     case 'interrupt-cancel': {
                         // Second Esc while LLM work runs (main turn and/or subagents):
@@ -444,7 +454,7 @@ export function apply(ctx) {
                             void disposeAndExit(0);
                             break;
                         }
-                        renderer.renderNotice(`${stopIcon()} Ctrl+C ×2 — quitting…`, 'info');
+                        renderer.renderNotice(t('tui.esc.quitArmed', { icon: stopIcon() }), 'info');
                         quitConfirmTimer = setTimeout(() => {
                             quitConfirmTimer = undefined;
                             void disposeAndExit(0);
@@ -459,7 +469,7 @@ export function apply(ctx) {
                         if (action.key === 'ctrl-c' && quitConfirmTimer !== undefined) {
                             clearTimeout(quitConfirmTimer);
                             quitConfirmTimer = undefined;
-                            renderer.renderNotice('quit aborted — Ctrl+C was held, not double-pressed', 'info');
+                            renderer.renderNotice(t('tui.esc.quitAborted'), 'info');
                         }
                         break;
                     case 'ctrl-d-quit':
@@ -486,7 +496,7 @@ export function apply(ctx) {
                             onRemove: item => {
                                 const agent = bridge.getAgent();
                                 if (agent === undefined)
-                                    return { kind: 'error', error: 'No active session.' };
+                                    return { kind: 'error', error: t('tui.session.none') };
                                 const result = removeFromInbox(agent.inbox, item);
                                 // Review B1: a successful revoke must retire the transcript
                                 // badge — the echo bubble becomes an explicit canceled line
@@ -499,7 +509,7 @@ export function apply(ctx) {
                             onPromote: item => {
                                 const agent = bridge.getAgent();
                                 if (agent === undefined)
-                                    return { kind: 'error', error: 'No active session.' };
+                                    return { kind: 'error', error: t('tui.session.none') };
                                 const result = promotePending(agent, item);
                                 if (result.kind === 'promoted' && result.degraded) {
                                     // Review S3: the steer degraded back into the queue — flip
@@ -516,7 +526,7 @@ export function apply(ctx) {
                             },
                             onOutcome: (result) => {
                                 if (result.kind === 'promoted' && result.degraded) {
-                                    renderer.renderNotice(STEER_UNAVAILABLE_NOTICE, 'info');
+                                    renderer.renderNotice(steerUnavailableNotice(), 'info');
                                 }
                                 else if (result.kind === 'error') {
                                     renderer.renderNotice(result.error, 'error');
@@ -586,7 +596,7 @@ export function apply(ctx) {
          * dialog's Stop choice (double-Esc) and the first Ctrl+C mid-task.
          */
         const stopTask = async () => {
-            renderer.renderNotice(`${stopIcon()} stopping all LLM work…`, 'info');
+            renderer.renderNotice(t('tui.stop.stopping', { icon: stopIcon() }), 'info');
             // The stop gesture is the everything-stop: side calls die with the turn.
             btwController.cancelAll();
             const cancelled = await bridge.cancelActiveTurn();
@@ -594,7 +604,7 @@ export function apply(ctx) {
             // State raced idle between the decision and the cancel calls — nothing
             // to cancel (e.g. the task settled while the dialog was up).
             if (!cancelled && stoppedChildren === 0)
-                renderer.renderNotice('Nothing running to cancel.', 'info');
+                renderer.renderNotice(t('tui.stop.nothingRunning'), 'info');
         };
         // Arm the settings watch sink now that the renderer exists (see apply()).
         applyThemeRef = (pref) => {
@@ -608,7 +618,7 @@ export function apply(ctx) {
         // Startup notices for a broken/misleading keybindings file — the TUI keeps
         // running with defaults; the panel shows the same warnings via /hotkeys.
         for (const warning of keyBindings.warnings) {
-            renderer.renderNotice(`keybindings: ${warning}`, 'error');
+            renderer.renderNotice(t('tui.keys.warningPrefix', { warning }), 'error');
         }
         // Arm the shared notice sink now that the TUI is up. Every operator
         // trace that fired before this point — the settings-namespace
@@ -663,7 +673,7 @@ export function apply(ctx) {
             agentStatus = status;
             if (status === 'running') {
                 if (loader === undefined) {
-                    loader = new Loader(ui.tui, text => BOLD + ansiFg(ui.theme.palette.accent) + text + RESET, text => BOLD + ansiFg(ui.theme.palette.accent) + text + RESET, 'working…');
+                    loader = new Loader(ui.tui, text => BOLD + ansiFg(ui.theme.palette.accent) + text + RESET, text => BOLD + ansiFg(ui.theme.palette.accent) + text + RESET, t('tui.status.working'));
                     ui.status.addChild(loader);
                     loader.start();
                 }
@@ -738,7 +748,7 @@ export function apply(ctx) {
                 for (const text of bridge.takePendingRemoteFollowups()) {
                     await bridge.prompt(text);
                 }
-                emitNotice('Write lock acquired — follow-ups sent.');
+                emitNotice(t('tui.takeover.writeLock'));
                 ui.requestRender();
             },
         };
@@ -895,7 +905,7 @@ export function apply(ctx) {
             stream: options => {
                 const llm = ctx.get('llm');
                 if (llm === undefined)
-                    throw new Error('LLM service is not available.');
+                    throw new Error(t('tui.btw.noLlm'));
                 return llm.stream({
                     provider: options.provider,
                     model: options.model,
@@ -929,10 +939,10 @@ export function apply(ctx) {
             if (parsed.kind === 'empty') {
                 const opened = btwController.openReview();
                 return opened === 'live'
-                    ? { kind: 'success', text: 'btw — the running answer is back on screen.' }
+                    ? { kind: 'success', text: t('tui.btw.backOnScreen') }
                     : opened === 'review'
-                        ? { kind: 'success', text: 'Last btw exchange shown.' }
-                        : { kind: 'success', text: BTW_USAGE };
+                        ? { kind: 'success', text: t('tui.btw.lastShown') }
+                        : { kind: 'success', text: btwUsage() };
             }
             if (parsed.kind === 'error')
                 return { kind: 'error', text: parsed.error };
@@ -940,7 +950,7 @@ export function apply(ctx) {
             // this must be the live view, not a read-only remote one) — when idle,
             // a normal prompt is strictly better (tools, history, full context).
             if (!(bridge.isRunning() && !bridge.isReadOnlyView())) {
-                return { kind: 'error', text: BTW_IDLE_NOTICE };
+                return { kind: 'error', text: btwIdleNotice() };
             }
             const result = btwController.submit({
                 question: parsed.question,
@@ -948,14 +958,14 @@ export function apply(ctx) {
             });
             switch (result.kind) {
                 case 'started':
-                    return { kind: 'success', text: 'btw — answering alongside the main task.' };
+                    return { kind: 'success', text: t('tui.btw.started') };
                 case 'queued':
-                    return { kind: 'success', text: `btw queued (position ${result.position}).` };
+                    return { kind: 'success', text: t('tui.btw.queued', { position: result.position }) };
                 case 'rejected':
-                    return { kind: 'error', text: `btw rejected — ${result.reason}.` };
+                    return { kind: 'error', text: t('tui.btw.rejected', { reason: result.reason }) };
             }
         };
-        registerLocalCommand('btw', 'Ask a side question while the main task runs (temp overlay, not kept)', btwHandler);
+        registerLocalCommand('btw', t('tui.cmd.btw.description'), btwHandler);
         // ------------------------------------------- TUI-owned slash commands --
         // Web-surface parity: `model` is a browser client contribution there and
         // `export` a web-only download plugin — the terminal gets native
@@ -966,7 +976,7 @@ export function apply(ctx) {
         const modelHandler = async () => {
             const picked = await pickModel(ctx, ui.tui, ui.theme, bridge.getSelection(), refocusEditor);
             if (picked === undefined)
-                return { kind: 'success', text: 'Model unchanged.' };
+                return { kind: 'success', text: t('tui.model.unchanged') };
             const llm = ctx.get('llm');
             if (llm !== undefined) {
                 await llm.resolveCallConfig({ provider: picked.provider, model: picked.model });
@@ -975,14 +985,14 @@ export function apply(ctx) {
             const persistError = await persistDefaultModel(ctx, picked);
             ui.requestRender();
             const modelText = picked.reasoningEffort === undefined
-                ? `Model: ${picked.provider}/${picked.model}`
-                : `Model: ${picked.provider}/${picked.model} · think ${String(picked.reasoningEffort)}`;
+                ? t('tui.model.selected', { id: `${picked.provider}/${picked.model}` })
+                : t('tui.model.selectedThink', { id: `${picked.provider}/${picked.model}`, effort: String(picked.reasoningEffort) });
             return {
                 kind: 'success',
-                text: persistError === undefined ? modelText : `${modelText} · ⚠ not persisted: ${persistError}`,
+                text: persistError === undefined ? modelText : t('tui.persist.failed', { text: modelText, error: persistError }),
             };
         };
-        registerLocalCommand('model', 'Select the model (and think level) for this conversation', modelHandler);
+        registerLocalCommand('model', t('tui.cmd.model.description'), modelHandler);
         // /agents: manage agent definition markdown files (model, think level,
         // spawn depth) — the terminal counterpart of pi's /fun-agent-cfg. An
         // optional argument preselects one agent by name.
@@ -990,44 +1000,44 @@ export function apply(ctx) {
             const trimmed = rawInput?.trim() ?? '';
             const result = await openAgentManager(ctx, ui.tui, ui.theme, refocusEditor, trimmed === '' ? undefined : trimmed, () => subagentPolicy.getStats());
             if (result === undefined)
-                return { kind: 'success', text: 'Agents unchanged.' };
+                return { kind: 'success', text: t('tui.agents.unchanged') };
             return { kind: 'success', text: result };
         };
-        registerLocalCommand('agents', 'Manage agent definitions (model, think level, spawn depth) from markdown files', agentsHandler);
+        registerLocalCommand('agents', t('tui.cmd.agents.description'), agentsHandler);
         // /subagents: the command twin of Ctrl+G — pick a running (or recently
         // settled) subagent and inspect its live transcript in the 80% viewer.
         // Same flow as the key path; empty board closes immediately.
         const subagentsHandler = async () => {
             await openSubagentViewer(ctx, ui.tui, ui.theme, bridge, refocusEditor);
-            return { kind: 'success', text: 'Subagent viewer closed.' };
+            return { kind: 'success', text: t('tui.subagents.viewerClosed') };
         };
-        registerLocalCommand('subagents', 'Browse subagents and inspect their live transcript', subagentsHandler);
+        registerLocalCommand('subagents', t('tui.cmd.subagents.description'), subagentsHandler);
         // /think: cycle the current model's reasoning effort without re-picking
         // the model. A no-session /think still lands in the selection ref and
         // survives the lazy session creation (bridge seeds only an empty ref).
         const thinkHandler = async () => {
             const current = bridge.getSelection();
             if (current === undefined) {
-                return { kind: 'error', text: 'No model selected — pick one with /model first.' };
+                return { kind: 'error', text: t('tui.think.noModel') };
             }
             const result = await pickEffort(ctx, ui.tui, ui.theme, current, refocusEditor);
             if (result.kind === 'unsupported') {
                 return {
                     kind: 'error',
-                    text: `${current.provider}/${current.model} exposes no selectable think levels.`,
+                    text: t('tui.think.unsupported', { id: `${current.provider}/${current.model}` }),
                 };
             }
             if (result.kind === 'cancelled')
-                return { kind: 'success', text: 'Think level unchanged.' };
+                return { kind: 'success', text: t('tui.think.unchanged') };
             if (result.effort === 'default') {
                 const next = { provider: current.provider, model: current.model };
                 bridge.setSelection(next);
                 const persistError = await persistDefaultModel(ctx, next);
                 ui.requestRender();
-                const thinkText = `Think: provider default (${current.provider}/${current.model}).`;
+                const thinkText = t('tui.think.providerDefault', { id: `${current.provider}/${current.model}` });
                 return {
                     kind: 'success',
-                    text: persistError === undefined ? thinkText : `${thinkText} · ⚠ not persisted: ${persistError}`,
+                    text: persistError === undefined ? thinkText : t('tui.persist.failed', { text: thinkText, error: persistError }),
                 };
             }
             const next = {
@@ -1038,13 +1048,13 @@ export function apply(ctx) {
             bridge.setSelection(next);
             const persistError = await persistDefaultModel(ctx, next);
             ui.requestRender();
-            const thinkText = `Think: ${String(result.effort)} (${current.provider}/${current.model}).`;
+            const thinkText = t('tui.think.set', { effort: String(result.effort), id: `${current.provider}/${current.model}` });
             return {
                 kind: 'success',
-                text: persistError === undefined ? thinkText : `${thinkText} · ⚠ not persisted: ${persistError}`,
+                text: persistError === undefined ? thinkText : t('tui.persist.failed', { text: thinkText, error: persistError }),
             };
         };
-        registerLocalCommand('think', 'Switch the current model\'s think (reasoning) level', thinkHandler);
+        registerLocalCommand('think', t('tui.cmd.think.description'), thinkHandler);
         /**
          * Record one committed preset as THIS workspace's remembered selection
          * (`$DSH_HOME/workspace-presets.json`, keyed by the session backend's
@@ -1062,7 +1072,7 @@ export function apply(ctx) {
                 const doc = withRememberedPreset(loadWorkspacePresets(path), projectKeyFor(process.cwd()), presetId);
                 const error = saveWorkspacePresets(path, doc);
                 if (error !== undefined)
-                    renderer.renderNotice(`preset memory not saved: ${error}`, 'error');
+                    renderer.renderNotice(t('tui.preset.memorySaveFailed', { error }), 'error');
             }
             catch {
                 // A broken store must never fail the switch itself.
@@ -1077,7 +1087,7 @@ export function apply(ctx) {
         // directly (the first submit already creates the session on it).
         const presetHandler = async (rawInput) => {
             if (presetState.roster.length === 0) {
-                return { kind: 'error', text: 'No agent presets available.' };
+                return { kind: 'error', text: t('tui.preset.none') };
             }
             const arg = rawInput?.trim() ?? '';
             let target;
@@ -1095,11 +1105,11 @@ export function apply(ctx) {
             else {
                 target = findPresetByName(presetState, arg);
                 if (target === undefined) {
-                    return { kind: 'error', text: `Unknown preset: ${arg}` };
+                    return { kind: 'error', text: t('tui.preset.unknown', { name: arg }) };
                 }
             }
             if (target === undefined)
-                return { kind: 'success', text: 'Preset unchanged.' };
+                return { kind: 'success', text: t('tui.preset.unchanged') };
             const outcome = await performPresetSwitch(presetState, target, { hasLiveSession: () => bridge.getAgent() !== undefined,
                 confirmSwitch: (name, restart) => openPresetConfirmDialog(ui.tui, ui.theme, name, restart, refocusEditor)
                     .then(outcome => (outcome === 'cancelled' ? 'cancel' : outcome)),
@@ -1181,7 +1191,7 @@ export function apply(ctx) {
                 persistRememberedPreset(target.id);
             return { kind: 'success', text: outcome.message };
         };
-        registerLocalCommand('preset', 'Switch the agent preset (starts a new session on it; /preset next cycles)', presetHandler);
+        registerLocalCommand('preset', t('tui.cmd.preset.description'), presetHandler);
         // Model profiles moved to the dsh-profile-switch plugin (ask-user based,
         // surface-agnostic). What stays HERE is the live-selection bridge it
         // consumes: the TUI's /model + /think ride the same selection ref, and
@@ -1198,18 +1208,37 @@ export function apply(ctx) {
             },
             current: () => bridge.getSelection(),
         });
+        /**
+         * The host session-title seam (`@deepseek-ai/dsh-session-title`), read
+         * structurally like every other optional host service: the host base
+         * bundle mounts it (with the first-prompt LLM provider), but a stripped
+         * profile without it must only degrade the /session panel to read-only,
+         * never crash it. The rename error contract is duck-typed by name — the
+         * class itself lives behind a module graph (zod) this plugin
+         * deliberately does not import.
+         */
+        const sessionTitleSeam = (() => {
+            try {
+                return ctx.get('sessionTitle');
+            }
+            catch {
+                return undefined;
+            }
+        })();
         const sessionHandler = async () => {
             const agent = bridge.getAgent();
             const stats = bridge.getStats();
             const selection = bridge.getSelection();
             const header = agent?.session.header;
+            const liveSession = agent?.session;
+            const titleOf = liveSession === undefined ? undefined : sessionTitleSeam?.get(liveSession)?.title;
             await showSessionInfo(ui.tui, ui.theme, {
                 id: agent === undefined ? undefined : String(agent.session.id),
                 cwd: header?.cwd,
                 createdAt: header?.createdAt,
                 model: selection === undefined ? undefined : `${selection.provider}/${selection.model}`,
                 effort: selection === undefined || selection.reasoningEffort === undefined
-                    ? (selection === undefined ? undefined : 'provider default')
+                    ? (selection === undefined ? undefined : t('tui.session.effortDefault'))
                     : String(selection.reasoningEffort),
                 msgCount: stats.msgCount,
                 toolCallCount: stats.toolCallCount,
@@ -1220,10 +1249,28 @@ export function apply(ctx) {
                 status: agent === undefined ? 'none' : agentStatus,
                 eventCount: agent === undefined ? undefined : agent.session.seq,
                 parentSession: header?.parentSession === undefined ? undefined : String(header.parentSession),
-            }, refocusEditor);
-            return { kind: 'success', text: agent === undefined ? 'No active session.' : 'Session info shown.' };
+                title: titleOf,
+                canRename: liveSession !== undefined && sessionTitleSeam !== undefined,
+            }, refocusEditor, liveSession === undefined || sessionTitleSeam === undefined
+                ? undefined
+                : (title) => {
+                    try {
+                        const snapshot = sessionTitleSeam.rename(liveSession, title);
+                        return { ok: true, note: t('tui.session.renamed', { title: snapshot.title }), title: snapshot.title };
+                    }
+                    catch (error) {
+                        // The one input-blaming failure gets a panel-friendly phrase;
+                        // anything else (disposed service, non-live session) rides its
+                        // own message into the panel's note line.
+                        if (error instanceof Error && error.name === 'SessionTitleInvalidError') {
+                            return { ok: false, note: t('tui.session.titleEmpty') };
+                        }
+                        throw error;
+                    }
+                });
+            return { kind: 'success', text: agent === undefined ? t('tui.session.none') : t('tui.session.infoShown') };
         };
-        registerLocalCommand('session', 'Show the current session\'s info (id, model, stats)', sessionHandler);
+        registerLocalCommand('session', t('tui.cmd.session.description'), sessionHandler);
         // /resume: pick a persisted session, validate its log, swap the live
         // agent for it, and rebuild transcript + stats from the stored events.
         const resumeHandler = async () => {
@@ -1241,7 +1288,7 @@ export function apply(ctx) {
                 return { kind: 'error', text: message };
             }
             if (picked.kind === 'empty') {
-                return { kind: 'error', text: 'No other persisted sessions to resume.' };
+                return { kind: 'error', text: t('tui.resume.noneOther') };
             }
             if (picked.kind === 'empty-filtered') {
                 // Sessions exist but the display window hid them all — name the
@@ -1252,11 +1299,11 @@ export function apply(ctx) {
                     : `${picked.minBytes}B`;
                 return {
                     kind: 'error',
-                    text: `No sessions within the resume window (${picked.maxAgeDays}d, ≥${floor}) — adjust dsh-tui.resume.* to see more.`,
+                    text: t('tui.resume.windowEmpty', { days: picked.maxAgeDays, floor }),
                 };
             }
             if (picked.kind === 'cancelled')
-                return { kind: 'success', text: 'Resume cancelled.' };
+                return { kind: 'success', text: t('tui.resume.cancelled') };
             // Narrowed shared handle for the closures below (const narrowing
             // propagates into async closures; `picked`'s does not).
             const target = picked;
@@ -1288,19 +1335,19 @@ export function apply(ctx) {
                             ui.requestRender();
                             return {
                                 kind: 'success',
-                                text: `Watching ${clipToWidth(String(target.id), 8)} (read-only · driven by another process). /resume or /new to switch.`,
+                                text: t('tui.resume.watching', { id: clipToWidth(String(target.id), 8) }),
                             };
                         }
                         catch (watchError) {
                             return {
                                 kind: 'error',
-                                text: `Cannot watch ${clipToWidth(String(target.id), 8)} read-only: ${messageOf(watchError)}`,
+                                text: t('tui.resume.watchFailed', { id: clipToWidth(String(target.id), 8), error: messageOf(watchError) }),
                             };
                         }
                     }
                     return {
                         kind: 'error',
-                        text: `Resume failed: ${message} — the previous session was closed; the next prompt starts a new one.`,
+                        text: t('tui.resume.failed', { error: message }),
                     };
                 }
                 // Seed the badge cache for the resumed session (its pin event may have
@@ -1328,7 +1375,7 @@ export function apply(ctx) {
                 ui.requestRender();
                 return {
                     kind: 'success',
-                    text: `Resumed ${clipToWidth(String(target.id), 8)} · ${session.seq} events.`,
+                    text: t('tui.resume.done', { id: clipToWidth(String(target.id), 8), count: session.seq }),
                 };
             };
             // Corrupt-log branch: the repair rewrites user data on disk, so it is
@@ -1342,13 +1389,13 @@ export function apply(ctx) {
                 if (logPath === undefined) {
                     return {
                         kind: 'error',
-                        text: `repair failed: cannot locate the log of ${clipToWidth(String(target.id), 8)} on disk — log untouched`,
+                        text: t('tui.repair.logMissing', { id: clipToWidth(String(target.id), 8) }),
                     };
                 }
                 if (await openRepairConfirmDialog(ui.tui, ui.theme, refocusEditor) !== 'repair') {
                     return {
                         kind: 'error',
-                        text: `Cannot resume ${clipToWidth(String(target.id), 8)}: ${message}`,
+                        text: t('tui.resume.cannot', { id: clipToWidth(String(target.id), 8), error: message }),
                     };
                 }
                 // repairSessionLog maps its own failures to results; the catch is a
@@ -1359,7 +1406,7 @@ export function apply(ctx) {
                 }
                 catch (error) {
                     const detail = messageOf(error);
-                    notice = `repair failed: ${detail} — log untouched`;
+                    notice = t('tui.repair.failed', { error: detail });
                 }
                 if (notice !== undefined)
                     return { kind: 'error', text: notice };
@@ -1377,11 +1424,11 @@ export function apply(ctx) {
                 if (isCorruptLogError(message)) {
                     return offerCorruptedLogRepair(message);
                 }
-                return { kind: 'error', text: `Cannot resume ${clipToWidth(String(picked.id), 8)}: ${message}` };
+                return { kind: 'error', text: t('tui.resume.cannot', { id: clipToWidth(String(picked.id), 8), error: message }) };
             }
             return resumeAndReplay();
         };
-        registerLocalCommand('resume', 'Resume a persisted session', resumeHandler);
+        registerLocalCommand('resume', t('tui.cmd.resume.description'), resumeHandler);
         // /history: the read-only two-pane look-back (ADR 0003) — left pane lists
         // the browsed session's completed turns, right pane shows the selected
         // turn's replies; Enter/c refills the editor with the turn's prompt (a
@@ -1447,7 +1494,7 @@ export function apply(ctx) {
             }, arg === '' ? undefined : arg);
             return { kind: result.error ? 'error' : 'success', text: result.text };
         };
-        registerLocalCommand('history', 'Browse past turns of a session (read-only; /history <id> for a stored one)', historyHandler);
+        registerLocalCommand('history', t('tui.cmd.history.description'), historyHandler);
         // Auto-resume after a hot-reload: a `/reload` stashes the previously
         // current session id before this fiber's teardown, and the freshly
         // re-imported module consumes it best-effort here so the next prompt
@@ -1496,7 +1543,7 @@ export function apply(ctx) {
                 }
                 catch (error) {
                     const message = messageOf(error);
-                    renderer.renderNotice(`--resume ${clipToWidth(bootResumeId, 8)}: ${message} — starting fresh.`, 'error');
+                    renderer.renderNotice(t('tui.boot.resumeFailed', { id: clipToWidth(bootResumeId, 8), error: message }), 'error');
                 }
             })();
         }
@@ -1506,11 +1553,11 @@ export function apply(ctx) {
         // falls back to the dsh path when one does (behavior unchanged there).
         commands.registerLocal('export', async () => ({
             kind: 'error',
-            text: 'No active session to export.',
+            text: t('tui.export.noSession'),
         }));
         ctx.effect(() => ctx.commands.register({
             name: 'export',
-            description: 'Export this session log as JSONL',
+            description: t('tui.cmd.export.description'),
             input: { hint: '[path]' },
             handler: async (invocation) => {
                 const events = invocation.agent.session.snapshotEvents();
@@ -1518,7 +1565,7 @@ export function apply(ctx) {
                 const target = invocation.rawInput.trim() === '' ? fallback : resolve(invocation.rawInput.trim());
                 await mkdir(dirname(target), { recursive: true });
                 await writeFile(target, events.map(event => JSON.stringify(event)).join('\n') + '\n');
-                return { kind: 'success', text: `Exported ${events.length} events → ${target}` };
+                return { kind: 'success', text: t('tui.export.done', { count: events.length, path: target }) };
             },
         }), 'dsh-tui-pi: /export');
         // /new: detach the live agent (and clear the on-screen transcript) so
@@ -1575,16 +1622,16 @@ export function apply(ctx) {
         };
         const newHandler = async () => {
             await startNewSession();
-            return { kind: 'success', text: 'New session started.' };
+            return { kind: 'success', text: t('tui.new.done') };
         };
-        registerLocalCommand('new', 'Start a new session', newHandler);
+        registerLocalCommand('new', t('tui.cmd.new.description'), newHandler);
         // /settings: text-based configuration browser — the terminal counterpart
         // of the web GUI's settings surface. Enumerates ctx.settings.describe()
         // and walks each namespace's schema (drill-ins, cycle rows, inline editors,
         // reset-to-defaults), writing through settings.mutate path ops.
         const settingsHandler = async () => {
             if (ctx.get('settings') === undefined) {
-                return { kind: 'error', text: 'Settings service is not available.' };
+                return { kind: 'error', text: t('tui.settings.unavailable') };
             }
             const changes = await openSettingsBrowser({
                 ctx,
@@ -1598,23 +1645,25 @@ export function apply(ctx) {
                 },
             });
             if (changes < 0)
-                return { kind: 'error', text: 'No settings namespaces are registered.' };
+                return { kind: 'error', text: t('tui.settings.noNamespaces') };
             return {
                 kind: 'success',
                 text: changes === 0
-                    ? 'Settings: no changes.'
-                    : `Settings: ${changes} change${changes === 1 ? '' : 's'} applied.`,
+                    ? t('tui.settings.noChanges')
+                    : changes === 1
+                        ? t('tui.settings.appliedOne', { count: changes })
+                        : t('tui.settings.appliedMany', { count: changes }),
             };
         };
-        registerLocalCommand('settings', 'Browse and edit configuration (namespaces, values, resets)', settingsHandler);
+        registerLocalCommand('settings', t('tui.cmd.settings.description'), settingsHandler);
         // /skills: standalone skill browser with Installed/Available dual mode.
         // Enter/Space toggles or symlinks; Tab switches views; Esc exits.
         const skillsHandler = async () => {
             const agent = bridge.getAgent();
             openSkillsManagerPanel(ctx, ui.tui, ui.theme, refocusEditor, agent ?? undefined, () => { });
-            return { kind: 'success', text: 'Skills manager opened.' };
+            return { kind: 'success', text: t('tui.skills.opened') };
         };
-        registerLocalCommand('skills', 'Manage user skills (installed and available)', skillsHandler);
+        registerLocalCommand('skills', t('tui.cmd.skills.description'), skillsHandler);
         // /theme: pick a color scheme and apply it immediately — the choice is
         // persisted to the dsh-tui settings namespace (`applies: 'live'`, so the
         // watch hook would re-apply the same change anyway) and hot-swapped into
@@ -1623,7 +1672,7 @@ export function apply(ctx) {
         // mirrors /settings: without the service there is nowhere to write.
         const themeHandler = async () => {
             if (ctx.get('settings') === undefined) {
-                return { kind: 'error', text: 'Settings service is not available.' };
+                return { kind: 'error', text: t('tui.settings.unavailable') };
             }
             // Preselect from the live settings value (which may have changed since
             // startup via the /settings browser), not the startup snapshot. The
@@ -1634,7 +1683,7 @@ export function apply(ctx) {
                 userNames: themeUserNames,
             });
             if (picked === undefined)
-                return { kind: 'success', text: 'Theme unchanged.' };
+                return { kind: 'success', text: t('tui.theme.unchanged') };
             const writeError = await writeThemePreference(ctx, picked);
             if (writeError !== undefined)
                 return { kind: 'error', text: writeError };
@@ -1649,12 +1698,70 @@ export function apply(ctx) {
             if (expected !== undefined && applied !== expected) {
                 return {
                     kind: 'success',
-                    text: `Theme preference saved — display is pinned by DSH_TUI_THEME=${process.env.DSH_TUI_THEME}`,
+                    text: t('tui.theme.pinned', { value: String(process.env.DSH_TUI_THEME) }),
                 };
             }
-            return { kind: 'success', text: `Theme: ${picked} — applied.` };
+            return { kind: 'success', text: t('tui.theme.applied', { name: picked }) };
+        };
+        registerLocalCommand('theme', t('tui.cmd.theme.description'), themeHandler);
+        // /language — switch the UI language. Language files live in the bundled
+        // locales/ directory plus the user's ~/.dsh/locales (one JSON file per
+        // language; adding one needs no code). Bare `/language` asks through the
+        // native ask-user panel (src/language-ask.ts) — the same docked question
+        // UI the model uses, so it answers on any registered surface (the TUI, a
+        // phone through dsh-feishu) with first answer wins. `/language <id>`
+        // switches directly. Either way the switch applies live (the next repaint
+        // speaks it) and persists the choice to `dsh-tui.language`.
+        const installedLanguages = () => listLocales().map(locale => `${locale.id} (${locale.name})`).join(', ');
+        const applyLanguage = async (id) => {
+            if (!setLocale(id)) {
+                return { kind: 'error', text: t('command.language.unknown', { id, list: installedLanguages() }) };
+            }
+            const persistError = await writeLanguagePreference(ctx, id);
+            const active = currentLocale();
+            const switched = t('command.language.switched', { name: active.name, id: active.id });
+            return {
+                kind: 'success',
+                text: persistError === undefined
+                    ? switched
+                    : `${switched} ${t('command.language.persistFailed', { error: persistError })}`,
+            };
+        };
+        const languageHandler = async (rawInput, signal) => {
+            const arg = rawInput.trim();
+            if (arg !== '')
+                return applyLanguage(arg);
+            const ask = ctx.get('userQuestions');
+            if (ask === undefined) {
+                return {
+                    kind: 'error',
+                    text: t('command.language.unavailable', { list: installedLanguages() }),
+                };
+            }
+            // Scope the ask to the live session when there is one (only the
+            // surfaces driving it are asked); a fresh TUI asks agentless.
+            let outcome;
+            try {
+                outcome = await askLanguageChoice(ask, { agent: bridge.getAgent(), signal });
+            }
+            catch (error) {
+                return {
+                    kind: 'error',
+                    text: t('command.language.askFailed', {
+                        error: error instanceof Error ? error.message : String(error),
+                    }),
+                };
+            }
+            if (outcome.kind === 'picked')
+                return applyLanguage(outcome.id);
+            if (outcome.kind === 'unknown') {
+                return { kind: 'error', text: t('command.language.unknown', { id: outcome.text, list: installedLanguages() }) };
+            }
+            // Picked the active language, declined the question, or it was never
+            // answered — nothing changed.
+            return { kind: 'success', text: t('command.language.unchanged') };
         };
-        registerLocalCommand('theme', 'Set the terminal color scheme (applies immediately)', themeHandler);
+        registerLocalCommand('language', t('command.language.description'), languageHandler);
         // /reload: hot-reload this plugin from the current source — re-imports the
         // module and its dependencies (picking up src changes after `pnpm build`)
         // and swaps the plugin runtime. The old fiber is disposed, so the TUI and
@@ -1664,7 +1771,7 @@ export function apply(ctx) {
             kind: 'success',
             text: await reloadPlugin(ctx, import.meta.url),
         });
-        registerLocalCommand('reload', 'Reload the TUI from the current source (apply code changes without restarting dsh)', reloadHandler);
+        registerLocalCommand('reload', t('tui.cmd.reload.description'), reloadHandler);
         // /hotkeys — pi's keybinding browser, in the /agents select-panel style:
         // a field list of the app keys, Enter opens an editor that writes
         // ~/.dsh/keybindings.json and live-applies the change (no /reload).
@@ -1674,9 +1781,9 @@ export function apply(ctx) {
                 apply: bindings => ui.setKeyBindings(bindings),
                 restoreFocus: refocusEditor,
             });
-            return { kind: 'success', text: summary ?? 'Keybindings unchanged.' };
+            return { kind: 'success', text: summary ?? t('tui.hotkeys.unchanged') };
         };
-        registerLocalCommand('hotkeys', 'Show the current keybindings (custom file: ~/.dsh/keybindings.json)', hotkeysHandler);
+        registerLocalCommand('hotkeys', t('tui.cmd.hotkeys.description'), hotkeysHandler);
         // /login: register provider credentials — the terminal counterpart of
         // pi-agent's /login, on the Models category's add-provider flow. Opens a
         // searchable provider directory (including already-configured routes, so
@@ -1687,7 +1794,7 @@ export function apply(ctx) {
         // filtered picker otherwise.
         const loginHandler = async (rawInput) => {
             if (ctx.get('settings') === undefined) {
-                return { kind: 'error', text: 'Settings service is not available.' };
+                return { kind: 'error', text: t('tui.settings.unavailable') };
             }
             const result = await openLoginFlow({
                 ctx,
@@ -1700,14 +1807,14 @@ export function apply(ctx) {
             if (result.kind === 'unknown') {
                 return {
                     kind: 'error',
-                    text: `Unknown provider '${result.target}' — run /login to pick from the directory.`,
+                    text: t('tui.login.unknownProvider', { name: result.target }),
                 };
             }
             if (result.kind === 'cancelled')
-                return { kind: 'success', text: 'Login cancelled.' };
-            return { kind: 'success', text: `Provider ${result.name} configured.` };
+                return { kind: 'success', text: t('tui.login.cancelled') };
+            return { kind: 'success', text: t('tui.login.configured', { name: result.name }) };
         };
-        registerLocalCommand('login', 'Register provider credentials (API key) through the provider directory', loginHandler);
+        registerLocalCommand('login', t('tui.cmd.login.description'), loginHandler);
         // /logout: unsubscribe a provider — pi-agent's /logout on the dsh side.
         // Lists the providers with a stored credential; on selection removes the
         // key AND the settings.yaml provider entry, so the provider's models
@@ -1716,7 +1823,7 @@ export function apply(ctx) {
         // the installed catalog's current model list.
         const logoutHandler = async () => {
             if (ctx.get('settings') === undefined) {
-                return { kind: 'error', text: 'Settings service is not available.' };
+                return { kind: 'error', text: t('tui.settings.unavailable') };
             }
             const result = await openLogoutFlow({
                 ctx,
@@ -1726,34 +1833,32 @@ export function apply(ctx) {
                 onError: message => renderer.renderNotice(message, 'error'),
             });
             if (result.kind === 'none') {
-                return { kind: 'success', text: 'No stored credentials to remove.' };
+                return { kind: 'success', text: t('tui.logout.none') };
             }
             if (result.kind === 'cancelled')
-                return { kind: 'success', text: 'Logout cancelled.' };
+                return { kind: 'success', text: t('tui.logout.cancelled') };
             if (result.kind === 'failed') {
                 const cause = result.cause === undefined ? '' : `: ${result.cause}`;
-                return { kind: 'error', text: `Failed to remove stored API key for ${result.name}${cause}.` };
+                return { kind: 'error', text: t('tui.logout.failed', { name: result.name, cause }) };
             }
             if (result.kind === 'removed-incomplete') {
                 return {
                     kind: 'error',
-                    text: `Removed the API key for ${result.name}, but its provider configuration stays: ${result.error}`
-                        + ' — remove the provider in /settings to finish the logout.',
+                    text: t('tui.logout.incomplete', { name: result.name, error: result.error }),
                 };
             }
             if (result.kind === 'removed-key-only') {
                 return {
                     kind: 'success',
-                    text: `Removed the API key for ${result.name}. Hand-declared route — its configuration stays;`
-                        + ' remove the provider in /settings to also drop its models.',
+                    text: t('tui.logout.keyOnly', { name: result.name }),
                 };
             }
             return {
                 kind: 'success',
-                text: `Logged out ${result.name} — API key and provider configuration removed.`,
+                text: t('tui.logout.done', { name: result.name }),
             };
         };
-        registerLocalCommand('logout', 'Log out a provider (removes its API key and provider configuration)', logoutHandler);
+        registerLocalCommand('logout', t('tui.cmd.logout.description'), logoutHandler);
         // ------------------------------------------------- powerline footer + git --
         const git = new GitBranchWatcher(process.cwd());
         git.onChange = () => ui.requestRender();
@@ -1892,6 +1997,9 @@ export function apply(ctx) {
          * (model/effort pickers, settings browser, session panel, resume list),
          * and plugin flows hold the editor just as long: /wiki onboard parks the
          * user in ask-user panels, /vault backup|restore push over the network.
+         * /language rides the same ask-user panel (src/language-ask.ts) — its
+         * auto-answer window is minutes, and with the timeouts disabled it waits
+         * indefinitely, so the generic guard must not cut it off mid-question.
          * The generic guard would fire mid-flow and echo a spurious
          * "aborted due to timeout" — those run with a never-aborting signal
          * instead.
@@ -1901,7 +2009,7 @@ export function apply(ctx) {
          * through this dispatcher, so their names belong here all the same
          * (dropping them in 2.16.0 re-introduced the timeout).
          */
-        const MODAL_COMMANDS = new Set(['settings', 'model', 'think', 'session', 'resume', 'history', 'theme', 'permission', 'agents', 'subagents', 'login', 'logout', 'skills', 'preset', 'profile-switch', 'profile-cfg', 'wiki', 'vault']);
+        const MODAL_COMMANDS = new Set(['settings', 'model', 'think', 'session', 'resume', 'history', 'theme', 'language', 'permission', 'agents', 'subagents', 'login', 'logout', 'skills', 'preset', 'profile-switch', 'profile-cfg', 'wiki', 'vault']);
         /** Route one submitted line: dsh slash command first, model prompt second. */
         const submit = async (text) => {
             const line = text.trim();
@@ -1943,7 +2051,7 @@ export function apply(ctx) {
                         // Cancelled — or the derived custom state, which is display-only
                         // and not a switch target (mirrors the web client's popup
                         // filtering). Either way nothing changed.
-                        renderer.renderCommandEcho(line, undefined, 'Permission unchanged.');
+                        renderer.renderCommandEcho(line, undefined, t('tui.permission.unchanged'));
                         return;
                     }
                     executeLine = `/permission ${picked}`;
@@ -1993,7 +2101,7 @@ export function apply(ctx) {
             try {
                 await bridge.prompt(line);
                 if (wasWatching)
-                    emitNotice('Queued follow-up — sends automatically once the write lock frees up.');
+                    emitNotice(t('tui.steer.queuedFollowup'));
             }
             catch (error) {
                 // Buffered notice: the failure line is the only on-screen record and
@@ -2021,7 +2129,7 @@ export function apply(ctx) {
             if (agent === undefined) {
                 // Running without a handle cannot deliver — say so instead of
                 // dropping the message silently.
-                renderer.renderNotice('No active session — the message was not delivered.', 'error');
+                renderer.renderNotice(t('tui.steer.noSession'), 'error');
                 return;
             }
             const message = buildUserPrompt(raw);
@@ -2031,7 +2139,7 @@ export function apply(ctx) {
                 const outcome = deliverToAgent(agent, message, route);
                 if (outcome.outcome === 'degraded') {
                     renderer.rebadgePendingEcho({ id: message.id }, 'queued');
-                    renderer.renderNotice(TURN_ENDED_QUEUED_NOTICE, 'info');
+                    renderer.renderNotice(turnEndedQueuedNotice(), 'info');
                 }
                 else if (outcome.outcome === 'error') {
                     renderer.resolvePendingEcho({ id: message.id }, 'failed');
@@ -2072,9 +2180,9 @@ export function apply(ctx) {
                 if (exitSessionId !== undefined) {
                     // DIM SGR (not a theme color): the hint prints after the TUI's
                     // theme machinery is gone; dim is universally supported.
-                    process.stdout.write(`\n\x1b[2mTo resume this session: ${formatResumeCommand(resolveProfileName(ctx), String(exitSessionId))}\x1b[0m\n`);
+                    process.stdout.write(`\n\x1b[2m${t('tui.exit.resumeHint', { command: formatResumeCommand(resolveProfileName(ctx), String(exitSessionId)) })}\x1b[0m\n`);
                 }
-                process.exit(code);
+                hardExit(code);
             })();
             return exitTask;
         };