@songsid/agend 2.1.3 → 2.1.4-beta.10

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":"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"}

package/dist/topic-commands.d.ts

@@ -24,6 +24,13 @@ export declare function parsePauseWakeCommand(text: string): {
     instance?: string;
 } | null;
 export declare function compactCommandForBackend(backend: string): string;
+/**
+ * Full conversation-reset command for a backend NAME. Keep this routing-only
+ * lookup in sync with CliBackend.getClearCommand(); the fleet process does not
+ * 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";
 /**
  * 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
@@ -99,6 +106,25 @@ export declare class TopicCommands {
     getCtxText(instanceName: string): Promise<string>;
     /** Send the backend-appropriate compact command to an instance's tmux pane */
     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.
+     */
+    private static STEER_SUPPORTED_BACKENDS;
+    sendSteer(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;

package/dist/topic-commands.js

@@ -82,6 +82,28 @@ export function compactCommandForBackend(backend) {
         return "/clear";
     return "/compact";
 }
+/**
+ * Full conversation-reset command for a backend NAME. Keep this routing-only
+ * lookup in sync with CliBackend.getClearCommand(); the fleet process does not
+ * own the backend object that lives inside each daemon.
+ */
+export function clearCommandForBackend(backend) {
+    switch (backend) {
+        case "claude-code":
+        case "codex":
+        case "kiro-cli":
+        case "antigravity":
+        case "opencode":
+        case "mock":
+            return "/clear";
+        case "grok":
+            return "/new";
+        case "gemini-cli":
+        default:
+            return null;
+    }
+}
+export const CLEAR_UNSUPPORTED_MSG = "⚠️ Clear 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
@@ -400,6 +422,40 @@ export class TopicCommands {
             await adapter.sendText(msg.chatId, result, { threadId: msg.threadId });
             return true;
         }
+        if (text === "/steer" || text.startsWith("/steer ") || text.startsWith("/steer@")) {
+            const adapter = this.getReplyAdapter(msg);
+            if (!adapter)
+                return false;
+            // Deliberately NOT admin-gated: anyone who can speak in this topic can
+            // already send the instance a message; /steer only changes WHEN it lands
+            // (mid-turn instead of after), and it goes through the full [user:]
+            // formatting — unlike /raw, which bypasses it and is gated.
+            const content = text.replace(/^\/steer(@\S+)?/, "").trim();
+            if (!content) {
+                await adapter.sendText(msg.chatId, t("steer.usage"), { threadId: msg.threadId });
+                return true;
+            }
+            const result = this.sendSteer(instanceName, content, msg);
+            await adapter.sendText(msg.chatId, result, { threadId: msg.threadId });
+            return true;
+        }
+        if (text === "/clear" || text.startsWith("/clear@")) {
+            const adapter = this.getReplyAdapter(msg);
+            if (!adapter)
+                return false;
+            if (!this.ctx.isFleetAdmin(msg.userId, msg.adapterId)) {
+                await adapter.sendText(msg.chatId, t("permission.denied"), { threadId: msg.threadId });
+                return true;
+            }
+            if (!this.ctx.promptClearConfirmation) {
+                await adapter.sendText(msg.chatId, t("clear.prompt_unavailable"), { threadId: msg.threadId });
+                return true;
+            }
+            const fallback = await this.ctx.promptClearConfirmation(instanceName, msg.threadId ?? msg.chatId, adapter, msg.chatId, msg.threadId);
+            if (fallback)
+                await adapter.sendText(msg.chatId, fallback, { threadId: msg.threadId });
+            return true;
+        }
         if (text === "/cancel" || text.startsWith("/cancel@")) {
             const adapter = this.getReplyAdapter(msg);
             if (!adapter)
@@ -489,6 +545,60 @@ export class TopicCommands {
         }
         return "❌ Instance not connected (IPC unavailable)";
     }
+    /** Whether the instance backend exposes a verified full-reset command. */
+    supportsClear(instanceName) {
+        return clearCommandForBackend(this.effectiveBackend(instanceName)) !== null;
+    }
+    /**
+     * 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.
+     */
+    static STEER_SUPPORTED_BACKENDS = new Set(["claude-code", "codex", "grok", "mock"]);
+    sendSteer(instanceName, content, msg) {
+        const backend = this.effectiveBackend(instanceName);
+        if (!TopicCommands.STEER_SUPPORTED_BACKENDS.has(backend)) {
+            return t("steer.unsupported", backend);
+        }
+        const ipc = this.ctx.instanceIpcClients.get(instanceName);
+        if (!ipc?.connected)
+            return t("steer.not_connected");
+        ipc.send({
+            type: "steer",
+            content,
+            meta: {
+                chat_id: msg.chatId,
+                message_id: msg.messageId ?? "",
+                user: msg.username,
+                user_id: msg.userId,
+                thread_id: msg.threadId ?? "",
+                adapter_id: msg.adapterId ?? "",
+                source: msg.source,
+            },
+        });
+        return t("steer.sent", instanceName);
+    }
+    /** Send the backend-appropriate full conversation reset through raw_paste. */
+    async sendClear(instanceName) {
+        const backend = this.effectiveBackend(instanceName);
+        const cmd = clearCommandForBackend(backend);
+        if (!cmd)
+            return CLEAR_UNSUPPORTED_MSG;
+        const ipc = this.ctx.instanceIpcClients.get(instanceName);
+        if (ipc?.connected) {
+            ipc.send({ type: "raw_paste", content: cmd });
+            return t("clear.sent", cmd);
+        }
+        return t("clear.not_connected");
+    }
     /** Send a backend-appropriate session-save command to a fleet-topic instance. */
     async sendSave(instanceName, filename) {
         const classicBackend = this.ctx.classicChannels?.getChannelIdByInstance(instanceName)
@@ -707,11 +817,13 @@ export class TopicCommands {
             await adapter.sendText(chatId, t("not_authorized"), { threadId });
             return;
         }
-        await adapter.sendText(chatId, t("update.running"), { threadId });
+        const sent = await adapter.sendText(chatId, t("update.progress.preparing", 0), { threadId });
+        this.ctx.beginUpdateProgress?.(adapter, chatId, threadId, sent.messageId);
         const currentVersion = createRequire(import.meta.url)("../package.json").version ?? "";
         const updateCmd = currentVersion.includes("beta") ? "agend update --beta" : "agend update";
         const { spawn } = await import("node:child_process");
         const child = spawn("sh", ["-c", `sleep 2 && ${updateCmd}`], { detached: true, stdio: "ignore" });
+        child.once("error", err => this.ctx.failUpdateProgress?.(err.message));
         child.unref();
     }
     async handleDoctorCommand(msg) {
@@ -870,6 +982,8 @@ export class TopicCommands {
                     { command: "dashboard", description: "🔒 Get dashboard URLs" },
                     { command: "ctx", description: "Show context usage" },
                     { command: "compact", description: "Compact agent context" },
+                    { command: "steer", description: "Interject into the current task" },
+                    { command: "clear", description: "🔒 Clear agent conversation context" },
                     { command: "model", description: "🔒 Switch model (admin only)" },
                     { command: "effort", description: "🔒 Set reasoning effort (admin only)" },
                     { command: "pause", description: "🔒 Pause an idle instance" },
@@ -902,6 +1016,8 @@ export class TopicCommands {
                     { command: "start", description: "🔒 Start an agent in this chat" },
                     { command: "stop", description: "🔒 Stop the agent" },
                     { command: "compact", description: "🔒 Compact agent context" },
+                    { command: "steer", description: "Interject into the current task" },
+                    { command: "clear", description: "🔒 Clear agent conversation context" },
                     { command: "model", description: "🔒 Switch model (admin only)" },
                     { command: "effort", description: "🔒 Set reasoning effort (admin only)" },
                     { command: "pause", description: "🔒 Pause the agent" },