@songsid/agend 2.1.4-beta.6 → 2.1.4-beta.60

package/dist/tool-progress.js

@@ -0,0 +1,289 @@
+/**
+ * Semantic tool-progress labelling for the channel processing bubble.
+ *
+ * This is a SECOND labeller, deliberately separate from `Daemon.summarizeTool`:
+ * that one feeds the statusline / `/view` / recent events and is pinned by
+ * tests to the terse `Read <path>` / `$ <cmd>` form. This one feeds the
+ * channel bubble only — it is semantic (`npm test` → `🧪 執行測試`), may
+ * return `""` for uninteresting work, and never carries shell arguments at
+ * the default `standard` level. Do not merge the two: they serve different
+ * audiences with different safety requirements (the bubble is broadcast to a
+ * chat channel; the statusline is an operator surface).
+ */
+/** Max characters for any single progress line (before the display cap). */
+const LABEL_MAX_CHARS = 80;
+/** Max characters of command preview appended at `verbose`. */
+const VERBOSE_PREVIEW_CHARS = 48;
+/**
+ * Strip credentials before anything reaches a chat channel. Patterns are
+ * deliberately broad — a false positive redacts a harmless token, a false
+ * negative broadcasts a secret.
+ */
+export function redactSecrets(text) {
+    return text
+        // JWTs (three base64url segments) — before generic keys, which match prefixes
+        .replace(/\beyJ[\w-]{8,}\.[\w-]{8,}\.[\w-]+/g, "[REDACTED]")
+        // Known key shapes: OpenAI/Anthropic/GitHub/Slack/AWS/Telegram bot tokens
+        .replace(/\b(sk|pk|rk)-[A-Za-z0-9_-]{16,}/g, "[REDACTED]")
+        .replace(/\bsk-ant-[A-Za-z0-9_-]{10,}/g, "[REDACTED]")
+        .replace(/\bgh[pousr]_[A-Za-z0-9]{16,}/g, "[REDACTED]")
+        .replace(/\bxox[baprs]-[A-Za-z0-9-]{10,}/g, "[REDACTED]")
+        .replace(/\bAKIA[0-9A-Z]{16}\b/g, "[REDACTED]")
+        .replace(/\b\d{8,10}:AA[A-Za-z0-9_-]{30,}/g, "[REDACTED]")
+        // Bearer / basic auth headers
+        .replace(/\b(Bearer|Basic)\s+[A-Za-z0-9+/._=-]{8,}/gi, "$1 [REDACTED]")
+        // key=value / key: value assignments for sensitive names
+        .replace(/\b((?:api[-_]?key|token|secret|passwd|password|authorization|credential)s?\s*[=:]\s*)(["']?)[^\s"']{6,}\2/gi, "$1[REDACTED]")
+        // URL userinfo credentials (https://user:pass@host)
+        .replace(/(\w+:\/\/[^/\s:@]+:)[^@\s]+@/g, "$1[REDACTED]@");
+}
+/** Flatten whitespace and cap length for a single bubble line. */
+function capLine(s) {
+    const flat = s.replace(/\s+/g, " ").trim();
+    return flat.length > LABEL_MAX_CHARS ? `${flat.slice(0, LABEL_MAX_CHARS - 1)}…` : flat;
+}
+/** Shorten an absolute path to something readable in a bubble line. */
+function shortPath(p) {
+    const clean = String(p).trim();
+    if (clean.length <= 48)
+        return clean;
+    const parts = clean.split("/");
+    if (parts.length <= 3)
+        return clean;
+    return `…/${parts.slice(-3).join("/")}`;
+}
+/**
+ * Reduce a shell command to its intent. Returns null for commands with no
+ * interesting intent — the caller renders a generic "執行指令" line with the
+ * program name only (never arguments) at `standard`.
+ */
+function classifyShellCommand(cmd) {
+    const c = cmd.trim();
+    // Test runners
+    if (/\b(npm|pnpm|yarn|bun)( run)? test\b/.test(c) || /\b(vitest|jest|pytest|go test|cargo test|mocha|rspec)\b/.test(c)) {
+        return { label: "🧪 執行測試", preview: true };
+    }
+    // Typecheck / build
+    if (/\btsc\b/.test(c) || /\b(npm|pnpm|yarn|bun) run build\b/.test(c) || /\b(cargo|go) build\b/.test(c) || /\bmake\b/.test(c)) {
+        return { label: "🔨 建置／型別檢查", preview: true };
+    }
+    // Dependency install
+    if (/\b(npm|pnpm|yarn|bun) (i|ci|install|add)\b/.test(c) || /\bpip3? install\b/.test(c) || /\bcargo add\b/.test(c)) {
+        return { label: "📦 安裝依賴", preview: true };
+    }
+    // Git — order matters: push/pull before generic commit
+    if (/\bgit push\b/.test(c))
+        return { label: "⬆️ git push", preview: true };
+    if (/\bgit (pull|fetch)\b/.test(c))
+        return { label: "⬇️ git pull/fetch", preview: true };
+    if (/\bgit commit\b/.test(c))
+        return { label: "💾 git commit", preview: false };
+    if (/\bgit (checkout|switch|branch)\b/.test(c))
+        return { label: "🔀 git 分支操作", preview: true };
+    if (/\bgit (diff|log|status|show|blame)\b/.test(c))
+        return { label: "🔎 檢視 git 狀態", preview: true };
+    if (/\bgh (pr|issue|api|run)\b/.test(c))
+        return { label: "🐙 GitHub 操作", preview: true };
+    return null;
+}
+/** Low-signal inspection commands: hidden entirely at `standard`. */
+function isLowSignalCommand(cmd) {
+    return /^(rg|grep|find|fd|ls|cat|head|tail|wc|which|pwd|echo|sed|awk|cut|sort|uniq)\b/.test(cmd.trim());
+}
+/** First program name of a shell command, pipelines/chains reduced to the head. */
+function shellProgramName(cmd) {
+    const head = cmd.trim().split(/\s*(?:&&|\|\||\||;)\s*/)[0] ?? "";
+    const tokens = head.trim().split(/\s+/);
+    // Skip env assignments and common wrappers
+    let i = 0;
+    while (i < tokens.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[i]))
+        i++;
+    if (tokens[i] === "sudo" || tokens[i] === "npx" || tokens[i] === "timeout")
+        i++;
+    if (tokens[i] && /^\d+[smh]?$/.test(tokens[i]))
+        i++; // timeout's duration arg
+    return tokens[i] ?? "";
+}
+function labelShell(cmd, level) {
+    const intent = classifyShellCommand(cmd);
+    if (intent) {
+        if (level === "verbose" && intent.preview) {
+            return `${intent.label}：${redactSecrets(cmd).slice(0, VERBOSE_PREVIEW_CHARS)}`;
+        }
+        return intent.label;
+    }
+    if (level === "verbose")
+        return `⚙️ $ ${redactSecrets(cmd).slice(0, VERBOSE_PREVIEW_CHARS)}`;
+    if (isLowSignalCommand(cmd))
+        return "";
+    // standard: program name only, never arguments
+    const prog = shellProgramName(cmd);
+    return prog ? `⚙️ 執行指令：${prog}` : "";
+}
+/** Extract the shell command from a codex exec input (array or JSON string). */
+function codexShellCommand(input) {
+    let inp = input;
+    if (typeof inp === "string") {
+        // custom_tool_call "exec" input is a JS snippet driving tools.* — surface the call names
+        const raw = inp;
+        const toolCalls = [...raw.matchAll(/\btools\.(\w+)\s*\(/g)].map(m => m[1]);
+        if (toolCalls.length)
+            return null; // handled by caller via codexToolsCalled
+        // Not JSON → a plain JS snippet for codex's exec runtime, not a shell command.
+        try {
+            inp = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    const obj = inp;
+    if (!obj)
+        return null;
+    const cmd = obj.command;
+    if (Array.isArray(cmd)) {
+        // ["bash","-lc","actual command"] — take the last element
+        return String(cmd[cmd.length - 1] ?? "");
+    }
+    if (typeof cmd === "string")
+        return cmd;
+    return null;
+}
+function codexToolsCalled(input) {
+    if (typeof input !== "string")
+        return [];
+    return [...new Set([...input.matchAll(/\btools\.(\w+)\s*\(/g)].map(m => m[1]))];
+}
+/**
+ * Name-level classification shared by direct tool uses and codex exec's
+ * tools.* calls. Returns "" for channel-plumbing agend MCP tools (suppressed),
+ * `🔌 server:tool` for other MCP tools, undefined for everything else.
+ *
+ * agend naming varies per CLI: claude-code `mcp__agend__reply`, codex
+ * `mcp__agend_<instance>__reply`, opencode `agend-<instance>_reply` — hence
+ * prefix matching rather than an exact list.
+ */
+function labelToolName(name) {
+    if (/^mcp__agend[_-]|^agend[-_]/.test(name))
+        return "";
+    const mcpMatch = name.match(/^mcp__(\w+?)__(\w+)$/);
+    if (mcpMatch)
+        return capLine(`🔌 ${mcpMatch[1]}:${mcpMatch[2]}`);
+    return undefined;
+}
+/**
+ * The channel-bubble labeller. Returns "" when the tool use is not worth a
+ * line (channel-plumbing MCP tools, low-signal inspection commands at
+ * `standard`). Input shapes vary per backend; unknown shapes degrade to the
+ * bare tool name rather than throwing.
+ */
+export function summarizeProgress(name, input, level = "standard") {
+    const inp = (input ?? {});
+    const named = labelToolName(name);
+    if (named !== undefined)
+        return named;
+    switch (name) {
+        // claude-code shapes
+        case "Read": {
+            const p = inp.file_path ?? inp.path ?? "";
+            return p ? capLine(`📄 讀取檔案：${shortPath(redactSecrets(String(p)))}`) : "📄 讀取檔案";
+        }
+        case "Edit":
+        case "Write":
+        case "NotebookEdit": {
+            const p = inp.file_path ?? inp.path ?? "";
+            return p ? capLine(`✏️ 編輯檔案：${shortPath(redactSecrets(String(p)))}`) : "✏️ 編輯檔案";
+        }
+        case "Glob":
+        case "Grep":
+            return level === "verbose" ? capLine(`🔍 搜尋：${redactSecrets(String(inp.pattern ?? ""))}`) : "🔍 搜尋程式碼";
+        case "Agent":
+        case "Task":
+            return "🤝 派工作給子 Agent";
+        case "WebFetch":
+            return level === "verbose" && inp.url ? capLine(`🌐 讀取網頁：${redactSecrets(String(inp.url))}`) : "🌐 讀取網頁";
+        case "WebSearch":
+            return "🌐 網路搜尋";
+        case "Skill":
+            return inp.skill ? capLine(`📚 使用 Skill：${String(inp.skill)}`) : "📚 使用 Skill";
+        case "TodoWrite":
+            return ""; // bookkeeping, not work
+        case "Bash":
+        case "bash": // opencode
+        case "shell": { // kiro / codex function_call
+            const cmd = String(inp.command ?? "");
+            return cmd ? capLine(labelShell(cmd, level)) : "";
+        }
+        case "exec": { // codex custom_tool_call — JS driving tools.*
+            const calls = codexToolsCalled(input);
+            if (calls.length) {
+                const labels = [...new Set(calls.map(c => labelToolName(c) ?? `🔌 ${c}`))].filter(Boolean);
+                return labels.length ? capLine(labels.join(" · ")) : "";
+            }
+            const cmd = codexShellCommand(input);
+            if (cmd)
+                return capLine(labelShell(cmd, level));
+            // A JS snippet with no tools.* calls: still work happening, name it as such.
+            return typeof input === "string" && input.trim() ? "⚙️ 執行程式碼" : "";
+        }
+        // kiro built-in file ops
+        case "fs_read": {
+            const ops = inp.operations;
+            const p = ops?.[0]?.path ?? inp.path ?? "";
+            return p ? capLine(`📄 讀取檔案：${shortPath(redactSecrets(String(p)))}`) : "📄 讀取檔案";
+        }
+        case "fs_write": {
+            const p = inp.path ?? "";
+            return p ? capLine(`✏️ 編輯檔案：${shortPath(redactSecrets(String(p)))}`) : "✏️ 編輯檔案";
+        }
+        // opencode built-ins
+        case "read":
+            return inp.filePath ? capLine(`📄 讀取檔案：${shortPath(redactSecrets(String(inp.filePath)))}`) : "📄 讀取檔案";
+        case "edit":
+        case "write":
+            return inp.filePath ? capLine(`✏️ 編輯檔案：${shortPath(redactSecrets(String(inp.filePath)))}`) : "✏️ 編輯檔案";
+        case "glob":
+        case "grep":
+            return "🔍 搜尋程式碼";
+        case "webfetch":
+            return "🌐 讀取網頁";
+        case "todowrite":
+        case "todoread":
+            return "";
+    }
+    // Unknown tool: show its name, nothing else — inputs of unknown tools are
+    // the highest-risk place for secrets.
+    return capLine(`🔧 ${name}`);
+}
+/**
+ * Per-turn progress accumulator: dedupes consecutive repeats, keeps a rolling
+ * window of the latest lines, renders to the bubble block.
+ */
+export class ProgressAccumulator {
+    maxLines;
+    lines = [];
+    constructor(maxLines = 8) {
+        this.maxLines = maxLines;
+    }
+    /** Add a labelled line. Empty labels are ignored. Returns true when the rendered block changed. */
+    add(label) {
+        if (!label)
+            return false;
+        if (this.lines[this.lines.length - 1] === label)
+            return false;
+        this.lines.push(label);
+        if (this.lines.length > this.maxLines)
+            this.lines.splice(0, this.lines.length - this.maxLines);
+        return true;
+    }
+    reset() {
+        this.lines = [];
+    }
+    isEmpty() {
+        return this.lines.length === 0;
+    }
+    render() {
+        return this.lines.join("\n");
+    }
+}
+//# sourceMappingURL=tool-progress.js.map

package/dist/tool-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.js","sourceRoot":"","sources":["../src/tool-progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,4EAA4E;AAC5E,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,+DAA+D;AAC/D,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI;QACT,8EAA8E;SAC7E,OAAO,CAAC,oCAAoC,EAAE,YAAY,CAAC;QAC5D,0EAA0E;SACzE,OAAO,CAAC,kCAAkC,EAAE,YAAY,CAAC;SACzD,OAAO,CAAC,8BAA8B,EAAE,YAAY,CAAC;SACrD,OAAO,CAAC,+BAA+B,EAAE,YAAY,CAAC;SACtD,OAAO,CAAC,iCAAiC,EAAE,YAAY,CAAC;SACxD,OAAO,CAAC,uBAAuB,EAAE,YAAY,CAAC;SAC9C,OAAO,CAAC,kCAAkC,EAAE,YAAY,CAAC;QAC1D,8BAA8B;SAC7B,OAAO,CAAC,4CAA4C,EAAE,eAAe,CAAC;QACvE,yDAAyD;SACxD,OAAO,CAAC,6GAA6G,EAAE,cAAc,CAAC;QACvI,oDAAoD;SACnD,OAAO,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;AAC/D,CAAC;AAED,kEAAkE;AAClE,SAAS,OAAO,CAAC,CAAS;IACxB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED,uEAAuE;AACvE,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC;AAQD;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,eAAe;IACf,IAAI,qCAAqC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,yDAAyD,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,oBAAoB;IACpB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7H,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IACD,qBAAqB;IACrB,IAAI,4CAA4C,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,uDAAuD;IACvD,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3E,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChF,IAAI,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/F,IAAI,sCAAsC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpG,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO,+EAA+E,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED,mFAAmF;AACnF,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,2CAA2C;IAC3C,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAE,CAAC,EAAE,CAAC;IAC5E,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,CAAC,EAAE,CAAC;IAChF,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAE,CAAC,EAAE,CAAC,CAAC,yBAAyB;IAC9E,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,KAA6B;IAC5D,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,EAAE,CAAC;QACjF,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,EAAE,CAAC;IAC7F,IAAI,kBAAkB,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,+CAA+C;IAC/C,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,gFAAgF;AAChF,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,yFAAyF;QACzF,MAAM,GAAG,GAAG,GAAG,CAAC;QAChB,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,SAAS,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,CAAC,yCAAyC;QAC5E,+EAA+E;QAC/E,IAAI,CAAC;YAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACvD,CAAC;IACD,MAAM,GAAG,GAAG,GAAqC,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,0DAA0D;QAC1D,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpD,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAc,EAAE,QAAgC,UAAU;IACxG,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IAErD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEtC,QAAQ,IAAI,EAAE,CAAC;QACb,qBAAqB;QACrB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACzG,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,UAAU;YACb,OAAO,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3G,KAAK,WAAW;YACd,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACjF,KAAK,WAAW;YACd,OAAO,EAAE,CAAC,CAAC,wBAAwB;QACrC,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,WAAW;QACxB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,6BAA6B;YAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,8CAA8C;YAC3D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,CAAC;YACD,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,GAAG;gBAAE,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAChD,6EAA6E;YAC7E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,CAAC;QACD,yBAAyB;QACzB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,GAAG,GAAG,GAAG,CAAC,UAAwD,CAAC;YACzE,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,CAAC;QACD,qBAAqB;QACrB,KAAK,MAAM;YACT,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzG,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzG,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,EAAE,CAAC;IACd,CAAC;IAED,0EAA0E;IAC1E,sCAAsC;IACtC,OAAO,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAEV;IADZ,KAAK,GAAa,EAAE,CAAC;IAC7B,YAAoB,WAAW,CAAC;QAAZ,aAAQ,GAAR,QAAQ,CAAI;IAAG,CAAC;IAEpC,mGAAmG;IACnG,GAAG,CAAC,KAAa;QACf,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/topic-commands.d.ts

@@ -10,6 +10,8 @@ type ExecutionFleetContext = FleetContext & {
 export declare function sanitizeInstanceName(name: string): string;
 /** Allowed filename for /save and /load (no path separators, no shell/inject chars). */
 export declare const SAVE_FILENAME_RE: RegExp;
+/** Backends with a native side-question command that does not steer the active turn. */
+export declare const BTW_SUPPORTED_BACKENDS: Set<string>;
 /**
  * Build the backend-specific session-save command, or null if the backend has no
  * /save equivalent. kiro-cli → `/chat save <name>`; claude-code → `/export <name>.md`.
@@ -18,7 +20,8 @@ export declare function saveCommandForBackend(backend: string, filename: string,
 /** Extract the filename argument from `/save <name>` or `/save@bot <name>`. */
 export declare function parseSaveFilename(text: string): string;
 /** Shared message when a backend doesn't support /save. */
-export declare const SAVE_UNSUPPORTED_MSG = "\u26A0\uFE0F /save is not supported for this backend (only kiro-cli and claude-code)";
+/** @deprecated Prefer t("save.unsupported") at the user-facing call site. */
+export declare const SAVE_UNSUPPORTED_MSG = "\u26A0\uFE0F /save is not supported for this backend (only Kiro CLI and Claude Code).";
 export declare function parsePauseWakeCommand(text: string): {
     action: "pause" | "wake";
     instance?: string;
@@ -30,7 +33,8 @@ export declare function compactCommandForBackend(backend: string): string;
  * own the backend object that lives inside each daemon.
  */
 export declare function clearCommandForBackend(backend: string): string | null;
-export declare const CLEAR_UNSUPPORTED_MSG = "\u26A0\uFE0F Clear not supported for this backend";
+/** @deprecated Prefer t("clear.unsupported") at the user-facing call site. */
+export declare const CLEAR_UNSUPPORTED_MSG = "\u26A0\uFE0F Clear is not supported for this backend.";
 /**
  * Extract context-usage % from a captured CLI pane. Scans bottom-up so the
  * MOST RECENT prompt wins (a captured scrollback may hold several). Covers the
@@ -46,6 +50,12 @@ export declare const CLEAR_UNSUPPORTED_MSG = "\u26A0\uFE0F Clear not supported f
 export declare function formatContextUsageLine(context: number, tokenRatio?: TokenContextRatio | null): string;
 /** Claude Code statusline.json context used % (null if missing / unreadable). */
 export declare function readStatuslineContextPct(dataDir: string, instanceName: string): number | null;
+/**
+ * Claude Code's statusline payload reports the model that actually served the
+ * current session. This can differ from fleet.yaml after the CLI rejects a
+ * plan-gated model and keeps using its previous/default model.
+ */
+export declare function readStatuslineModel(dataDir: string, instanceName: string): string | null;
 /** Live-pane scrape used by /ctx, /status Ctx, and /view sidebar. */
 export declare function scrapePaneContext(instanceName: string, backend: string): {
     context: number | null;
@@ -108,18 +118,43 @@ export declare class TopicCommands {
     sendCompact(instanceName: string): Promise<string>;
     /** Whether the instance backend exposes a verified full-reset command. */
     supportsClear(instanceName: string): boolean;
+    /**
+     * Steer: interject a message into the instance's CURRENT turn. The daemon
+     * pastes it into the busy CLI instead of queueing for idle (falling back to
+     * the queue if the TUI swallows busy input — see Daemon.steerMessage).
+     */
+    /**
+     * Backends whose TUI accepts a busy-pane paste as steering input,
+     * live-verified: claude-code and codex buffer-then-submit at the turn
+     * boundary, grok accepts it in its input line. kiro's legacy TUI swallows
+     * the paste outright, and opencode/antigravity are unverified — for those
+     * the user gets an honest "not supported" instead of a silent queue
+     * fallback that looks like a steer but behaves like a normal message.
+     */
+    sendSteer(instanceName: string, content: string, msg: Pick<InboundMessage, "chatId" | "messageId" | "username" | "userId" | "threadId" | "adapterId" | "source">): string;
+    /** Ask a Claude Code side question without folding it into the active turn. */
+    sendBtw(instanceName: string, content: string, msg: Pick<InboundMessage, "chatId" | "messageId" | "username" | "userId" | "threadId" | "adapterId" | "source">): string;
     /** Send the backend-appropriate full conversation reset through raw_paste. */
     sendClear(instanceName: string): Promise<string>;
     /** Send a backend-appropriate session-save command to a fleet-topic instance. */
     sendSave(instanceName: string, filename: string): Promise<string>;
     private handleRestartCommand;
     /**
-     * `/usage` — AI subscription usage for every CLI backend logged in on this
-     * machine, one compact message. Same permission level as /ctx (none): whoever
+     * `/usage` — AI subscription usage for CLI backends used by running or paused
+     * instances, one compact message. Same permission level as /ctx (none): whoever
      * can talk to the fleet may see how much headroom it has left. Vendor rate
      * limits are protected by the shared 5-minute cache, not by gating callers.
      */
     private handleUsageCommand;
+    /**
+     * `/login [backend] | code <text> | cancel` — remote CLI re-login.
+     * Fleet-admin only: the flow emits live authorization URLs/codes, and anyone
+     * completing one binds their own account to this fleet's CLI.
+     */
+    private handleLoginCommand;
+    /** `/install-cli <backend> | cancel` — remote CLI install. Fleet-admin only. */
+    private handleInstallCliCommand;
+    private handleTipsCommand;
     private handleStatusCommand;
     /** Compact label for status/sysinfo tables: prefer display_name, else strip the
      * `-t<topicId>` suffix (e.g. doupo-server-t1503381916525793300 → doupo-server).
@@ -130,14 +165,18 @@ export declare class TopicCommands {
     getStatusText(): Promise<string>;
     private handleSysInfoCommand;
     /**
-     * Get system info as markdown text (shared by TG + DC).
+     * Get system info as formatted text.
      *
      * System-level only. The per-instance table (state/IPC/cost) moved to /status,
      * which was already the fleet-per-instance view — the two tables overlapped on
      * everything but the IPC column, and each command answered half of "is the
      * machine fine and are the instances fine".
+     *
+     * @param opts.platform - "telegram" uses markdown table, "discord" uses plain lines
      */
-    getSysInfoText(): string;
+    getSysInfoText(opts?: {
+        platform?: "telegram" | "discord";
+    }): string;
     private handleUpdateCommand;
     private handleDoctorCommand;
     /** Reply with redirect when message arrives in an unbound topic */