@vegamo/loom 0.1.1

package/dist/agents/memory/memory.js.map

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

package/dist/agents/memory/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Memory 类型定义
+ */
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions.js';
+/** 对话历史配置 */
+export interface MemoryConfig {
+    /** 最大保留的消息轮数 (一问一答算两条) */
+    maxMessages?: number;
+}
+/** 对话历史快照 */
+export interface ConversationSnapshot {
+    messages: ChatCompletionMessageParam[];
+    messageCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/memory/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/agents/memory/types.js

@@ -0,0 +1,5 @@
+/**
+ * Memory 类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/memory/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Loom CLI 入口
+ *
+ * 子命令:
+ *   loom chat               — TUI 对话，生成 JSON Schema
+ *   loom view [--port]      — Web 文档查看器
+ *   loom mock [--port]      — Mock 服务
+ *   loom serve [--port]     — 文档查看 + Mock 合一
+ *   loom manifest rebuild   — 重建 docs manifest 索引
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Loom CLI 入口
+ *
+ * 子命令:
+ *   loom chat               — TUI 对话，生成 JSON Schema
+ *   loom view [--port]      — Web 文档查看器
+ *   loom mock [--port]      — Mock 服务
+ *   loom serve [--port]     — 文档查看 + Mock 合一
+ *   loom manifest rebuild   — 重建 docs manifest 索引
+ */
+import { Command } from 'commander';
+import { loadConfig, getOutDir } from './shared/config.js';
+import { ensureChatConfig } from './shared/config-wizard.js';
+import { logger } from './shared/logger.js';
+const program = new Command();
+program
+    .name('loom')
+    .description('AI-powered JSON Schema document generator')
+    .version('0.1.0');
+// ============================================================
+// loom chat
+// ============================================================
+program
+    .command('chat')
+    .description('Start TUI to generate JSON Schema documents via AI')
+    .option('-d, --dir <path>', 'Target project directory', process.cwd())
+    .action(async (opts) => {
+    const config = await ensureChatConfig(opts.dir);
+    const { render } = await import('ink');
+    const React = await import('react');
+    const { App } = await import('./tui/app.js');
+    const agentConfig = {
+        loomConfig: config,
+        projectDir: opts.dir,
+    };
+    render(React.createElement(App, { agentConfig }));
+});
+// ============================================================
+// loom view
+// ============================================================
+program
+    .command('view')
+    .description('Start web documentation viewer')
+    .option('-p, --port <number>', 'Port number', '3000')
+    .option('-d, --dir <path>', 'Target project directory', process.cwd())
+    .action(async (opts) => {
+    const config = loadConfig(opts.dir);
+    const port = parseInt(opts.port, 10) || config.serve.port;
+    const docsDir = getOutDir(config, opts.dir);
+    const { startViewServer } = await import('./view/server.js');
+    await startViewServer({ port, docsDir });
+});
+// ============================================================
+// loom mock
+// ============================================================
+program
+    .command('mock')
+    .description('Start mock API server based on JSON Schemas')
+    .option('-p, --port <number>', 'Port number', '3001')
+    .option('-d, --dir <path>', 'Target project directory', process.cwd())
+    .action(async (opts) => {
+    const config = loadConfig(opts.dir);
+    const port = parseInt(opts.port, 10) || config.mock.port;
+    const docsDir = getOutDir(config, opts.dir);
+    const { startMockServer } = await import('./mocks/server.js');
+    await startMockServer({ port, docsDir });
+});
+// ============================================================
+// loom serve
+// ============================================================
+program
+    .command('serve')
+    .description('Start combined web viewer + mock server')
+    .option('-p, --port <number>', 'Port number', '3000')
+    .option('-d, --dir <path>', 'Target project directory', process.cwd())
+    .action(async (opts) => {
+    const config = loadConfig(opts.dir);
+    const port = parseInt(opts.port, 10) || config.serve.port;
+    const docsDir = getOutDir(config, opts.dir);
+    const { startServe } = await import('./serve.js');
+    await startServe({ port, docsDir });
+});
+// ============================================================
+// loom manifest
+// ============================================================
+const manifestCommand = program
+    .command('manifest')
+    .description('Manifest utilities');
+manifestCommand
+    .command('rebuild')
+    .description('Rebuild docs manifest index')
+    .option('-d, --dir <path>', 'Target project directory', process.cwd())
+    .action(async (opts) => {
+    const config = loadConfig(opts.dir);
+    const docsDir = getOutDir(config, opts.dir);
+    const { rebuildManifest } = await import('./shared/manifest-utils.js');
+    const manifest = rebuildManifest(docsDir);
+    logger.success(`Manifest rebuilt at ${docsDir}/.loom-manifest.json`);
+    logger.info(`Indexed ${manifest.endpointIndex.length} endpoints, ` +
+        `${manifest.entities.length} entities, ${manifest.references.length} references.`);
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/llm/client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * LLM 客户端
+ *
+ * 基于 OpenAI SDK，通过配置 baseURL 兼容 DeepSeek 等提供商
+ *
+ * 能力:
+ * - 非 streaming 完整请求 (chat)
+ * - Streaming 逐字输出 (chatStream)
+ * - 自动重试 (可重试错误)
+ * - 超时控制
+ * - AbortController 取消
+ */
+import type { LLMConfig } from '../shared/types.js';
+import type { LLMRequest, LLMResponse, LLMStreamCallback } from './types.js';
+export declare class LLMClient {
+    private client;
+    private config;
+    constructor(config: LLMConfig);
+    /**
+     * 发送完整聊天请求 (等待全部响应)
+     */
+    chat(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * 发送 streaming 聊天请求
+     *
+     * 通过回调逐步接收文本片段和 tool call 信息
+     * 最终返回完整的 LLMResponse
+     */
+    chatStream(request: LLMRequest, onEvent: LLMStreamCallback): Promise<LLMResponse>;
+    /**
+     * 解析非 streaming 响应
+     */
+    private parseResponse;
+    /**
+     * 带重试的执行器
+     *
+     * 自动处理:
+     * - 可重试错误的指数退避重试
+     * - 外部 AbortSignal 取消
+     * - OpenAI SDK 错误的统一转换
+     */
+    private withRetry;
+    /**
+     * 将各种错误统一转换为 LLMError
+     */
+    private normalizeError;
+    private sleep;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAYpB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAuB7B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCrD;;;;;OAKG;IACG,UAAU,CACd,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC;IA6FvB;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;;;;;;OAOG;YACW,SAAS;IA+CvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuDtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/llm/client.js

@@ -0,0 +1,256 @@
+/**
+ * LLM 客户端
+ *
+ * 基于 OpenAI SDK，通过配置 baseURL 兼容 DeepSeek 等提供商
+ *
+ * 能力:
+ * - 非 streaming 完整请求 (chat)
+ * - Streaming 逐字输出 (chatStream)
+ * - 自动重试 (可重试错误)
+ * - 超时控制
+ * - AbortController 取消
+ */
+import OpenAI from 'openai';
+import { LLMError } from './types.js';
+import { resolveLLMConfig } from './config.js';
+import { logger } from '../shared/logger.js';
+/** 默认超时 (ms) */
+const DEFAULT_TIMEOUT = 120_000;
+/** 默认最大重试次数 */
+const DEFAULT_MAX_RETRIES = 2;
+/** 重试间隔基数 (ms) */
+const RETRY_BASE_DELAY = 1000;
+export class LLMClient {
+    client;
+    config;
+    constructor(config) {
+        this.config = resolveLLMConfig(config);
+        if (!this.config.apiKey) {
+            throw new LLMError(`API key not found for provider "${this.config.provider}". ` +
+                `Set it in loom.config.json.`, 'auth_error');
+        }
+        this.client = new OpenAI({
+            apiKey: this.config.apiKey,
+            baseURL: this.config.baseURL,
+            timeout: DEFAULT_TIMEOUT,
+            maxRetries: 0, // 我们自己控制重试
+        });
+    }
+    // ============================================================
+    // 非 streaming 请求
+    // ============================================================
+    /**
+     * 发送完整聊天请求 (等待全部响应)
+     */
+    async chat(request) {
+        return this.withRetry(async (signal) => {
+            logger.debug(`LLM request: ${request.messages.length} messages`);
+            const response = await this.client.chat.completions.create({
+                model: this.config.model,
+                messages: request.messages,
+                tools: request.tools?.length ? request.tools : undefined,
+                temperature: request.temperature ?? this.config.temperature ?? 0.7,
+                max_tokens: request.maxTokens ?? this.config.maxTokens,
+            }, { signal });
+            const choice = response.choices[0];
+            if (!choice) {
+                throw new LLMError('Empty response from LLM', 'invalid_response');
+            }
+            const result = this.parseResponse(choice, response.usage);
+            logger.debug(`LLM response: content=${result.content?.length ?? 0} chars, ` +
+                `toolCalls=${result.toolCalls.length}, ` +
+                `finish=${result.finishReason}`);
+            return result;
+        }, request.signal);
+    }
+    // ============================================================
+    // Streaming 请求
+    // ============================================================
+    /**
+     * 发送 streaming 聊天请求
+     *
+     * 通过回调逐步接收文本片段和 tool call 信息
+     * 最终返回完整的 LLMResponse
+     */
+    async chatStream(request, onEvent) {
+        return this.withRetry(async (signal) => {
+            logger.debug(`LLM stream request: ${request.messages.length} messages`);
+            const stream = await this.client.chat.completions.create({
+                model: this.config.model,
+                messages: request.messages,
+                tools: request.tools?.length ? request.tools : undefined,
+                temperature: request.temperature ?? this.config.temperature ?? 0.7,
+                max_tokens: request.maxTokens ?? this.config.maxTokens,
+                stream: true,
+            }, { signal });
+            // 累积状态
+            let contentBuffer = '';
+            let finishReason = '';
+            const toolCallBuffers = new Map();
+            for await (const chunk of stream) {
+                const delta = chunk.choices[0]?.delta;
+                if (!delta)
+                    continue;
+                // 文本内容增量
+                if (delta.content) {
+                    contentBuffer += delta.content;
+                    onEvent({ type: 'content_delta', delta: delta.content });
+                }
+                // Tool call 增量 (tool call 是分片传来的)
+                if (delta.tool_calls) {
+                    for (const tc of delta.tool_calls) {
+                        const idx = tc.index;
+                        if (!toolCallBuffers.has(idx)) {
+                            toolCallBuffers.set(idx, { id: '', name: '', arguments: '' });
+                        }
+                        const buf = toolCallBuffers.get(idx);
+                        if (tc.id)
+                            buf.id = tc.id;
+                        if (tc.function?.name)
+                            buf.name += tc.function.name;
+                        if (tc.function?.arguments)
+                            buf.arguments += tc.function.arguments;
+                        onEvent({
+                            type: 'tool_call_delta',
+                            toolCall: {
+                                index: idx,
+                                id: buf.id || undefined,
+                                function: { name: buf.name, arguments: buf.arguments },
+                            },
+                        });
+                    }
+                }
+                // finish reason
+                if (chunk.choices[0]?.finish_reason) {
+                    finishReason = chunk.choices[0].finish_reason;
+                }
+            }
+            // 组装最终响应
+            const toolCalls = Array.from(toolCallBuffers.values())
+                .filter((tc) => tc.id && tc.name)
+                .map((tc) => ({
+                id: tc.id,
+                function: { name: tc.name, arguments: tc.arguments },
+            }));
+            const result = {
+                content: contentBuffer || null,
+                toolCalls,
+                finishReason,
+            };
+            onEvent({ type: 'done', response: result });
+            logger.debug(`LLM stream done: content=${contentBuffer.length} chars, ` +
+                `toolCalls=${toolCalls.length}, finish=${finishReason}`);
+            return result;
+        }, request.signal);
+    }
+    // ============================================================
+    // 内部工具方法
+    // ============================================================
+    /**
+     * 解析非 streaming 响应
+     */
+    parseResponse(choice, usage) {
+        const parsedUsage = usage
+            ? {
+                promptTokens: usage.prompt_tokens,
+                completionTokens: usage.completion_tokens,
+                totalTokens: usage.total_tokens,
+            }
+            : undefined;
+        return {
+            content: choice.message.content,
+            toolCalls: (choice.message.tool_calls || [])
+                .filter((tc) => tc.type === 'function')
+                .map((tc) => ({
+                id: tc.id,
+                function: {
+                    name: tc.function.name,
+                    arguments: tc.function.arguments,
+                },
+            })),
+            finishReason: choice.finish_reason ?? undefined,
+            usage: parsedUsage,
+        };
+    }
+    /**
+     * 带重试的执行器
+     *
+     * 自动处理:
+     * - 可重试错误的指数退避重试
+     * - 外部 AbortSignal 取消
+     * - OpenAI SDK 错误的统一转换
+     */
+    async withRetry(fn, externalSignal) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= DEFAULT_MAX_RETRIES; attempt++) {
+            // 检查外部取消
+            if (externalSignal?.aborted) {
+                throw new LLMError('Request aborted', 'aborted');
+            }
+            // 合并内外超时信号
+            const timeoutController = new AbortController();
+            const timeout = setTimeout(() => timeoutController.abort(), DEFAULT_TIMEOUT);
+            const combinedSignal = externalSignal
+                ? AbortSignal.any([externalSignal, timeoutController.signal])
+                : timeoutController.signal;
+            try {
+                const result = await fn(combinedSignal);
+                clearTimeout(timeout);
+                return result;
+            }
+            catch (err) {
+                clearTimeout(timeout);
+                const llmError = this.normalizeError(err);
+                lastError = llmError;
+                // 不可重试 或 已达最大重试次数 → 直接抛出
+                if (!llmError.retryable || attempt >= DEFAULT_MAX_RETRIES) {
+                    throw llmError;
+                }
+                // 指数退避等待
+                const delay = RETRY_BASE_DELAY * Math.pow(2, attempt);
+                logger.warn(`LLM request failed (attempt ${attempt + 1}/${DEFAULT_MAX_RETRIES + 1}), ` +
+                    `retrying in ${delay}ms: ${llmError.message}`);
+                await this.sleep(delay);
+            }
+        }
+        throw lastError || new LLMError('Unknown error', 'unknown');
+    }
+    /**
+     * 将各种错误统一转换为 LLMError
+     */
+    normalizeError(err) {
+        if (err instanceof LLMError)
+            return err;
+        if (err instanceof OpenAI.APIError) {
+            const status = err.status;
+            if (status === 401 || status === 403) {
+                return new LLMError(`Authentication failed: ${err.message}`, 'auth_error', { statusCode: status });
+            }
+            if (status === 429) {
+                return new LLMError(`Rate limit exceeded: ${err.message}`, 'rate_limit', { retryable: true, statusCode: status });
+            }
+            if (status && status >= 500) {
+                return new LLMError(`Server error: ${err.message}`, 'network_error', { retryable: true, statusCode: status });
+            }
+            return new LLMError(err.message, 'unknown', { statusCode: status });
+        }
+        if (err instanceof DOMException && err.name === 'AbortError') {
+            return new LLMError('Request aborted', 'aborted');
+        }
+        if (err instanceof Error) {
+            // 网络错误通常可重试
+            if (err.message.includes('ECONNREFUSED') ||
+                err.message.includes('ECONNRESET') ||
+                err.message.includes('ETIMEDOUT') ||
+                err.message.includes('fetch failed')) {
+                return new LLMError(`Network error: ${err.message}`, 'network_error', { retryable: true });
+            }
+            return new LLMError(err.message, 'unknown');
+        }
+        return new LLMError(String(err), 'unknown');
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/llm/client.js.map

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

package/dist/llm/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * LLM 配置管理
+ */
+import type { LLMConfig } from '../shared/types.js';
+/**
+ * 解析 LLM 配置，合并预置值
+ */
+export declare function resolveLLMConfig(config: LLMConfig): LLMConfig;
+/**
+ * 获取所有支持的预置 provider 名称
+ */
+export declare function getSupportedProviders(): string[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/llm/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgBpD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAW7D;AAiBD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}

package/dist/llm/config.js

@@ -0,0 +1,50 @@
+/**
+ * LLM 配置管理
+ */
+/** 预置的 LLM 提供商配置 */
+const PROVIDER_PRESETS = {
+    deepseek: {
+        baseURL: 'https://api.deepseek.com/v1',
+        model: 'deepseek-chat',
+        temperature: 0.7,
+    },
+    openai: {
+        baseURL: 'https://api.openai.com/v1',
+        model: 'gpt-4o',
+        temperature: 0.7,
+    },
+};
+/**
+ * 解析 LLM 配置，合并预置值
+ */
+export function resolveLLMConfig(config) {
+    const preset = PROVIDER_PRESETS[config.provider] || {};
+    const resolved = {
+        ...preset,
+        ...config,
+    };
+    // 配置校验
+    validateConfig(resolved);
+    return resolved;
+}
+/**
+ * 校验关键配置字段
+ */
+function validateConfig(config) {
+    if (!config.baseURL) {
+        throw new Error(`LLM config error: baseURL is required for provider "${config.provider}"`);
+    }
+    if (!config.model) {
+        throw new Error(`LLM config error: model is required for provider "${config.provider}"`);
+    }
+    if (!config.apiKey) {
+        throw new Error(`LLM config error: apiKey is required for provider "${config.provider}"`);
+    }
+}
+/**
+ * 获取所有支持的预置 provider 名称
+ */
+export function getSupportedProviders() {
+    return Object.keys(PROVIDER_PRESETS);
+}
+//# sourceMappingURL=config.js.map

package/dist/llm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/llm/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oBAAoB;AACpB,MAAM,gBAAgB,GAAuC;IAC3D,QAAQ,EAAE;QACR,OAAO,EAAE,6BAA6B;QACtC,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,GAAG;KACjB;IACD,MAAM,EAAE;QACN,OAAO,EAAE,2BAA2B;QACpC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,GAAG;KACjB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAc;QAC1B,GAAG,MAAM;QACT,GAAG,MAAM;KACV,CAAC;IAEF,OAAO;IACP,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAiB;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uDAAuD,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * LLM 相关类型定义
+ */
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions.js';
+/** LLM 请求参数 */
+export interface LLMRequest {
+    messages: ChatCompletionMessageParam[];
+    tools?: LLMToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    /** 用于取消请求 */
+    signal?: AbortSignal;
+}
+/** LLM 工具定义 (OpenAI function calling 格式) */
+export interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** LLM Tool Call 结果 */
+export interface LLMToolCall {
+    id: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** LLM 完整响应 */
+export interface LLMResponse {
+    content: string | null;
+    toolCalls: LLMToolCall[];
+    finishReason?: string;
+    usage?: LLMUsage;
+}
+/** Token 用量 */
+export interface LLMUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/** Streaming 事件类型 */
+export type LLMStreamEventType = 'content_delta' | 'tool_call_delta' | 'done' | 'error';
+/** Streaming 事件 */
+export interface LLMStreamEvent {
+    type: LLMStreamEventType;
+    /** content_delta 时为文本片段 */
+    delta?: string;
+    /** tool_call_delta 时的信息 */
+    toolCall?: Partial<LLMToolCall> & {
+        index?: number;
+    };
+    /** done 时的完整响应 */
+    response?: LLMResponse;
+    /** error 时的错误信息 */
+    error?: string;
+}
+/** Streaming 回调 */
+export type LLMStreamCallback = (event: LLMStreamEvent) => void;
+/** LLM 错误类型 */
+export type LLMErrorCode = 'auth_error' | 'rate_limit' | 'timeout' | 'network_error' | 'invalid_response' | 'aborted' | 'unknown';
+/** LLM 自定义错误 */
+export declare class LLMError extends Error {
+    code: LLMErrorCode;
+    retryable: boolean;
+    statusCode?: number;
+    constructor(message: string, code: LLMErrorCode, opts?: {
+        retryable?: boolean;
+        statusCode?: number;
+    });
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAMvF,eAAe;AACf,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAMD,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,eAAe;AACf,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAqB;AACrB,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,iBAAiB,GACjB,MAAM,GACN,OAAO,CAAC;AAEZ,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,kBAAkB;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mBAAmB;AACnB,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAMhE,eAAe;AACf,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,eAAe,GACf,kBAAkB,GAClB,SAAS,GACT,SAAS,CAAC;AAEd,gBAAgB;AAChB,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAOrG"}