@armadra/agent 0.2.1 → 0.4.0

package/dist/modes/interactive/panels.js

@@ -0,0 +1,143 @@
+/**
+ * 消息区面板（终端界面视觉设计 v1 §3.13）：`/session`、`/cache`、`/permissions` 用左竖条卡片 + 键值表
+ * 渲染，而不是把纯文本拍进通知。line 模式与 RPC 仍用 session-report 的文本版。
+ *
+ * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 用量 / 上下文（余量表，阈值着色），
+ *   空一行后「缓存」段（与 `/cache` 共用 `cacheRows`）；
+ * - `/permissions`：权限模式、判定顺序（折行对齐值列）、规则（allow success、deny error、来源 dim）、
+ *   最近的 auto 判定。
+ */
+import { AUTO_LAYER_TEXT, permissionModeLabel } from "../../permissions/modes.js";
+import { Card, KeyValue, Meter, } from "../../tui.js";
+import { cacheRows, formatTokenCount, formatUsd } from "../session-report.js";
+import { tildePath } from "../../cli/startup-screen.js";
+/** 多段内容按顺序拼起来（段之间不加空行，由调用方放空串）。 */
+class Stack {
+    parts;
+    constructor(parts) {
+        this.parts = parts;
+    }
+    render(width) {
+        return this.parts.flatMap((part) => (typeof part === "string" ? [part] : part.render(width)));
+    }
+    invalidate() {
+        for (const part of this.parts)
+            if (typeof part !== "string")
+                part.invalidate();
+    }
+}
+/** 缩进若干列的子组件。 */
+class Indent {
+    child;
+    columns;
+    constructor(child, columns) {
+        this.child = child;
+        this.columns = columns;
+    }
+    render(width) {
+        const pad = " ".repeat(this.columns);
+        return this.child
+            .render(Math.max(1, width - this.columns))
+            .map((line) => (line === "" ? "" : pad + line));
+    }
+    invalidate() {
+        this.child.invalidate();
+    }
+}
+function keyValue(rows, theme, wrap = false) {
+    return new KeyValue(rows, { theme, maxKeyRatio: 0.3, ...(wrap ? { wrap: true } : {}) });
+}
+function cacheSection(session, theme, now) {
+    return [theme.bold("缓存"), new Indent(keyValue(cacheRows(session, now), theme), 2)];
+}
+export function sessionPanel(session, theme, options = {}) {
+    const now = options.now ?? Date.now();
+    const state = session.state;
+    const stats = session.getStats();
+    const t = stats.tokens;
+    const sep = theme.fg("dim", " · ");
+    const model = state.model === undefined ? "?" : `${state.model.provider}/${state.model.id}`;
+    const ratio = stats.contextPercent === undefined ? undefined : stats.contextPercent / 100;
+    const meter = new Meter(ratio, { theme }).render(40)[0] ?? "";
+    const window = stats.contextTokens === undefined && stats.contextWindow === undefined
+        ? ""
+        : sep +
+            `${stats.contextTokens === undefined ? "?" : formatTokenCount(stats.contextTokens)} / ` +
+            `${stats.contextWindow === undefined ? "?" : formatTokenCount(stats.contextWindow)}`;
+    const rows = [
+        {
+            key: "模型",
+            value: theme.fg("accent", model) +
+                sep +
+                `思考 ${state.thinkingLevel}` +
+                sep +
+                `权限 ${permissionModeLabel(state.permissionMode)}`,
+        },
+        {
+            key: "消息",
+            value: [
+                `用户 ${stats.userMessages}`,
+                `助手 ${stats.assistantMessages}`,
+                `工具调用 ${stats.toolCalls}`,
+            ].join(sep),
+        },
+        {
+            key: "用量",
+            value: [
+                `输入 ${formatTokenCount(t.input)}`,
+                `输出 ${formatTokenCount(t.output)}`,
+                `缓存读 ${formatTokenCount(t.cacheRead)}`,
+                `缓存写 ${formatTokenCount(t.cacheWrite)}`,
+                formatUsd(stats.cost),
+            ].join(sep),
+        },
+        { key: "上下文", value: meter + window },
+    ];
+    const file = state.sessionFile === undefined ? "未落盘" : tildePath(state.sessionFile, options.home);
+    return new Card(new Stack([keyValue(rows, theme), "", ...cacheSection(session, theme, now)]), {
+        theme,
+        title: `会话 ${state.sessionId.slice(0, 8)}`,
+        subtitle: file,
+    });
+}
+export function cachePanel(session, theme, now = Date.now()) {
+    return new Card(keyValue(cacheRows(session, now), theme), { theme, title: "缓存" });
+}
+const DECISION_COLOR = {
+    allow: "success",
+    deny: "error",
+    ask: "warning",
+};
+export function permissionsPanel(runtime, session, theme) {
+    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 effect = (decision) => theme.fg(DECISION_COLOR[decision] ?? "text", decision.padEnd(5));
+    const parts = [
+        keyValue([
+            { key: "权限模式", value: `${permissionModeLabel(mode)}${theme.fg("dim", `（${mode}）`)}` },
+            { key: "判定顺序", value: order },
+        ], theme, true),
+        theme.bold(rules.length === 0 ? "规则（无）" : `规则（${rules.length}）`),
+    ];
+    if (rules.length > 0) {
+        parts.push(new Indent(keyValue(rules.map((r) => ({
+            key: effect(r.effect),
+            value: `${r.raw}  ${theme.fg("dim", `[${r.source}]`)}`,
+        })), theme), 2));
+    }
+    const recent = runtime.permission.autoDecisions?.() ?? [];
+    if (recent.length > 0) {
+        parts.push(theme.bold(`最近的 auto 判定（${recent.length}）`));
+        parts.push(new Indent(keyValue(recent.map((d) => ({
+            key: AUTO_LAYER_TEXT[d.layer],
+            value: `${effect(d.decision)}  ${d.toolName} ${d.summary} — ${d.reason}` +
+                (d.cached === true ? theme.fg("dim", "（缓存）") : ""),
+        })), theme), 2));
+    }
+    return new Card(new Stack(parts), { theme });
+}

package/dist/modes/interactive/pickers.d.ts

@@ -4,8 +4,11 @@
  * - 模型：按供应商分组并标 key 状态（`modelItems`，与启动期共用），当前模型预选；
  * - 会话：名字或首条提示、相对时间、消息数（`sessionItems`）；
  * - 树：会话文件里全部用户消息，按分叉缩进，`●` 标出当前分支；选中项回填编辑器（由 commands.ts 处理）；
- * - 权限模式（从严到宽）与思考级别。
+ * - 权限模式（标题「权限模式」，界面顺序 1–6，当前模式 ✓ / Default dim / Recommended accent，底部按键提示，
+ *   上下留白，见 permissionItems）与思考级别；
+ * - 所有选择器底部一行按键提示（dim），模型选择器带 (i/n) 并给当前模型打 ✓。
  */
+import type { PermissionMode } from "../../permissions/types.js";
 import type { SessionEntry } from "../../session/types.js";
 import { type Keybindings, type OverlayHandle, type OverlayOptions, type SelectItem, type Theme, type Component } from "../../tui.js";
 export { modelItems, sessionItems } from "./startup-ui.js";
@@ -23,10 +26,28 @@ export interface PickerSpec {
     filterable?: boolean;
     maxVisible?: number;
     emptyText?: string;
+    /** 右侧序号 1–9，按数字直接选中。 */
+    numberKeys?: boolean;
+    /** 说明放在标签下一行。 */
+    stacked?: boolean;
+    /** 当前值（标 ✓）。 */
+    currentValue?: string;
+    /** 列表下的按键提示，缺省「↑↓ 选择 · Enter 确认 · Esc 取消」。 */
+    footer?: string;
+    /** 提示行前带 (i/n)。 */
+    showCount?: boolean;
+    /** 框内上下留白行数。 */
+    paddingY?: number;
 }
+export declare const PICKER_FOOTER = "\u2191\u2193 \u9009\u62E9 \u00B7 Enter \u786E\u8BA4 \u00B7 Esc \u53D6\u6D88";
 /** 打开一个居中选择器；Enter 返回选中项，Esc / Ctrl+C 返回 undefined。 */
 export declare function openPicker(host: PickerHost, spec: PickerSpec): Promise<SelectItem | undefined>;
-export declare function permissionItems(): SelectItem[];
+/**
+ * 模式选择器（标题「权限模式」）：界面顺序、当前模式打勾（`currentValue`）、配置里的缺省模式标
+ * `Default`、Auto 标 `Recommended`，右侧数字快捷键 1–6，说明在下一行。
+ */
+export declare function permissionItems(_current: PermissionMode, configDefault?: PermissionMode): SelectItem[];
+export declare function permissionPickerSpec(current: PermissionMode, configDefault?: PermissionMode): PickerSpec;
 export declare function thinkingItems(reasoning: boolean): SelectItem[];
 export interface TreeNode {
     entry: SessionEntry;

package/dist/modes/interactive/pickers.js

@@ -4,14 +4,17 @@
  * - 模型：按供应商分组并标 key 状态（`modelItems`，与启动期共用），当前模型预选；
  * - 会话：名字或首条提示、相对时间、消息数（`sessionItems`）；
  * - 树：会话文件里全部用户消息，按分叉缩进，`●` 标出当前分支；选中项回填编辑器（由 commands.ts 处理）；
- * - 权限模式（从严到宽）与思考级别。
+ * - 权限模式（标题「权限模式」，界面顺序 1–6，当前模式 ✓ / Default dim / Recommended accent，底部按键提示，
+ *   上下留白，见 permissionItems）与思考级别；
+ * - 所有选择器底部一行按键提示（dim），模型选择器带 (i/n) 并给当前模型打 ✓。
  */
 import { THINKING_LEVELS } from "../../ai/thinking.js";
-import { PERMISSION_MODES_STRICT_FIRST } from "../../permissions/types.js";
+import { PERMISSION_MODE_INFO, PERMISSION_MODE_ORDER, RECOMMENDED_PERMISSION_MODE, } from "../../permissions/modes.js";
 import { Box, SelectList, } from "../../tui.js";
 import { contentText } from "./message-view.js";
 import { relativeTime } from "./startup-ui.js";
 export { modelItems, sessionItems } from "./startup-ui.js";
+export const PICKER_FOOTER = "↑↓ 选择 · Enter 确认 · Esc 取消";
 /** 打开一个居中选择器；Enter 返回选中项，Esc / Ctrl+C 返回 undefined。 */
 export function openPicker(host, spec) {
     return new Promise((resolve) => {
@@ -26,30 +29,60 @@ export function openPicker(host, spec) {
             filterable: spec.filterable ?? spec.items.length > 8,
             ...(host.keybindings !== undefined ? { keybindings: host.keybindings } : {}),
             ...(spec.emptyText !== undefined ? { emptyText: spec.emptyText } : {}),
+            ...(spec.numberKeys === true ? { numberKeys: true } : {}),
+            ...(spec.stacked === true ? { stacked: true } : {}),
+            ...(spec.currentValue !== undefined ? { currentValue: spec.currentValue } : {}),
+            ...(spec.showCount === true ? { showCount: true } : {}),
+            footer: spec.footer ?? PICKER_FOOTER,
             onSelect: (item) => close(item),
             onCancel: () => close(undefined),
         });
         if (spec.selected !== undefined)
             list.selectValue(spec.selected);
         const width = Math.max(20, Math.min(host.columns() - 2, 72));
-        handle = host.showOverlay(new Box(list, { title: spec.title, theme: host.theme }), {
+        const box = new Box(list, {
+            title: spec.title,
+            theme: host.theme,
+            ...(spec.paddingY !== undefined ? { paddingY: spec.paddingY } : {}),
+        });
+        handle = host.showOverlay(box, {
             anchor: "center",
             width,
         });
     });
 }
-const PERMISSION_TEXT = {
-    plan: "只读，不改文件不跑命令",
-    default: "写入与命令逐次确认",
-    "auto-edit": "文件编辑自动放行，命令确认",
-    "full-auto": "全部放行（危险命令仍确认）",
-};
-export function permissionItems() {
-    return PERMISSION_MODES_STRICT_FIRST.map((mode) => ({
-        value: mode,
-        label: mode,
-        description: PERMISSION_TEXT[mode],
-    }));
+/**
+ * 模式选择器（标题「权限模式」）：界面顺序、当前模式打勾（`currentValue`）、配置里的缺省模式标
+ * `Default`、Auto 标 `Recommended`，右侧数字快捷键 1–6，说明在下一行。
+ */
+export function permissionItems(_current, configDefault = "default") {
+    return PERMISSION_MODE_ORDER.map((mode) => {
+        const info = PERMISSION_MODE_INFO[mode];
+        const item = { value: mode, label: info.label, description: info.description };
+        const badges = [
+            ...(mode === configDefault ? ["Default"] : []),
+            ...(mode === RECOMMENDED_PERMISSION_MODE ? ["Recommended"] : []),
+        ];
+        if (badges.length > 0) {
+            item.badge = badges.join(" · ");
+            if (mode !== RECOMMENDED_PERMISSION_MODE)
+                item.badgeColor = "dim";
+        }
+        return item;
+    });
+}
+export function permissionPickerSpec(current, configDefault = "default") {
+    return {
+        title: "权限模式",
+        items: permissionItems(current, configDefault),
+        selected: current,
+        currentValue: current,
+        filterable: false,
+        numberKeys: true,
+        stacked: true,
+        footer: "↑↓ 选择 · 1-6 直接选 · Enter 确认 · Esc 取消",
+        paddingY: 1,
+    };
 }
 export function thinkingItems(reasoning) {
     return THINKING_LEVELS.map((level) => {

package/dist/modes/interactive/run-indicator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 运行指示与排队消息（终端界面视觉设计 v1 §3.7、§3.8）：输入框上方的 Loader 动词状态机与排队列表。
+ *
+ * 动词按「当前最深状态」取，避免事件乱序时闪回：
+ *   审批打开 → `等待确认`（无 Esc 提示，Esc 由对话框消费）
+ *   有运行中的工具 → `运行 bash` / `运行 3 个工具`
+ *   自动重试等待中 → `重试 2/3 · 2s 后`（不显示已用时）
+ *   压缩中 → `压缩上下文`
+ *   助手在流式输出 → 末块是思考 `思考中`，否则 `回复中 · ↓≈1.2k`（本条输出的估算 token，4 字符 ≈ 1）
+ *   其余（等首个 token）→ `思考中`
+ * 运行或压缩时 Loader 才挂进槽位；附加项 `Esc 中断`。
+ *
+ * 排队消息：缩进 2 列（挂在当前回合下），`↳ 插话 / 之后  文本` 整体 muted、标签 dim；超过 3 条首行
+ * `… 另 N 条`；末行 `Alt+↑ 取回 · Esc 回填并中断`。
+ */
+import type { SessionEvent } from "../../agent/types.js";
+import { Container, Text, type Loader, type Theme } from "../../tui.js";
+import type { ToolTracker } from "./tool-view.js";
+export declare const QUEUE_PREVIEW = 3;
+export interface RunIndicatorDeps {
+    theme: Theme;
+    loader: Loader;
+    /** Loader 的挂载槽位（运行时才有子组件）。 */
+    slot: Container;
+    tools: ToolTracker;
+    render(): void;
+}
+export declare class RunIndicator {
+    private readonly deps;
+    running: boolean;
+    compacting: boolean;
+    private approval;
+    private retry;
+    private stream;
+    constructor(deps: RunIndicatorDeps);
+    get busy(): boolean;
+    setApproval(open: boolean): void;
+    /** 会话切换后清零。 */
+    reset(): void;
+    /** 会话事件 → 状态；返回后已同步 Loader。 */
+    onEvent(event: SessionEvent): void;
+    /** 按当前状态换动词，并挂上 / 撤下 Loader。 */
+    sync(): void;
+    private applyVerb;
+}
+/** 排队消息（插话 / 之后），挂在 Loader 之上。 */
+export declare class QueueView extends Text {
+    private readonly theme;
+    constructor(theme: Theme);
+    setQueue(steering: readonly string[], followUp: readonly string[]): void;
+}

package/dist/modes/interactive/run-indicator.js

@@ -0,0 +1,189 @@
+/**
+ * 运行指示与排队消息（终端界面视觉设计 v1 §3.7、§3.8）：输入框上方的 Loader 动词状态机与排队列表。
+ *
+ * 动词按「当前最深状态」取，避免事件乱序时闪回：
+ *   审批打开 → `等待确认`（无 Esc 提示，Esc 由对话框消费）
+ *   有运行中的工具 → `运行 bash` / `运行 3 个工具`
+ *   自动重试等待中 → `重试 2/3 · 2s 后`（不显示已用时）
+ *   压缩中 → `压缩上下文`
+ *   助手在流式输出 → 末块是思考 `思考中`，否则 `回复中 · ↓≈1.2k`（本条输出的估算 token，4 字符 ≈ 1）
+ *   其余（等首个 token）→ `思考中`
+ * 运行或压缩时 Loader 才挂进槽位；附加项 `Esc 中断`。
+ *
+ * 排队消息：缩进 2 列（挂在当前回合下），`↳ 插话 / 之后  文本` 整体 muted、标签 dim；超过 3 条首行
+ * `… 另 N 条`；末行 `Alt+↑ 取回 · Esc 回填并中断`。
+ */
+import { Container, Text } from "../../tui.js";
+import { ORIGIN_LABELS } from "./message-view.js";
+import { formatTokens } from "./status-bar.js";
+export const QUEUE_PREVIEW = 3;
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+/** 助手消息里已流出的文字（思考 + 正文）的估算 token 与末块类型。 */
+function streamState(message) {
+    let chars = 0;
+    let last;
+    for (const block of message.content) {
+        if (block.type === "text") {
+            chars += block.text.length;
+            if (block.text !== "")
+                last = "text";
+        }
+        else if (block.type === "thinking") {
+            chars += block.thinking.length;
+            if (block.thinking !== "")
+                last = "thinking";
+        }
+        else if (block.type === "toolCall")
+            last = "toolCall";
+    }
+    return { tokens: Math.ceil(chars / 4), thinking: last === "thinking" };
+}
+export class RunIndicator {
+    deps;
+    running = false;
+    compacting = false;
+    approval = false;
+    retry;
+    stream;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get busy() {
+        return this.running || this.compacting;
+    }
+    setApproval(open) {
+        this.approval = open;
+        this.sync();
+    }
+    /** 会话切换后清零。 */
+    reset() {
+        this.running = false;
+        this.compacting = false;
+        this.approval = false;
+        this.retry = undefined;
+        this.stream = undefined;
+        this.sync();
+    }
+    /** 会话事件 → 状态；返回后已同步 Loader。 */
+    onEvent(event) {
+        switch (event.type) {
+            case "agent_start":
+                this.running = true;
+                break;
+            case "agent_settled":
+                this.running = false;
+                this.retry = undefined;
+                this.stream = undefined;
+                break;
+            case "message_start":
+                if (event.message.role === "assistant") {
+                    this.retry = undefined;
+                    this.stream = streamState(event.message);
+                }
+                break;
+            case "message_update":
+                if (event.message.role === "assistant")
+                    this.stream = streamState(event.message);
+                break;
+            case "message_end":
+                if (event.message.role === "assistant")
+                    this.stream = undefined;
+                break;
+            case "compaction_start":
+                this.compacting = true;
+                break;
+            case "compaction_end":
+                this.compacting = false;
+                break;
+            case "auto_retry_start":
+                this.retry = { attempt: event.attempt, max: event.maxAttempts, delayMs: event.delayMs };
+                break;
+            case "auto_retry_end":
+                this.retry = undefined;
+                break;
+            case "tool_execution_start":
+            case "tool_execution_end":
+                break;
+            default:
+                return;
+        }
+        this.sync();
+    }
+    /** 按当前状态换动词，并挂上 / 撤下 Loader。 */
+    sync() {
+        const { loader, slot, render } = this.deps;
+        const active = this.busy;
+        if (active)
+            this.applyVerb();
+        if (active && slot.children.length === 0) {
+            slot.addChild(loader);
+            loader.start();
+        }
+        else if (!active && slot.children.length > 0) {
+            loader.stop();
+            slot.clear();
+        }
+        render();
+    }
+    applyVerb() {
+        const { loader, tools } = this.deps;
+        const esc = ["Esc 中断"];
+        if (this.approval) {
+            loader.setVerb("等待确认");
+            return;
+        }
+        const running = tools.running();
+        const top = running.filter((view) => !running.some((p) => p.children.includes(view)));
+        if (top.length === 1) {
+            loader.setVerb(`运行 ${top[0].toolName}`, esc);
+            return;
+        }
+        if (top.length > 1) {
+            loader.setVerb(`运行 ${top.length} 个工具`, esc);
+            return;
+        }
+        if (this.retry !== undefined) {
+            const seconds = Math.max(1, Math.round(this.retry.delayMs / 1000));
+            loader.setVerb(`重试 ${this.retry.attempt}/${this.retry.max}`, [`${seconds}s 后`], {
+                elapsed: false,
+            });
+            return;
+        }
+        if (this.compacting) {
+            loader.setVerb("压缩上下文", esc);
+            return;
+        }
+        const stream = this.stream;
+        if (stream !== undefined && !stream.thinking && stream.tokens > 0) {
+            loader.setVerb("回复中", [`↓≈${formatTokens(stream.tokens)}`, ...esc]);
+            return;
+        }
+        loader.setVerb("思考中", esc);
+    }
+}
+/** 排队消息（插话 / 之后），挂在 Loader 之上。 */
+export class QueueView extends Text {
+    theme;
+    constructor(theme) {
+        super("");
+        this.theme = theme;
+    }
+    setQueue(steering, followUp) {
+        const t = this.theme;
+        const row = (origin, text) => `  ${t.fg("dim", `${t.glyphs.queued} ${ORIGIN_LABELS[origin]}`)}  ${t.fg("muted", oneLine(text))}`;
+        const rows = [
+            ...steering.map((text) => row("steer", text)),
+            ...followUp.map((text) => row("followUp", text)),
+        ];
+        const shown = rows.slice(-QUEUE_PREVIEW);
+        if (rows.length > shown.length) {
+            shown.unshift("  " + t.fg("dim", `${t.glyphs.ellipsis} 另 ${rows.length - shown.length} 条`));
+        }
+        if (rows.length > 0) {
+            shown.push("    " + t.fg("dim", `Alt+${t.glyphs.arrowUp} 取回 · Esc 回填并中断`));
+        }
+        this.setText(shown.join("\n"));
+    }
+}

package/dist/modes/interactive/startup-header.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 交互模式启动头（终端界面视觉设计 v1 §3.1）。
+ *
+ * - `normal`：宽度 ≥ 56 且非 `ui.compact` 时画框（宽 `min(width, 64)`，左对齐）——标题 `✻ ama x.y.z`、
+ *   键值行（模型 / 目录 / 模式 / 已加载 / 宿主 / 警告）、按键提示；否则去框去键列，每项一行。
+ * - `header`：一行 `✻ ama x.y.z · 模型 · 模式 · /help`，无框。`silent` 不输出（调用方不加本组件）。
+ * - 着色：`✻` accent、标题粗体；键列 dim；模型 accent；已信任 success / 未信任 warning；Bypass 模式 warning；
+ *   按键提示 dim。路径过长时从左截断（`…/armadra-agent`）。宽度变化时按新宽重算是否去框。
+ */
+import type { StartupInfo } from "../../cli/startup-screen.js";
+import { type Component, type Theme } from "../../tui.js";
+/** 画框的最小宽度；更窄时去框去键列。 */
+export declare const HEADER_BOX_MIN_WIDTH = 56;
+/** 设计稿写 60；常见的「供应商/模型@渠道 · 思考 级别」要 62 列左右才不截断，取 64。 */
+export declare const HEADER_BOX_MAX_WIDTH = 64;
+export interface StartupHeaderOptions {
+    theme: Theme;
+    level: "normal" | "header";
+    /** `ui.compact`：normal 也不画框。 */
+    compact?: boolean;
+}
+/** 从左截断到 `width` 列（保留末尾，前面加省略号）。 */
+export declare function truncateLeft(text: string, width: number, ellipsis?: string): string;
+export declare class StartupHeader implements Component {
+    private readonly info;
+    private readonly options;
+    private cache;
+    constructor(info: StartupInfo, options: StartupHeaderOptions);
+    private get theme();
+    private title;
+    private modeText;
+    private trustText;
+    private loadedText;
+    private codemodeText;
+    render(width: number): string[];
+    private headerLine;
+    private plainLines;
+    private boxLines;
+    invalidate(): void;
+}