@deepwhale/coding-agent 1.0.10 → 1.0.12

package/dist/repl.d.ts

@@ -1,154 +0,0 @@
-/**
- * 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, type Usage } 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 { 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>;
-/**
- * Sprint 1b: 把 usage 翻译成人类可读的一行 status, 写到 stderr (不污染 stdout 流式输出)。
- *
- * 显示规则 (Hermes footer 教训应用 — 多字段同值时去冗余):
- * - 满 usage (有 cached_tokens) → 完整 4 字段: cache: 90% | ¥0.05/turn | prompt 1.2k (1.1k cached)
- * - 无 cached_tokens → 简化为: usage: 1.2k prompt / 200 completion
- *   (不打 cache% / cost, 避免没数据时显示 0% 误导)
- * - 无 usage → 完全不打印 (LLM 没返 usage 时不污染 stderr)
- *
- * Sprint 1c 抽 pricing 到 config.toml, 此函数签名不变。
- *
- * Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 cache 96%↔85% 跳变 footer 焦虑):
- * 增 emaState 形参. 形参 hitRateEMA 是过去 5-turn 滚动平均 (α=0.5 平滑).
- * 输出: `cache: 90% (avg 85%)` — per-turn 数字 + 趋势均值并列. user 视角:
- * 1) 知道当 turn 真值, 2) 知道趋势 (avg 不会跟着单 turn 抖动).
- * 边界:
- *   - sampleCount < 3: 不显示 (avg) 段 (样本太少, 趋势没意义, 不污染)
- *   - sampleCount >= 3: 显示 (avg NN%)
- *   - ema 永远存在 (闭包外, startRepl 持有), 跨 turn 累积
- * 行为兼容: 旧 caller 不传 emaState 用默认 { hitRateEMA: undefined, sampleCount: 0 }
- * → 行为跟改前一致 (不显示 avg 段). 现有单测 (formatUsageStatus) 不破.
- */
-export interface UsageEmaState {
-    hitRateEMA?: number;
-    sampleCount: number;
-}
-export declare function formatUsageStatus(usage: Usage | undefined, emaState?: UsageEmaState): string | null;
-/**
- * Sprint 1c-revive-2-D-21.1 (2026-06-06): emaState 接受 mutable 引用 (闭包),
- * 在 sampleCount < 5 用 cold-start EMA (直接赋值), 之后 α=0.5 平滑:
- *   newEMA = α * current + (1 - α) * oldEMA = 0.5 * current + 0.5 * oldEMA
- * α=0.5 是 "等权平滑" (5-turn 半衰期 ≈ 1 turn, 快速响应 + 适度平滑).
- * 数学: sampleCount=5 时, 5 turn 前的数据权重 = 0.5^5 = 3.1% (基本忘掉),
- * 跟 5-turn rolling window 趋势一致, 但 EMA 实现更轻.
- *
- * export 出来供单测 (test/unit/usage-ema.test.ts) 验证 state machine.
- * 之前是 local function, D-21.1 改成 export — 单测需要直接调它验 in-place update.
- */
-export declare function appendUsageStatus(usage: Usage | undefined, err: NodeJS.WritableStream, emaState: UsageEmaState): void;
-//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

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