@co0ontty/wand 4.80.0 → 4.80.1-beta.g1fbbefb

package/dist/ws-broadcast.js

@@ -13,6 +13,7 @@ const QUEUE_RESUME_SIZE = Math.floor(MAX_QUEUE_SIZE * 0.8);
 const SEND_BATCH_SIZE = 8;
 const MAX_BLOCK_BUDGET = 2_000;
 const OUTPUT_DEBOUNCE_MS = 16;
+const MAX_DEBOUNCED_CHUNK_CHARS = 256 * 1024;
 /**
  * 服务端心跳节奏。20s 一次，比常见 NAT/代理空闲超时（30~60s）更短，可以保活；
  * 也不至于让 idle 连接每秒都在跑 timer。前后端在心跳间窗内任何方向消息都会
@@ -276,8 +277,14 @@ export class WsBroadcastManager {
             }
             return;
         }
-        // Debounce output events to reduce flicker during rapid streaming
+        // Coalesce within the first event's deadline; continuous output must not starve.
         if (event.type === "output") {
+            const eventData = asEventData(event.data);
+            if (typeof eventData.chunk === "string" && eventData.chunk.length >= MAX_DEBOUNCED_CHUNK_CHARS) {
+                this.flushOutput(event.sessionId);
+                this.broadcast(event);
+                return;
+            }
             const existing = this.outputDebounceCache.get(event.sessionId);
             if (existing) {
                 const prevData = asEventData(existing.event.data);
@@ -293,14 +300,15 @@ export class WsBroadcastManager {
                 // 形状不一致时 flush 上一条立即广播，新事件单独开窗口。这样客户端永远
                 // 不会在一条 WS 消息里同时看到 messages 和 lastMessage 两种语义。
                 const shapeMismatch = outputEventShapeMismatch(prevData, curData);
-                if (shapeMismatch) {
+                const chunkChars = (typeof prevData.chunk === "string" ? prevData.chunk.length : 0)
+                    + (typeof curData.chunk === "string" ? curData.chunk.length : 0);
+                if (shapeMismatch || chunkChars > MAX_DEBOUNCED_CHUNK_CHARS) {
                     clearTimeout(existing.timer);
                     this.outputDebounceCache.delete(event.sessionId);
                     this.broadcast(existing.event);
                     // Fall through to schedule cur on a fresh debounce window
                 }
                 else {
-                    clearTimeout(existing.timer);
                     // Merge prev + cur. Cur takes precedence for identically-named fields,
                     // but fields only present on prev (e.g. chunk while cur carries
                     // messages, or messages while cur carries chunk) survive — the old
@@ -314,14 +322,18 @@ export class WsBroadcastManager {
                     else if (prevChunk && !curChunk) {
                         merged.chunk = prevChunk;
                     }
-                    event = { ...event, data: merged };
+                    existing.event = { ...event, data: merged };
+                    return;
                 }
             }
-            const timer = setTimeout(() => {
+            const pending = { event, timer: undefined };
+            pending.timer = setTimeout(() => {
+                if (this.outputDebounceCache.get(event.sessionId) !== pending)
+                    return;
                 this.outputDebounceCache.delete(event.sessionId);
-                this.broadcast(event);
+                this.broadcast(pending.event);
             }, OUTPUT_DEBOUNCE_MS);
-            this.outputDebounceCache.set(event.sessionId, { event, timer });
+            this.outputDebounceCache.set(event.sessionId, pending);
             return;
         }
         // Preserve PTY ordering: the final debounced bytes must arrive before an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@co0ontty/wand",
-  "version": "4.80.0",
+  "version": "4.80.1-beta.g1fbbefb",
   "description": "A web console for Claude Code, Codex, OpenCode, and other local CLI tools.",
   "type": "module",
   "bin": {
@@ -47,7 +47,6 @@
     "node": ">=26.10.0"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.138",
     "@anthropic-ai/sdk": "^0.81.0",
     "@xterm/addon-serialize": "^0.14.0",
     "@xterm/addon-unicode11": "^0.9.0",

package/dist/claude-sdk-runner.d.ts

@@ -1,59 +0,0 @@
-export type ClaudeRunErrorCode = "CLAUDE_CLI_MISSING" | "CLAUDE_TIMEOUT" | "CLAUDE_CLI_FAILED" | "CLAUDE_EMPTY_RESULT";
-export declare class ClaudeRunError extends Error {
-    readonly code: ClaudeRunErrorCode;
-    constructor(message: string, code: ClaudeRunErrorCode);
-}
-export interface RunClaudePrintOptions {
-    cwd?: string;
-    timeoutMs: number;
-    /** Optional Claude model id / alias. Empty or "default" keeps Claude Code's own default. */
-    model?: string;
-    /** Optional adaptive-thinking effort. CLI 动态档位（high / xhigh 等）原样传给 SDK。 */
-    effort?: string;
-    /**
-     * 用户偏好的回复语言（取自 config.language）。传进来时会以
-     * `appendSystemPrompt` 形式灌给 Claude，保证 quick-commit / prompt-optimizer
-     * 这种一次性调用也跟用户主会话同语言——之前 wand 的 git commit message 会
-     * 莫名其妙变中英混搭，根因就在这。
-     */
-    language?: string;
-    /**
-     * 本次调用的规则 / 角色 / 输出格式。走 appendSystemPrompt，不拼进用户串，
-     * 避免规则被当成待处理内容，也避免它进 provider 历史时冒充用户输入。
-     */
-    systemInstructions?: string;
-}
-/**
- * 解析 SDK 应使用的 claude binary：**优先系统安装的 claude，回退 SDK 内置 native binary**。
- *
- * 优先系统版的原因：node_modules 里的内置 binary 版本在装包那刻就钉死了，会随时间
- * 越来越旧，最终可能被 API 端拒绝（实测内置 2.1.138 对部分端点持续 502 重试到超时，
- * 而系统侧日常更新的 2.1.170 正常）。系统 claude 跟交互式 PTY 会话同源，用户平时
- * 一直在用、一直在更新，是最可靠的选择。
- *
- * 内置 binary 仅作兜底（系统没装 claude 时仍可用）。Linux 上必须显式按 libc 选包：
- * SDK 默认解析在 glibc 系统上可能错选 musl 包直接抛 "native binary not found"。
- */
-export declare function resolveSdkClaudeBinary(): string | undefined;
-/**
- * 用 `@anthropic-ai/claude-agent-sdk` 跑一次"prompt → 单段纯文本"调用，
- * 等价以前的 `claude -p --output-format text`。
- *
- * 行为对齐 Claude Code 默认：
- *   - 不指定 model / appendSystemPrompt / agent / mcpServers / hooks 等覆盖项，
- *     完全由 `~/.claude/settings.json`、OAuth 凭据、`CLAUDE_*` 环境变量等
- *     用户侧配置接管，与 Claude Code 自身一致。
- *   - `tools: []` 关掉所有内置工具：这两个调用点（commit message / prompt 优化）
- *     本质就是"纯文本生成"，关掉工具能 (1) 防止 Claude 随手开个工具卡住权限询问；
- *     (2) 避免一次性短调用还顺便加载文件 / 跑 bash 这种副作用。
- *   - `mcpServers: {}` + `strictMcpConfig: true` 跳过用户配置的全部 MCP 服务器：
- *     纯文本生成用不上 MCP，但不禁的话每次调用都要连接 MCP（启动慢好几秒）、
- *     还把所有 MCP 工具 schema 灌进 system prompt（实测一次多写 1.6 万 token 的
- *     prompt cache，白花钱）。
- *   - `persistSession: false`：这些 ephemeral 调用不应该污染 `~/.claude/projects/`
- *     的会话历史；用户在 wand UI 里也压根看不到这些"虚拟会话"。
- *
- * binary 解析见 `resolveSdkClaudeBinary()`：优先系统 claude（与 PTY 会话同源、
- * 版本新），回退 SDK 内置 native binary（系统没装时的零 PATH 依赖兜底）。
- */
-export declare function runClaudePrint(prompt: string, options: RunClaudePrintOptions): Promise<string>;

package/dist/claude-sdk-runner.js

@@ -1,188 +0,0 @@
-import { accessSync, constants as fsConstants, existsSync, statSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { query as sdkQuery, } from "@anthropic-ai/claude-agent-sdk";
-import { buildLanguageDirective } from "./language-prompt.js";
-import { getErrorMessage } from "./error-utils.js";
-export class ClaudeRunError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.code = code;
-        this.name = "ClaudeRunError";
-    }
-}
-/**
- * 判断当前 Linux 是否是 musl 系（Alpine 等）。glibc 系跑不动 musl native binary，
- * 反之亦然，SDK 默认的优先级与本机不匹配时会抛 "Claude Code native binary not found"。
- */
-function isMuslSystem() {
-    try {
-        const header = process.report?.getReport()?.header;
-        return !header?.glibcVersionRuntime;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 在 PATH 上找系统安装的 `claude`。wand 的交互式 PTY 会话本来就 spawn PATH 上的
- * claude（service 模式下 path-repair 已先把 PATH 补全），SDK 调用对齐同一个 binary
- * 才能保证两边版本、认证、API 端点兼容性完全一致。
- */
-function findClaudeOnPath() {
-    const dirs = (process.env.PATH || "").split(path.delimiter);
-    for (const dir of dirs) {
-        if (!dir)
-            continue;
-        const candidate = path.join(dir, "claude");
-        try {
-            accessSync(candidate, fsConstants.X_OK);
-            if (statSync(candidate).isFile())
-                return candidate;
-        }
-        catch {
-            // 不存在或不可执行，继续找下一个目录
-        }
-    }
-    return undefined;
-}
-/**
- * 解析 SDK 应使用的 claude binary：**优先系统安装的 claude，回退 SDK 内置 native binary**。
- *
- * 优先系统版的原因：node_modules 里的内置 binary 版本在装包那刻就钉死了，会随时间
- * 越来越旧，最终可能被 API 端拒绝（实测内置 2.1.138 对部分端点持续 502 重试到超时，
- * 而系统侧日常更新的 2.1.170 正常）。系统 claude 跟交互式 PTY 会话同源，用户平时
- * 一直在用、一直在更新，是最可靠的选择。
- *
- * 内置 binary 仅作兜底（系统没装 claude 时仍可用）。Linux 上必须显式按 libc 选包：
- * SDK 默认解析在 glibc 系统上可能错选 musl 包直接抛 "native binary not found"。
- */
-export function resolveSdkClaudeBinary() {
-    // Windows 上 PATH 命中的多是 .cmd shim，spawn 语义不同，维持 SDK 默认解析。
-    if (process.platform !== "win32") {
-        const systemClaude = findClaudeOnPath();
-        if (systemClaude)
-            return systemClaude;
-    }
-    if (process.platform !== "linux")
-        return undefined;
-    const musl = isMuslSystem();
-    const arch = process.arch;
-    const require = createRequire(import.meta.url);
-    const candidates = musl
-        ? [
-            `@anthropic-ai/claude-agent-sdk-linux-${arch}-musl/claude`,
-            `@anthropic-ai/claude-agent-sdk-linux-${arch}/claude`,
-        ]
-        : [
-            `@anthropic-ai/claude-agent-sdk-linux-${arch}/claude`,
-            `@anthropic-ai/claude-agent-sdk-linux-${arch}-musl/claude`,
-        ];
-    for (const pkg of candidates) {
-        try {
-            const resolved = require.resolve(pkg);
-            if (existsSync(resolved))
-                return resolved;
-        }
-        catch {
-            // 包不存在，尝试下一个
-        }
-    }
-    return undefined;
-}
-/**
- * 用 `@anthropic-ai/claude-agent-sdk` 跑一次"prompt → 单段纯文本"调用，
- * 等价以前的 `claude -p --output-format text`。
- *
- * 行为对齐 Claude Code 默认：
- *   - 不指定 model / appendSystemPrompt / agent / mcpServers / hooks 等覆盖项，
- *     完全由 `~/.claude/settings.json`、OAuth 凭据、`CLAUDE_*` 环境变量等
- *     用户侧配置接管，与 Claude Code 自身一致。
- *   - `tools: []` 关掉所有内置工具：这两个调用点（commit message / prompt 优化）
- *     本质就是"纯文本生成"，关掉工具能 (1) 防止 Claude 随手开个工具卡住权限询问；
- *     (2) 避免一次性短调用还顺便加载文件 / 跑 bash 这种副作用。
- *   - `mcpServers: {}` + `strictMcpConfig: true` 跳过用户配置的全部 MCP 服务器：
- *     纯文本生成用不上 MCP，但不禁的话每次调用都要连接 MCP（启动慢好几秒）、
- *     还把所有 MCP 工具 schema 灌进 system prompt（实测一次多写 1.6 万 token 的
- *     prompt cache，白花钱）。
- *   - `persistSession: false`：这些 ephemeral 调用不应该污染 `~/.claude/projects/`
- *     的会话历史；用户在 wand UI 里也压根看不到这些"虚拟会话"。
- *
- * binary 解析见 `resolveSdkClaudeBinary()`：优先系统 claude（与 PTY 会话同源、
- * 版本新），回退 SDK 内置 native binary（系统没装时的零 PATH 依赖兜底）。
- */
-export async function runClaudePrint(prompt, options) {
-    const cwd = options.cwd && options.cwd.length > 0 ? options.cwd : undefined;
-    const abortController = new AbortController();
-    const timeoutHandle = setTimeout(() => abortController.abort(), options.timeoutMs);
-    const sdkClaudeBinary = resolveSdkClaudeBinary();
-    const languageDirective = options.language ? buildLanguageDirective(options.language) : "";
-    const appendSystemPrompt = [languageDirective, options.systemInstructions?.trim() ?? ""].filter(Boolean).join("\n\n");
-    const model = options.model?.trim();
-    const sdkOptions = {
-        abortController,
-        tools: [],
-        mcpServers: {},
-        strictMcpConfig: true,
-        persistSession: false,
-        ...(cwd ? { cwd } : {}),
-        ...(sdkClaudeBinary ? { pathToClaudeCodeExecutable: sdkClaudeBinary } : {}),
-        ...(appendSystemPrompt ? { appendSystemPrompt } : {}),
-        ...(model && model !== "default" ? { model } : {}),
-        ...(options.effort ? { effort: options.effort } : {}),
-    };
-    // 单条 user message → AsyncGenerator，SDK 的 streaming input 协议要求。
-    async function* singleShot() {
-        yield {
-            type: "user",
-            message: {
-                role: "user",
-                content: [{ type: "text", text: prompt }],
-            },
-            parent_tool_use_id: null,
-        };
-    }
-    let resultText = "";
-    let resultError = null;
-    try {
-        for await (const msg of sdkQuery({
-            prompt: singleShot(),
-            options: sdkOptions,
-        })) {
-            if (msg.type !== "result")
-                continue;
-            if (msg.subtype === "success" && typeof msg.result === "string") {
-                resultText = msg.result.trim();
-            }
-            else {
-                const errs = Array.isArray(msg.errors)
-                    ? msg.errors.join("; ")
-                    : msg.subtype;
-                resultError = new ClaudeRunError(`Claude SDK 失败：${errs}`, "CLAUDE_CLI_FAILED");
-            }
-            break; // 一次性调用，拿到 result 即退出
-        }
-    }
-    catch (err) {
-        if (abortController.signal.aborted) {
-            throw new ClaudeRunError("Claude 调用超时。", "CLAUDE_TIMEOUT");
-        }
-        const message = getErrorMessage(err);
-        // SDK 找不到 native binary 时会抛 "Claude Code native binary not found"。
-        // 极少数情况下也可能透出 ENOENT。两种都归到"CLI_MISSING"，文案给用户。
-        if (/Claude Code native binary not found|ENOENT/i.test(message)) {
-            throw new ClaudeRunError("未找到 claude CLI。", "CLAUDE_CLI_MISSING");
-        }
-        throw new ClaudeRunError(`Claude SDK 失败：${message}`, "CLAUDE_CLI_FAILED");
-    }
-    finally {
-        clearTimeout(timeoutHandle);
-    }
-    if (resultError)
-        throw resultError;
-    if (!resultText) {
-        throw new ClaudeRunError("Claude 返回了空结果。", "CLAUDE_EMPTY_RESULT");
-    }
-    return resultText;
-}

package/dist/claude-skills.d.ts

@@ -1,6 +0,0 @@
-export interface ClaudeSkillSummary {
-    name: string;
-    description: string;
-    source: "user" | "project";
-}
-export declare function listClaudeSkills(cwd: string): ClaudeSkillSummary[];

package/dist/claude-skills.js

@@ -1,53 +0,0 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-function parseFrontmatter(source) {
-    if (!source.startsWith("---"))
-        return {};
-    const end = source.indexOf("\n---", 3);
-    if (end === -1)
-        return {};
-    const frontmatter = source.slice(3, end);
-    const name = frontmatter.match(/^name:\s*(.+?)\s*$/m)?.[1]?.trim().replace(/^['"]|['"]$/g, "");
-    const description = frontmatter.match(/^description:\s*(.+?)\s*$/m)?.[1]?.trim().replace(/^['"]|['"]$/g, "");
-    return { name, description };
-}
-function readSkills(directory, source) {
-    if (!existsSync(directory))
-        return [];
-    let entries;
-    try {
-        entries = readdirSync(directory, { withFileTypes: true, encoding: "utf8" });
-    }
-    catch {
-        return [];
-    }
-    return entries.flatMap((entry) => {
-        if (!entry.isDirectory())
-            return [];
-        const skillFile = path.join(directory, entry.name, "SKILL.md");
-        if (!existsSync(skillFile))
-            return [];
-        try {
-            const metadata = parseFrontmatter(readFileSync(skillFile, "utf8"));
-            return [{
-                    name: metadata.name || entry.name,
-                    description: metadata.description || "",
-                    source,
-                }];
-        }
-        catch {
-            return [];
-        }
-    });
-}
-export function listClaudeSkills(cwd) {
-    const byName = new Map();
-    for (const skill of [
-        ...readSkills(path.join(os.homedir(), ".claude", "skills"), "user"),
-        ...readSkills(path.join(cwd, ".claude", "skills"), "project"),
-    ]) {
-        byName.set(skill.name, skill);
-    }
-    return Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
-}

package/dist/system-ai.d.ts

@@ -1,27 +0,0 @@
-import type { SessionProvider, SystemAiConfig } from "./types.js";
-export declare function normalizeSystemAiConfig(value: unknown, fallback?: SystemAiConfig): SystemAiConfig;
-/** Copy every usable direct-API profile from the user's configured CLIs. */
-export declare function discoverCliSystemAiConfigs(preferred?: SessionProvider, home?: string): SystemAiConfig[];
-/** Backward-compatible first-profile discovery. */
-export declare function discoverCliSystemAiConfig(preferred?: SessionProvider, home?: string): SystemAiConfig | null;
-/** Return the configured API chain in call order, excluding incomplete entries. */
-export declare function systemAiProfiles(config: SystemAiConfig | undefined, forceEnabled?: boolean): SystemAiConfig[];
-/**
- * Flatten and combine direct-API groups in caller-defined priority order.
- * Later groups are appended after earlier groups and duplicate routes are skipped.
- */
-export declare function mergeSystemAiConfigs(...groups: Array<SystemAiConfig | SystemAiConfig[] | undefined>): SystemAiConfig | undefined;
-/**
- * 一次性 AI 请求：规则 / 角色走系统提示，内容走用户消息。
- * 直连 API 用各协议的 system 通道；CLI 用各 provider 自己的系统提示开关
- * （`systemPromptFlag`），没有开关的 provider 退回把规则并在内容前面。
- */
-export interface AiTextRequest {
-    /** 规则、角色、输出格式。空字符串表示这次调用不需要系统提示。 */
-    system: string;
-    /** 本次要处理的内容（diff、用户原话、对话摘要…）。 */
-    prompt: string;
-}
-export declare function callSystemAiText(request: AiTextRequest, config: SystemAiConfig, timeoutMs?: number): Promise<string>;
-/** Try every configured API in order. Empty responses are treated as unavailable. */
-export declare function callSystemAiTextWithFallback(request: AiTextRequest, config: SystemAiConfig, timeoutMs?: number): Promise<string>;