@armadra/agent 0.5.1 → 0.6.1

package/dist/modes/interactive/commands.js

@@ -10,33 +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 / Tab（输入为空时）切换权限模式（进入 Bypass 前确认）  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 } : {};
 }
@@ -52,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");
@@ -79,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("● "));
@@ -95,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);
@@ -111,23 +151,31 @@ 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: "选择模型",
-                items: await modelItems(ui.env === undefined
-                    ? ui.runtime.providers
-                    : hideFakeProvider(ui.runtime.providers, ui.env)),
-                filterable: true,
-                showCount: true,
-                ...(ref !== undefined ? { selected: ref, currentValue: ref } : {}),
-            });
+            const providers = ui.env === undefined
+                ? ui.runtime.providers
+                : hideFakeProvider(ui.runtime.providers, ui.env);
+            const picked = ui.pickModel !== undefined
+                ? await ui.pickModel(providers, ref)
+                : (await ui.pick({
+                    title: m.modelTitle,
+                    items: await modelItems(providers, {
+                        current: ref,
+                        enabled: ui.runtime.config.models?.enabled,
+                        hints: false,
+                    }),
+                    filterable: true,
+                    showCount: true,
+                    ...(ref !== undefined ? { selected: ref, currentValue: ref } : {}),
+                }))?.value;
             if (picked === undefined)
                 return;
-            await session.setModel(picked.value);
-            ui.notice("info", `模型：${picked.value}`);
+            await session.setModel(picked);
+            ui.notice("info", m.modelSet(picked));
             return;
         }
         case "session": {
@@ -137,26 +185,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;
         }
@@ -167,11 +215,11 @@ async function handlePick(what, ui) {
             const mode = picked.value;
             const current = session.state.permissionMode;
             if (mode !== current && ui.confirmMode !== undefined && !(await ui.confirmMode(mode))) {
-                ui.notice("info", `已取消，权限模式仍为 ${permissionModeLabel(current)}`);
+                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": {
@@ -179,13 +227,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: `↑↓ 选择 · 1-${THINKING_LEVELS.length} 直接选 · Enter 确认 · Esc 取消`,
+                footer: m.numberFooter("↑↓", THINKING_LEVELS.length),
             });
             if (picked !== undefined)
                 session.setThinkingLevel(picked.value);
@@ -201,6 +249,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;
@@ -251,7 +302,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;
+}