@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/modes/rpc.js

@@ -0,0 +1,316 @@
+/**
+ * RPC 模式 — Sprint 1a stub
+ *
+ * NDJSON over stdio（Codex / oh-my-pi 借鉴）：每行 = 1 个 JSON object。
+ *   - request:  { id, method, params }
+ *   - response: { id, result | error }
+ *   - notification: { method, params }  // server push,无 id
+ *
+ * Sprint 1a stub 范围：
+ *   - 实现 NDJSON line parser + writer
+ *   - 实现 1 个 method: 'chat'（复用 runPrintMode 逻辑）
+ *   - 拒绝其他 method 返回 "method not found"
+ *   - Ctrl-C 优雅退出
+ *
+ * Sprint 1b 扩展：
+ *   - initialize / cancel / shutdown
+ *   - session 加载/恢复/分支
+ *   - streaming 增量推送（sse-like notifications）
+ */
+import process from 'node:process';
+import { createInterface } from 'node:readline';
+import { isLLMError } from '@deepwhale/llm';
+import { SessionReader, SessionWriter } from '@deepwhale/core';
+import { isToolLoopError, loadSession, persistToolLoopSteps, runToolLoop, runToolLoopWithCompaction, } from '../agent/index.js';
+import { CompactionState } from '@deepwhale/core';
+import { createDefaultRegistry } from '../tools/registry.js';
+import { createDefaultClient } from '../llm-factory.js';
+import { resolveSandboxRunnerFromEnv } from '../sandbox/env-gate.js';
+import { staticToolPolicy } from '../policy/static-rules.js';
+export async function runRpcMode(options) {
+    // Sprint 1c-revive-2-D-5+ (review P2, 2026-06-04): rpc 改走 createDefaultClient
+    // factory, 跟 print/repl 拍板一致 (env 推断 + flag 显式覆盖). 旧实现写死
+    // DeepSeekClient 拍 P2 bug: --provider anthropic 走 rpc 仍用 deepseek.
+    const client = options.client ??
+        createDefaultClient({
+            ...(options.provider !== undefined ? { provider: options.provider } : {}),
+            ...(options.model !== undefined ? { model: options.model } : {}),
+        });
+    const sessionPath = options.sessionPath;
+    // Sprint 1c-revive-3-D-12 review P1 修复 (2026-06-05): 入口解析 sandbox env.
+    // 未知值 throw (fail-closed), 由 CLI `main().catch` 写到 stderr + exit 1.
+    const sandboxRunner = resolveSandboxRunnerFromEnv({ sandboxRoot: process.cwd() });
+    // Sprint 1c-revive-3-D-13: rpc 拍板 isInteractive=false (D-15 扩 confirmedTools 协议).
+    const policyYes = options.yes ?? false;
+    // session
+    let workingMessages = [];
+    const writer = sessionPath ? new SessionWriter(sessionPath) : null;
+    const reader = sessionPath ? new SessionReader(sessionPath) : null;
+    if (writer && reader) {
+        try {
+            await writer.open();
+            const loaded = await loadSession(reader);
+            workingMessages = [...loaded.messages];
+        }
+        catch (e) {
+            sendError('session_load_failed', `could not load session: ${String(e)}`, '');
+        }
+    }
+    // Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): CompactionState 闭包持有,
+    // 跨 chat request 持续累计 failures / paused 状态. 跟 startRepl 拍板一致.
+    let compactionConfig = null;
+    if (options.compactionConfig && writer) {
+        compactionConfig = {
+            ...options.compactionConfig,
+            writer,
+            state: new CompactionState(options.compactionConfig.pauseAfterFailures ?? 2),
+        };
+    }
+    else if (options.compactionConfig && !writer) {
+        sendError('compaction_requires_session', 'compactionConfig requires sessionPath; falling back to baseline (no compaction).', '');
+    }
+    process.stderr.write('deepwhale rpc mode (Sprint 1a stub)\n');
+    process.stderr.write('  methods: chat { prompt, stream? }\n');
+    process.stderr.write('  notifications: stderr only\n');
+    const rl = createInterface({
+        input: options.input ?? process.stdin,
+        terminal: false,
+    });
+    let exiting = false;
+    // Sprint 1a follow-up:readline line event 不会 await handler,并发 dispatch 会让 workingMessages race。
+    // 维护一个 in-flight chain,保证 request 串行处理,workingMessages 累积语义稳定。
+    //
+    // P1 follow-up:close/SIGINT 路径必须先 await chain,否则正在跑的 chat 写到一半就被 rl.close 砍掉,
+    // chat.delta notification / response 都会被截断,响应"晚到"或直接丢。
+    // 协议契约:close 触发后,已收到的 request 仍要完整处理完,只有 stdin 已关且 chain 排空才能 finish。
+    let chain = Promise.resolve();
+    // 标记"想退出",但不立刻 finish。close handler 会 await chain 再 finish。
+    let shouldExit = false;
+    let exitSignal = 0;
+    const finish = async () => {
+        if (exiting)
+            return;
+        exiting = true;
+        rl.close();
+        if (writer) {
+            try {
+                await writer.close();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    };
+    const requestShutdown = (code) => {
+        if (shouldExit)
+            return; // 已经处于 shutdown 流程,不要重复 signal
+        shouldExit = true;
+        exitSignal = code;
+    };
+    rl.on('line', (line) => {
+        chain = chain.then(async () => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            let req;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (typeof parsed !== 'object' ||
+                    parsed === null ||
+                    typeof parsed.id !== 'string' ||
+                    typeof parsed.method !== 'string') {
+                    sendError('invalid_request', 'expected {id, method, params?}', '');
+                    return;
+                }
+                req = parsed;
+            }
+            catch (e) {
+                sendError('parse_error', `invalid JSON: ${String(e)}`, '');
+                return;
+            }
+            try {
+                const result = await dispatch(client, req, workingMessages, writer, options, compactionConfig, sandboxRunner, policyYes);
+                sendOk(req.id, result);
+            }
+            catch (e) {
+                if (isToolLoopError(e)) {
+                    sendError('tool_loop_limit', e.message, req.id);
+                }
+                else if (isLLMError(e)) {
+                    sendError('llm_error', e.message, req.id);
+                }
+                else {
+                    sendError('internal_error', e instanceof Error ? e.message : String(e), req.id);
+                }
+            }
+        });
+    });
+    rl.on('close', () => {
+        // stdin 关闭 → 标记退出,但不立刻 finish。finish 由 chain 排空触发。
+        // Sprint 1a follow-up #3:signal handler 走的是 "rl.close() 触发此 close handler" 路径,
+        // 所以 SIGINT/SIGTERM 也走这里 drain — 保证 in-flight chat 能写完响应。
+        requestShutdown(0);
+    });
+    // Sprint 1a follow-up #3: 之前 SIGINT/SIGTERM 只 requestShutdown(0) 但不 rl.close(),
+    // 若 stdin 还开着 (例如纯 RPC 模式无 stdin 数据), 进程永远等 close 事件 → 挂住。
+    // 修法: signal handler 主动 rl.close(), 走和 stdin close 一样的 drain 路径。
+    // exitSignal 反映是被 signal 干掉 (128 + 信号编号), 让 caller 决定退出码 130/143。
+    const watchSignals = options.watchSignals ?? ['SIGINT', 'SIGTERM'];
+    const signalHandlers = [];
+    for (const sig of watchSignals) {
+        const handler = () => {
+            // 128 + 信号编号 是 POSIX 约定 (130 = SIGINT, 143 = SIGTERM, ...)
+            const code = sig === 'SIGINT' ? 130 : sig === 'SIGTERM' ? 143 : 128;
+            requestShutdown(code);
+            // 主动触发 close, 走和 stdin close 完全一样的 drain 路径
+            rl.close();
+        };
+        process.on(sig, handler);
+        signalHandlers.push({ sig, handler });
+    }
+    // 阻塞直到 stdin 关闭。close 之后,等 chain 排空再 cleanup。
+    await new Promise((resolve) => rl.once('close', () => resolve()));
+    // P1 follow-up:等 chain 排空 + finish,才能保证 close 之后排队的 request 完整写完 stdout。
+    await chain;
+    await finish();
+    // 卸载 signal handler 避免 leak: 同一进程多次调用 runRpcMode 不能重复挂 signal。
+    for (const { sig, handler } of signalHandlers) {
+        process.off(sig, handler);
+    }
+    return exitSignal;
+}
+async function dispatch(client, req, workingMessages, writer, options, compactionConfig, 
+// Sprint 1c-revive-3-D-12 review P1 修复: 透传 sandboxRunner 进 dispatch,
+// 让 chat request 内的 tool loop 跟 env 配置一致.
+sandboxRunner, 
+// Sprint 1c-revive-3-D-13: 透传 yes 进 dispatch.
+yes) {
+    switch (req.method) {
+        case 'chat': {
+            const prompt = req.params?.['prompt'];
+            if (typeof prompt !== 'string') {
+                throw new Error('chat: params.prompt must be a string');
+            }
+            const stream = req.params?.['stream'] === true;
+            if (writer) {
+                const userEvent = { kind: 'user', ts: Date.now(), content: prompt };
+                await writer.append(userEvent);
+            }
+            // 构造 turn 消息:历史 + 本轮 user。Sprint 1a 修 P1 — user 必须进 LLM。
+            const turnMessages = [...workingMessages, { role: 'user', content: prompt }];
+            // Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): compactionConfig 存在
+            // 走 runToolLoopWithCompaction, 跨 chat request 复用 CompactionState (paused
+            // / failures 跨 request 持续, 跟 test 1c-revive-2-D-5-2 拍板).
+            const summaryFn = compactionConfig
+                ? makeLlmSummarizeFn(client, compactionConfig.protocol)
+                : null;
+            const result = await (async () => {
+                if (compactionConfig !== null && summaryFn !== null) {
+                    return runToolLoopWithCompaction(client, turnMessages, {
+                        registry: createDefaultRegistry({ sandboxRunner }),
+                        ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+                        ...(stream
+                            ? {
+                                onChunk: (chunk) => {
+                                    if (chunk.content) {
+                                        const notif = {
+                                            method: 'chat.delta',
+                                            params: { content: chunk.content },
+                                        };
+                                        process.stdout.write(`${JSON.stringify(notif)}\n`);
+                                    }
+                                },
+                            }
+                            : {}),
+                        policy: staticToolPolicy,
+                        isInteractive: false, // rpc 拍板非交互 (D-13)
+                        yes,
+                        ...(writer ? { writer } : {}),
+                    }, compactionConfig, summaryFn);
+                }
+                return runToolLoop(client, turnMessages, {
+                    registry: createDefaultRegistry({ sandboxRunner }),
+                    ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+                    ...(stream
+                        ? {
+                            onChunk: (chunk) => {
+                                if (chunk.content) {
+                                    const notif = {
+                                        method: 'chat.delta',
+                                        params: { content: chunk.content },
+                                    };
+                                    process.stdout.write(`${JSON.stringify(notif)}\n`);
+                                }
+                            },
+                        }
+                        : {}),
+                    policy: staticToolPolicy,
+                    isInteractive: false, // rpc 拍板非交互 (D-13)
+                    yes,
+                    ...(writer ? { writer } : {}),
+                });
+            })();
+            if (writer) {
+                try {
+                    await persistToolLoopSteps(writer, result.steps);
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+            // 跑完回写 workingMessages,下一个 request 拿到的是包含本轮 assistant 步骤的 history。
+            // 修 Sprint 1a follow-up: 之前不写回,后续 chat 永远基于空历史。
+            workingMessages.length = 0;
+            workingMessages.push(...result.messages);
+            // Sprint 1b: 顶层暴露 cache_hit_rate / cost_turn, 让 RPC caller 不用 deep dive 到 usage
+            // (跟 print/REPL 状态栏对齐: 关键可观测性 1 层扁平访问)
+            const resultObj = {
+                content: result.final.content,
+                usage: result.final.usage,
+                steps: result.steps.length,
+            };
+            if (result.final.usage?.cache_hit_rate !== undefined) {
+                resultObj['cache_hit_rate'] = result.final.usage.cache_hit_rate;
+            }
+            if (result.final.usage?.cost_turn !== undefined) {
+                resultObj['cost_turn'] = result.final.usage.cost_turn;
+            }
+            return resultObj;
+        }
+        default:
+            throw new Error(`method not found: '${req.method}'`);
+    }
+}
+function sendOk(id, result) {
+    const resp = { id, result };
+    process.stdout.write(`${JSON.stringify(resp)}\n`);
+}
+function sendError(code, message, id) {
+    const resp = { id, error: { code, message } };
+    process.stdout.write(`${JSON.stringify(resp)}\n`);
+}
+/**
+ * 生成 LLM summary callback (Sprint 1c-revive-2-D-6).
+ * 跟 startRepl / runPrintMode 同形态 helper 拍板一致. 跨 openai/anthropic
+ * 同形态 (走 LLMClient 统一契约).
+ */
+function makeLlmSummarizeFn(client, _protocol) {
+    return async (toSummarize) => {
+        const summaryMessages = [
+            {
+                role: 'system',
+                content: 'You are a concise summarizer. Compress the following conversation into 1 short paragraph ' +
+                    '(max 200 words). Preserve key arithmetic results, tool calls, and final answers.',
+            },
+            {
+                role: 'user',
+                content: toSummarize
+                    .map((m, i) => `[${i}] ${m.role}: ${m.content ?? '(empty)'}`)
+                    .join('\n'),
+            },
+        ];
+        const r = await client.chat(summaryMessages, {});
+        return r.content;
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/modes/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/modes/rpc.ts"],"names":[],"mappings":"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"}

package/dist/modes/tui.d.ts

@@ -0,0 +1,107 @@
+/**
+ * TUI 模式 — Sprint 1c-revive-4-D-20.3 P0-B (2026-06-05) v1.0 capability completion
+ *
+ * @deprecated LEGACY — Sprint 1c-revive-2-D-24.3 (2026-06-06) v1.0.9:
+ *   1.0.9+ `deepwhale tui` mode 走 Ink 容器 (@deepwhale/tui-ink 1.0.9 bundle).
+ *   本文件保留仅作 source-install dev 路径保底, 不再是 default path.
+ *   - bin/deepwhale.js 'tui' case → runTuiInkMode (D-24.3 dispatch)
+ *   - 跟 D-24.1 §6 红线 1 一致: legacy 0 删, fallback 兜底
+ *   - 现有 979 行 tui-smoke.test.ts 0 改动, 行为在 readline 容器仍验过
+ *
+ *   业务逻辑 0 重写: D-22 / D-23.1 / D-23.2 业务 1:1 搬到 tui-ink/, 跟本文件同形态.
+ *   不再维护 (sprint 1.1+): 计划完全删除本文件, 但保留 0 改动作 fallback.
+ *
+ *   ---- 下方为 v1.0.0 - v1.0.8 readline 容器实现 ----
+ *
+ * Minimal ANSI TUI. **不**装新依赖 (无 Ink), 用 node:readline + ANSI 转义码.
+ *
+ * 复用红线 (D-20.3 P0-B 拍板):
+ *   - 复用 runToolLoop + staticToolPolicy (不绕过 ToolPolicy)
+ *   - 复用 createReplConfirm (D-19 串行化, 不重建 2 套 confirm)
+ *   - 复用 SessionWriter (不绕过 session audit, 跟 REPL/print mode 同形态)
+ *   - 复用 formatUsageStatus (REPL 状态栏 4 字段, 风格统一)
+ *
+ * 必须实现 (用户红线):
+ *   1. `deepwhale tui` 启动
+ *   2. 用户可输入 prompt
+ *   3. assistant stream 可显示
+ *   4. tool call / result 可显示
+ *   5. destructive tool 触发 y/N confirm (走 createReplConfirm)
+ *   6. y 执行, n/empty 拒绝
+ *   7. /exit 或 q 退出
+ *   8. session 不损坏 (走 D-19.5 finish 路径, writer.close)
+ *   9. TUI 路径复用 ToolPolicy / SessionWriter / runToolLoop
+ *
+ * Minimal scope (v1.0):
+ *   - ANSI 颜色: 标题 / 用户 prompt / tool call / tool result / 状态栏
+ *   - 不做: 多行 / 自动补全 / 主题 / 鼠标 / 文件树 / syntax highlight
+ *
+ * NOT covered (defer to v1.1):
+ *   - 全屏 IDE-style TUI
+ *   - 主题切换
+ *   - 多 session 切换
+ *   - Plan mode / recovery
+ */
+import type { LLMClient } from '@deepwhale/llm';
+import { type AgentCompactionConfig } from '../agent/index.js';
+import { type Provider } from '../llm-factory.js';
+export type TuiThemeName = 'default' | 'solarized' | 'monochrome';
+export interface TuiTheme {
+    header: string;
+    model: string;
+    divider: string;
+    prompt: string;
+    error: string;
+    success: string;
+    /** D-23.1 (2026-06-06): 工具名 (tool call/result 行), 跟 model 同级, 用同色变体 */
+    toolName: string;
+}
+export declare const THEMES: Record<TuiThemeName, TuiTheme>;
+/**
+ * 解析 theme 来源 (env > 默认), 找不到或 invalid 时退化到 'default' + stderr warning.
+ * 不抛: 启动期不阻塞, 跟 env-gate 风格一致.
+ */
+export declare function resolveTuiTheme(themeArg?: string): TuiThemeName;
+/**
+ * 语法高亮 chunk content. 非 TTY 退化到原 text (跟 colorize 行为一致, 跟 CI/管道 log 兼容).
+ *
+ * @param text - 单 chunk 文本 fragment
+ * @param theme - 当前 theme (从 runTuiMode 闭包传入)
+ * @param forceColor - D-23.2 测试 hook: 强制当 TTY (非默认) 用于 unit test 验证染色字节.
+ *                     生产路径 (runTuiMode) 不传, 走 isTty() 自动判断.
+ * @returns 染色后文本 (含 ANSI escape) 或原 text (非 TTY)
+ */
+export declare function highlightChunk(text: string, theme?: TuiTheme, forceColor?: boolean): string;
+declare const SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼"];
+declare const SPINNER_INTERVAL_MS = 80;
+declare const SPINNER_LABEL = "thinking\u2026";
+declare class Spinner {
+    private timer;
+    private frame;
+    private active;
+    start(stream?: NodeJS.WritableStream): void;
+    stop(stream?: NodeJS.WritableStream): void;
+    private render;
+}
+export { Spinner, SPINNER_FRAMES, SPINNER_INTERVAL_MS, SPINNER_LABEL };
+export interface TuiModeOptions {
+    sessionPath?: string;
+    enableToolLoop?: boolean;
+    maxSteps?: number;
+    client?: LLMClient;
+    provider?: Provider;
+    model?: string;
+    yes?: boolean;
+    /** 注入输入流（默认 stdin）。单测用。 */
+    input?: NodeJS.ReadableStream;
+    /** 注入输出流（默认 stdout）。单测用。 */
+    output?: NodeJS.WritableStream;
+    /** 注入错误流（默认 stderr）。单测用。 */
+    errorOutput?: NodeJS.WritableStream;
+    /** D-23.1 (2026-06-06): TUI 主题. 不传或 invalid → 'default' (跟 env DEEPWHALE_TUI_THEME 协同). */
+    theme?: TuiThemeName;
+    /** compaction config 跟 print mode 同形态 */
+    compactionConfig?: Omit<AgentCompactionConfig, 'writer' | 'state'> | null;
+}
+export declare function runTuiMode(options?: TuiModeOptions): Promise<number>;
+//# sourceMappingURL=tui.d.ts.map

package/dist/modes/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/modes/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,OAAO,EAKL,KAAK,qBAAqB,EAE3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAwCvE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CA8BjD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAO/D;AAyED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,QAAyB,EAChC,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,CA8CR;AAkBD,QAAA,MAAM,cAAc,oCAAqC,CAAC;AAC1D,QAAA,MAAM,mBAAmB,KAAK,CAAC;AAC/B,QAAA,MAAM,aAAa,mBAAc,CAAC;AAElC,cAAM,OAAO;IACX,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAS;IAEvB,KAAK,CAAC,MAAM,GAAE,MAAM,CAAC,cAAuB,GAAG,IAAI;IAYnD,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,cAAuB,GAAG,IAAI;IA0BlD,OAAO,CAAC,MAAM;CAKf;AAGD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC;AAmBvE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACpC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3E;AAID,wBAAsB,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqX9E"}