@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/repl.d.ts

@@ -0,0 +1,117 @@
+/**
+ * deepwhale REPL — Sprint 1a 接入 tool loop + session
+ *
+ * Sprint 0.3 范围：单轮 chat + 内建命令。
+ * Sprint 1a 扩展：
+ *   - 接 Session JSONL：启动时 load(可选路径)，退出时 close(flush)
+ *   - 接 runToolLoop：每轮 user → tool loop → 持久化 steps
+ *   - 流式：onChunk 实时打印 final.content（assistant 增量）
+ *   - 命令：保留 /help / /exit / exit / quit
+ *
+ * Sprint 1a 简化：
+ *   - 不做 plan mode、recovery、自动压缩
+ *   - 不做 multi-session 切换
+ *   - 错误用 i18n + 不污染 messages
+ *
+ * 文件职责：
+ *   - runOneTurn: 仍保留为低层单轮 API（不持久化，无 tool loop）
+ *   - startRepl: 接 tool loop + session 的入口
+ */
+import { SessionWriter } from '@deepwhale/core';
+import { ChatMessage, LLMClient } from '@deepwhale/llm';
+import { type AgentCompactionConfig } from './agent/index.js';
+import { type Provider } from './llm-factory.js';
+export { createReplConfirm } from './repl/repl-confirm.js';
+import { type UsageEmaState } from './repl/repl-session.js';
+export { formatUsageStatus, appendUsageStatus, type UsageEmaState } from './repl/repl-session.js';
+import type { ToolPolicy } from './policy/types.js';
+import type { SandboxRunner } from './sandbox/types.js';
+export interface ReplOptions {
+    /** 注入 LLM 客户端（默认 createDefaultClient env 推断, Sprint 1b.5 Step 2 C3 拍板）。单测用。 */
+    client?: LLMClient;
+    /**
+     * Sprint 1c-revive-3-D-13 (2026-06-05): --yes 标志.
+     * yes=true bypass require_confirmation (write_file / edit_file / 危险 bash),
+     * 不 bypass deny. 拍板: REPL = 交互模式 (isInteractive=true), policy=staticToolPolicy.
+     */
+    yes?: boolean;
+    /**
+     * Sprint 1b.5 Step 2 (2.5 拍板, C3 拍板 2026-06-03): 显式 provider. 跟 env 推断冲突时优先.
+     * 跟 options.client 互斥 — 传 client 时 provider 忽略 (单测路径).
+     */
+    provider?: Provider;
+    /** Sprint 1b.5 Step 2: 显式 model. 不传则用 provider 默认 (deepseek → deepseek-v4-flash, anthropic → claude-sonnet-4-5). */
+    model?: string;
+    /** 注入输入流（默认 stdin）。单测用。 */
+    input?: NodeJS.ReadableStream;
+    /** 注入输出流（默认 stdout）。单测用。 */
+    output?: NodeJS.WritableStream;
+    /** 注入错误流（默认 stderr）。单测用。 */
+    errorOutput?: NodeJS.WritableStream;
+    /** 注入退出函数（默认 process.exit）。单测用。 */
+    exit?: (code?: number) => never;
+    /**
+     * Session JSONL 路径。提供则启动时 load + 退出时 append + close。
+     * 不提供则不持久化（Sprint 0.3 行为）。
+     */
+    sessionPath?: string;
+    /** 是否启用 tool loop（默认 true）。false = 退化为 Sprint 0.3 单轮 chat。 */
+    enableToolLoop?: boolean;
+    /**
+     * Session compaction 集成 (Sprint 1c-revive-2-D-6, review P1 修复 2026-06-04).
+     *
+     * 传 = 走 runToolLoopWithCompaction, turn 入口测 token 触发则 compact + 写
+     * 'compaction' event 到 SessionWriter. 不传 = 走裸 runToolLoop (向后兼容,
+     * 现有 baseline 244 测试不变).
+     *
+     * 拍板: 提供 AgentCompactionConfig 即可, CompactionState 内部持有 (startRepl
+     * 闭包). writer 字段 REPL 自动注入 (跟 startRepl 内部 sessionPath writer
+     * 同 instance, 让 compaction 事件写到同一 JSONL).
+     *
+     * 拍板 contextWindow=0 = 关闭 (跟 core compact() 行为契约一致). 默认
+     * (不传此参数) = 不接 compaction.
+     */
+    compactionConfig?: Omit<AgentCompactionConfig, 'writer' | 'state'> | null;
+    /**
+     * Sprint 1c-revive-2-D-11-4 (2026-06-04): verify 自定义 check.
+     * 不传 = 走 runVerify() 默认 4 步 (corepack pnpm build/lint/typecheck/test).
+     * 单测用: 传 4 个简单 pass check, 避免 30-60s 真跑 build.
+     */
+    verifyChecks?: import('./verify/index.js').VerifyCheck[];
+}
+/**
+ * 单轮 chat 工具函数：把 user 输入 → LLM chat → 输出 assistant 文本。
+ * 不修改 messages；不调工具；不持久化。
+ *
+ * Sprint 1a 保留作为低层 API。Sprint 1a 之后 REPL 入口推荐用 startRepl +
+ * enableToolLoop=true 走完整 agent loop。
+ */
+export declare function runOneTurn(client: LLMClient, line: string, messages: ChatMessage[], options?: {
+    signal?: AbortSignal;
+}): Promise<{
+    kind: 'chat';
+    assistant: string;
+} | {
+    kind: 'error';
+    error: string;
+} | {
+    kind: 'empty';
+}>;
+/**
+ * 启动 REPL。返回 Promise，resolve 时为退出码。
+ */
+export declare function startRepl(options?: ReplOptions): Promise<number>;
+/**
+ * 跑一轮 agent turn:append user → runToolLoop → 持久化 → 打印 final content。
+ *
+ * workingMessages 由 caller 持有（startRepl 闭包），turn 跑完后 caller 用新 messages 覆盖。
+ *
+ * Sprint 1a 修 P1:user 必须进 LLM。Sprint 1a 修 P2-A:流式不再重复打印 final content。
+ * Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): 可选 compactionConfig — 传
+ * 时调 runToolLoopWithCompaction (入口测 token, 触发则 compact + 写 event),
+ * 不传 = 走裸 runToolLoop (向后兼容, 单测 baseline 244 不变). summaryFn 内部
+ * 用 client + 固定 prompt 模板生成, 跟 test 1c-revive-2-D-5 cluster 拍板一致.
+ * 单测通过 export 暴露,直接注入 mock LLMClient + WritableStream 验证行为。
+ */
+export declare function runAgentTurn(client: LLMClient, userInput: string, workingMessages: ChatMessage[], writer: SessionWriter | null, out: NodeJS.WritableStream, err: NodeJS.WritableStream, signal: AbortSignal, compactionConfig?: AgentCompactionConfig | null, sandboxRunner?: SandboxRunner, yes?: boolean, policy?: ToolPolicy, emaState?: UsageEmaState): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAiB,aAAa,EAAqB,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAEL,WAAW,EAGX,SAAS,EAMV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAOL,KAAK,qBAAqB,EAG3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAItE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oHAAoH;IACpH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,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,mCAAmC;IACnC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1E;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,mBAAmB,EAAE,WAAW,EAAE,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACrC,OAAO,CACR;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAC3F,CAcA;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmX1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,WAAW,EAAE,EAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,MAAM,EAAE,WAAW,EACnB,gBAAgB,GAAE,qBAAqB,GAAG,IAAW,EAGrD,aAAa,CAAC,EAAE,aAAa,EAE7B,GAAG,CAAC,EAAE,OAAO,EAGb,MAAM,CAAC,EAAE,UAAU,EAInB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC,CAoHf"}