@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/llm-factory.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @deepwhale/coding-agent — LLM provider factory
+ *
+ * Sprint 1b.5 Step 2 (2.5 拍板, C3 拍板 2026-06-03):
+ * REPL 启动时 provider 怎么选, 拍板为 "env 推断 + flag 显式覆盖":
+ * 1. options.provider 显式给 → 优先用显式值 (REPL --provider flag)
+ * 2. options.provider 未给 → 看 env:
+ *    - DEEPWHALE_PROVIDER=deepseek|anthropic 显式设 → 用该值 (D-21.1 拍板,
+ *      让 shell user 一行 set 决断, 不必 unset 另一个 key)
+ *    - ANTHROPIC_AUTH_TOKEN 设了 + DEEPSEEK_API_KEY 没设 → anthropic (走 DeepSeek shim)
+ *    - DEEPSEEK_API_KEY 设了 + ANTHROPIC_AUTH_TOKEN 没设 → deepseek
+ *    - 两个都设了 → 报错 (静默走错 provider 误用 API key 是 P0 风险)
+ *    - 两个都没设 → 报错 (让 user 知道必须设 key)
+ *
+ * 设计原则 (Hermes 1a follow-up #2 lesson):
+ * - 不**静默** default 到某个 provider, 必报清晰错
+ * - DEEPWHALE_PROVIDER 是 "user 决断" 显式语义, 优先级高于 env 推断
+ * - 不**做**汇率换算 / 跨 provider 兼容 (DeepSeek shim 走同一 endpoint, 接口层隔离)
+ * - 注入点已存在 (ReplOptions.client), factory 只在 startRepl 入口用
+ */
+import { AnthropicClient, DeepSeekClient, type LLMClient } from '@deepwhale/llm';
+export type Provider = 'deepseek' | 'anthropic';
+export interface CreateClientOptions {
+    /** 显式 provider. 跟 env 推断冲突时, 优先用显式值 + warn. */
+    provider?: Provider;
+    /** 显式 model ID. 不传则用 provider 默认 (deepseek → deepseek-v4-flash, anthropic → claude-sonnet-4-5). */
+    model?: string;
+}
+/**
+ * C3 拍板: env 推断 + flag 显式覆盖.
+ * - provider 显式给 → 走 provider (不再读 env, 显式胜出)
+ * - provider 未给 → 看 env (ANTHROPIC_AUTH_TOKEN vs DEEPSEEK_API_KEY)
+ * - provider 显式 + env 也设了不一致 → 显式胜出, 不报错 (user 知道自己传了啥)
+ * - 都没设 → 报错 (跟 1b 时代 APIKeyMissingError 行为一致, 引导 user 设 env)
+ */
+export declare function createDefaultClient(options?: CreateClientOptions): LLMClient;
+/**
+ * 公开 env key 解析, 给 mode 层 (repl/print/rpc) 显式判断 provider 用.
+ * 跟 AnthropicClient.resolveApiKey 内部逻辑**保持一致**: ANTHROPIC_AUTH_TOKEN 优先,
+ * DEEPSEEK_API_KEY 退路. 不抛 (返 undefined 让 caller 决定).
+ */
+export declare function resolveAnthropicApiKey(): string | undefined;
+/**
+ * 重新导出 Re-export 给 cli.ts 入口, 让 cli.ts 不必直接 import from @deepwhale/llm
+ * (单测 mock LLMClient 时, 走 @deepwhale/coding-agent/llm-factory 一处 import 即可).
+ *
+ * Provider + CreateClientOptions type 已在上面 line 22-25 export, 这里只 re-export class.
+ */
+export { AnthropicClient, DeepSeekClient };
+//# sourceMappingURL=llm-factory.d.ts.map

package/dist/llm-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-factory.d.ts","sourceRoot":"","sources":["../src/llm-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,SAAS,EAAsB,MAAM,gBAAgB,CAAC;AAErG,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAchF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAM3D;AAiDD;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/llm-factory.js

@@ -0,0 +1,110 @@
+/**
+ * @deepwhale/coding-agent — LLM provider factory
+ *
+ * Sprint 1b.5 Step 2 (2.5 拍板, C3 拍板 2026-06-03):
+ * REPL 启动时 provider 怎么选, 拍板为 "env 推断 + flag 显式覆盖":
+ * 1. options.provider 显式给 → 优先用显式值 (REPL --provider flag)
+ * 2. options.provider 未给 → 看 env:
+ *    - DEEPWHALE_PROVIDER=deepseek|anthropic 显式设 → 用该值 (D-21.1 拍板,
+ *      让 shell user 一行 set 决断, 不必 unset 另一个 key)
+ *    - ANTHROPIC_AUTH_TOKEN 设了 + DEEPSEEK_API_KEY 没设 → anthropic (走 DeepSeek shim)
+ *    - DEEPSEEK_API_KEY 设了 + ANTHROPIC_AUTH_TOKEN 没设 → deepseek
+ *    - 两个都设了 → 报错 (静默走错 provider 误用 API key 是 P0 风险)
+ *    - 两个都没设 → 报错 (让 user 知道必须设 key)
+ *
+ * 设计原则 (Hermes 1a follow-up #2 lesson):
+ * - 不**静默** default 到某个 provider, 必报清晰错
+ * - DEEPWHALE_PROVIDER 是 "user 决断" 显式语义, 优先级高于 env 推断
+ * - 不**做**汇率换算 / 跨 provider 兼容 (DeepSeek shim 走同一 endpoint, 接口层隔离)
+ * - 注入点已存在 (ReplOptions.client), factory 只在 startRepl 入口用
+ */
+import { AnthropicClient, DeepSeekClient, APIKeyMissingError } from '@deepwhale/llm';
+/**
+ * C3 拍板: env 推断 + flag 显式覆盖.
+ * - provider 显式给 → 走 provider (不再读 env, 显式胜出)
+ * - provider 未给 → 看 env (ANTHROPIC_AUTH_TOKEN vs DEEPSEEK_API_KEY)
+ * - provider 显式 + env 也设了不一致 → 显式胜出, 不报错 (user 知道自己传了啥)
+ * - 都没设 → 报错 (跟 1b 时代 APIKeyMissingError 行为一致, 引导 user 设 env)
+ */
+export function createDefaultClient(options = {}) {
+    const resolved = resolveProvider(options.provider);
+    switch (resolved) {
+        case 'deepseek':
+            return new DeepSeekClient({ ...(options.model !== undefined ? { model: options.model } : {}) });
+        case 'anthropic':
+            // Sprint 1b.5 Step 2.5 (F1 拍板, review 2026-06-03): 不**传** apiKey, 让 AnthropicClient
+            // 内部 resolveApiKey() 读 env. 之前传 'placeholder' 是测试 mock 路径留下的 bug, 会**盖**
+            // 真实 env ANTHROPIC_AUTH_TOKEN / DEEPSEEK_API_KEY, Step 3 真接会 401.
+            //
+            // X3 拍板: 测试场景单测 mock fetch, 不**走**真 HTTP, apiKey 走 env 也无所谓.
+            // 真要测试"不传 apiKey 时 constructor 抛" 的路径, 显式 inject options.apiKey.
+            return new AnthropicClient({ ...(options.model !== undefined ? { model: options.model } : {}) });
+    }
+}
+/**
+ * 公开 env key 解析, 给 mode 层 (repl/print/rpc) 显式判断 provider 用.
+ * 跟 AnthropicClient.resolveApiKey 内部逻辑**保持一致**: ANTHROPIC_AUTH_TOKEN 优先,
+ * DEEPSEEK_API_KEY 退路. 不抛 (返 undefined 让 caller 决定).
+ */
+export function resolveAnthropicApiKey() {
+    const anthropic = process.env['ANTHROPIC_AUTH_TOKEN'];
+    if (anthropic !== undefined && anthropic !== '')
+        return anthropic;
+    const deepseek = process.env['DEEPSEEK_API_KEY'];
+    if (deepseek !== undefined && deepseek !== '')
+        return deepseek;
+    return undefined;
+}
+/**
+ * 解析 provider (env 推断 + flag 显式).
+ * 显式给 → 直接返, 跳过 env 推断.
+ * 显式未给 → 看 env:
+ *   - 都没设 → 抛 APIKeyMissingError (跟 1b 时代一致, 引导 user)
+ *   - 都设了 → 抛 'both-set' 错误 (P0 风险, 强制 user 决断)
+ *   - 只设一个 → 返那个
+ *
+ * Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 Anthropic wins tiebreak bug):
+ * 之前 if-else 顺序是 "hasAnthropic 排第一", 跟产品 "DeepSeek-first" 品牌
+ * (README:18 / package.json:6 / DeepSeekClient 默认 model=deepseek-v4-flash)
+ * 矛盾. 两个都设的实情被 tryCreateClient catch 静默 + tryCreateClient
+ * 自身的 fallback 让用户误以为"在走 anthropic". 拍板: 跟品牌一致,
+ * hasDeepseek 排第一; 都设的 error 信息明示用户可以传 --provider 决断.
+ * 行为兼容: 单 key 路径 (只设 Anthropic 或只设 DeepSeek) 完全不变.
+ */
+function resolveProvider(explicit) {
+    // 优先级: 显式 options.provider > DEEPWHALE_PROVIDER env > 单 key 推断.
+    if (explicit !== undefined)
+        return explicit;
+    // Sprint 1c-revive-2-D-21.1 (2026-06-06): DEEPWHALE_PROVIDER 让 user shell 一行
+    // 决断 (e.g. `DEEPWHALE_PROVIDER=deepseek deepwhale` 即使两个 key 都设了也走 deepseek).
+    const providerEnv = process.env['DEEPWHALE_PROVIDER'];
+    if (providerEnv === 'deepseek' || providerEnv === 'anthropic') {
+        return providerEnv;
+    }
+    // DEEPWHALE_PROVIDER 设了非法值: 静默 fall through 到 env 推断, 不让 typo
+    // (e.g. `DEEPWHALE_PROVIDER=depseek`) 整个 CLI 崩. 拍板: 静默忽略, 因为
+    // "拼错" 不该是 fatal, user 该看到下面的 "Both set" 错才知道哪里设错了.
+    const hasAnthropic = (process.env['ANTHROPIC_AUTH_TOKEN'] ?? '') !== '';
+    const hasDeepseek = (process.env['DEEPSEEK_API_KEY'] ?? '') !== '';
+    if (hasAnthropic && hasDeepseek) {
+        throw new APIKeyMissingError('Both ANTHROPIC_AUTH_TOKEN and DEEPSEEK_API_KEY are set. ' +
+            'Unset one, or set DEEPWHALE_PROVIDER=<deepseek|anthropic>, or pass --provider <name>. ' +
+            'This is a safety check to prevent silently using the wrong provider with the wrong API key. ' +
+            'Note: DeepWhale is DeepSeek-first (default model: deepseek-v4-flash).');
+    }
+    if (hasDeepseek)
+        return 'deepseek';
+    if (hasAnthropic)
+        return 'anthropic';
+    throw new APIKeyMissingError('No LLM API key set. Set DEEPSEEK_API_KEY (DeepSeek) or ' +
+        'ANTHROPIC_AUTH_TOKEN (Anthropic, via DeepSeek shim /anthropic endpoint) ' +
+        'environment variable, or pass --provider explicitly.');
+}
+/**
+ * 重新导出 Re-export 给 cli.ts 入口, 让 cli.ts 不必直接 import from @deepwhale/llm
+ * (单测 mock LLMClient 时, 走 @deepwhale/coding-agent/llm-factory 一处 import 即可).
+ *
+ * Provider + CreateClientOptions type 已在上面 line 22-25 export, 这里只 re-export class.
+ */
+export { AnthropicClient, DeepSeekClient };
+//# sourceMappingURL=llm-factory.js.map

package/dist/llm-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-factory.js","sourceRoot":"","sources":["../src/llm-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAkB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAWrG;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA+B,EAAE;IACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,IAAI,cAAc,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClG,KAAK,WAAW;YACd,oFAAoF;YACpF,yEAAyE;YACzE,kEAAkE;YAClE,EAAE;YACF,6DAA6D;YAC7D,iEAAiE;YACjE,OAAO,IAAI,eAAe,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACtD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,eAAe,CAAC,QAA8B;IACrD,gEAAgE;IAChE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACtD,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAC9D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,8DAA8D;IAC9D,6DAA6D;IAC7D,oDAAoD;IACpD,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;IACxE,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;IACnE,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAC1B,0DAA0D;YACxD,wFAAwF;YACxF,8FAA8F;YAC9F,uEAAuE,CAC1E,CAAC;IACJ,CAAC;IACD,IAAI,WAAW;QAAE,OAAO,UAAU,CAAC;IACnC,IAAI,YAAY;QAAE,OAAO,WAAW,CAAC;IACrC,MAAM,IAAI,kBAAkB,CAC1B,yDAAyD;QACvD,0EAA0E;QAC1E,sDAAsD,CACzD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/modes/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @deepwhale/coding-agent/modes — CLI 运行模式
+ *
+ * Sprint 1a 落地：
+ *   - interactive: REPL（repl.ts 已有，bin 直接复用 startRepl）
+ *   - print:      一次性 chat + tool loop（脚本/CI 友好）
+ *   - rpc:        NDJSON over stdio（编辑器/LSP 集成用）
+ *
+ * Sprint 1b 再加：rpc method 注册表（initialize / chat / cancel / shutdown）。
+ */
+export { runPrintMode } from './print.js';
+export { runRpcMode } from './rpc.js';
+export { runTuiMode } from './tui.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/modes/index.js

@@ -0,0 +1,14 @@
+/**
+ * @deepwhale/coding-agent/modes — CLI 运行模式
+ *
+ * Sprint 1a 落地：
+ *   - interactive: REPL（repl.ts 已有，bin 直接复用 startRepl）
+ *   - print:      一次性 chat + tool loop（脚本/CI 友好）
+ *   - rpc:        NDJSON over stdio（编辑器/LSP 集成用）
+ *
+ * Sprint 1b 再加：rpc method 注册表（initialize / chat / cancel / shutdown）。
+ */
+export { runPrintMode } from './print.js';
+export { runRpcMode } from './rpc.js';
+export { runTuiMode } from './tui.js';
+//# sourceMappingURL=index.js.map

package/dist/modes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/modes/print.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Print 模式 — Sprint 1a
+ *
+ * 一次性 chat（默认）+ tool loop：接 -p prompt，跑完退出。
+ *
+ * 用法：
+ *   deepwhale -p "列出当前目录"
+ *
+ * 行为契约：
+ *   - enableToolLoop=true（默认）：接 tool loop（runToolLoop + createDefaultRegistry）
+ *   - enableToolLoop=false（--no-tool-loop）：纯 chat，**完全不暴露 tools schema 给 LLM**，
+ *     不调任何工具。即使 LLM 想调 tool_calls，client 端 tools=undefined，
+ *     LLM 服务端收到请求 schema 不含 tools，会回纯文本 content。
+ *   - 流式输出到 stdout（不缓冲）
+ *   - 退出码：0 正常 / 1 错误 / 2 用法错
+ *
+ * Sprint 1a 简化：不读 stdin，只读 -p 参数。
+ */
+import { type LLMClient } from '@deepwhale/llm';
+import { type AgentCompactionConfig } from '../agent/index.js';
+import { type Provider } from '../llm-factory.js';
+export interface PrintModeOptions {
+    prompt: string;
+    sessionPath?: string;
+    enableToolLoop?: boolean;
+    maxSteps?: number;
+    /**
+     * 注入 LLM 客户端（默认 createDefaultClient env 推断, Sprint 1b.5 Step 2.5 C3 拍板）。
+     * Sprint 1a follow-up: 单测用。
+     */
+    client?: LLMClient;
+    /** Sprint 1b.5 Step 2.5: 显式 provider, 跟 env 推断冲突时优先. */
+    provider?: Provider;
+    /** Sprint 1b.5 Step 2.5: 显式 model. 不传则用 provider 默认. */
+    model?: string;
+    /**
+     * Session compaction 集成 (Sprint 1c-revive-2-D-6, review P1 修复 2026-06-04).
+     * 不传 = baseline (走 runToolLoop). 传 = 走 runToolLoopWithCompaction.
+     * 拍板: writer 字段 print mode 内部构造 (跟 sessionPath 同 instance).
+     */
+    compactionConfig?: Omit<AgentCompactionConfig, 'writer' | 'state'> | null;
+    /**
+     * Sprint 1c-revive-3-D-13 (2026-06-05): --yes 标志.
+     * yes=true bypass require_confirmation (write_file / edit_file / 危险 bash).
+     * 不 bypass deny. 拍板: print mode 默认 isInteractive=false + policy=staticToolPolicy.
+     */
+    yes?: boolean;
+}
+export declare function runPrintMode(options: PrintModeOptions): Promise<number>;
+//# sourceMappingURL=print.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../src/modes/print.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAoB,KAAK,SAAS,EAAsB,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EAML,KAAK,qBAAqB,EAG3B,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIvE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1E;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmL7E"}

package/dist/modes/print.js

@@ -0,0 +1,236 @@
+/**
+ * Print 模式 — Sprint 1a
+ *
+ * 一次性 chat（默认）+ tool loop：接 -p prompt，跑完退出。
+ *
+ * 用法：
+ *   deepwhale -p "列出当前目录"
+ *
+ * 行为契约：
+ *   - enableToolLoop=true（默认）：接 tool loop（runToolLoop + createDefaultRegistry）
+ *   - enableToolLoop=false（--no-tool-loop）：纯 chat，**完全不暴露 tools schema 给 LLM**，
+ *     不调任何工具。即使 LLM 想调 tool_calls，client 端 tools=undefined，
+ *     LLM 服务端收到请求 schema 不含 tools，会回纯文本 content。
+ *   - 流式输出到 stdout（不缓冲）
+ *   - 退出码：0 正常 / 1 错误 / 2 用法错
+ *
+ * Sprint 1a 简化：不读 stdin，只读 -p 参数。
+ */
+import process from 'node:process';
+import { APIKeyMissingError } 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 { formatUsageStatus } from '../repl.js';
+import { createDefaultClient } from '../llm-factory.js';
+import { resolveSandboxRunnerFromEnv } from '../sandbox/env-gate.js';
+import { staticToolPolicy } from '../policy/static-rules.js';
+export async function runPrintMode(options) {
+    // Sprint 1b.5 Step 2.5: print mode 跟 startRepl 一样, 用 createDefaultClient 让 provider
+    // 走 env 推断 + 显式 provider 优先 (C3 拍板). 不再写死 DeepSeekClient.
+    const client = options.client ??
+        createDefaultClient({
+            ...(options.provider !== undefined ? { provider: options.provider } : {}),
+            ...(options.model !== undefined ? { model: options.model } : {}),
+        });
+    // Sprint 1c-revive-2-D-6 (review P2 修复, 2026-06-04): 拿掉 anthropic × tool loop
+    // 温柔降级 (跟 startRepl 同拍板, 见 repl.ts). D-4 已实装 AnthropicClient tool
+    // schema 转换, --provider anthropic 选了就该跑 tool loop.
+    const enableToolLoop = options.enableToolLoop ?? true;
+    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.
+    // 解析成功则把 runner 显式注入 registry, 跟 BashTool 对齐.
+    const sandboxRunner = resolveSandboxRunnerFromEnv({ sandboxRoot: process.cwd() });
+    // Sprint 1c-revive-3-D-13 (2026-06-05): print mode 拍板 isInteractive=false
+    // (非交互, 无用户确认). default policy = staticToolPolicy. --yes 透传 bypass
+    // require_confirmation, 不 bypass deny.
+    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) {
+            process.stderr.write(`warning: could not load session: ${String(e)}\n`);
+        }
+    }
+    // Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): compaction 集成.
+    // 传 options.compactionConfig + writer 存在 → 注入完整 AgentCompactionConfig.
+    let compactionConfig = null;
+    if (options.compactionConfig && writer) {
+        compactionConfig = {
+            ...options.compactionConfig,
+            writer,
+            state: new CompactionState(options.compactionConfig.pauseAfterFailures ?? 2),
+        };
+    }
+    else if (options.compactionConfig && !writer) {
+        process.stderr.write('warning: compactionConfig requires sessionPath; falling back to baseline (no compaction).\n');
+    }
+    try {
+        // 持久化 user 输入
+        if (writer) {
+            const userEvent = { kind: 'user', ts: Date.now(), content: options.prompt };
+            await writer.append(userEvent);
+        }
+        // 构造 turn 消息:历史 + 本轮 user。Sprint 1a 修 P1 — user 必须进 LLM。
+        const turnMessages = [
+            ...workingMessages,
+            { role: 'user', content: options.prompt },
+        ];
+        // 调 LLM。两种模式分支:
+        //   - enableToolLoop=true (默认): 走 runToolLoop (有 compactionConfig 时走
+        //     runToolLoopWithCompaction, Sprint 1c-revive-2-D-6 拍板), 创 registry
+        //   - enableToolLoop=false (--no-tool-loop): 走 client.stream 直发,
+        //     tools 字段不传, 强制 LLM 服务端 schema 里不出现 tool, 不会产生 tool_calls
+        const summaryFn = compactionConfig
+            ? makeLlmSummarizeFn(client, compactionConfig.protocol)
+            : null;
+        let result;
+        try {
+            if (enableToolLoop) {
+                if (compactionConfig !== null && summaryFn !== null) {
+                    result = await runToolLoopWithCompaction(client, turnMessages, {
+                        registry: createDefaultRegistry({ sandboxRunner }),
+                        onChunk: (chunk) => {
+                            if (chunk.content)
+                                process.stdout.write(chunk.content);
+                        },
+                        ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+                        policy: staticToolPolicy,
+                        isInteractive: false, // print mode = 非交互 (D-13 拍板)
+                        yes: policyYes,
+                        ...(writer ? { writer } : {}),
+                    }, compactionConfig, summaryFn);
+                }
+                else {
+                    result = await runToolLoop(client, turnMessages, {
+                        registry: createDefaultRegistry({ sandboxRunner }),
+                        onChunk: (chunk) => {
+                            if (chunk.content)
+                                process.stdout.write(chunk.content);
+                        },
+                        ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+                        policy: staticToolPolicy,
+                        isInteractive: false, // print mode = 非交互 (D-13 拍板)
+                        yes: policyYes,
+                        ...(writer ? { writer } : {}),
+                    });
+                }
+                printStepSummary(result.steps);
+            }
+            else {
+                // --no-tool-loop: 真关闭 tool calling。流式 + tools=undefined,
+                // 让 LLM 服务端只回 content, 不返回 tool_calls 字段。
+                // stream() 内部已累加好 final.content, 这里只负责把增量实写到 stdout。
+                // 注意: client.stream 的 onChunk 接 ChatChunk, content 在 delta.content 上
+                // (与 runToolLoop 的 onChunk 签名不同, 后者直接 .content)。
+                const streamResult = await client.stream(turnMessages, {
+                    onChunk: (chunk) => {
+                        if (chunk.delta.content)
+                            process.stdout.write(chunk.delta.content);
+                    },
+                });
+                // 包装成 ToolLoopResult 形态,让 caller 持久化逻辑无感
+                result = {
+                    messages: [...turnMessages, { role: 'assistant', content: streamResult.content }],
+                    final: streamResult,
+                    steps: [
+                        {
+                            kind: 'assistant',
+                            ts: Date.now(),
+                            message: { role: 'assistant', content: streamResult.content },
+                            result: streamResult,
+                        },
+                    ],
+                };
+            }
+        }
+        catch (e) {
+            if (isToolLoopError(e)) {
+                process.stderr.write(`\nerror: tool loop hit max steps (${e.steps})\n`);
+            }
+            else if (e instanceof APIKeyMissingError) {
+                // Sprint 1c-revive-4-D-20.1 (2026-06-05) review-fix: print mode 缺 key
+                // 给 setup hint + 退出码 2 (跟参数错一致), 跟 CLI main().catch 拍板一致.
+                process.stderr.write('Error: API key not set. deepwhale needs DEEPSEEK_API_KEY (or ANTHROPIC_AUTH_TOKEN),\n' +
+                    '       or pass --provider. See --help for full setup.\n' +
+                    '       Hint: --verify runs build/lint/typecheck/test and does NOT need a key.\n' +
+                    `       Underlying: ${e.message}\n`);
+                return 2;
+            }
+            else {
+                process.stderr.write(`\nerror: ${e instanceof Error ? e.message : String(e)}\n`);
+            }
+            return 1;
+        }
+        // 持久化 steps
+        if (writer) {
+            try {
+                await persistToolLoopSteps(writer, result.steps);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        // Sprint 1b: 退出后打一行 cache / cost summary 到 stderr (不污染 stdout)
+        // 跟 REPL 状态栏用同一个 formatUsageStatus, 风格统一
+        const usageLine = formatUsageStatus(result.final.usage);
+        if (usageLine !== null) {
+            process.stderr.write(`  ${usageLine}\n`);
+        }
+        return 0;
+    }
+    finally {
+        if (writer) {
+            try {
+                await writer.close();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+}
+function printStepSummary(steps) {
+    for (const step of steps) {
+        if (step.kind === 'tool') {
+            const status = step.result.success ? '✓' : '✗';
+            process.stdout.write(`  ${status} ${step.tool_call.name} (${step.duration_ms}ms)\n`);
+        }
+    }
+}
+/**
+ * 生成 LLM summary callback (Sprint 1c-revive-2-D-6).
+ *
+ * 跟 1c-revive-2-D-5 cluster test (compaction-cross-protocol-2d5.test.ts:231)
+ * + startRepl 同形态 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=print.js.map

package/dist/modes/print.js.map

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

package/dist/modes/rpc.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 { type LLMClient } from '@deepwhale/llm';
+import { type AgentCompactionConfig } from '../agent/index.js';
+import { type Provider } from '../llm-factory.js';
+export interface RpcModeOptions {
+    sessionPath?: string;
+    maxSteps?: number;
+    /** 注入 LLM 客户端（默认 createDefaultClient env 推断, Sprint 1c-revive-2-D-5+ P2）。 */
+    client?: LLMClient;
+    /** Sprint 1c-revive-2-D-5+ P2: 显式 provider, 跟 env 推断冲突时优先. */
+    provider?: Provider;
+    /** Sprint 1c-revive-2-D-5+ P2: 显式 model. */
+    model?: string;
+    /** 注入输入流（默认 process.stdin）。Sprint 1a follow-up:单测用。 */
+    input?: NodeJS.ReadableStream;
+    /**
+     * 注入 signal handler 监听哪个信号（默认监听 SIGINT + SIGTERM）。
+     * Sprint 1a follow-up #3: 单测用 — 避免重复监听真实 OS signal 污染 vitest 全局。
+     * 设成 `[]` 跳过 signal handler 注册, 仅靠 stdin close 退出。
+     */
+    watchSignals?: ReadonlyArray<NodeJS.Signals>;
+    /**
+     * Session compaction 集成 (Sprint 1c-revive-2-D-6, review P1 修复 2026-06-04).
+     * 不传 = baseline. 传 = runToolLoopWithCompaction 跨 chat request 持久化
+     * (CompactionState 闭包持有, writer 复用 sessionPath writer).
+     */
+    compactionConfig?: Omit<AgentCompactionConfig, 'writer' | 'state'> | null;
+    /**
+     * Sprint 1c-revive-3-D-13 (2026-06-05): --yes 标志. rpc 拍板 isInteractive=false.
+     */
+    yes?: boolean;
+}
+export declare function runRpcMode(options: RpcModeOptions): Promise<number>;
+//# sourceMappingURL=rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/modes/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAML,KAAK,qBAAqB,EAE3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKvE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1E;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAuBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyKzE"}