@router-agent/infra 0.0.0-stage → 0.3.32

package/dist/chat.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 通用对话补全客户端。
+ *
+ * 只依赖两种常见协议的 HTTP 接口，不引入新 SDK：
+ * - `openai-completions`：POST `{baseUrl}/chat/completions`，密钥走 `Authorization: Bearer`；
+ * - `anthropic-messages`：POST `{baseUrl}/v1/messages`，密钥走 `x-api-key`
+ *   （配置了 `authHeader` 时按 `ANTHROPIC_AUTH_TOKEN` 的语义改成 `Authorization: Bearer`）。
+ *
+ * 支持工具调用（tool use）：模型可以要求执行只读工具（读配置、读本地代码），
+ * 再基于工具结果给结论——这正是「排查助手要能看本机代码与配置」需要的形态。
+ */
+export type ChatApi = 'openai-completions' | 'anthropic-messages';
+export interface ChatModelConfig {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    api?: ChatApi;
+    /** anthropic-messages 下把密钥作为 Authorization: Bearer 发送。 */
+    authHeader?: boolean;
+    temperature?: number;
+}
+/** 工具声明（JSON Schema 形式的参数说明）。 */
+export interface ChatToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** 模型发起的一次工具调用。 */
+export interface ChatToolCall {
+    id: string;
+    name: string;
+    /** 已解析的参数对象。 */
+    arguments: Record<string, unknown>;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    /** assistant 发起工具调用时带上。 */
+    toolCalls?: ChatToolCall[];
+    /** tool 消息指回哪一次调用。 */
+    toolCallId?: string;
+}
+/** 一轮对话的结果。 */
+export interface ChatTurn {
+    /** 模型的文字输出（发起工具调用时可以为空）。 */
+    content: string;
+    /** 模型请求执行的工具。 */
+    toolCalls: ChatToolCall[];
+}
+export interface ChatClientOptions {
+    /** 单次请求硬超时，默认 60s。 */
+    timeoutMs?: number;
+    /** 输出 token 上限，默认 2000。 */
+    maxTokens?: number;
+    /** 测试注入点。 */
+    fetchImpl?: typeof fetch;
+}
+export interface ChatClient {
+    complete(messages: ChatMessage[], opts?: {
+        tools?: ChatToolSpec[];
+    }): Promise<ChatTurn>;
+}
+/** 创建对话补全客户端；模型地址、密钥、模型名缺一不可。 */
+export declare function createChatClient(model: ChatModelConfig, opts?: ChatClientOptions): ChatClient;
+/** OpenAI 兼容地址：baseUrl 填到 /v1 即可，这里补上 /chat/completions。 */
+export declare function chatCompletionsUrl(baseUrl: string): string;
+/** Anthropic 兼容地址：baseUrl 填网关根地址（不带 /v1/messages）。 */
+export declare function anthropicMessagesUrl(baseUrl: string): string;
+/** 解析一轮响应：文字 + 工具调用。 */
+export declare function parseChatTurn(payload: unknown, api?: ChatApi): ChatTurn;
+/** 从返回里取文本；兼容 OpenAI 的字符串 / 分段数组与 Anthropic 的 content 数组。 */
+export declare function parseChatText(payload: unknown, api?: ChatApi): string;
+/** 工具参数可能是 JSON 字符串，也可能是已经解析好的对象。 */
+export declare function parseToolArguments(raw: unknown): Record<string, unknown>;

package/dist/chat.js

@@ -0,0 +1,236 @@
+/**
+ * 通用对话补全客户端。
+ *
+ * 只依赖两种常见协议的 HTTP 接口，不引入新 SDK：
+ * - `openai-completions`：POST `{baseUrl}/chat/completions`，密钥走 `Authorization: Bearer`；
+ * - `anthropic-messages`：POST `{baseUrl}/v1/messages`，密钥走 `x-api-key`
+ *   （配置了 `authHeader` 时按 `ANTHROPIC_AUTH_TOKEN` 的语义改成 `Authorization: Bearer`）。
+ *
+ * 支持工具调用（tool use）：模型可以要求执行只读工具（读配置、读本地代码），
+ * 再基于工具结果给结论——这正是「排查助手要能看本机代码与配置」需要的形态。
+ */
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_TOKENS = 2_000;
+/** 创建对话补全客户端；模型地址、密钥、模型名缺一不可。 */
+export function createChatClient(model, opts = {}) {
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const timeoutMs = opts.timeoutMs && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_TIMEOUT_MS;
+    const maxTokens = opts.maxTokens && opts.maxTokens > 0 ? opts.maxTokens : DEFAULT_MAX_TOKENS;
+    const api = model.api === 'anthropic-messages' ? 'anthropic-messages' : 'openai-completions';
+    const url = api === 'anthropic-messages' ? anthropicMessagesUrl(model.baseUrl) : chatCompletionsUrl(model.baseUrl);
+    return {
+        async complete(messages, completeOpts = {}) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            let response;
+            try {
+                response = await fetchImpl(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...authHeaders(model, api),
+                    },
+                    body: JSON.stringify(requestBody(model, api, messages, maxTokens, completeOpts.tools)),
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                if (isAbortError(error))
+                    throw new Error(`chat:timeout(${timeoutMs}ms)`);
+                throw new Error(`chat:request-failed: ${errorText(error)}`);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok) {
+                const detail = (await response.text().catch(() => '')).slice(0, 200);
+                throw new Error(`chat:http-${response.status}${detail ? `: ${detail}` : ''}`);
+            }
+            let payload;
+            try {
+                payload = await response.json();
+            }
+            catch (error) {
+                throw new Error(`chat:invalid-json: ${errorText(error)}`);
+            }
+            const turn = parseChatTurn(payload, api);
+            // 既没有文字也没有工具调用，说明模型没给出可用的东西，直接报错让上层降级。
+            if (!turn.content && turn.toolCalls.length === 0)
+                throw new Error('chat:empty-response');
+            return turn;
+        },
+    };
+}
+/** OpenAI 兼容地址：baseUrl 填到 /v1 即可，这里补上 /chat/completions。 */
+export function chatCompletionsUrl(baseUrl) {
+    const clean = baseUrl.trim().replace(/\/+$/, '');
+    if (!clean)
+        throw new Error('chat:base-url-missing');
+    if (clean.endsWith('/chat/completions'))
+        return clean;
+    return `${clean}/chat/completions`;
+}
+/** Anthropic 兼容地址：baseUrl 填网关根地址（不带 /v1/messages）。 */
+export function anthropicMessagesUrl(baseUrl) {
+    const clean = baseUrl.trim().replace(/\/+$/, '');
+    if (!clean)
+        throw new Error('chat:base-url-missing');
+    if (clean.endsWith('/v1/messages'))
+        return clean;
+    if (clean.endsWith('/messages'))
+        return clean;
+    return `${clean}/v1/messages`;
+}
+function authHeaders(model, api) {
+    if (!model.apiKey)
+        return {};
+    if (api === 'anthropic-messages') {
+        return model.authHeader
+            ? { Authorization: `Bearer ${model.apiKey}` }
+            : { 'x-api-key': model.apiKey, 'anthropic-version': '2023-06-01' };
+    }
+    return { Authorization: `Bearer ${model.apiKey}` };
+}
+function requestBody(model, api, messages, maxTokens, tools) {
+    const temperature = model.temperature ?? 0.2;
+    if (api === 'anthropic-messages') {
+        const system = messages.filter(item => item.role === 'system').map(item => item.content).join('\n\n');
+        const rest = messages.filter(item => item.role !== 'system');
+        return {
+            model: model.model,
+            max_tokens: maxTokens,
+            temperature,
+            ...(system ? { system } : {}),
+            ...(tools && tools.length > 0 ? { tools: tools.map(anthropicTool) } : {}),
+            messages: rest.map(anthropicMessage),
+        };
+    }
+    return {
+        model: model.model,
+        max_tokens: maxTokens,
+        temperature,
+        ...(tools && tools.length > 0 ? { tools: tools.map(openaiTool) } : {}),
+        messages: messages.map(openaiMessage),
+    };
+}
+function openaiTool(tool) {
+    return {
+        type: 'function',
+        function: { name: tool.name, description: tool.description, parameters: tool.parameters },
+    };
+}
+function anthropicTool(tool) {
+    return { name: tool.name, description: tool.description, input_schema: tool.parameters };
+}
+function openaiMessage(message) {
+    if (message.role === 'tool') {
+        return { role: 'tool', tool_call_id: message.toolCallId ?? '', content: message.content };
+    }
+    if (message.role === 'assistant' && message.toolCalls && message.toolCalls.length > 0) {
+        return {
+            role: 'assistant',
+            content: message.content || null,
+            tool_calls: message.toolCalls.map(call => ({
+                id: call.id,
+                type: 'function',
+                function: { name: call.name, arguments: JSON.stringify(call.arguments ?? {}) },
+            })),
+        };
+    }
+    return { role: message.role, content: message.content };
+}
+function anthropicMessage(message) {
+    if (message.role === 'tool') {
+        return {
+            role: 'user',
+            content: [{ type: 'tool_result', tool_use_id: message.toolCallId ?? '', content: message.content }],
+        };
+    }
+    if (message.role === 'assistant' && message.toolCalls && message.toolCalls.length > 0) {
+        const blocks = [];
+        if (message.content)
+            blocks.push({ type: 'text', text: message.content });
+        for (const call of message.toolCalls) {
+            blocks.push({ type: 'tool_use', id: call.id, name: call.name, input: call.arguments ?? {} });
+        }
+        return { role: 'assistant', content: blocks };
+    }
+    return { role: message.role, content: message.content };
+}
+/** 解析一轮响应：文字 + 工具调用。 */
+export function parseChatTurn(payload, api = 'openai-completions') {
+    const root = payload;
+    if (!root)
+        return { content: '', toolCalls: [] };
+    if (api === 'anthropic-messages') {
+        const blocks = Array.isArray(root.content) ? root.content : [];
+        const content = blocks
+            .filter((block) => block?.type === 'text')
+            .map((block) => String(block.text ?? ''))
+            .join('')
+            .trim();
+        const toolCalls = blocks
+            .filter((block) => block?.type === 'tool_use')
+            .map((block) => ({
+            id: String(block.id ?? ''),
+            name: String(block.name ?? ''),
+            arguments: block.input ?? {},
+        }));
+        return { content, toolCalls };
+    }
+    const message = root.choices?.[0]?.message;
+    const content = parseChatContent(message?.content);
+    const rawCalls = Array.isArray(message?.tool_calls) ? message.tool_calls : [];
+    const toolCalls = rawCalls.map((call) => ({
+        id: String(call?.id ?? ''),
+        name: String(call?.function?.name ?? ''),
+        arguments: parseToolArguments(call?.function?.arguments),
+    }));
+    return { content, toolCalls };
+}
+/** 从返回里取文本；兼容 OpenAI 的字符串 / 分段数组与 Anthropic 的 content 数组。 */
+export function parseChatText(payload, api = 'openai-completions') {
+    const root = payload;
+    if (!root)
+        return '';
+    if (api === 'anthropic-messages') {
+        const blocks = Array.isArray(root.content) ? root.content : [];
+        return blocks
+            .map((block) => (block && typeof block.text === 'string' ? block.text : ''))
+            .join('')
+            .trim();
+    }
+    return parseChatContent(root.choices?.[0]?.message?.content);
+}
+function parseChatContent(content) {
+    if (typeof content === 'string')
+        return content.trim();
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => (part && part.type === 'text' ? String(part.text ?? '') : ''))
+            .join('')
+            .trim();
+    }
+    return '';
+}
+/** 工具参数可能是 JSON 字符串，也可能是已经解析好的对象。 */
+export function parseToolArguments(raw) {
+    if (raw && typeof raw === 'object')
+        return raw;
+    if (typeof raw !== 'string' || !raw.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function isAbortError(error) {
+    return error instanceof Error && (error.name === 'AbortError' || /aborted/i.test(error.message));
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 基础设施包入口。
+ *
+ * `chat.ts` 与 `vision.ts` 各自保留了同名的 OpenAI 地址规范化函数（错误码不同），
+ * 这里显式只导出 chat 版本，避免 barrel 出现二义性；vision 版本仍可从模块深路径引用。
+ */
+export * from './logger.js';
+export * from './process.js';
+export * from './chat.js';
+export * from './plugin-loader.js';
+export * from './plugin-install.js';
+export { createVisionTranscriber, type ImageInput, type ImageTranscriber, type VisionModelConfig, } from './vision.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * 基础设施包入口。
+ *
+ * `chat.ts` 与 `vision.ts` 各自保留了同名的 OpenAI 地址规范化函数（错误码不同），
+ * 这里显式只导出 chat 版本，避免 barrel 出现二义性；vision 版本仍可从模块深路径引用。
+ */
+export * from './logger.js';
+export * from './process.js';
+export * from './chat.js';
+export * from './plugin-loader.js';
+export * from './plugin-install.js';
+export { createVisionTranscriber, } from './vision.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/infra/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,OAAO,EACL,uBAAuB,GAIxB,MAAM,aAAa,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 结构化日志的统一入口。
+ *
+ * 服务日志一行一个 JSON（`at` / `level` / `message` + 业务字段），
+ * 面板日志页按 info / warn / error 三档过滤，所以这里只保留这三档。
+ * 各模块只依赖这个接口，不直接碰文件，方便测试注入与将来换实现。
+ */
+export interface Logger {
+    info(message: string, extra?: Record<string, unknown>): void;
+    warn(message: string, extra?: Record<string, unknown>): void;
+    error(message: string, extra?: Record<string, unknown>): void;
+}
+/** 未注入日志实现时的空实现；关键链路不会因为「没传 logger」而崩。 */
+export declare const noopLogger: Logger;
+/** 把任意异常折成一行可读文本；日志里不写堆栈，避免刷屏。 */
+export declare function errorMessage(error: unknown): string;

package/dist/logger.js

@@ -0,0 +1,11 @@
+/** 未注入日志实现时的空实现；关键链路不会因为「没传 logger」而崩。 */
+export const noopLogger = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/** 把任意异常折成一行可读文本；日志里不写堆栈，避免刷屏。 */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../packages/infra/src/logger.ts"],"names":[],"mappings":"AAaA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAA;AAED,kCAAkC;AAClC,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/D,CAAC"}

package/dist/plugin-install.d.ts

@@ -0,0 +1,45 @@
+import { type Logger } from './logger.js';
+/** npm 执行器；测试里可以注入假的实现。 */
+export type NpmRunner = (args: string[], opts: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    timeoutMs: number;
+    onLine: (line: string) => void;
+}) => Promise<number>;
+export interface PluginInstallOptions {
+    home: string;
+    /** 纯 npm 包名，不能是本地路径。 */
+    packageName: string;
+    /** 精确版本或 'latest'；缺省 latest。 */
+    version?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    onLine?: (line: string) => void;
+    logger?: Logger;
+    /** 测试注入：执行 npm，返回退出码。 */
+    runNpm?: NpmRunner;
+}
+export interface PluginInstallResult {
+    ok: boolean;
+    version?: string;
+    log: string[];
+    error?: string;
+}
+/**
+ * 从插件入口里取出 npm 包名。
+ *
+ * 本地路径（`./x` / `/x` / `file:`）、URL 和带空格的写法都返回 undefined；
+ * 调用方据此区分「需要安装」与「重启即可生效」。
+ */
+export declare function npmPackageNameOf(value: string): string | undefined;
+/** npm 全局安装的同一套命令名：Windows 上是 npm.cmd。 */
+export declare function npmBin(): string;
+/** 读已安装包的版本；没装或 package.json 损坏时返回 null。 */
+export declare function installedPluginVersion(home: string, packageName: string): string | null;
+/**
+ * 把 npm 包安装到 `<RA_HOME>/node_modules`。
+ *
+ * 安装完成后会用插件加载器同一套解析逻辑确认包能被找到；解析不到的包
+ * 即使用 npm 装上了，服务重启时也加载不了，所以这里按失败返回。
+ */
+export declare function installPluginPackage(opts: PluginInstallOptions): Promise<PluginInstallResult>;