@armadra/agent 0.5.0 → 0.6.0

package/dist/modes/interactive/commands.js

@@ -10,32 +10,75 @@
  * - `/rewind`（无参数）打开回滚列表与确认面板（rewind-flow.ts）；带参数走 commands-core，对话变了时
  *   重画消息区并回填原消息。
  * - 不是命令（含模板与 `/skill:`）返回 false，调用方把整行当提示发出。
+ * - [W6-C0] 面板钩子：`/config`（W6-S）、`/trace`（W6-T1）、`/memory`（W6-M）按 `PANEL_COMMANDS` 表分派到
+ *   `CommandUi` 的可选钩子；`/tasks` 无参在有 `agentBar` 时聚焦 Agent 栏、`/tasks <id>` 在有 `agentView` 时
+ *   直接进子 Agent 视图（W6-A）。钩子没装时回落 commands-core（line 模式同一套文本）。
  */
+import { msg } from "../../i18n/index.js";
 import { formatModelRef } from "../../ai/providers/channels.js";
 import { AgentSessionImpl } from "../../agent/session.js";
+import { THINKING_LEVELS } from "../../ai/thinking.js";
 import { listSessions } from "../../cli/compose-store.js";
 import { hideFakeProvider } from "../../cli/fake-visibility.js";
-import { AUTO_LAYER_TEXT, permissionModeLabel } from "../../permissions/modes.js";
+import { autoLayerText, permissionModeLabel } from "../../permissions/modes.js";
 import { BUILTIN_COMMANDS, parseSlash, runSlashCommand, } from "../commands-core.js";
 import { contentText } from "./message-view.js";
 import { cachePanel, permissionsPanel, sessionPanel } from "./panels.js";
 import { modelItems, permissionPickerSpec, sessionItems, thinkingItems, treeItems, } from "./pickers.js";
+/** 说明随界面语言（取用时求值）。 */
+function command(name, key) {
+    return {
+        name,
+        get description() {
+            return msg().interactive.commands[key];
+        },
+    };
+}
 export const INTERACTIVE_COMMANDS = [
-    { name: "tree", description: "浏览会话树，回到某条消息之前重写" },
-    { name: "permissions", description: "权限模式、判定顺序与规则" },
+    command("tree", "treeDescription"),
+    command("permissions", "permissionsDescription"),
 ];
 /** 补全与 /help 用的完整命令表。 */
 export const ALL_COMMANDS = [...BUILTIN_COMMANDS, ...INTERACTIVE_COMMANDS];
-export const KEY_HINTS = [
-    "Enter 发送（运行中 = 插话）  Alt+Enter 排到本轮之后  Shift+Enter / Ctrl+J 换行",
-    "Esc 中断（排队消息回填编辑器）  Alt+↑ 取回最后一条排队消息",
-    "空闲时 Esc Esc：输入框为空 = 回滚（/rewind），有字 = 清空（↑ 取回）",
-    "Shift+Tab 切换权限模式  Ctrl+L 模型  Ctrl+T 思考级别  Ctrl+O 展开工具输出与思考",
-    "审批：1–3 或 ↑↓ Enter 选择，y 允许  a 本会话允许同类  n / Esc 拒绝  v 完整输入",
-    "计划审批：1 批准  2 新上下文执行  3 继续修改  4 放弃并退出 Plan  e 编辑计划  Esc 留在 Plan",
-    "Ctrl+V 粘贴剪贴板图片（插入 @路径）  Ctrl+G 底部信息行两行 / 一行",
-    "Ctrl+C 清空输入（再按退出）  Ctrl+D 空输入时退出  Tab 补全  @ 引用文件",
-].join("\n");
+/** `/help` 末尾的按键说明（多行）。 */
+export function keyHints() {
+    return msg().interactive.commands.keyHints;
+}
+/**
+ * [W6-C0] 面板类命令 → `CommandUi` 钩子。钩子存在就调用并返回 true；不存在返回 false（回落 commands-core）。
+ */
+export const PANEL_COMMANDS = {
+    config: async (ui, args) => {
+        if (ui.configPanel === undefined)
+            return false;
+        await ui.configPanel(args);
+        return true;
+    },
+    trace: async (ui, args) => {
+        if (ui.traceView === undefined)
+            return false;
+        await ui.traceView(args === "" ? undefined : args);
+        return true;
+    },
+    memory: async (ui, args) => {
+        if (ui.memoryPanel === undefined)
+            return false;
+        await ui.memoryPanel(args);
+        return true;
+    },
+    tasks: async (ui, args) => {
+        const parts = args.split(/\s+/).filter((s) => s !== "");
+        if (parts.length === 0 && ui.agentBar !== undefined) {
+            await ui.agentBar();
+            return true;
+        }
+        if (parts.length === 1 && parts[0] !== "stop" && ui.agentView !== undefined) {
+            await ui.agentView(parts[0]);
+            return true;
+        }
+        return false;
+    },
+};
 function homeOf(ui) {
     return ui.home !== undefined ? { home: ui.home } : {};
 }
@@ -51,25 +94,23 @@ export function activeBranchIds(session) {
     return new Set(session.entries.map((e) => e.id));
 }
 export function permissionsText(runtime, session) {
+    const m = msg().interactive.commands;
+    const p = msg().panels.permissions;
     const rules = runtime.permission.rules;
     const mode = session.state.permissionMode;
-    const order = mode === "auto"
-        ? "deny 规则 → Hook deny → 危险命令确认 → 规则层（受保护路径、项目外写入、网络、删除类）→ Hook ask → allow 规则 / Hook allow / 本会话记忆 → 静态判定（只读、项目内写入、安全名单）→ 模型分类器 → 询问"
-        : mode === "allowlist"
-            ? "deny 规则 → Hook deny → 危险命令（拒绝）→ 只读工具 / allow 规则 / Hook allow 放行 → 其余拒绝（从不询问）"
-            : "deny 规则 → Hook deny → 危险命令确认 → 权限模式 → allow 规则 / Hook allow / 本会话记忆 → 询问";
+    const order = mode === "auto" ? p.orderAuto : mode === "allowlist" ? p.orderAllowlist : p.orderDefault;
     const lines = [
-        `权限模式：${permissionModeLabel(mode)}（${mode}）`,
-        `判定顺序：${order}`,
-        rules.length === 0 ? "规则：（无）" : `规则（${rules.length}）：`,
+        m.permissionsMode(permissionModeLabel(mode), mode),
+        m.permissionsOrder(order),
+        rules.length === 0 ? m.rulesNone : m.rules(rules.length),
         ...rules.map((r) => `  ${r.effect === "deny" ? "deny " : "allow"}  ${r.raw}  [${r.source}]`),
     ];
     const recent = runtime.permission.autoDecisions?.() ?? [];
     if (recent.length > 0) {
-        lines.push(`最近的 auto 判定（${recent.length}）：`);
+        lines.push(m.recentAuto(recent.length));
         for (const d of recent) {
-            const cached = d.cached === true ? "（缓存）" : "";
-            lines.push(`  ${AUTO_LAYER_TEXT[d.layer]}  ${d.decision}  ${d.toolName} ${d.summary} — ${d.reason}${cached}`);
+            const cached = d.cached === true ? p.cached : "";
+            lines.push(`  ${autoLayerText(d.layer)}  ${d.decision}  ${d.toolName} ${d.summary} — ${d.reason}${cached}`);
         }
     }
     return lines.join("\n");
@@ -78,7 +119,7 @@ async function pickTree(ui, title) {
     const session = ui.session();
     const items = treeItems(session.entries, activeBranchIds(session), ui.now());
     if (items.length === 0) {
-        ui.notice("info", "还没有用户消息");
+        ui.notice("info", msg().interactive.commands.noUserMessages);
         return undefined;
     }
     const active = [...items].reverse().find((i) => i.label.includes("● "));
@@ -94,14 +135,14 @@ async function pickTree(ui, title) {
 async function treeCommand(ui) {
     const session = ui.session();
     if (!(session instanceof AgentSessionImpl)) {
-        ui.notice("warn", "当前会话不支持 /tree");
+        ui.notice("warn", msg().interactive.commands.treeUnsupported);
         return;
     }
     if (session.state.isStreaming) {
-        ui.notice("warn", "运行中不能切换分支（先 Esc 中断）");
+        ui.notice("warn", msg().interactive.commands.treeBusy);
         return;
     }
-    const entry = await pickTree(ui, "会话树");
+    const entry = await pickTree(ui, msg().interactive.commands.treeTitle);
     if (entry === undefined)
         return;
     await session.navigate(entry.parentId);
@@ -110,12 +151,13 @@ async function treeCommand(ui) {
 }
 async function handlePick(what, ui) {
     const session = ui.session();
+    const m = msg().interactive.commands;
     switch (what) {
         case "model": {
             const current = session.state.model;
             const ref = current === undefined ? undefined : `${current.provider}/${current.id}`;
             const picked = await ui.pick({
-                title: "选择模型",
+                title: m.modelTitle,
                 items: await modelItems(ui.env === undefined
                     ? ui.runtime.providers
                     : hideFakeProvider(ui.runtime.providers, ui.env)),
@@ -126,7 +168,7 @@ async function handlePick(what, ui) {
             if (picked === undefined)
                 return;
             await session.setModel(picked.value);
-            ui.notice("info", `模型：${picked.value}`);
+            ui.notice("info", m.modelSet(picked.value));
             return;
         }
         case "session": {
@@ -136,26 +178,26 @@ async function handlePick(what, ui) {
             });
             const others = items.filter((i) => i.id !== session.state.sessionId);
             if (others.length === 0) {
-                ui.notice("info", "本目录没有其它会话");
+                ui.notice("info", m.noOtherSessions);
                 return;
             }
             const picked = await ui.pick({
-                title: "恢复会话",
+                title: m.resumeTitle,
                 items: sessionItems(others, ui.now()),
                 filterable: true,
             });
             if (picked === undefined)
                 return;
             const next = await ui.switchSession({ kind: "resume", id: picked.value });
-            ui.notice("info", `已恢复会话 ${next.state.sessionId.slice(0, 8)}`);
+            ui.notice("info", m.resumed(next.state.sessionId.slice(0, 8)));
             return;
         }
         case "tree": {
-            const entry = await pickTree(ui, "从哪条消息之前分叉");
+            const entry = await pickTree(ui, m.forkTitle);
             if (entry === undefined)
                 return;
             const next = await ui.switchSession(entry.parentId === null ? { kind: "new" } : { kind: "fork", entryId: entry.parentId });
-            ui.notice("info", `已分叉到新会话 ${next.state.sessionId.slice(0, 8)}`);
+            ui.notice("info", m.forked(next.state.sessionId.slice(0, 8)));
             ui.setEditorText(userEntryText(entry) ?? "");
             return;
         }
@@ -164,8 +206,13 @@ async function handlePick(what, ui) {
             if (picked === undefined)
                 return;
             const mode = picked.value;
+            const current = session.state.permissionMode;
+            if (mode !== current && ui.confirmMode !== undefined && !(await ui.confirmMode(mode))) {
+                ui.notice("info", m.modeCancelled(permissionModeLabel(current)));
+                return;
+            }
             session.setPermissionMode(mode);
-            ui.notice("info", `权限模式：${permissionModeLabel(mode)}`);
+            ui.notice("info", m.modeSet(permissionModeLabel(mode)));
             return;
         }
         case "thinking": {
@@ -173,9 +220,13 @@ async function handlePick(what, ui) {
             const found = model === undefined ? undefined : ui.runtime.providers.findModel(formatModelRef(model));
             const reasoning = found?.ok === true ? found.model.reasoning : true;
             const picked = await ui.pick({
-                title: "思考级别",
+                title: m.thinkingTitle,
                 items: thinkingItems(reasoning),
                 selected: session.state.thinkingLevel,
+                currentValue: session.state.thinkingLevel,
+                filterable: false,
+                numberKeys: true,
+                footer: m.numberFooter("↑↓", THINKING_LEVELS.length),
             });
             if (picked !== undefined)
                 session.setThinkingLevel(picked.value);
@@ -191,6 +242,9 @@ export async function runInteractiveCommand(line, ui) {
     try {
         if (ui.extra !== undefined && (await ui.extra(parsed.name, parsed.args)))
             return true;
+        const panel = PANEL_COMMANDS[parsed.name];
+        if (panel !== undefined && (await panel(ui, parsed.args)))
+            return true;
         if (parsed.name === "tree") {
             await treeCommand(ui);
             return true;
@@ -222,6 +276,7 @@ export async function runInteractiveCommand(line, ui) {
             runtime: ui.runtime,
             session: () => ui.session(),
             switchSession: (request) => ui.switchSession(request),
+            ...(ui.confirmMode !== undefined ? { confirmPermissionMode: ui.confirmMode } : {}),
         });
         if (result === undefined)
             return false;
@@ -240,7 +295,7 @@ export async function runInteractiveCommand(line, ui) {
                     ui.reload();
                 if (parsed.name === "help") {
                     const extra = INTERACTIVE_COMMANDS.map((c) => `/${c.name}  ${c.description}`);
-                    ui.notice("info", [result.message ?? "", ...extra, "", KEY_HINTS].join("\n"));
+                    ui.notice("info", [result.message ?? "", ...extra, "", keyHints()].join("\n"));
                 }
                 else if (result.message !== undefined)
                     ui.notice("info", result.message);

package/dist/modes/interactive/completion.js

@@ -7,6 +7,7 @@
  *   最多 50 项；查询含 glob 字符时按 glob（tools/glob.ts）匹配相对路径，否则按「文件名前缀 → 路径前缀 →
  *   文件名子串 → 路径子串」排序。目录以 `/` 结尾，可继续补全。文件表按 cwd 缓存 15 秒、最多 20 000 项。
  */
+import { msg } from "../../i18n/index.js";
 import { GlobMatcher } from "../../tools/glob.js";
 import { walk } from "../../tools/ignore.js";
 export const MAX_FILE_ITEMS = 50;
@@ -82,7 +83,7 @@ export class InteractiveCompletion {
                 : command.description, command.name);
         }
         for (const prompt of this.source.prompts())
-            push(prompt.name, "提示模板", prompt.name);
+            push(prompt.name, msg().interactive.completion.promptTemplate, prompt.name);
         for (const skill of this.source.skills()) {
             push(`skill:${skill.name}`, skill.description, `skill:${skill.name}`);
         }

package/dist/modes/interactive/config-panel.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `/config` settings panel component (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ *
+ * Bottom overlay with the card bar: title + write target (`Tab` switches user / project), a search line,
+ * the grouped `SettingsList`, a rule, the selected key's description (key-docs, dim, wrapped), one notice
+ * line and the key hints. What a key press *does* to a setting is the controller's job (config-ui.ts):
+ * the panel calls `activate(key)` for Enter / Space, `unset(key)` for a confirmed Backspace / Delete,
+ * `commit(key, text)` for the inline number / text editor, `switchScope()` for Tab and `close()` for Esc.
+ *
+ * Keys: ↑↓ (and Ctrl+P / Ctrl+N) move; `/` starts a search (typing filters, Esc clears it first, a
+ * second Esc closes); Backspace / Delete asks once, then unsets; inside the editor Enter saves (an
+ * invalid value stays in the box with the error in red), Esc cancels.
+ */
+import { type Component, type Focusable, type Keybindings, type SemanticColor, type SettingsRow, type Theme } from "../../tui.js";
+import { type ConfigSnapshot, type EditScope, type SettingValue } from "../../config/edit.js";
+import { type SettingSpec } from "../../config/settings-registry.js";
+export interface ConfigPanelDeps {
+    theme: Theme;
+    keybindings?: Keybindings;
+    /** Terminal rows (the panel fits in `rows - 1`). */
+    rows?(): number;
+    /** Write target paths for the title (already shortened with ~). */
+    paths: Readonly<Record<EditScope, string>>;
+    /** Embedded host (profile): the title says changes go to the user config. */
+    embedded?: boolean;
+    activate(key: string, scope: EditScope): void | Promise<void>;
+    unset(key: string, scope: EditScope): void | Promise<void>;
+    /** Inline editor: returns an error message to keep the box open. */
+    commit(key: string, text: string, scope: EditScope): Promise<string | undefined>;
+    close(): void;
+    requestRender(): void;
+}
+/** Display text of a setting value (unset ASCII shows the detected value). */
+export declare function settingValueText(spec: SettingSpec, value: SettingValue, theme: Theme): string;
+/** Why the row cannot be changed in `scope` (undefined: editable). */
+export declare function blockedReason(spec: SettingSpec, value: SettingValue, scope: EditScope): string | undefined;
+/** Panel rows for a snapshot (pure; frame tests use it directly). */
+export declare function settingRows(snapshot: ConfigSnapshot, scope: EditScope, theme: Theme): SettingsRow[];
+/** Hint text for an "edited elsewhere" row id (undefined for settings). */
+export declare function hintOf(id: string): string | undefined;
+export declare class ConfigPanel implements Component, Focusable {
+    private snapshot;
+    private readonly deps;
+    focused: boolean;
+    scope: EditScope;
+    private readonly list;
+    private searching;
+    private edit;
+    private pendingUnset;
+    private notice;
+    private busy;
+    constructor(snapshot: ConfigSnapshot, deps: ConfigPanelDeps);
+    /** Selected row id (tests). */
+    get selectedKey(): string | undefined;
+    get editing(): boolean;
+    refresh(snapshot?: ConfigSnapshot): void;
+    select(key: string): void;
+    setNotice(text: string | undefined, color?: SemanticColor): void;
+    /** Open the inline editor for a number / text key. */
+    startEdit(key: string, initial: string): void;
+    handleInput(data: string): void;
+    private move;
+    /** Run a controller action; input is ignored until it settles. */
+    private run;
+    private editInput;
+    render(width: number): string[];
+    private body;
+    private description;
+    invalidate(): void;
+}

package/dist/modes/interactive/config-panel.js

@@ -0,0 +1,319 @@
+/**
+ * `/config` settings panel component (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ *
+ * Bottom overlay with the card bar: title + write target (`Tab` switches user / project), a search line,
+ * the grouped `SettingsList`, a rule, the selected key's description (key-docs, dim, wrapped), one notice
+ * line and the key hints. What a key press *does* to a setting is the controller's job (config-ui.ts):
+ * the panel calls `activate(key)` for Enter / Space, `unset(key)` for a confirmed Backspace / Delete,
+ * `commit(key, text)` for the inline number / text editor, `switchScope()` for Tab and `close()` for Esc.
+ *
+ * Keys: ↑↓ (and Ctrl+P / Ctrl+N) move; `/` starts a search (typing filters, Esc clears it first, a
+ * second Esc closes); Backspace / Delete asks once, then unsets; inside the editor Enter saves (an
+ * invalid value stays in the box with the error in red), Esc cancels.
+ */
+import { Card, SettingsList, defaultKeybindings, isPasteData, isPrintableText, matchesKey, truncateToWidth, unwrapPaste, wrapTextWithAnsi, } from "../../tui.js";
+import { msg } from "../../i18n/index.js";
+import { formatSettingValue, getConfigValue, overriddenFor, } from "../../config/edit.js";
+import { SETTING_HINTS, settingDoc, settingDynamicDefault, settingsRegistry, } from "../../config/settings-registry.js";
+const ELSEWHERE = "elsewhere:";
+/** Display text of a setting value (unset ASCII shows the detected value). */
+export function settingValueText(spec, value, theme) {
+    if (value.value === undefined && spec.key === "ui.ascii")
+        return msg().settings.auto(String(theme.glyphs.ascii));
+    return formatSettingValue(value.value);
+}
+function lockReason(value) {
+    const reasons = msg().settings.lockReason;
+    if (value.source === "env")
+        return reasons.env(value.envName ?? "");
+    if (value.source === "cli")
+        return reasons.cli;
+    if (value.source === "profile")
+        return reasons.profile;
+    return reasons.project;
+}
+/** Why the row cannot be changed in `scope` (undefined: editable). */
+export function blockedReason(spec, value, scope) {
+    const s = msg().settings;
+    if (overriddenFor(value, scope) !== undefined)
+        return s.errors.locked(s.labels[spec.key] ?? spec.key, lockReason(value));
+    if (scope === "project" && spec.project === "deny")
+        return s.errors.projectDenied(spec.key);
+    return undefined;
+}
+/** Panel rows for a snapshot (pure; frame tests use it directly). */
+export function settingRows(snapshot, scope, theme) {
+    const s = msg().settings;
+    const labels = s.labels;
+    const rows = settingsRegistry().map((spec) => {
+        const value = getConfigValue(snapshot, spec.key);
+        const locked = overriddenFor(value, scope) !== undefined;
+        const tag = spec.prefix === true ? `${s.apply[spec.apply]} · ${s.prefixTag}` : s.apply[spec.apply];
+        let note;
+        let noteColor;
+        if (locked) {
+            note = s.locked(value.envName ?? value.source);
+            noteColor = "warning";
+        }
+        else if (scope === "project" && spec.project !== "any")
+            note = s.projectNote[spec.project];
+        else if (value.source !== "default")
+            note = s.source(value.source);
+        const row = {
+            id: spec.key,
+            group: s.groups[spec.group],
+            label: labels[spec.key] ?? spec.key,
+            value: settingValueText(spec, value, theme),
+            tag,
+            search: [...(spec.options ?? []), settingDoc(spec.key) ?? ""].join(" "),
+        };
+        if (value.value === undefined)
+            row.valueColor = "dim";
+        if (note !== undefined)
+            row.note = note;
+        if (noteColor !== undefined)
+            row.noteColor = noteColor;
+        if (scope === "project" && spec.project === "deny")
+            row.dim = true;
+        return row;
+    });
+    for (const hint of SETTING_HINTS) {
+        rows.push({
+            id: `${ELSEWHERE}${hint.key}`,
+            group: s.groups.elsewhere,
+            label: hint.key,
+            value: s.hints[hint.hint],
+            dim: true,
+        });
+    }
+    return rows;
+}
+/** Hint text for an "edited elsewhere" row id (undefined for settings). */
+export function hintOf(id) {
+    if (!id.startsWith(ELSEWHERE))
+        return undefined;
+    const key = id.slice(ELSEWHERE.length);
+    const hint = SETTING_HINTS.find((h) => h.key === key);
+    return hint === undefined ? undefined : msg().settings.hints[hint.hint];
+}
+class Lines {
+    build;
+    constructor(build) {
+        this.build = build;
+    }
+    render(width) {
+        return this.build(width);
+    }
+    invalidate() { }
+}
+/** Fixed lines besides the list: title (+ embedded), search, rule, description (≤ 3), notice, footer. */
+const CHROME = 8;
+export class ConfigPanel {
+    snapshot;
+    deps;
+    focused = false;
+    scope = "user";
+    list;
+    searching = false;
+    edit;
+    pendingUnset;
+    notice;
+    busy = false;
+    constructor(snapshot, deps) {
+        this.snapshot = snapshot;
+        this.deps = deps;
+        this.list = new SettingsList({ theme: deps.theme, emptyText: msg().settings.noMatches });
+        this.refresh(snapshot);
+    }
+    /** Selected row id (tests). */
+    get selectedKey() {
+        return this.list.selectedRow?.id;
+    }
+    get editing() {
+        return this.edit !== undefined;
+    }
+    refresh(snapshot = this.snapshot) {
+        this.snapshot = snapshot;
+        this.list.setRows(settingRows(snapshot, this.scope, this.deps.theme));
+    }
+    select(key) {
+        this.list.selectId(key);
+    }
+    setNotice(text, color = "dim") {
+        this.notice = text === undefined ? undefined : { text, color };
+    }
+    /** Open the inline editor for a number / text key. */
+    startEdit(key, initial) {
+        this.edit = { key, text: initial };
+    }
+    handleInput(data) {
+        if (this.busy)
+            return;
+        const keys = this.deps.keybindings ?? defaultKeybindings;
+        if (this.edit !== undefined)
+            return this.editInput(data);
+        const row = this.list.selectedRow;
+        const unsetKey = matchesKey(data, "backspace") || matchesKey(data, "delete");
+        if (!unsetKey || this.searching)
+            this.pendingUnset = undefined;
+        if (keys.matches(data, "tui.select.up"))
+            return this.move(-1);
+        if (keys.matches(data, "tui.select.down"))
+            return this.move(1);
+        if (matchesKey(data, "escape") || keys.matches(data, "app.clear")) {
+            if (this.searching || this.list.query !== "") {
+                this.searching = false;
+                this.list.setQuery("");
+                return;
+            }
+            return this.deps.close();
+        }
+        if (matchesKey(data, "tab")) {
+            this.scope = this.scope === "user" ? "project" : "user";
+            this.notice = undefined;
+            this.refresh();
+            return;
+        }
+        if (this.searching) {
+            if (matchesKey(data, "enter") && row !== undefined)
+                return this.run(this.deps.activate(row.id, this.scope));
+            if (matchesKey(data, "backspace"))
+                return this.list.setQuery([...this.list.query].slice(0, -1).join(""));
+            const text = isPasteData(data) ? unwrapPaste(data) : isPrintableText(data) ? data : "";
+            if (text !== "")
+                this.list.setQuery(this.list.query + text.replace(/\s+/g, " "));
+            return;
+        }
+        if (data === "/") {
+            this.searching = true;
+            return;
+        }
+        if (row === undefined)
+            return;
+        if (matchesKey(data, "enter") || matchesKey(data, "space")) {
+            this.notice = undefined;
+            const hint = hintOf(row.id);
+            if (hint !== undefined)
+                return this.setNotice(hint);
+            return this.run(this.deps.activate(row.id, this.scope));
+        }
+        if (unsetKey && hintOf(row.id) === undefined) {
+            if (this.pendingUnset === row.id) {
+                this.pendingUnset = undefined;
+                return this.run(this.deps.unset(row.id, this.scope));
+            }
+            this.pendingUnset = row.id;
+            this.setNotice(msg().settings.confirmUnset(row.id), "warning");
+        }
+    }
+    move(delta) {
+        this.list.move(delta);
+        this.pendingUnset = undefined;
+        if (!this.searching)
+            this.notice = undefined;
+    }
+    /** Run a controller action; input is ignored until it settles. */
+    run(result) {
+        if (!(result instanceof Promise))
+            return;
+        this.busy = true;
+        void result.finally(() => {
+            this.busy = false;
+            this.deps.requestRender();
+        });
+    }
+    editInput(data) {
+        const edit = this.edit;
+        if (matchesKey(data, "escape") ||
+            (this.deps.keybindings ?? defaultKeybindings).matches(data, "app.clear")) {
+            this.edit = undefined;
+            return;
+        }
+        if (matchesKey(data, "enter")) {
+            this.busy = true;
+            void this.deps
+                .commit(edit.key, edit.text, this.scope)
+                .then((error) => {
+                if (error === undefined)
+                    this.edit = undefined;
+                else
+                    edit.error = error;
+            })
+                .finally(() => {
+                this.busy = false;
+                this.deps.requestRender();
+            });
+            return;
+        }
+        if (matchesKey(data, "backspace"))
+            edit.text = [...edit.text].slice(0, -1).join("");
+        else if (isPasteData(data))
+            edit.text += unwrapPaste(data).replace(/\s+/g, " ");
+        else if (isPrintableText(data))
+            edit.text += data;
+        else
+            return;
+        delete edit.error;
+    }
+    render(width) {
+        const { theme } = this.deps;
+        const s = msg().settings;
+        const rows = this.deps.rows?.();
+        const embedded = this.deps.embedded === true ? 1 : 0;
+        if (rows !== undefined)
+            this.list.maxVisible = rows - 1 - CHROME - embedded;
+        const subtitle = `${s.writeTo(s.scope[this.scope], this.deps.paths[this.scope])}  ${s.tabSwitch}`;
+        const card = new Card(new Lines((w) => this.body(w)), { theme, title: s.title, subtitle });
+        return card.render(width);
+    }
+    body(width) {
+        const { theme } = this.deps;
+        const s = msg().settings;
+        const out = [];
+        if (this.deps.embedded === true)
+            out.push(theme.fg("warning", s.embedded));
+        const query = this.list.query;
+        out.push(this.searching || query !== ""
+            ? `${s.searchPrompt(query)}${this.searching && this.edit === undefined ? theme.fg("accent", "_") : ""}`
+            : theme.fg("dim", s.searchPlaceholder));
+        out.push(...this.list.render(width));
+        out.push(theme.fg("border", theme.glyphs.rule.repeat(Math.max(1, width))));
+        out.push(...this.description(width));
+        if (this.edit !== undefined) {
+            const label = s.labels[this.edit.key] ?? this.edit.key;
+            const box = `${s.editPrompt(label)}${this.edit.text}${theme.fg("accent", "_")}`;
+            out.push(truncateToWidth(box, width));
+            if (this.edit.error !== undefined)
+                out.push(theme.fg("error", truncateToWidth(this.edit.error, width)));
+        }
+        else if (this.notice !== undefined) {
+            out.push(...wrapTextWithAnsi(theme.fg(this.notice.color, this.notice.text), width).slice(0, 2));
+        }
+        const footer = this.edit !== undefined
+            ? s.footerEdit
+            : this.searching
+                ? s.footerSearch
+                : width < 72
+                    ? s.footerCompact
+                    : s.footer;
+        out.push(theme.fg("dim", truncateToWidth(footer, width)));
+        return out;
+    }
+    description(width) {
+        const { theme } = this.deps;
+        const row = this.list.selectedRow;
+        if (row === undefined || hintOf(row.id) !== undefined)
+            return [];
+        const doc = settingDoc(row.id) ?? "";
+        const value = getConfigValue(this.snapshot, row.id);
+        const dynamic = value.value === undefined ? settingDynamicDefault(row.id) : undefined;
+        const text = dynamic === undefined ? doc : `${doc} · ${dynamic}`;
+        const spec = settingsRegistry().find((x) => x.key === row.id);
+        const blocked = spec === undefined ? undefined : blockedReason(spec, value, this.scope);
+        const lines = blocked === undefined ? [] : [theme.fg("warning", truncateToWidth(blocked, width))];
+        if (text !== "")
+            lines.push(...wrapTextWithAnsi(theme.fg("dim", text), width));
+        return lines.slice(0, 3);
+    }
+    invalidate() { }
+}