webaiapi 0.0.0-stage → 0.1.0

package/dist/tools/workspace.js

@@ -0,0 +1,224 @@
+/**
+ * 工作目录与文件路径提取 —— `legacy-python/src/utils/tool_calls.py` 的一部分。
+ *
+ * ⚠️ 这里是踩坑最密的地方，改动前请读 `docs/hard-constraints.md`「工作目录提取」。
+ *
+ * 核心结论：方法1（显式声明正则）**必须对所有 role 生效**。
+ * CodeBuddy 把 `Workspace Folder: <path>` 放在 **user** 消息的 `<user_info>` 里，
+ * 只扫 system 消息会落空 → 回退到 API 进程的 CWD → 工具调用路径全部错误。
+ *
+ * 与原实现的差异：
+ * - Python `re` 的 `\w` 是 Unicode 语义，JS 的 `\w` 只有 ASCII，故统一替换为
+ *   `PY_W_CHARS`（`\p{L}\p{N}_`）并使用 `u` 标志。
+ * - 「目录是否存在」的检查改为可注入（{@link ExtractWorkspaceOptions.isDir}），
+ *   便于单测与跨平台（Python 直接调 `os.path.isdir`）。
+ */
+import { statSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../log/logger.js';
+import { messageToDict } from '../types/message.js';
+import { PY_W_CHARS } from './repair.js';
+/** AI 不确定路径时常用的编造前缀（必须排除）。 */
+export const FABRICATED_PATH_PREFIXES = [
+    '/home/user/',
+    '/home/amble/project/',
+    '/home/amble/workspace/',
+    '/home/project/',
+    '/home/workspace/',
+    'C:/Users/user/',
+];
+/**
+ * 匹配显式声明的工作目录。
+ *
+ * 锚点需覆盖各 IDE 注入 `<user_info>` 的格式差异：
+ * - Trae / Cursor: `Working directory:` / `Primary working directory:`
+ * - CodeBuddy:     `Workspace Folder:`
+ * - 通用:          `Project root:` / `Project path:` / `工作目录:`
+ */
+export const WORKSPACE_PATH_PATTERNS = new RegExp(String.raw `(?:working\s*director|primary\s*working\s*director|` +
+    String.raw `workspace\s*folder|project\s*root|project\s*path|project\s*folder|` +
+    String.raw `workspace|工作目录)` +
+    String.raw `[：:]\s*[` +
+    '`"\'' +
+    String.raw `]*([/${PY_W_CHARS}~.\-]+)`, 'iu');
+/** 匹配 `Working directories:` 之后的列表项。 */
+const WORKING_DIRS_BLOCK = /Working\s+director(?:y|ies)[：:]\s*\n((?:\s*-\s+[^\n]+\n?)+)/iu;
+/** 匹配形如 `- /path/to/dir` 的行。 */
+export const PATH_LINE_PATTERN = new RegExp(String.raw `^\s*-\s+([/~${PY_W_CHARS}./-]+)\s*$`, 'gmu');
+/** 路径提取后带的文件扩展名（工作目录是目录，不是文件）。 */
+// ⚠️ 必须写成 `[${PY_W_CHARS}]{n,m}`：直接写 `${PY_W_CHARS}{n,m}` 时量词
+// 只作用于最后一个原子（`_`），而不是整个「字母/数字/下划线」集合。
+const HAS_EXTENSION = new RegExp(String.raw `\.[a-zA-Z][${PY_W_CHARS}]{0,7}$`, 'u');
+/** Java 关键字：被无锚点正则误拼成路径的常见片段。 */
+const JAVA_CLASS_KEYWORDS = new Set([
+    'class', 'function', 'public', 'private', 'protected',
+    'interface', 'extends', 'implements', 'package', 'import',
+    'abstract', 'final', 'static', 'void', 'return', 'new',
+    'super', 'this', 'true', 'false', 'null',
+]);
+/** 代码示例路径关键词。 */
+const EXAMPLE_KEYWORDS = ['good-example', 'bad-example', 'example', 'demo', 'sample'];
+/** 项目根目录的路径深度上限。 */
+const MAX_PATH_DEPTH = 5;
+/** 路径最短长度（太短不太可能是项目目录）。 */
+const MIN_PATH_LEN = 10;
+/**
+ * API 项目自身目录（用于排除 —— 用户项目不可能在这个目录下）。
+ *
+ * 从模块位置往上两级：`src/tools/` → 仓库根，`dist/tools/` → 仓库根，两者一致。
+ */
+export const SELF_PROJECT_DIR = fileURLToPath(new URL('../../', import.meta.url)).replace(/\/$/, '');
+function defaultIsDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 从消息里提取工作目录 / 项目根路径；找不到返回空字符串。
+ *
+ * 优先级：user 显式声明(3) > system 显式声明(2) > system 路径推断(1)。
+ */
+export function extractWorkspacePath(messages, options = {}) {
+    const { isDir = defaultIsDir, selfDir = SELF_PROJECT_DIR } = options;
+    let workspacePath = '';
+    let systemContent = '';
+    let bestPriority = 0;
+    for (const raw of messages) {
+        const m = messageToDict(raw);
+        const role = m.role;
+        const content = typeof m.content === 'string' ? m.content : '';
+        if (!content)
+            continue;
+        // ── 方法1（任意 role）：匹配显式声明的目录 ──
+        const match = WORKSPACE_PATH_PATTERNS.exec(content);
+        if (match) {
+            const path = match[1].replace(/\/+$/, '');
+            const priority = role === 'user' ? 3 : 2;
+            if (isDir(path) && priority > bestPriority) {
+                workspacePath = path;
+                bestPriority = priority;
+                logger.info({ role, path }, '[workspace] 从消息提取工作目录');
+            }
+        }
+        if (role !== 'system')
+            continue;
+        systemContent = content;
+        // ── 方法2：`Working directories:` 之后的列表 ──
+        const wdMatch = WORKING_DIRS_BLOCK.exec(content);
+        if (wdMatch) {
+            for (const lineMatch of wdMatch[1].matchAll(new RegExp(PATH_LINE_PATTERN.source, 'gmu'))) {
+                const path = lineMatch[1].replace(/\/+$/, '');
+                // system 级显式声明优先级 2，**不能覆盖** user 级声明(3)。
+                // ⚠️ 与原设计不同处：Python 版写的是 `best_priority < 2`，
+                //    一旦第一行把 bestPriority 置成 2，后面更长的候选就永远进不来
+                //    （列表里有多个目录时等于只取第一个），与「取最长」的意图不符。
+                //    这里改成 `< 3`：既不越过 user 级声明，又能继续在 system 级候选里挑最长的。
+                if (isDir(path) && bestPriority < 3 && path.length > workspacePath.length) {
+                    workspacePath = path;
+                    bestPriority = 2;
+                }
+            }
+        }
+        // ── 方法3：在 system 消息里找非编造的真实目录路径 ──
+        if (!workspacePath) {
+            // lookbehind 排除 XML/HTML 标签误匹配：
+            // 系统提示里的 <maximize_context_understanding> 会被无锚点正则误认成路径，
+            // 进而作为错误工作目录注入工具描述，导致 AI 把文件写到不存在的目录。
+            const pathPattern = new RegExp(String.raw `(?<![\p{L}\p{N}_<])([/~][${PY_W_CHARS}./-]+)`, 'gu');
+            for (const pm of content.matchAll(pathPattern)) {
+                const path = pm[1].replace(/\/+$/, '');
+                if (HAS_EXTENSION.test(path))
+                    continue; // 带扩展名 → 是文件不是目录
+                if (FABRICATED_PATH_PREFIXES.some((p) => path.startsWith(p)))
+                    continue;
+                if (path === selfDir || path.startsWith(`${selfDir}/`))
+                    continue;
+                const parts = path.split('/');
+                const last = parts[parts.length - 1];
+                if (parts.length >= 2 && JAVA_CLASS_KEYWORDS.has(last))
+                    continue;
+                if (EXAMPLE_KEYWORDS.some((ex) => path.toLowerCase().includes(ex)))
+                    continue;
+                if (path.length < MIN_PATH_LEN)
+                    continue;
+                if ((path.match(/\//g) ?? []).length > MAX_PATH_DEPTH)
+                    continue;
+                // 排除「疑似 JSON 字段名拼接」：所有段都是纯字母且段数 >= 3
+                // （真实项目目录几乎都会含下划线/数字/连字符/点之一）
+                const nonEmpty = parts.filter(Boolean);
+                if (nonEmpty.length >= 3 && nonEmpty.every((p) => /^[A-Za-z]+$/u.test(p)))
+                    continue;
+                // 注意：不再验证目录是否存在 ——
+                // 用户的项目目录在用户机器上，不在 API 服务器上
+                if (path.length > workspacePath.length) {
+                    workspacePath = path;
+                    bestPriority = Math.max(bestPriority, 1);
+                }
+            }
+        }
+    }
+    // ── 兜底：从 tool 结果的 file_path 反推目录 ──
+    if (!workspacePath) {
+        for (const raw of messages) {
+            const m = messageToDict(raw);
+            if (m.role !== 'tool')
+                continue;
+            const content = typeof m.content === 'string' ? m.content : '';
+            for (const pm of content.matchAll(new RegExp(String.raw `(?:file_path|path)[：:]\s*([/~][${PY_W_CHARS}./-]+)`, 'gu'))) {
+                const path = pm[1];
+                const dir = path.slice(0, path.lastIndexOf('/')) || '/';
+                if (isDir(dir) && dir.length > workspacePath.length)
+                    workspacePath = dir;
+            }
+        }
+    }
+    if (workspacePath) {
+        logger.info({ workspacePath }, '[workspace] 成功提取工作目录');
+    }
+    else {
+        logger.warn('[workspace] 未能从消息中提取工作目录');
+        if (systemContent) {
+            for (const line of systemContent.split('\n')) {
+                if (line.includes('/home/') ||
+                    line.includes('/Users/') ||
+                    line.includes('Primary') ||
+                    line.includes('Working')) {
+                    logger.warn({ line: line.trim() }, '[workspace] 系统消息路径行');
+                }
+            }
+        }
+    }
+    return workspacePath;
+}
+/**
+ * 从消息历史里提取出现过的真实文件路径。
+ *
+ * ⚠️ **只从 tool 结果里提取**，不从 AI 的 `tool_calls` 里提取 ——
+ * 后者可能是模型编造的。
+ */
+export function extractFilePathsFromMessages(messages) {
+    const paths = new Set();
+    for (const raw of messages) {
+        const m = messageToDict(raw);
+        if (m.role !== 'tool')
+            continue;
+        const content = typeof m.content === 'string' ? m.content : '';
+        // 模式1: `file_path: /path/to/file` 或 `path: /path/to/file`
+        for (const pm of content.matchAll(new RegExp(String.raw `(?:file_path|path)[：:]\s*["']*([/~][${PY_W_CHARS}./-]+\.[${PY_W_CHARS}]{1,10})`, 'gu'))) {
+            const p = pm[1];
+            if (!p.startsWith('http') && p.length < 300)
+                paths.add(p);
+        }
+        // 模式2: 路径出现在文件内容开头（如 Read 工具返回 `# /path/to/file`）
+        for (const pm of content.matchAll(new RegExp(String.raw `^#\s*([/~][${PY_W_CHARS}./-]+\.[${PY_W_CHARS}]{1,10})\s*$`, 'gmu'))) {
+            const p = pm[1];
+            if (!p.startsWith('http') && p.length < 300)
+                paths.add(p);
+        }
+    }
+    return [...paths].sort();
+}
+//# sourceMappingURL=workspace.js.map

package/dist/tools/workspace.js.map

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

package/dist/types/message.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 消息模型 —— `legacy-python/src/models/request.py` 的 TypeScript 移植。
+ *
+ * 与原实现的差异：
+ * - Python 用 pydantic 做校验（role 白名单、messages 非空、首条必须是 system/user）。
+ *   TS 侧改为 zod（见 `src/types/openai.ts`）在 HTTP 边界校验，本文件只放纯类型与工具函数。
+ * - `content` 保持「字符串或多模态数组」的原始形态，不再在读取时提前拍平成字符串，
+ *   这样 `formatMessagesAsText` 才能正确处理 `image_url` 项（Python 版对 dict 入参
+ *   能正确处理，对 pydantic 入参则因提前拍平而丢失图片标记）。
+ */
+/** 允许的消息角色。 */
+export declare const ALLOWED_ROLES: readonly ['system', 'user', 'assistant', 'tool', 'function'];
+export type MessageRole = (typeof ALLOWED_ROLES)[number];
+/** 多模态内容项（OpenAI 格式）。 */
+export interface ContentPart {
+    type?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+export type MessageContent = string | ContentPart[] | null;
+/** OpenAI 兼容的消息。 */
+export interface ChatMessage {
+    role: MessageRole | string;
+    content?: MessageContent;
+    name?: string | null;
+    tool_calls?: ToolCallPayload[] | null;
+    tool_call_id?: string | null;
+}
+/** OpenAI 工具调用（function 的 arguments 是 JSON 字符串）。 */
+export interface ToolCallPayload {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * 工具定义（OpenAI `tools` 数组的元素）。
+ *
+ * 这里用宽松类型：客户端（CodeBuddy / Trae）实际发来的结构并不总是严格符合规范，
+ * Python 版也是把 `tools` 当 `List[Dict[str, Any]]` 用的。
+ */
+export interface ToolDefinition {
+    type?: string;
+    function?: {
+        name?: string;
+        description?: string;
+        parameters?: {
+            type?: string;
+            properties?: Record<string, unknown>;
+            required?: string[];
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/** 消息的「扁平化」视图：所有字段都可选、便于统一取值。 */
+export interface MessageDict {
+    role: string;
+    content: MessageContent;
+    name?: string;
+    tool_calls?: ToolCallPayload[];
+    tool_call_id?: string;
+}
+/**
+ * 取纯文本内容（合并多模态数组里的 text 项）。
+ *
+ * 与 Python `Message.get_text_content()` 等价。
+ */
+export declare function getTextContent(content: MessageContent): string;
+/**
+ * 把消息规范化成 `MessageDict`（等价于 Python `_msg_to_dict()`）。
+ *
+ * 与 Python 的区别：这里永远保留 `content` 的原始形态（字符串或数组），
+ * 不再用 `get_text_content()` 提前拍平 —— 拍平会丢掉 `image_url` 标记。
+ * 需要纯文本的地方请显式调用 {@link getTextContent}。
+ */
+export declare function messageToDict(msg: ChatMessage | Record<string, unknown>): MessageDict;
+/** 取工具定义的名字（容错：客户端结构可能不规范）。 */
+export declare function toolNameOf(tool: ToolDefinition | undefined | null): string;
+/** 取工具定义的参数名列表。 */
+export declare function toolParamNames(tool: ToolDefinition | undefined | null): string[];
+/** 取工具定义的必填参数名列表。 */
+export declare function toolRequiredParams(tool: ToolDefinition | undefined | null): string[];
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAe;AACf,eAAO,MAAM,aAAa,YAAI,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;AAE3D,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE;YACX,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAoB9D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAsBrF;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAG1E;AAED,mBAAmB;AACnB,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAIhF;AAED,qBAAqB;AACrB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAGpF"}

package/dist/types/message.js

@@ -0,0 +1,85 @@
+/**
+ * 消息模型 —— `legacy-python/src/models/request.py` 的 TypeScript 移植。
+ *
+ * 与原实现的差异：
+ * - Python 用 pydantic 做校验（role 白名单、messages 非空、首条必须是 system/user）。
+ *   TS 侧改为 zod（见 `src/types/openai.ts`）在 HTTP 边界校验，本文件只放纯类型与工具函数。
+ * - `content` 保持「字符串或多模态数组」的原始形态，不再在读取时提前拍平成字符串，
+ *   这样 `formatMessagesAsText` 才能正确处理 `image_url` 项（Python 版对 dict 入参
+ *   能正确处理，对 pydantic 入参则因提前拍平而丢失图片标记）。
+ */
+/** 允许的消息角色。 */
+export const ALLOWED_ROLES = ['system', 'user', 'assistant', 'tool', 'function'];
+/**
+ * 取纯文本内容（合并多模态数组里的 text 项）。
+ *
+ * 与 Python `Message.get_text_content()` 等价。
+ */
+export function getTextContent(content) {
+    if (content == null)
+        return '';
+    if (typeof content === 'string')
+        return content;
+    const parts = [];
+    for (const item of content) {
+        if (typeof item === 'string') {
+            parts.push(item);
+            continue;
+        }
+        if (item && typeof item === 'object') {
+            const rec = item;
+            if (rec['type'] === 'text' && 'text' in rec) {
+                parts.push(String(rec['text']));
+            }
+            else if (typeof rec['text'] === 'string') {
+                parts.push(rec['text']);
+            }
+        }
+    }
+    return parts.join('');
+}
+/**
+ * 把消息规范化成 `MessageDict`（等价于 Python `_msg_to_dict()`）。
+ *
+ * 与 Python 的区别：这里永远保留 `content` 的原始形态（字符串或数组），
+ * 不再用 `get_text_content()` 提前拍平 —— 拍平会丢掉 `image_url` 标记。
+ * 需要纯文本的地方请显式调用 {@link getTextContent}。
+ */
+export function messageToDict(msg) {
+    const rec = msg;
+    const out = {
+        role: typeof rec['role'] === 'string' ? rec['role'] : '',
+        content: (rec['content'] ?? ''),
+    };
+    const toolCalls = rec['tool_calls'];
+    if (Array.isArray(toolCalls) && toolCalls.length > 0) {
+        out.tool_calls = toolCalls;
+    }
+    const toolCallId = rec['tool_call_id'];
+    if (typeof toolCallId === 'string' && toolCallId) {
+        out.tool_call_id = toolCallId;
+    }
+    const name = rec['name'];
+    if (typeof name === 'string' && name) {
+        out.name = name;
+    }
+    return out;
+}
+/** 取工具定义的名字（容错：客户端结构可能不规范）。 */
+export function toolNameOf(tool) {
+    const name = tool?.function?.name;
+    return typeof name === 'string' ? name : '';
+}
+/** 取工具定义的参数名列表。 */
+export function toolParamNames(tool) {
+    const props = tool?.function?.parameters?.properties;
+    if (!props || typeof props !== 'object')
+        return [];
+    return Object.keys(props);
+}
+/** 取工具定义的必填参数名列表。 */
+export function toolRequiredParams(tool) {
+    const required = tool?.function?.parameters?.required;
+    return Array.isArray(required) ? required : [];
+}
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

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

package/dist/types/openai.d.ts

@@ -0,0 +1,100 @@
+/**
+ * OpenAI 兼容的请求/响应模型 —— `legacy-python/src/models/{request,response}.py` 的移植。
+ *
+ * 与原实现的差异：
+ * - pydantic → zod。校验规则逐条对齐（role 白名单、messages 非空、
+ *   首条必须是 system/user、temperature/max_tokens 等取值范围）。
+ * - `EmbeddingRequest` / `ModerationRequest` / `CreateConversationRequest` 不移植：
+ *   Python 版定义了但**没有任何路由使用它们**（`grep` 可验证）。
+ */
+import { z } from 'zod';
+import { type MessageContent } from './message.js';
+export declare const messageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        function: "function";
+        system: "system";
+        tool: "tool";
+        user: "user";
+    }>;
+    content: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnknown>, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tool_calls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+    tool_call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type MessageInput = z.infer<typeof messageSchema>;
+export declare const chatCompletionRequestSchema: z.ZodObject<{
+    model: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            function: "function";
+            system: "system";
+            tool: "tool";
+            user: "user";
+        }>;
+        content: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnknown>, z.ZodNull]>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tool_calls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+        tool_call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    stream: z.ZodDefault<z.ZodBoolean>;
+    temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    max_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+    tool_choice: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+    conversation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    workspace_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    n: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    top_p: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    frequency_penalty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    presence_penalty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    stop: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    response_format: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type ChatCompletionRequest = z.infer<typeof chatCompletionRequestSchema>;
+export interface ChatCompletionChoice {
+    index: number;
+    message: Record<string, unknown>;
+    finish_reason: string;
+    logprobs?: unknown;
+}
+export interface Usage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage?: Usage | null;
+    system_fingerprint?: string | null;
+}
+export interface ModelInfo {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+    provider: string;
+}
+export interface ModelListResponse {
+    object: 'list';
+    data: ModelInfo[];
+}
+export interface HealthCheckResponse {
+    status: string;
+    version: string;
+    providers: Record<string, Record<string, string>>;
+}
+/** 当前 Unix 时间戳（秒），等价于 Python `int(datetime.now().timestamp())`。 */
+export declare function nowSeconds(now?: () => number): number;
+/** 模型信息工厂（`created` 可注入，便于测试）。 */
+export declare function makeModelInfo(id: string, provider: string, now?: () => number): ModelInfo;
+/** 构造 OpenAI 格式的错误对象（等价于 `ErrorResponse.from_openai_error`）。 */
+export declare function buildOpenAiError(message: string, errorType?: string, param?: string | null, code?: string | null): Record<string, unknown>;
+/** 取消息内容的纯文本（便捷转发，避免使用方到处 import）。 */
+export type { MessageContent };
+//# sourceMappingURL=openai.d.ts.map

package/dist/types/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/types/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAQlE,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAMxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BrC,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAMhF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,MAAM,CAE/D;AAED,kCAAkC;AAClC,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAiB,GAC3B,SAAS,CAEX;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,SAA0B,EACnC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,sCAAsC;AACtC,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/types/openai.js

@@ -0,0 +1,66 @@
+/**
+ * OpenAI 兼容的请求/响应模型 —— `legacy-python/src/models/{request,response}.py` 的移植。
+ *
+ * 与原实现的差异：
+ * - pydantic → zod。校验规则逐条对齐（role 白名单、messages 非空、
+ *   首条必须是 system/user、temperature/max_tokens 等取值范围）。
+ * - `EmbeddingRequest` / `ModerationRequest` / `CreateConversationRequest` 不移植：
+ *   Python 版定义了但**没有任何路由使用它们**（`grep` 可验证）。
+ */
+import { z } from 'zod';
+import { ALLOWED_ROLES } from './message.js';
+/* ------------------------------------------------------------------ */
+/* 请求                                                                */
+/* ------------------------------------------------------------------ */
+const contentSchema = z.union([z.string(), z.array(z.unknown()), z.null()]);
+export const messageSchema = z.object({
+    role: z.enum(ALLOWED_ROLES),
+    content: contentSchema.optional(),
+    name: z.string().nullish(),
+    tool_calls: z.array(z.unknown()).nullish(),
+    tool_call_id: z.string().nullish(),
+});
+export const chatCompletionRequestSchema = z
+    .object({
+    model: z.string().min(1),
+    messages: z.array(messageSchema).min(1, '消息列表不能为空'),
+    stream: z.boolean().default(false),
+    temperature: z.number().min(0).max(2).nullish(),
+    max_tokens: z.number().int().min(1).nullish(),
+    tools: z.array(z.unknown()).nullish(),
+    tool_choice: z.union([z.string(), z.record(z.string(), z.unknown())]).nullish(),
+    conversation_id: z.string().nullish(),
+    workspace_path: z.string().nullish(),
+    // OpenAI 兼容参数：接收但不一定使用
+    n: z.number().int().nullish().default(1),
+    top_p: z.number().min(0).max(1).nullish(),
+    frequency_penalty: z.number().min(-2).max(2).nullish(),
+    presence_penalty: z.number().min(-2).max(2).nullish(),
+    stop: z.union([z.string(), z.array(z.string())]).nullish(),
+    response_format: z.record(z.string(), z.unknown()).nullish(),
+})
+    .refine((value) => {
+    const first = value.messages[0];
+    return first !== undefined && (first.role === 'system' || first.role === 'user');
+}, {
+    message: '第一条消息必须是 system 或 user',
+    path: ['messages'],
+});
+/** 当前 Unix 时间戳（秒），等价于 Python `int(datetime.now().timestamp())`。 */
+export function nowSeconds(now = Date.now) {
+    return Math.floor(now() / 1000);
+}
+/** 模型信息工厂（`created` 可注入，便于测试）。 */
+export function makeModelInfo(id, provider, now = Date.now) {
+    return { id, object: 'model', created: nowSeconds(now), owned_by: 'ai-api', provider };
+}
+/** 构造 OpenAI 格式的错误对象（等价于 `ErrorResponse.from_openai_error`）。 */
+export function buildOpenAiError(message, errorType = 'invalid_request_error', param, code) {
+    const error = { message, type: errorType };
+    if (code != null)
+        error['code'] = code;
+    if (param != null)
+        error['param'] = param;
+    return error;
+}
+//# sourceMappingURL=openai.js.map

package/dist/types/openai.js.map

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