@lingxiao-office/sdk 1.0.0

package/dist/llm/reasoningSampling.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 推理/编排/判定类 LLM 调用的采样参数(防漂移根因修复)。
+ *
+ * 背景：主推理循环此前完全不设采样温度，走 provider 默认(~1.0)随机解码，
+ * 导致相同任务两次跑出不同任务分解 / 工具选择 / 续跑判定。这与
+ * `no-heuristics-deterministic-only` 原则相悖——确定性贯彻到了压缩/scope/
+ * 任务板，唯独漏了解码器。
+ *
+ * 这里集中读取 `llm.reasoning_temperature`(默认 0 = 确定性解码)，供 Leader 主推理、
+ * Worker 主推理、judgment、压缩摘要、续跑判定等"要可靠不要创意"的调用统一引用。
+ *
+ * 不走此路径：记忆生成类(Dream/Distill/Checkpoint)各自硬编码发散温度。
+ */
+/**
+ * 返回推理调用的 sampling 对象。temperature 未配置时返回 undefined(由调用方决定是否传)。
+ */
+export declare function getReasoningSampling(): {
+    temperature: number;
+} | undefined;
+/**
+ * 返回可直接作为 LlmGuard.call 第 9 参数(generateOptions)的对象。
+ * 已合并 sampling；调用方若有 maxTokens 需求可在此基础上展开。
+ */
+export declare function getReasoningGenerateOptions(): {
+    sampling?: {
+        temperature: number;
+    };
+};
+/**
+ * ContentGenerator 层全局温度兜底(防漂移根因修复 A1)。
+ *
+ * 背景：旧实现透传温度的逻辑是 `params.sampling?.temperature`——只在调用方**显式**
+ * 传 sampling 时才下发 temperature。新调用点(Leader/Worker/Judgment/压缩之外的新增
+ * LLM 调用)若忘记调 `getReasoningGenerateOptions()`，sampling 为空 → temperature
+ * 字段不写 → 走 provider 默认(~1.0 随机解码) → 相同任务两次跑出不同结果(漂移)。
+ *
+ * 这里在 ContentGenerator 透传处统一收口为三态确定性分派(非启发式，无阈值/无打分)：
+ *   1. thinkingActive=true → 返回 undefined
+ *      (Anthropic extended thinking 经 API/SDK 强制要求 temperature=1，下发会 400；
+ *      Vercel/OpenAI 路径同样不下发，保留 provider 默认)
+ *   2. 调用方显式传 sampling.temperature(number) → 原样转发(尊重显式意图，如
+ *      记忆生成类调用方显式传发散温度；这是确定性"显式优先"规则)
+ *   3. 否则(无 sampling 或 sampling.temperature 缺省) → 锁 getReasoningSampling()，
+ *      配置未加载时兜底为 DETERMINISTIC_FALLBACK_TEMPERATURE(0)
+ *
+ * thinkingActive 由调用方按各自 provider 的真实信号(supportsThinking + 配置开关 +
+ * thinking 参数将实际下发)确定性计算后传入，本函数不做任何二次推断。
+ *
+ * @param explicitTemperature 调用方通过 GenerateContentParams.sampling.temperature 显式传入的温度，
+ *        undefined 表示调用方未指定(走兜底)
+ * @param thinkingActive 该 provider/模型本次是否处于 thinking 模式(由调用方确定性判定)
+ * @returns 最终透传给底层 SDK 的 temperature 数值，或 undefined(表示不下发该字段)
+ */
+export declare function resolveGuardedTemperature(explicitTemperature: number | undefined, thinkingActive: boolean): number | undefined;
+//# sourceMappingURL=reasoningSampling.d.ts.map

package/dist/llm/reasoningSampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningSampling.d.ts","sourceRoot":"","sources":["../../src/llm/reasoningSampling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAG1E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI;IAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAGpF;AAYD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,cAAc,EAAE,OAAO,GACtB,MAAM,GAAG,SAAS,CAKpB"}

package/dist/llm/reasoningSampling.js

@@ -0,0 +1,72 @@
+/**
+ * 推理/编排/判定类 LLM 调用的采样参数(防漂移根因修复)。
+ *
+ * 背景：主推理循环此前完全不设采样温度，走 provider 默认(~1.0)随机解码，
+ * 导致相同任务两次跑出不同任务分解 / 工具选择 / 续跑判定。这与
+ * `no-heuristics-deterministic-only` 原则相悖——确定性贯彻到了压缩/scope/
+ * 任务板，唯独漏了解码器。
+ *
+ * 这里集中读取 `llm.reasoning_temperature`(默认 0 = 确定性解码)，供 Leader 主推理、
+ * Worker 主推理、judgment、压缩摘要、续跑判定等"要可靠不要创意"的调用统一引用。
+ *
+ * 不走此路径：记忆生成类(Dream/Distill/Checkpoint)各自硬编码发散温度。
+ */
+import { getConfigValue } from '../config.js';
+/**
+ * 返回推理调用的 sampling 对象。temperature 未配置时返回 undefined(由调用方决定是否传)。
+ */
+export function getReasoningSampling() {
+    const temperature = getConfigValue('llm.reasoning_temperature');
+    return typeof temperature === 'number' ? { temperature } : undefined;
+}
+/**
+ * 返回可直接作为 LlmGuard.call 第 9 参数(generateOptions)的对象。
+ * 已合并 sampling；调用方若有 maxTokens 需求可在此基础上展开。
+ */
+export function getReasoningGenerateOptions() {
+    const sampling = getReasoningSampling();
+    return sampling ? { sampling } : {};
+}
+/**
+ * 全局温度兜底阈值：调用方未显式指定 sampling.temperature 时锁定的确定性解码温度。
+ *
+ * 这是确定性常量，不是启发式阈值——它不参与"判结构/判类别"，只是缺省解码参数的
+ * 兜底值。配置层 `llm.reasoning_temperature`(schema 默认 0) 是单一事实源；当配置
+ * 尚未加载(如早期初始化/单元测试环境 getConfigValue 返回 undefined)时，用此常量
+ * 兜底，确保新调用点漏锁也不会静默走 provider 默认(~1.0)导致漂移。
+ */
+const DETERMINISTIC_FALLBACK_TEMPERATURE = 0;
+/**
+ * ContentGenerator 层全局温度兜底(防漂移根因修复 A1)。
+ *
+ * 背景：旧实现透传温度的逻辑是 `params.sampling?.temperature`——只在调用方**显式**
+ * 传 sampling 时才下发 temperature。新调用点(Leader/Worker/Judgment/压缩之外的新增
+ * LLM 调用)若忘记调 `getReasoningGenerateOptions()`，sampling 为空 → temperature
+ * 字段不写 → 走 provider 默认(~1.0 随机解码) → 相同任务两次跑出不同结果(漂移)。
+ *
+ * 这里在 ContentGenerator 透传处统一收口为三态确定性分派(非启发式，无阈值/无打分)：
+ *   1. thinkingActive=true → 返回 undefined
+ *      (Anthropic extended thinking 经 API/SDK 强制要求 temperature=1，下发会 400；
+ *      Vercel/OpenAI 路径同样不下发，保留 provider 默认)
+ *   2. 调用方显式传 sampling.temperature(number) → 原样转发(尊重显式意图，如
+ *      记忆生成类调用方显式传发散温度；这是确定性"显式优先"规则)
+ *   3. 否则(无 sampling 或 sampling.temperature 缺省) → 锁 getReasoningSampling()，
+ *      配置未加载时兜底为 DETERMINISTIC_FALLBACK_TEMPERATURE(0)
+ *
+ * thinkingActive 由调用方按各自 provider 的真实信号(supportsThinking + 配置开关 +
+ * thinking 参数将实际下发)确定性计算后传入，本函数不做任何二次推断。
+ *
+ * @param explicitTemperature 调用方通过 GenerateContentParams.sampling.temperature 显式传入的温度，
+ *        undefined 表示调用方未指定(走兜底)
+ * @param thinkingActive 该 provider/模型本次是否处于 thinking 模式(由调用方确定性判定)
+ * @returns 最终透传给底层 SDK 的 temperature 数值，或 undefined(表示不下发该字段)
+ */
+export function resolveGuardedTemperature(explicitTemperature, thinkingActive) {
+    if (thinkingActive)
+        return undefined;
+    if (typeof explicitTemperature === 'number')
+        return explicitTemperature;
+    const configured = getReasoningSampling();
+    return configured ? configured.temperature : DETERMINISTIC_FALLBACK_TEMPERATURE;
+}
+//# sourceMappingURL=reasoningSampling.js.map

package/dist/llm/reasoningSampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningSampling.js","sourceRoot":"","sources":["../../src/llm/reasoningSampling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,WAAW,GAAG,cAAc,CAAC,2BAA2B,CAAC,CAAC;IAChE,OAAO,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,yBAAyB,CACvC,mBAAuC,EACvC,cAAuB;IAEvB,IAAI,cAAc;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,OAAO,mBAAmB,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IACxE,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,kCAAkC,CAAC;AAClF,CAAC"}

package/dist/llm/tesseractResolver.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tesseract 本地资源解析 — 单一事实源。
+ *
+ * 背景（bug）：OCRTool 和 local_vision_fallback 各自用一段相同的脆弱逻辑解析
+ * tessdata 目录（只试 `../../tessdata` 和 `../../../tessdata` 两个相对 dist 的候选）。
+ * 一旦项目布局嵌套更深（如 tessdata 在更上层目录），两个候选都落空，langPath
+ * 指向空目录，tesseract.js 退回从 CDN 下载语言数据/wasm core，在隔离或弱网环境
+ * 必然 15s 初始化超时（用户现象：「OCR worker 初始化超时(15000ms)」）。
+ *
+ * 本模块把解析逻辑收敛为单一实现：
+ *  - tessdata 目录：多级向上查找 + 环境变量覆盖，覆盖打包/源码/嵌套多种布局
+ *  - corePath / workerPath：用 require.resolve 从 node_modules 精确定位本地 wasm/worker，
+ *    传给 createWorker 后彻底切断 CDN 下载路径（完全本地、可离线）
+ *  - isTessdataAvailable：语言数据缺失时让调用方快速失败/跳过，而非空跑到超时
+ */
+/** 本地 tessdata 目录（模块加载时解析一次）。 */
+export declare const LOCAL_TESSDATA_DIR: string;
+/** 语言数据是否本地可用——调用方据此快速跳过，避免 createWorker 空跑到超时。 */
+export declare function isTessdataAvailable(): boolean;
+/**
+ * 解析 tesseract.js-core 的本地 corePath（含 wasm）。
+ * 用 require.resolve 定位包目录，比相对路径稳健（不受 dist 层级影响）。
+ * 解析失败返回 undefined——createWorker 不传 corePath 时退回默认（可能联网），
+ * 调用方应结合 isTessdataAvailable 决定是否启用 OCR。
+ */
+export declare function resolveCorePath(): string | undefined;
+/**
+ * 解析 tesseract.js 的本地 worker 脚本（dist/worker.min.js）。
+ * 同样用 require.resolve 定位，避免 CDN 下载 worker。
+ */
+export declare function resolveWorkerPath(): string | undefined;
+/**
+ * 组装传给 createWorker 的本地资源选项：langPath + corePath + workerPath。
+ * 三者齐备时 tesseract 完全本地运行，不触发任何 CDN 下载。
+ */
+export declare function localWorkerOptions(): {
+    langPath: string;
+    corePath?: string;
+    workerPath?: string;
+};
+//# sourceMappingURL=tesseractResolver.d.ts.map

package/dist/llm/tesseractResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tesseractResolver.d.ts","sourceRoot":"","sources":["../../src/llm/tesseractResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4CH,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AAEvD,mDAAmD;AACnD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAOpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAQtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAQA"}

package/dist/llm/tesseractResolver.js

@@ -0,0 +1,103 @@
+/**
+ * Tesseract 本地资源解析 — 单一事实源。
+ *
+ * 背景（bug）：OCRTool 和 local_vision_fallback 各自用一段相同的脆弱逻辑解析
+ * tessdata 目录（只试 `../../tessdata` 和 `../../../tessdata` 两个相对 dist 的候选）。
+ * 一旦项目布局嵌套更深（如 tessdata 在更上层目录），两个候选都落空，langPath
+ * 指向空目录，tesseract.js 退回从 CDN 下载语言数据/wasm core，在隔离或弱网环境
+ * 必然 15s 初始化超时（用户现象：「OCR worker 初始化超时(15000ms)」）。
+ *
+ * 本模块把解析逻辑收敛为单一实现：
+ *  - tessdata 目录：多级向上查找 + 环境变量覆盖，覆盖打包/源码/嵌套多种布局
+ *  - corePath / workerPath：用 require.resolve 从 node_modules 精确定位本地 wasm/worker，
+ *    传给 createWorker 后彻底切断 CDN 下载路径（完全本地、可离线）
+ *  - isTessdataAvailable：语言数据缺失时让调用方快速失败/跳过，而非空跑到超时
+ */
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const requireFromHere = createRequire(import.meta.url);
+/** 必备语言数据文件名（gzip 形态，与 createWorker gzip:true 对应）。 */
+const REQUIRED_TRAINEDDATA = ['eng.traineddata.gz'];
+/**
+ * 解析本地 tessdata 目录：
+ *  1. 环境变量 LINGXIAO_TESSDATA_DIR 显式覆盖（最高优先级）
+ *  2. 从当前文件向上逐级查找 `tessdata/`，直到文件系统根
+ *  3. 回退到 process.cwd()/tessdata
+ * 命中判据：目录存在且含 eng.traineddata.gz（避免命中空目录）。
+ */
+function resolveTessdataDir() {
+    const envDir = process.env.LINGXIAO_TESSDATA_DIR;
+    if (envDir && hasTrainedData(envDir))
+        return envDir;
+    // 从 __dirname 向上逐级找 tessdata/（覆盖 dist 同级、项目根、嵌套上层等布局）
+    let cursor = __dirname;
+    for (let i = 0; i < 8; i++) {
+        const candidate = path.join(cursor, 'tessdata');
+        if (hasTrainedData(candidate))
+            return candidate;
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            break; // 抵达文件系统根
+        cursor = parent;
+    }
+    // 回退：cwd/tessdata（即便不存在也返回，让 isTessdataAvailable 统一判定）
+    return path.join(process.cwd(), 'tessdata');
+}
+function hasTrainedData(dir) {
+    if (!dir || !fs.existsSync(dir))
+        return false;
+    return REQUIRED_TRAINEDDATA.every((f) => fs.existsSync(path.join(dir, f)));
+}
+/** 本地 tessdata 目录（模块加载时解析一次）。 */
+export const LOCAL_TESSDATA_DIR = resolveTessdataDir();
+/** 语言数据是否本地可用——调用方据此快速跳过，避免 createWorker 空跑到超时。 */
+export function isTessdataAvailable() {
+    return hasTrainedData(LOCAL_TESSDATA_DIR);
+}
+/**
+ * 解析 tesseract.js-core 的本地 corePath（含 wasm）。
+ * 用 require.resolve 定位包目录，比相对路径稳健（不受 dist 层级影响）。
+ * 解析失败返回 undefined——createWorker 不传 corePath 时退回默认（可能联网），
+ * 调用方应结合 isTessdataAvailable 决定是否启用 OCR。
+ */
+export function resolveCorePath() {
+    try {
+        const corePkg = requireFromHere.resolve('tesseract.js-core/package.json');
+        return path.dirname(corePkg);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 解析 tesseract.js 的本地 worker 脚本（dist/worker.min.js）。
+ * 同样用 require.resolve 定位，避免 CDN 下载 worker。
+ */
+export function resolveWorkerPath() {
+    try {
+        const tjsPkg = requireFromHere.resolve('tesseract.js/package.json');
+        const workerPath = path.join(path.dirname(tjsPkg), 'dist', 'worker.min.js');
+        return fs.existsSync(workerPath) ? workerPath : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 组装传给 createWorker 的本地资源选项：langPath + corePath + workerPath。
+ * 三者齐备时 tesseract 完全本地运行，不触发任何 CDN 下载。
+ */
+export function localWorkerOptions() {
+    const corePath = resolveCorePath();
+    const workerPath = resolveWorkerPath();
+    return {
+        langPath: LOCAL_TESSDATA_DIR,
+        ...(corePath ? { corePath } : {}),
+        ...(workerPath ? { workerPath } : {}),
+    };
+}
+//# sourceMappingURL=tesseractResolver.js.map

package/dist/llm/tesseractResolver.js.map

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

package/dist/llm/tokenLimits.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Token 限制常量与工具函数
+ *
+ * 实现 "Adaptive Output Token Escalation" 策略：
+ * - 默认使用 CAPPED_DEFAULT_MAX_TOKENS (8K) 避免过度预留 GPU 资源
+ * - 当输出因 max_tokens 被截断时，自动以 ESCALATED_MAX_TOKENS (64K) 重试
+ *
+ * 参考 qwen-code 的 adaptive-output-token-escalation 设计
+ */
+/** 默认 max_tokens 上限 — 99% 的响应在 5K tokens 以内，8K 提供足够余量 */
+export declare const CAPPED_DEFAULT_MAX_TOKENS: 16384;
+/** 升级后 max_tokens — 覆盖绝大多数长输出场景 */
+export declare const ESCALATED_MAX_TOKENS: 65536;
+/**
+ * 获取模型的最大输出 token 限制。
+ * 优先级：
+ *   1. ModelManager 用户配置 capabilities.max_output_tokens
+ *   2. ModelsDevRegistry（models.dev 社区数据）
+ *   3. 全局升级上限
+ */
+export declare function getModelOutputLimit(model: string): number;
+/**
+ * 计算初始 max_tokens。
+ * 取 min(模型输出上限, CAPPED_DEFAULT_MAX_TOKENS)，确保不超模型能力且节省资源。
+ */
+export declare function getInitialMaxTokens(model: string): number;
+/**
+ * 计算升级后 max_tokens。
+ * 取 min(模型输出上限, ESCALATED_MAX_TOKENS)。
+ */
+export declare function getEscalatedMaxTokens(model: string): number;
+//# sourceMappingURL=tokenLimits.d.ts.map

package/dist/llm/tokenLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenLimits.d.ts","sourceRoot":"","sources":["../../src/llm/tokenLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,OAAwB,CAAC;AAE/D,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,OAA2B,CAAC;AAmD7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/llm/tokenLimits.js

@@ -0,0 +1,91 @@
+/**
+ * Token 限制常量与工具函数
+ *
+ * 实现 "Adaptive Output Token Escalation" 策略：
+ * - 默认使用 CAPPED_DEFAULT_MAX_TOKENS (8K) 避免过度预留 GPU 资源
+ * - 当输出因 max_tokens 被截断时，自动以 ESCALATED_MAX_TOKENS (64K) 重试
+ *
+ * 参考 qwen-code 的 adaptive-output-token-escalation 设计
+ */
+import { LLM } from '../config/defaults.js';
+import { config as runtimeConfig } from '../config.js';
+import { getModelManager } from '../config/ModelManager.js';
+import { getModelDevInfo } from './ModelsDevRegistry.js';
+/** 默认 max_tokens 上限 — 99% 的响应在 5K tokens 以内，8K 提供足够余量 */
+export const CAPPED_DEFAULT_MAX_TOKENS = LLM.CAPPED_MAX_TOKENS;
+/** 升级后 max_tokens — 覆盖绝大多数长输出场景 */
+export const ESCALATED_MAX_TOKENS = LLM.ESCALATED_MAX_TOKENS;
+function configuredPositiveInteger(value, fallback) {
+    return positiveInteger(value) ?? fallback;
+}
+function cappedDefaultMaxTokens() {
+    return configuredPositiveInteger(runtimeConfig.llm?.capped_max_tokens, LLM.CAPPED_MAX_TOKENS);
+}
+function escalatedMaxTokens() {
+    return configuredPositiveInteger(runtimeConfig.llm?.escalated_max_tokens, LLM.ESCALATED_MAX_TOKENS);
+}
+function positiveInteger(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0
+        ? Math.floor(value)
+        : undefined;
+}
+function getProviderConfig(model) {
+    try {
+        return getModelManager().getModelById(model);
+    }
+    catch {
+        return undefined;
+    }
+}
+function getConfiguredOutputLimit(model) {
+    const modelConfig = getProviderConfig(model);
+    return positiveInteger(modelConfig?.capabilities?.max_output_tokens);
+}
+function getProviderModelName(model) {
+    const modelConfig = getProviderConfig(model);
+    if (!modelConfig)
+        return undefined;
+    const configuredModel = modelConfig.model;
+    if (typeof configuredModel === 'string' && configuredModel.trim())
+        return configuredModel;
+    if ('modelId' in modelConfig && typeof modelConfig.modelId === 'string' && modelConfig.modelId.trim()) {
+        return modelConfig.modelId;
+    }
+    return undefined;
+}
+function getRegistryOutputLimit(model) {
+    const direct = positiveInteger(getModelDevInfo(model)?.outputLimit);
+    if (direct)
+        return direct;
+    const providerModel = getProviderModelName(model);
+    return providerModel ? positiveInteger(getModelDevInfo(providerModel)?.outputLimit) : undefined;
+}
+/**
+ * 获取模型的最大输出 token 限制。
+ * 优先级：
+ *   1. ModelManager 用户配置 capabilities.max_output_tokens
+ *   2. ModelsDevRegistry（models.dev 社区数据）
+ *   3. 全局升级上限
+ */
+export function getModelOutputLimit(model) {
+    return getConfiguredOutputLimit(model)
+        ?? getRegistryOutputLimit(model)
+        ?? escalatedMaxTokens();
+}
+/**
+ * 计算初始 max_tokens。
+ * 取 min(模型输出上限, CAPPED_DEFAULT_MAX_TOKENS)，确保不超模型能力且节省资源。
+ */
+export function getInitialMaxTokens(model) {
+    const modelLimit = getModelOutputLimit(model);
+    return Math.min(modelLimit, cappedDefaultMaxTokens());
+}
+/**
+ * 计算升级后 max_tokens。
+ * 取 min(模型输出上限, ESCALATED_MAX_TOKENS)。
+ */
+export function getEscalatedMaxTokens(model) {
+    const modelLimit = getModelOutputLimit(model);
+    return Math.min(modelLimit, escalatedMaxTokens());
+}
+//# sourceMappingURL=tokenLimits.js.map

package/dist/llm/tokenLimits.js.map

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

package/dist/llm/token_counter.d.ts

@@ -0,0 +1,82 @@
+import { type MessageContent, type ThinkingBlock, type ToolCall } from './types.js';
+/**
+ * Token 计数器 - 完整复刻 Python 版本
+ *
+ * 提供粗略和精确的 token 计数功能
+ */
+/**
+ * 粗略估计 token 数量
+ * 中文约 1.5 字符/token，英文约 4 字符/token
+ */
+export declare function countTokens(text: string): number;
+/**
+ * 计算消息列表的 token 数量
+ */
+type TokenCountableMessage = {
+    role: string;
+    content?: MessageContent;
+    tool_calls?: ToolCall[];
+    thinking?: ThinkingBlock[];
+    /** 工具结果消息引用的 tool_call id，回传给 provider 时计入请求体 */
+    tool_call_id?: string;
+    /** 部分 provider 支持的消息 name 字段（function/tool 名等） */
+    name?: string;
+};
+export declare function countMessagesTokens(messages: TokenCountableMessage[]): number;
+/**
+ * 计算消息的 token 数量（单个消息）
+ */
+export declare function countMessageTokens(message: TokenCountableMessage): number;
+/**
+ * Token 计数器类 - 提供更精确的计数
+ */
+export declare class TokenCounter {
+    private totalPrompt;
+    private totalCompletion;
+    /**
+     * 记录 token 使用
+     */
+    addUsage(promptTokens: number, completionTokens: number): void;
+    /**
+     * 获取总 prompt token
+     */
+    getTotalPrompt(): number;
+    /**
+     * 获取总 completion token
+     */
+    getTotalCompletion(): number;
+    /**
+     * 获取总 token
+     */
+    getTotal(): number;
+    /**
+     * 重置计数器
+     */
+    reset(): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+}
+/**
+ * 获取全局 Token 计数器
+ */
+export declare function getTokenCounter(): TokenCounter;
+/**
+ * 快速估算文本 token 数
+ */
+export declare function estimateTokens(text: string | object | null | undefined): number;
+declare const _default: {
+    countTokens: typeof countTokens;
+    countMessagesTokens: typeof countMessagesTokens;
+    countMessageTokens: typeof countMessageTokens;
+    TokenCounter: typeof TokenCounter;
+    getTokenCounter: typeof getTokenCounter;
+    estimateTokens: typeof estimateTokens;
+};
+export default _default;
+//# sourceMappingURL=token_counter.d.ts.map

package/dist/llm/token_counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_counter.d.ts","sourceRoot":"","sources":["../../src/llm/token_counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO9H;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqChD;AAED;;GAEG;AACH,KAAK,qBAAqB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAKF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,CA+C7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAa;IAEpC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAK9D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAOlE;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQ/E;;;;;;;;;AAED,wBAOE"}