webaiapi 0.0.0-stage → 0.1.0

package/dist/tools/parse.js

@@ -0,0 +1,273 @@
+/**
+ * 从 AI 文本里解析工具调用 —— `legacy-python/src/utils/tool_calls.py` 的 `parse_tool_calls_from_text`。
+ *
+ * 一共 7 层 Pattern，一层比一层宽容（都是被真实输出逼出来的）：
+ * 1. `<tool_call>{...}</tool_call>`（我们注入的标准格式）
+ * 2. `<tool_call name="X">{...}</tool_call`（模型把名字写成 XML 属性）
+ * 3. `{"name":"X","arguments":{...}}</tool_call`（名字在 JSON 里，闭合标签残缺）
+ * 4. `tool_call>{...}</tool_call`（少了开头的 `<`）
+ * 5. `tool_call>{...}`（完全没有闭合标签）
+ * 6. 标签全碎：直接在正文里扫 `{"name": ...}` 并 raw_decode
+ * 7. 超级兜底：`<tool_call>` 被当 HTML 消费、内部 JSON 被渲染破坏 → 先修复再扫
+ *
+ * 返回值与原实现的 Tuple 不同：改为 `{ text, toolCalls }` 对象，避免调用方解构时写错顺序。
+ */
+import { logger } from '../log/logger.js';
+import { buildToolCall } from './build.js';
+import { normalizeToolCallTags, stripLeftoverToolTags } from './clean.js';
+import { EMPTY_TOOL_MAPS } from './names.js';
+import { BROKEN_TAG_INDICATOR, DOM_CORRUPTION_INDICATOR, DOM_PREVIEW_KEY_INDICATOR, hasSmartQuotes, repairDomCorruptedJson, tryParseJson, } from './repair.js';
+/**
+ * Pattern 1：`<tool_call>{...}</tool_call>`（全局版，DOTALL）
+ *
+ * ⚠️ 结尾必须带 `>`。Python 原版是 `re.escape("</tool_call>")`，
+ * 漏掉 `>` 会导致删除工具调用块后正文里残留一个孤立的 `>`。
+ */
+const P1_TOOL_CALL_PATTERN = /<tool_call>\s*(.*?)\s*<\/tool_call>/gsu;
+/** Pattern 2：`<tool_call name="X">{...}</tool_call` */
+const XML_TOOL_CALL_PATTERN = /<tool_call\s+name\s*=\s*["']([^"']+)["']\s*>(.*?)<\/tool_call/gsu;
+/** Pattern 3：`{...}</tool_call`（名字在 JSON 内部） */
+const JSON_TOOL_CALL_PATTERN = /(\{.*?\})\s*<\/tool_call/gsu;
+/** Pattern 4：宽容版，`tool_call>` 前没有 `<` */
+const LENIENT_TOOL_PATTERN = /tool_call>\s*(.*?)\s*<\/tool_call/gsu;
+/** Pattern 5：极宽容，`tool_call>` + JSON 且**完全没有闭合标签** */
+const NO_CLOSE_TOOL_PATTERN = /<?>?tool_call>\s*(\{)/gsu;
+/** 扫描 `{"name": ...}` 起点用的正则（Pattern 6/7）。 */
+const JSON_NAME_START = /\{\s*"name"\s*:\s*"/gu;
+/**
+ * 等价于 Python `json.JSONDecoder().raw_decode(text, pos)`。
+ *
+ * 从 `text[pos]` 开始解析**第一个完整的 JSON 值**，返回其结束位置（**绝对下标**）。
+ * Python 的 `raw_decode` 允许后面还有别的内容，JS 的 `JSON.parse` 不允许，
+ * 所以这里自己扫括号配平（正确处理字符串与转义），再对切片做 `JSON.parse`。
+ *
+ * @param pos 起始下标；ChatGLM 的 SSE 报文会把多个 JSON 直接拼在一行，
+ *   需要从任意位置连续往后扫（`pos` 让调用方免于反复 `slice`，避免 O(n²)）。
+ */
+export function rawDecodeJson(text, pos = 0) {
+    let i = pos;
+    while (i < text.length && /\s/.test(text[i]))
+        i += 1;
+    const first = text[i];
+    if (first !== '{' && first !== '[')
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let j = i; j < text.length; j += 1) {
+        const ch = text[j];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            continue;
+        }
+        if (ch === '{' || ch === '[') {
+            depth += 1;
+            continue;
+        }
+        if (ch === '}' || ch === ']') {
+            depth -= 1;
+            if (depth === 0) {
+                try {
+                    return { value: JSON.parse(text.slice(i, j + 1)), end: j + 1 };
+                }
+                catch {
+                    return undefined;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function spansOverlap(start, end, spans) {
+    return spans.some(([s, e]) => start < e && end > s);
+}
+/**
+ * 从 AI 回复文本中解析工具调用。
+ *
+ * @param text AI 完整回复
+ * @param maps 本请求的工具映射表（决定了标准名会映射到哪个客户端真实工具名）
+ */
+export function parseToolCallsFromText(text, maps = EMPTY_TOOL_MAPS) {
+    // === 预处理：修复 DOM 提取导致的标签破碎 ===
+    const normalized = normalizeToolCallTags(text);
+    const toolCalls = [];
+    const removalSpans = [];
+    let repaired = '';
+    /** 统一的「从 JSON 对象构造调用」步骤，成功才登记待删除区间。 */
+    const tryAdd = (data, start, end) => {
+        if (!data)
+            return false;
+        const tc = buildToolCall(data['name'], data['arguments'] ?? {}, maps);
+        if (!tc)
+            return false;
+        toolCalls.push(tc);
+        removalSpans.push([start, end]);
+        return true;
+    };
+    // --- Pattern 1 ---
+    for (const match of normalized.matchAll(P1_TOOL_CALL_PATTERN)) {
+        const raw = (match[1] ?? '').trim();
+        if (!raw)
+            continue;
+        // 有 DOM 损坏特征就跳过，交给 Pattern 7；否则 tryParseJson 的正则兜底会拿到短预览值
+        if (DOM_PREVIEW_KEY_INDICATOR.test(raw) ||
+            DOM_CORRUPTION_INDICATOR.test(raw) ||
+            hasSmartQuotes(raw)) {
+            continue;
+        }
+        const start = match.index ?? 0;
+        tryAdd(tryParseJson(raw), start, start + match[0].length);
+    }
+    // --- Pattern 2 ---
+    for (const match of normalized.matchAll(new RegExp(XML_TOOL_CALL_PATTERN.source, 'gsu'))) {
+        const start = match.index ?? 0;
+        const end = start + match[0].length;
+        if (spansOverlap(start, end, removalSpans))
+            continue;
+        const name = (match[1] ?? '').trim();
+        const rawArgs = (match[2] ?? '').trim();
+        const parsed = rawArgs ? tryParseJson(rawArgs) : undefined;
+        const args = parsed && typeof parsed === 'object' ? parsed : {};
+        const tc = buildToolCall(name, args, maps);
+        if (tc) {
+            toolCalls.push(tc);
+            removalSpans.push([start, end]);
+        }
+    }
+    // --- Pattern 4 ---
+    // ⚠️ 与原设计不同处：这里**先跑 Pattern 4 再跑 Pattern 3**。
+    //    Pattern 4 的匹配区间包含开头的 `tool_call>`，区间更大，
+    //    先注册它就能把整段（含破碎标签）一次删干净；
+    //    若按 Python 的顺序先跑 Pattern 3（只从 `{` 开始），
+    //    残留的 `tool_call>` 会被 stripLeftoverToolTags 清掉、但最后会多留一个 `>` 在正文里。
+    for (const match of normalized.matchAll(new RegExp(LENIENT_TOOL_PATTERN.source, 'gsu'))) {
+        const start = match.index ?? 0;
+        const end = start + match[0].length;
+        if (spansOverlap(start, end, removalSpans))
+            continue;
+        const raw = (match[1] ?? '').trim();
+        if (!raw)
+            continue;
+        const data = tryParseJson(raw);
+        if (!data)
+            continue;
+        tryAdd(data, start, end);
+    }
+    // --- Pattern 3 ---
+    for (const match of normalized.matchAll(new RegExp(JSON_TOOL_CALL_PATTERN.source, 'gsu'))) {
+        const start = match.index ?? 0;
+        const end = start + match[0].length;
+        if (spansOverlap(start, end, removalSpans))
+            continue;
+        const raw = (match[1] ?? '').trim();
+        if (!raw)
+            continue;
+        const data = tryParseJson(raw);
+        if (!data)
+            continue;
+        tryAdd(data, start, end);
+    }
+    // --- Pattern 5 ---
+    for (const match of normalized.matchAll(new RegExp(NO_CLOSE_TOOL_PATTERN.source, 'gsu'))) {
+        const start = match.index ?? 0;
+        const end = start + match[0].length;
+        if (spansOverlap(start, end, removalSpans))
+            continue;
+        const jsonStart = start + match[0].length - 1; // 指向 "{"
+        const decoded = rawDecodeJson(normalized.slice(jsonStart));
+        if (!decoded)
+            continue;
+        const data = decoded.value;
+        if (!data || typeof data !== 'object')
+            continue;
+        const tc = buildToolCall(data['name'], data['arguments'] ?? {}, maps);
+        if (tc) {
+            toolCalls.push(tc);
+            removalSpans.push([start, jsonStart + decoded.end]);
+        }
+    }
+    // --- Pattern 6：标签全碎时从正文里扫 JSON ---
+    if (toolCalls.length === 0 && BROKEN_TAG_INDICATOR.test(normalized)) {
+        logger.info('[tool_calls] 标签破碎但未提取到工具调用，启用 Pattern 6 兜底扫描');
+        scanStandaloneJson(normalized, toolCalls, removalSpans, maps);
+    }
+    // --- Pattern 7：修复被 DOM 破坏的 JSON 后再扫 ---
+    if (toolCalls.length === 0 &&
+        (BROKEN_TAG_INDICATOR.test(normalized) ||
+            DOM_CORRUPTION_INDICATOR.test(normalized) ||
+            DOM_PREVIEW_KEY_INDICATOR.test(normalized))) {
+        repaired = repairDomCorruptedJson(normalized);
+        if (repaired && repaired !== normalized) {
+            logger.info({ from: normalized.length, to: repaired.length }, '[tool_calls] Pattern 7 DOM 损坏修复');
+            const before = toolCalls.length;
+            scanStandaloneJson(repaired, toolCalls, removalSpans, maps);
+            for (const tc of toolCalls.slice(before)) {
+                const name = tc.function.name;
+                let argKeys = [];
+                try {
+                    const parsed = JSON.parse(tc.function.arguments);
+                    if (parsed && typeof parsed === 'object')
+                        argKeys = Object.keys(parsed);
+                }
+                catch {
+                    // 忽略：只为日志
+                }
+                logger.info({ name, argKeys }, '[tool_calls] Pattern 7 修复后提取');
+                if (name === 'SearchReplace') {
+                    try {
+                        const parsed = JSON.parse(tc.function.arguments);
+                        logger.info({
+                            filePath: parsed['file_path'],
+                            oldStrLen: String(parsed['old_str'] ?? '').length,
+                            newStrLen: String(parsed['new_str'] ?? '').length,
+                        }, '[tool_calls] SearchReplace 参数');
+                    }
+                    catch {
+                        // 忽略
+                    }
+                }
+            }
+        }
+    }
+    // === 移除所有命中的区间（从后往前，避免位置失效） ===
+    let remaining = toolCalls.length > 0 && repaired && repaired !== normalized ? repaired : normalized;
+    for (const [start, end] of [...removalSpans].sort((a, b) => b[0] - a[0])) {
+        remaining = remaining.slice(0, start) + remaining.slice(end);
+    }
+    return { text: stripLeftoverToolTags(remaining).trim(), toolCalls };
+}
+/**
+ * 扫描形如 `{"name": "...", "arguments": {...}}` 的独立 JSON 对象。
+ * Pattern 6 / Pattern 7 共用。
+ */
+function scanStandaloneJson(source, toolCalls, removalSpans, maps) {
+    for (const match of source.matchAll(new RegExp(JSON_NAME_START.source, 'gu'))) {
+        const jsonStart = match.index ?? 0;
+        if (spansOverlap(jsonStart, jsonStart + match[0].length, removalSpans))
+            continue;
+        const decoded = rawDecodeJson(source.slice(jsonStart));
+        if (!decoded)
+            continue;
+        const data = decoded.value;
+        if (!data || typeof data !== 'object')
+            continue;
+        if (!('name' in data) || !('arguments' in data))
+            continue;
+        const tc = buildToolCall(data['name'], data['arguments'], maps);
+        if (tc) {
+            toolCalls.push(tc);
+            removalSpans.push([jsonStart, jsonStart + decoded.end]);
+            logger.info({ name: data['name'] }, '[tool_calls] 独立 JSON 兜底提取');
+        }
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/tools/parse.js.map

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

package/dist/tools/placeholder.d.ts

@@ -0,0 +1,21 @@
+import type { ToolCallPayload } from '../types/message.js';
+/** 占位符「整值」集合：仅当参数值**整体等于**其中之一时才判定为占位符。 */
+export declare const PLACEHOLDER_VALUES: ReadonlyArray<string>;
+/** 只有这些「路径类」字段才做占位符判定。 */
+export declare const PLACEHOLDER_PATH_KEYS: ReadonlyArray<string>;
+/** 占位符工具名。 */
+export declare const PLACEHOLDER_TOOL_NAMES: ReadonlySet<string>;
+/**
+ * 判断工具调用是否为「示例占位符」而非真实调用。
+ *
+ * 两种情况都应丢弃：
+ * 1. **工具名本身是占位符**（如 `工具名称`），或含未填充的尖括号
+ * 2. **参数值是占位符**（如 `真实文件路径` / `文件内容`）
+ */
+export declare function isPlaceholderToolCall(toolCall: ToolCallPayload): boolean;
+/** 过滤掉占位符工具调用，返回 `[有效, 被丢弃]`。 */
+export declare function filterPlaceholderToolCalls(toolCalls: ReadonlyArray<ToolCallPayload> | null | undefined): {
+    valid: ToolCallPayload[];
+    dropped: ToolCallPayload[];
+};
+//# sourceMappingURL=placeholder.d.ts.map

package/dist/tools/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../src/tools/placeholder.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAcpD,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAMvD,CAAC;AAEF,cAAc;AACd,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAWrD,CAAC;AAsBH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAkCxE;AAED,iCAAiC;AACjC,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,GAC3D;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,CAsB1D"}

package/dist/tools/placeholder.js

@@ -0,0 +1,135 @@
+/**
+ * 占位符工具调用过滤 —— `legacy-python/src/utils/tool_calls.py` 的一部分。
+ *
+ * AI 有时会把提示词里的**格式示例**原样抄出来：
+ * `{"name": "工具名称", "arguments": {"参数1": "值1"}}`，
+ * IDE 会去执行一个不存在的工具并报错，必须在返回前拦截。
+ *
+ * ⚠️ **判定必须从严**：只认「整值就是占位符」，**绝不做子串包含判断**。
+ * 真实文件内容里出现「新代码」「文件内容」等词完全正常，
+ * 子串判断会把合法的 `write_to_file` 误杀（曾导致工具调用被整体丢弃，
+ * 客户端只收到纯文本而不再继续执行工具）。
+ */
+import { logger } from '../log/logger.js';
+/** 占位符「整值」集合：仅当参数值**整体等于**其中之一时才判定为占位符。 */
+export const PLACEHOLDER_VALUES = [
+    '真实文件路径',
+    '文件内容',
+    '要替换的代码',
+    '新代码',
+    'your_file_path',
+    'your_file',
+    'path/to/file',
+    'path/to/your/file',
+    'example.com/path',
+    '参数1',
+    '参数2',
+    '值1',
+    '值2',
+];
+/** 只有这些「路径类」字段才做占位符判定。 */
+export const PLACEHOLDER_PATH_KEYS = [
+    'file_path',
+    'filepath',
+    'path',
+    'filename',
+    'file',
+];
+/** 占位符工具名。 */
+export const PLACEHOLDER_TOOL_NAMES = new Set([
+    '工具名称',
+    '工具名',
+    '工具',
+    '参数1',
+    '<工具名>',
+    'tool_name',
+    'toolname',
+    'your_tool',
+    'tool',
+    'function_name',
+]);
+/** 纯尖括号模板，如 `<file_path>` / `<此处填写真实文件路径>`。 */
+const ANGLE_PLACEHOLDER = /^<[^<>]{1,50}>$/;
+function parseArguments(raw) {
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+                ? parsed
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return undefined;
+}
+/**
+ * 判断工具调用是否为「示例占位符」而非真实调用。
+ *
+ * 两种情况都应丢弃：
+ * 1. **工具名本身是占位符**（如 `工具名称`），或含未填充的尖括号
+ * 2. **参数值是占位符**（如 `真实文件路径` / `文件内容`）
+ */
+export function isPlaceholderToolCall(toolCall) {
+    let name = '';
+    let rawArgs = '{}';
+    try {
+        name = String(toolCall?.function?.name ?? '');
+        rawArgs = toolCall?.function?.arguments ?? '{}';
+    }
+    catch {
+        return false;
+    }
+    const nameStripped = name.trim();
+    if (PLACEHOLDER_TOOL_NAMES.has(nameStripped))
+        return true;
+    if (nameStripped.includes('<') || nameStripped.includes('>'))
+        return true;
+    const args = parseArguments(rawArgs);
+    if (!args)
+        return false; // 解析不了就不判定，宁可放过
+    for (const [key, val] of Object.entries(args)) {
+        if (typeof val !== 'string')
+            continue;
+        const v = val.trim();
+        if (!v)
+            continue;
+        // 纯尖括号模板
+        if (v.length <= 60 && ANGLE_PLACEHOLDER.test(v))
+            return true;
+        // 路径类字段：整值等于示例词，或明显是示例路径
+        if (PLACEHOLDER_PATH_KEYS.includes(key.toLowerCase())) {
+            if (PLACEHOLDER_VALUES.includes(v))
+                return true;
+            if (v.startsWith('your_file') || v.startsWith('example.com'))
+                return true;
+        }
+    }
+    return false;
+}
+/** 过滤掉占位符工具调用，返回 `[有效, 被丢弃]`。 */
+export function filterPlaceholderToolCalls(toolCalls) {
+    const valid = [];
+    const dropped = [];
+    for (const tc of toolCalls ?? []) {
+        if (isPlaceholderToolCall(tc))
+            dropped.push(tc);
+        else
+            valid.push(tc);
+    }
+    if (dropped.length > 0) {
+        const detail = dropped.map((tc) => {
+            let args = tc.function?.arguments ?? '';
+            if (typeof args === 'string' && args.length > 200)
+                args = `${args.slice(0, 200)}...`;
+            return `${tc.function?.name}(${String(args)})`;
+        });
+        logger.warn({ count: dropped.length }, `[tool_calls] 丢弃 ${dropped.length} 个占位符工具调用（参数整值为示例文本）：${detail.join(' | ')}`);
+    }
+    return { valid, dropped };
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/tools/placeholder.js.map

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

package/dist/tools/prompts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 兜底轮的提示词 —— 原来是「两轮策略转换器」（`build_reparse_prompt`），
+ * 2026-10-14 与「自驱动续跑」「工具名纠正轮」合并成**唯一一层**动作恢复轮
+ * （见 `docs/native-parity.md`）。
+ *
+ * ⚠️ 关键踩坑（2026-09-2x）：工具名**必须取自客户端真实 tools**，绝不能硬编码
+ * `Write` / `SearchReplace` / `Read`。实测客户端只提供 `list_dir`/`read_file`/`search_content`
+ * 时，旧提示词却写着「工具名必须严格使用以下名称：read_file, Write, SearchReplace」，
+ * 转换器照着输出 → 客户端没有这些工具 → 被 `filterUnknownToolCalls` 全部丢弃，
+ * 表现为「转换成功但 IDE 不执行」。
+ */
+import type { ToolDefinition } from '../types/message.js';
+/** 恢复轮里回放「上一轮回复」的长度上限。 */
+export declare const RECOVERY_ANSWER_MAX_LEN = 4000;
+export interface BuildActionRecoveryPromptOptions {
+    /** 上一轮的回复/思考正文（可能为空 —— 整轮只输出了一段 `<tool_call>` 块）。 */
+    answer?: string;
+    /** 上一轮里「客户端没有这个工具」的调用名（空数组表示「压根没给出调用」）。 */
+    invalidNames?: ReadonlyArray<string>;
+    /** 上一轮这些调用的原文（`name(arguments)`），让模型看清自己原本想调什么。 */
+    invalidCalls?: ReadonlyArray<string>;
+    /** 「最近进展」文本（`formatRecentProgress()` 的产出）。 */
+    recentProgress?: string;
+    /** 当前工作目录；默认取 `process.cwd()`（对应 Python 的 `os.getcwd()`）。 */
+    currentWorkingDir?: string;
+}
+/**
+ * 构造**唯一一层**兜底的提示词：逼模型把「下一步」变成真实的工具调用。
+ *
+ * ## 为什么只有一层（2026-10-14 重构）
+ * 原来有**三套**独立兜底，最坏会串起来跑 2~3 轮额外对话（每轮实测 30~98s）：
+ * - 「两轮策略 reparse」：本轮没有任何工具调用 → 让模型把文字转成调用；
+ * - 「自驱动续跑」：回答像计划书（只说不做）→ 再驱动一轮；
+ * - 「工具名纠正轮」：调了客户端没有的工具（如平台自带的 `execute_sandbox_code`）→ 纠正。
+ * 三者的**触发条件互斥、提示词高度重叠**，合并成一个 directive 提示词即可，
+ * 且总成本封顶为**一轮**（见 `docs/native-parity.md` 的「取舍与代价」）。
+ *
+ * ⚠️ 与 `buildReparsePrompt` 同样的铁律：**工具名/参数名只能取自客户端真实 tools**，
+ * 绝不在提示词里硬编码任何工具名。
+ */
+export declare function buildActionRecoveryPrompt(tools: ReadonlyArray<ToolDefinition>, options?: BuildActionRecoveryPromptOptions): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/tools/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,0BAA0B;AAC1B,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,WAAW,gCAAgC;IAC/C,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CAyDR"}

package/dist/tools/prompts.js

@@ -0,0 +1,69 @@
+import { toolNameOf, toolParamNames } from '../types/message.js';
+import { TOOL_CALL_CLOSE, TOOL_CALL_OPEN } from './protocol.js';
+/* ==================================================================== */
+/* 动作恢复轮（**唯一一层兜底**）                                      */
+/* ==================================================================== */
+/** 恢复轮里回放「上一轮回复」的长度上限。 */
+export const RECOVERY_ANSWER_MAX_LEN = 4000;
+/**
+ * 构造**唯一一层**兜底的提示词：逼模型把「下一步」变成真实的工具调用。
+ *
+ * ## 为什么只有一层（2026-10-14 重构）
+ * 原来有**三套**独立兜底，最坏会串起来跑 2~3 轮额外对话（每轮实测 30~98s）：
+ * - 「两轮策略 reparse」：本轮没有任何工具调用 → 让模型把文字转成调用；
+ * - 「自驱动续跑」：回答像计划书（只说不做）→ 再驱动一轮；
+ * - 「工具名纠正轮」：调了客户端没有的工具（如平台自带的 `execute_sandbox_code`）→ 纠正。
+ * 三者的**触发条件互斥、提示词高度重叠**，合并成一个 directive 提示词即可，
+ * 且总成本封顶为**一轮**（见 `docs/native-parity.md` 的「取舍与代价」）。
+ *
+ * ⚠️ 与 `buildReparsePrompt` 同样的铁律：**工具名/参数名只能取自客户端真实 tools**，
+ * 绝不在提示词里硬编码任何工具名。
+ */
+export function buildActionRecoveryPrompt(tools, options = {}) {
+    const { answer = '', invalidNames = [], invalidCalls = [], recentProgress = '', currentWorkingDir = process.cwd(), } = options;
+    const names = [...new Set(invalidNames.map((n) => (n ?? '').trim()).filter(Boolean))];
+    const namesText = names.map((n) => `\`${n}\``).join(', ');
+    // 问题定性：调错名字 vs 压根没动手（两者的「必须做的事」是一样的）
+    const problem = names.length
+        ? `你调用了**本环境不存在的工具**：${namesText}。\n` +
+            '那些名字属于网页平台自带的工具（代码沙箱 / 联网搜索之类），本地客户端**没有提供**，' +
+            '调用无效 —— 那一轮什么都不会被执行。'
+        : '你上一轮**没有给出可执行的工具调用**（只有文字/计划），这在当前环境下是无效回复。';
+    // 工具清单只列名称与参数名（长描述会干扰这一轮）
+    const toolLines = tools.map((tool) => {
+        const name = toolNameOf(tool);
+        const params = toolParamNames(tool).join(', ');
+        const desc = tool?.function?.description ?? '';
+        const shortDesc = desc.length > 60 ? `${desc.slice(0, 60)}...` : desc;
+        return `- ${name}(${params}): ${shortDesc}`;
+    });
+    const trimmedAnswer = answer.trim();
+    let shownAnswer = trimmedAnswer.slice(0, RECOVERY_ANSWER_MAX_LEN);
+    if (trimmedAnswer.length > RECOVERY_ANSWER_MAX_LEN) {
+        shownAnswer += '\n\n[... 内容已截断 ...]';
+    }
+    const answerBlock = shownAnswer ? `\n[你上一轮的回复]\n${shownAnswer}\n` : '';
+    const callsBlock = invalidCalls.length > 0 ? `\n[你上一轮实际输出的调用]\n${invalidCalls.join('\n')}\n` : '';
+    const progressBlock = recentProgress ? `\n# 最近进展（对话尾部）\n${recentProgress}\n` : '';
+    return `你上一轮没有推进任务。${problem}
+
+[现在必须做的事]
+1. **只输出工具调用**（${TOOL_CALL_OPEN}...${TOOL_CALL_CLOSE}），不要任何解释、计划、清单、总结，
+   也不要复述本段文字。
+2. 把「下一步」换成下方清单里的**真实工具**：要执行代码/命令 → 用命令执行类工具；
+   要读文件 → 用读取类工具；要改文件 → 用修改/写入类工具。
+3. **禁止**输出清单以外的工具名${namesText ? `（尤其禁止 ${namesText}）` : ''}；
+   **禁止占位符**（如「真实文件路径」「文件内容」「<...>」），file_path 用真实绝对路径。
+4. 不需要再问、不要再确认——直接调用。
+5. **不要重复已经执行过的同一条调用**（同工具 + 同参数）；
+   如果事实上已经没有新动作可做，就只输出一行文字：\`任务已完成。\`
+
+# 本次可用的真实工具（只有这些可用）
+${toolLines.join('\n')}
+
+# 当前工作目录
+\`${currentWorkingDir}\`
+${progressBlock}${answerBlock}${callsBlock}
+现在输出工具调用：`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/tools/prompts.js.map

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

package/dist/tools/protocol.d.ts

@@ -0,0 +1,58 @@
+import type { ChatMessage, MessageDict, ToolDefinition } from '../types/message.js';
+import { toolParamNames } from '../types/message.js';
+import { type ToolMaps } from './names.js';
+/** 工具调用的 XML 标签。 */
+export declare const TOOL_CALL_OPEN = "<tool_call>";
+export declare const TOOL_CALL_CLOSE = "</tool_call>";
+/** 匹配 `<tool_call>...</tool_call>` 块。 */
+export declare const TOOL_CALL_PATTERN: RegExp;
+/**
+ * 工具说明在提示词中的最大长度。
+ *
+ * 客户端的工具说明常常很长（含 Usage/Examples），全部注入会吃掉输入框额度，
+ * 且**提示词越长模型越容易「只描述不调用」**。截断成一句话足够选对工具。
+ */
+export declare const TOOL_DESC_MAX_LEN = 80;
+export interface FormatToolsOptions {
+    /** 用户项目/工作目录（用于防止模型编造路径）。 */
+    workspacePath?: string;
+    /** 对话中已出现过的真实文件路径。 */
+    knownFilePaths?: readonly string[];
+}
+/**
+ * 把 OpenAI `tools` 定义渲染成注入用的文本块。
+ *
+ * 返回的文本会被追加到系统提示里，告诉模型用 `<tool_call>` 标签输出调用。
+ *
+ * 工具列表用**紧凑格式**：`名称(必填*,可选)：说明`。
+ * 27 个工具实测从 11,892 字符降到 3,462 字符（-71%）。
+ */
+export declare function formatToolsAsText(tools: ReadonlyArray<ToolDefinition>, options?: FormatToolsOptions): string;
+/** `formatToolsAsText` + 映射表的组合结果。 */
+export interface ToolProtocol {
+    /** 要注入提示词的文本。 */
+    text: string;
+    /** 本请求专用的映射表（替代 Python 版的全局变量）。 */
+    maps: ToolMaps;
+}
+/**
+ * 一次算出「注入文本 + 映射表」。
+ *
+ * 路由层应该用这个函数而不是分别调用 `formatToolsAsText` / `createToolMaps`，
+ * 避免映射表与提示词里的工具列表不一致。
+ */
+export declare function buildToolProtocol(tools: ReadonlyArray<ToolDefinition>, options?: FormatToolsOptions): ToolProtocol;
+/**
+ * 把所有消息拍平成一段文本（等价于 `format_messages_as_text`）。
+ *
+ * 目的：让网页版模型在**一次提示**里看到完整对话上下文。
+ *
+ * 截断策略（这里是**唯一会丢内容**的地方）：
+ * - tool_call 参数 > 3000 字符 → 截断
+ * - assistant 文本 > 3000 字符 → 截断
+ * - tool 结果 > 5000 字符 → 截断（Read 类例外，保留全文）
+ */
+export declare function formatMessagesAsText(messages: ReadonlyArray<ChatMessage | MessageDict>): string;
+/** 便捷：取工具的参数名列表（供 reparse 提示词等使用）。 */
+export { toolParamNames };
+//# sourceMappingURL=protocol.d.ts.map

package/dist/tools/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/tools/protocol.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAGL,cAAc,EAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5E,oBAAoB;AACpB,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,QAG7B,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAiHR;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAKd;AAcD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,MAAM,CA8F/F;AAsBD,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,CAAC"}