@armadra/agent 0.3.0 → 0.5.0

package/dist/modes/interactive/status-area.js

@@ -0,0 +1,190 @@
+/**
+ * 交互界面的底部区域：提示行、速率行（status-line.ts）与状态栏（status-bar.ts）的装配。[W5-A]
+ *
+ * - 布局 `ui.statusLine`（独立终端缺省 full；有 profile 时 PROFILE_DEFAULTS 给 compact）；运行时 Ctrl+G
+ *   （`app.statusLine.toggle`）或 `/statusline [full|compact]` 切换，只影响本会话（本进程），不写配置。
+ * - 会话时长从本进程打开当前会话（含 /new /resume /fork 切换）起算，用界面的时钟。
+ * - git：`GitInfoWatcher` 在回合边界刷新——agent_settled、写类工具（write / edit / bash / task）结束、
+ *   session_rewound、/tree 之后；结果变化时重画。
+ * - [W5-U] `model_fallback` 之后状态栏模型项显示 `主模型 → 回退模型`，切回主模型（`model_changed`）后消失。
+ * - `telemetry_tick`（流式中 ≤ 2 Hz）只重取统计并重画（速率行），状态栏的内容这时不变。
+ */
+import { basename } from "node:path";
+import { sandboxCapabilityFor } from "../../codemode/capability.js";
+import { formatModelRef } from "../../ai/providers/channels.js";
+import { GitInfoWatcher } from "../../git/info.js";
+import { resolveBashSandbox } from "../../sandbox/bash.js";
+import { osSandboxStatus } from "../../sandbox/detect.js";
+import { effectiveCodemodeMode } from "../../tools/presets.js";
+import { truncateToWidth } from "../../tui.js";
+import { StatusBar } from "./status-bar.js";
+import { StatusLine } from "./status-line.js";
+/** 结束后可能改了工作区的工具。 */
+const WRITE_TOOLS = new Set(["write", "edit", "bash", "task"]);
+/** 一行提示；空时不占行。 */
+export class HintLine {
+    text = "";
+    setText(text) {
+        this.text = text;
+    }
+    render(width) {
+        return this.text === "" ? [] : [truncateToWidth(this.text, width)];
+    }
+    invalidate() { }
+}
+export class StatusArea {
+    deps;
+    hint = new HintLine();
+    bar;
+    rate;
+    mode;
+    startedAt;
+    git;
+    gitCwd;
+    offGit = () => undefined;
+    sandboxStrict;
+    /** [W5-U] 模型回退中（`model_fallback` 到切回主模型）。 */
+    fallback;
+    bashSandbox;
+    constructor(deps) {
+        this.deps = deps;
+        const { runtime } = deps;
+        this.mode = deps.layout ?? runtime.config.ui?.statusLine ?? "full";
+        this.startedAt = deps.now();
+        const source = {
+            session: () => deps.session(),
+            preset: () => runtime.config.tools?.preset ?? "default",
+            hostStatus: () => runtime.host?.status(),
+            codemode: () => {
+                const mode = effectiveCodemodeMode(runtime.config);
+                const active = deps
+                    .session()
+                    .getTools()
+                    .some((tool) => tool.name === "codemode");
+                return mode === "off" || !active ? undefined : mode;
+            },
+            // S2：Node 权限模型与 OS 沙箱都不隔离网络时才标 net!（尊重 sandbox.enabled）
+            sandboxStrict: () => (this.sandboxStrict ??= sandboxCapabilityFor(runtime.config).strict),
+            layout: () => this.mode,
+            git: () => this.gitView(),
+            now: () => deps.now(),
+            sessionStartedAt: () => this.startedAt,
+            fallback: () => this.fallback,
+            // S2：bash 沙箱生效（配置 + 本机能力，与 compose 同一结论）且 bash 工具活动
+            bashSandbox: () => (this.bashSandbox ??= resolveBashSandbox(runtime.config.sandbox, {
+                status: osSandboxStatus(),
+            }).active) &&
+                deps
+                    .session()
+                    .getTools()
+                    .some((tool) => tool.name === "bash"),
+        };
+        this.bar = new StatusBar(source, deps.theme);
+        this.rate = new StatusLine(this.bar, source, deps.theme);
+        this.watchGit();
+    }
+    layout() {
+        return this.mode;
+    }
+    setLayout(mode) {
+        if (mode === this.mode)
+            return;
+        this.mode = mode;
+        (this.deps.redraw ?? this.deps.render)();
+    }
+    toggle() {
+        this.setLayout(this.mode === "full" ? "compact" : "full");
+        return this.mode;
+    }
+    refresh() {
+        this.bar.refresh();
+    }
+    /** 换了会话（/new /resume /fork）：时长重新起算，cwd 变了就换 git 监视。 */
+    rebind() {
+        this.startedAt = this.deps.now();
+        this.fallback = undefined;
+        this.watchGit();
+        this.bar.refresh();
+    }
+    refreshGit() {
+        void this.git?.refresh();
+    }
+    /** 返回 true：事件已处理完（只需重画），调用方不再分派。 */
+    onEvent(event) {
+        switch (event.type) {
+            case "telemetry_tick":
+                this.bar.refresh();
+                return true;
+            case "agent_settled":
+            case "session_rewound":
+                this.refreshGit();
+                return false;
+            case "tool_execution_end":
+                if (WRITE_TOOLS.has(event.toolName))
+                    this.refreshGit();
+                return false;
+            case "model_fallback":
+                this.fallback = {
+                    from: formatModelRef(event.from),
+                    to: formatModelRef(event.to),
+                };
+                this.bar.refresh();
+                return false;
+            case "model_changed": {
+                const model = this.deps.session().state.model;
+                if (this.fallback !== undefined && model !== undefined) {
+                    if (formatModelRef(model) === this.fallback.from)
+                        this.fallback = undefined;
+                }
+                return false;
+            }
+            default:
+                return false;
+        }
+    }
+    dispose() {
+        this.offGit();
+        this.git?.dispose();
+        this.git = undefined;
+    }
+    gitView() {
+        const cwd = this.gitCwd;
+        if (cwd === undefined)
+            return undefined;
+        return { dir: basename(cwd), info: this.git?.current() };
+    }
+    watchGit() {
+        const cwd = this.deps.session().state.cwd;
+        if (cwd === this.gitCwd && this.git !== undefined)
+            return;
+        this.dispose();
+        this.gitCwd = cwd;
+        const git = new GitInfoWatcher(cwd, this.deps.env !== undefined ? { env: this.deps.env } : {});
+        this.git = git;
+        this.offGit = git.onChange(() => this.deps.render());
+        void git.refresh();
+    }
+}
+/**
+ * `/statusline [full|compact]`（无参数切换）：是这条命令就处理并返回 true，否则 false 交给其它命令。
+ * line 模式没有底部信息行，commands-core 只登记命令名、回一句说明。
+ */
+export function statusLineSlash(area, line, notice) {
+    const match = /^\/statusline(?:\s+(.*))?$/i.exec(line.trim());
+    if (match === null)
+        return false;
+    const value = (match[1] ?? "").trim();
+    if (value === "")
+        area.toggle();
+    else if (value === "full" || value === "compact")
+        area.setLayout(value);
+    else {
+        notice("error", "用法：/statusline [full|compact]");
+        return true;
+    }
+    notice("info", statusLineText(area.layout()));
+    return true;
+}
+export function statusLineText(mode) {
+    return mode === "full" ? "状态栏：完整（两行）" : "状态栏：精简（一行）";
+}

package/dist/modes/interactive/status-bar.d.ts

@@ -1,22 +1,34 @@
 /**
- * 状态栏（设计 §12.6）：编辑器下方一行。[B7]
+ * 状态栏（设计 §12.6；终端界面视觉设计 v1 §3.10；第五波 §1）：编辑器下方，永远是最后一行。[B7][W5-A]
  *
- * `provider/model · think:medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · rebill $0.11 · ctx 34%
- *  · queue 1 · mode:default · codemode:only net! · preset:default · [宿主状态]`
+ * 两区：左区「权限模式 + shift+tab 切换」，右区信息，中间用空格撑开；空隙不足 4 列时退回单区。模式永远在最左；
+ * 同组项（模型与思考级别、目录与 git）以空格相连。compact 分隔符固定为 ` · `（tmux 宿主按此解析），full 按用户
+ * 样例用 ` | `。
  *
- * - 用量来自 `session.getStats()`（`↑` = 输入含缓存读写，`↓` = 输出），只在 `refresh()` 时读取
- *   （事件驱动），渲染只拼字符串；
- * - [W3-C2] `cache` 是**最近一次**请求的命中率（会话累计在 `/session`）；端点三态：`unknown` →
- *   `cache —`，`silent` → `cache 未报告`；保温计时中追加 `♨`；会话有重计费时显示 `rebill $x`
- *   （无价模型显示重计费 token）；会话层缓存未接线时回落到会话命中率 `cacheHitRate`；
- * - `ctx ?` 表示模型没有上下文窗口；≥ 70% 黄、≥ 90% 红；没有用量时不显示 token / cache / 费用；
- * - [W3-C2 A4] codemode 生效时显示 `codemode:on|only`，运行时 Node 的权限模型不隔离网络
- *   （`detectSandboxCapability().strict` 为 false）时追加红色 `net!`；
- * - 宿主状态读 `HostAdapterHandle.status()`（宿主 `ui.setStatus`），每次渲染现取；
- * - 宽度不够时按优先级丢弃（宿主 → 预设 → rebill → 费用 → cache → token → think → 队列 →
- *   codemode），模型、ctx、权限模式最后丢。
+ * 两种布局（`ui.statusLine`，§1.1）：
+ * - `compact`（嵌入宿主缺省，即原单行状态栏）：
+ *   `Manual · shift+tab 切换    sonnet-4-5 · medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · ctx 34% · proj ⎇ main 5ae9e54 +12 −3 · 2h24m`
+ *   右区顺序：模型 · 思考 · `↑ ↓` · cache · 费用 · rebill · ctx · git · 时长 · queue · codemode · 预设 · [宿主]。
+ * - `full`（独立终端缺省，用户样例）：用量类项移到上方速率行（status-line.ts），本行为
+ *   `Manual | 模型 思考 | Ctx 3.0% | 目录 ⎇ 分支 短提交 (+a,-d) | $费用 | 会话时长`；Ctx 一位小数、不换余量表。
+ *
+ * - 用量来自 `session.getStats()`，只在 `refresh()` 时读取（事件驱动），渲染只拼字符串；时长按渲染时刻算。
+ * - [W3-C2] `cache` 是**最近一次**请求的命中率；端点三态 `cache —` / `cache 未报告`；保温中追加 `♨`；
+ *   重计费 `rebill $x`（无价模型显示 token）；codemode 生效时 `codemode on|only`，网络未隔离追加 `net!`
+ *   （S2：Node 权限模型与 OS 沙箱都不隔离网络时）。
+ * - 费用 = `stats.cost` + 外部 Agent 以美元计的用量（`stats.external`，W5-E；其它单位只在 /session 显示）。
+ * - 着色：整行 dim；模式名正文色（Bypass permissions warning、Plan accent）；模型 accent；ctx 按阈值
+ *   success / warning / error；rebill、queue warning；`net!` error。宽 ≥ 110 时 ctx 用余量表。
+ * - [W5-U] bash 在操作系统沙箱里跑时（S2）用量类项多一个 `沙箱`（与 codemode 同一丢弃优先级）。
+ * - [W5-U] 模型回退中（`model_fallback`）模型项显示 `主模型 → 回退模型`，切回主模型后恢复。
+ * - 模型名缩写：宽 < 100 去掉供应商前缀，< 60 再去掉 `@渠道`，< 48 去掉版本后缀（第一个 `-数字` 起）。
+ * - ASCII：`⎇` → `git`（字形表 `branch`）、`−` → `-`、`♨` → `~`。
+ * - 宽度不够时按优先级丢弃（数字大的先丢，表见 §1.2）；会变的数字按最宽形状占位（`reserve`），
+ *   数字变化不会让某项时有时无（40 列不抖动）。
  */
-import type { AgentSession, SessionCacheStats } from "../../agent/types.js";
+import type { AgentSession, SessionCacheStats, SessionStats } from "../../agent/types.js";
+import type { StatusLineMode } from "../../config/types.js";
+import type { GitInfo } from "../../git/info.js";
 import { type Component, type Theme } from "../../tui.js";
 export interface StatusBarSource {
     session(): AgentSession;
@@ -28,11 +40,83 @@ export interface StatusBarSource {
     codemode?(): "on" | "only" | undefined;
     /** 沙箱是否隔离网络（缺省 true，不标 `net!`）。 */
     sandboxStrict?(): boolean;
+    /** 布局；缺省 `compact`（单行）。 */
+    layout?(): StatusLineMode;
+    /** 工作目录名与 git 信息；没有时不显示目录与 git。 */
+    git?(): {
+        dir: string;
+        info: GitInfo | undefined;
+    } | undefined;
+    /** 会话时长的时钟（缺省 Date.now）。 */
+    now?(): number;
+    /** 会话时长的起点；缺省取 `getStats().telemetry.sessionStartedAt`。 */
+    sessionStartedAt?(): number | undefined;
+    /** [W5-U] bash 命令在操作系统沙箱里跑（S2 第二阶段，`sandbox.bash: auto` 且可用、bash 工具活动）。 */
+    bashSandbox?(): boolean;
+    /** [W5-U] 模型回退中（`model_fallback` 之后、切回主模型之前）：主模型与回退模型的引用。 */
+    fallback?(): {
+        from: string;
+        to: string;
+    } | undefined;
 }
 export declare function formatTokens(count: number): string;
 export declare function formatCost(cost: number): string;
+/** 会话时长：`Ns` / `Nm` / `NhMm`。 */
+export declare function formatDuration(ms: number): string;
 /** `cache 83%` / `cache —` / `cache 未报告`，保温计时中追加 ` ♨`。 */
-export declare function cacheText(cache: SessionCacheStats): string;
+export declare function cacheText(cache: SessionCacheStats, warm?: string): string;
+/** 状态费用：会话费用 + 外部 Agent 以美元计的用量；会话费用未知为 undefined。 */
+export declare function statusCost(stats: SessionStats): number | undefined;
+export interface Part {
+    text: string;
+    /** 越小越重要（最后丢）；undefined = 永不丢。 */
+    priority: number | undefined;
+    zone: "left" | "right";
+    /** 同组相邻项连成一段（组内用 `RowStyle.groups[组].glue`，缺省空格）。 */
+    group?: string;
+    /** 这一段前面的连接符（缺省行分隔符）；段首项的值生效。 */
+    lead?: string;
+    /** 判断放不放得下时按这个宽度算（会变的数字取最宽形状，避免抖动）。 */
+    reserve?: number;
+}
+export interface RowStyle {
+    /** 段间分隔符，缺省 ` · `。 */
+    sep?: string;
+    /** 组的连接方式：组内连接符与包围（如 `(avg 100 · ttft 1.4s)`）。 */
+    groups?: Readonly<Record<string, {
+        glue?: string;
+        open?: string;
+        close?: string;
+    }>>;
+}
+/** 按优先级丢弃后排成一行（两区 / 单区）；连接符都是 dim。 */
+export declare function layoutRow(parts: readonly Part[], width: number, theme: Theme, style?: RowStyle): string;
+/** 按终端宽度缩写模型名（§3.10）。 */
+export declare function abbreviateModel(ref: string, width: number): string;
+/** 用量类项（compact 在本行、full 在速率行）的优先级表。 */
+export interface UsagePriorities {
+    tokens: number;
+    cache: number;
+    cost?: number;
+    rebill: number;
+    queue: number;
+    codemode: number;
+    preset: number;
+    host: number;
+}
+export interface UsageItems {
+    tokens?: string;
+    cache?: string;
+    cost?: string;
+    rebill?: string;
+    queue?: string;
+    codemode?: string;
+    sandbox?: string;
+    preset?: string;
+    host?: string;
+}
+/** 用量类项的文本（已着色；普通项 dim）。 */
+export declare function usageItems(stats: SessionStats, queue: number, source: StatusBarSource, theme: Theme): UsageItems;
 export declare class StatusBar implements Component {
     private readonly source;
     private readonly theme;
@@ -42,7 +126,14 @@ export declare class StatusBar implements Component {
     /** 用量、模型等变化后调用（事件驱动；流式期间不必每帧算）。 */
     refresh(): void;
     setQueue(steering: number, followUp: number): void;
+    /** 当前统计（速率行共用，避免重复 getStats）。 */
+    current(): SessionStats;
+    queued(): number;
+    layout(): StatusLineMode;
     private parts;
+    /** `目录 ⎇ 分支 短提交 +a −b`：三项同组、各自按优先级丢弃。 */
+    private gitParts;
+    private ctxText;
     render(width: number): string[];
     invalidate(): void;
 }