@zhin.js/ai 0.0.1 → 0.0.2

package/lib/tools.js

@@ -0,0 +1,194 @@
+/**
+ * @zhin.js/ai - Built-in Tools
+ * 内置工具集合 - 使用 ZhinTool 类定义
+ */
+import { ZhinTool } from '@zhin.js/core';
+/**
+ * 计算器工具
+ * 支持基本运算和数学函数
+ */
+export const calculatorTool = new ZhinTool('calculator')
+    .desc('执行数学计算。支持基本运算（+、-、*、/、^）和数学函数（sin、cos、sqrt 等）')
+    .param('expression', { type: 'string', description: '数学表达式，例如 "2 + 3 * 4" 或 "sqrt(16)"' }, true)
+    .execute(async ({ expression }) => {
+    try {
+        // 安全的数学表达式求值
+        const sanitized = expression
+            .replace(/[^0-9+\-*/().^eEsincosqrtabspowlogxMathPI\s]/g, '')
+            .replace(/\bsqrt\b/g, 'Math.sqrt')
+            .replace(/\bsin\b/g, 'Math.sin')
+            .replace(/\bcos\b/g, 'Math.cos')
+            .replace(/\btan\b/g, 'Math.tan')
+            .replace(/\blog\b/g, 'Math.log')
+            .replace(/\babs\b/g, 'Math.abs')
+            .replace(/\bpow\b/g, 'Math.pow')
+            .replace(/\bPI\b/g, 'Math.PI')
+            .replace(/\bE\b(?![0-9])/g, 'Math.E')
+            .replace(/\^/g, '**');
+        const result = new Function(`return ${sanitized}`)();
+        return { result, expression };
+    }
+    catch (error) {
+        return { error: '无法计算表达式', expression };
+    }
+});
+/**
+ * 时间工具
+ * 获取当前时间和日期
+ */
+export const timeTool = new ZhinTool('get_time')
+    .desc('获取当前时间和日期信息')
+    .param('timezone', { type: 'string', description: '时区，例如 "Asia/Shanghai" 或 "UTC"' })
+    .param('format', { type: 'string', description: '输出格式: full(完整), date(日期), time(时间), timestamp(时间戳)' })
+    .execute(async ({ timezone, format = 'full' }) => {
+    const now = new Date();
+    const options = {
+        timeZone: timezone || 'Asia/Shanghai',
+    };
+    switch (format) {
+        case 'date':
+            options.dateStyle = 'full';
+            break;
+        case 'time':
+            options.timeStyle = 'long';
+            break;
+        case 'timestamp':
+            return { timestamp: now.getTime(), iso: now.toISOString() };
+        default:
+            options.dateStyle = 'full';
+            options.timeStyle = 'long';
+    }
+    return {
+        formatted: now.toLocaleString('zh-CN', options),
+        timestamp: now.getTime(),
+        iso: now.toISOString(),
+    };
+});
+/**
+ * 网页搜索工具
+ * 需要配置搜索 API
+ */
+export const searchTool = new ZhinTool('web_search')
+    .desc('在互联网上搜索信息（需要配置搜索 API）')
+    .param('query', { type: 'string', description: '搜索关键词' }, true)
+    .param('limit', { type: 'number', description: '返回结果数量（默认 5）' })
+    .execute(async ({ query, limit = 5 }) => {
+    // 默认实现提示需要配置
+    return {
+        query,
+        error: '搜索功能未配置，请提供搜索 API',
+        hint: '可以集成 SerpAPI、Bing Search API 或 Google Custom Search',
+    };
+});
+/**
+ * 代码执行工具
+ * 在安全沙箱中执行 JavaScript
+ */
+export const codeRunnerTool = new ZhinTool('run_code')
+    .desc('执行 JavaScript 代码（在安全沙箱中）')
+    .param('code', { type: 'string', description: 'JavaScript 代码' }, true)
+    .execute(async ({ code }) => {
+    try {
+        // 简单的沙箱执行（生产环境应使用 vm2 或 isolated-vm）
+        const result = new Function(`
+        'use strict';
+        const console = { log: (...args) => args.join(' ') };
+        return (function() { ${code} })();
+      `)();
+        return {
+            success: true,
+            result: result !== undefined ? String(result) : 'undefined',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+});
+/**
+ * HTTP 请求工具
+ * 发送 HTTP 请求获取数据
+ */
+export const httpTool = new ZhinTool('http_request')
+    .desc('发送 HTTP 请求获取数据')
+    .param('url', { type: 'string', description: '请求 URL' }, true)
+    .param('method', { type: 'string', description: 'HTTP 方法: GET, POST, PUT, DELETE（默认 GET）' })
+    .param('headers', { type: 'object', description: '请求头（JSON 对象）' })
+    .param('body', { type: 'string', description: '请求体（JSON 字符串）' })
+    .execute(async ({ url, method = 'GET', headers = {}, body }) => {
+    try {
+        const response = await fetch(url, {
+            method: method,
+            headers: {
+                'Content-Type': 'application/json',
+                ...headers,
+            },
+            body: body ? body : undefined,
+        });
+        const contentType = response.headers.get('content-type') || '';
+        let data;
+        if (contentType.includes('application/json')) {
+            data = await response.json();
+        }
+        else {
+            data = await response.text();
+            // 限制文本长度
+            if (data.length > 5000) {
+                data = data.substring(0, 5000) + '... (truncated)';
+            }
+        }
+        return {
+            status: response.status,
+            statusText: response.statusText,
+            data,
+        };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+});
+/**
+ * 记忆工具
+ * 让 AI 记住重要信息
+ */
+export const memoryTool = new ZhinTool('remember')
+    .desc('记住用户告诉你的重要信息，以便后续对话中使用')
+    .param('key', { type: 'string', description: '记忆的标识符，如 "user_name", "preference"' }, true)
+    .param('value', { type: 'string', description: '要记住的内容' }, true)
+    .execute(async ({ key, value }, context) => {
+    // 这里需要与 session/context manager 集成
+    return {
+        success: true,
+        message: `已记住 ${key}: ${value}`,
+        key,
+        value,
+    };
+});
+/**
+ * 获取所有内置工具（ZhinTool 实例）
+ * 注意：天气工具已移除，请使用 weather-tool 插件，支持多平台配置
+ */
+export function getBuiltinTools() {
+    return [
+        calculatorTool,
+        timeTool,
+    ];
+}
+/**
+ * 获取所有可用的内置工具（包括可选工具）
+ */
+export function getAllBuiltinTools() {
+    return [
+        calculatorTool,
+        timeTool,
+        searchTool,
+        codeRunnerTool,
+        httpTool,
+        memoryTool,
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,243 @@
+/**
+ * @zhin.js/ai - AI Service Types
+ * 统一的 AI 服务类型定义
+ */
+/** 消息角色 */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/** 聊天消息 */
+export interface ChatMessage {
+    role: MessageRole;
+    content: string | ContentPart[];
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: ToolCall[];
+}
+/** 内容部分（支持多模态） */
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+} | {
+    type: 'audio';
+    audio: {
+        data: string;
+        format: 'wav' | 'mp3';
+    };
+};
+/** 工具调用 */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** 工具定义 */
+export interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JsonSchema;
+    };
+}
+/** JSON Schema */
+export interface JsonSchema {
+    type: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: any[];
+    description?: string;
+    default?: any;
+    [key: string]: any;
+}
+/** 聊天补全请求 */
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    tools?: ToolDefinition[];
+    tool_choice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    stream?: boolean;
+    stop?: string | string[];
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    user?: string;
+}
+/** 聊天补全响应 */
+export interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage?: Usage;
+}
+/** 选择 */
+export interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+}
+/** 用量统计 */
+export interface Usage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/** 流式响应块 */
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: ChatCompletionChunkChoice[];
+    usage?: Usage;
+}
+/** 流式选择 */
+export interface ChatCompletionChunkChoice {
+    index: number;
+    delta: Partial<ChatMessage>;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+}
+/** Provider 配置 */
+export interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+/** Provider 接口 */
+export interface AIProvider {
+    name: string;
+    models: string[];
+    /** 聊天补全 */
+    chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /** 流式聊天补全 */
+    chatStream(request: ChatCompletionRequest): AsyncIterable<ChatCompletionChunk>;
+    /** 列出可用模型 */
+    listModels?(): Promise<string[]>;
+    /** 检查连接 */
+    healthCheck?(): Promise<boolean>;
+}
+/** Agent 工具 */
+export interface AgentTool {
+    name: string;
+    description: string;
+    parameters: JsonSchema;
+    execute: (args: Record<string, any>) => Promise<any>;
+}
+/** Agent 配置 */
+export interface AgentConfig {
+    provider: string;
+    model?: string;
+    systemPrompt?: string;
+    tools?: AgentTool[];
+    maxIterations?: number;
+    temperature?: number;
+}
+/** Agent 运行结果 */
+export interface AgentResult {
+    content: string;
+    toolCalls: {
+        tool: string;
+        args: Record<string, any>;
+        result: any;
+    }[];
+    usage: Usage;
+    iterations: number;
+}
+/** 会话配置 */
+export interface SessionConfig {
+    provider: string;
+    model?: string;
+    systemPrompt?: string;
+    maxHistory?: number;
+    expireMs?: number;
+}
+/** 会话 */
+export interface Session {
+    id: string;
+    config: SessionConfig;
+    messages: ChatMessage[];
+    createdAt: number;
+    updatedAt: number;
+    metadata?: Record<string, any>;
+}
+/** AI 服务配置 */
+export interface AIConfig {
+    enabled?: boolean;
+    defaultProvider?: string;
+    providers?: {
+        openai?: ProviderConfig;
+        anthropic?: ProviderConfig;
+        deepseek?: ProviderConfig;
+        moonshot?: ProviderConfig;
+        zhipu?: ProviderConfig;
+        ollama?: ProviderConfig & {
+            host?: string;
+            models?: string[];
+        };
+        custom?: ProviderConfig[];
+    };
+    sessions?: {
+        /** 最大历史消息数（数据库模式默认200，内存模式默认100） */
+        maxHistory?: number;
+        /** 会话过期时间（毫秒，数据库模式默认7天，内存模式默认24小时） */
+        expireMs?: number;
+        /** 是否使用数据库持久化存储（默认 true） */
+        useDatabase?: boolean;
+    };
+    context?: {
+        /** 是否启用消息记录（默认 true） */
+        enabled?: boolean;
+        /** 读取的最近消息数量（默认 100） */
+        maxRecentMessages?: number;
+        /** 触发总结的消息数量阈值（默认 50） */
+        summaryThreshold?: number;
+        /** 总结后保留的消息数量（默认 10） */
+        keepAfterSummary?: number;
+        /** 上下文最大 token 估算（默认 4000） */
+        maxContextTokens?: number;
+        /** 自定义总结提示词 */
+        summaryPrompt?: string;
+    };
+    /** AI 触发配置 */
+    trigger?: {
+        /** 是否启用（默认 true） */
+        enabled?: boolean;
+        /** 触发前缀列表（默认 ['#', 'AI:']） */
+        prefixes?: string[];
+        /** 是否响应 @ 机器人（默认 true） */
+        respondToAt?: boolean;
+        /** 是否响应私聊（默认 true） */
+        respondToPrivate?: boolean;
+        /** 触发关键词（可选） */
+        keywords?: string[];
+        /** 忽略的前缀（命令前缀，避免与命令冲突，默认 ['/', '!', '！']） */
+        ignorePrefixes?: string[];
+        /** 超时时间（毫秒，默认 60000） */
+        timeout?: number;
+        /** 思考中提示语（可选，设置后会在处理前发送） */
+        thinkingMessage?: string;
+        /** 错误提示模板（默认 '❌ AI 处理失败: {error}'） */
+        errorTemplate?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,WAAW;AACX,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,kBAAkB;AAClB,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,CAAA;CAAE,CAAC;AAEtE,WAAW;AACX,MAAM,WAAW,QAAQ;IACvB,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,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,UAAU,CAAC;KACxB,CAAC;CACH;AAED,kBAAkB;AAClB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAMD,aAAa;AACb,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,aAAa;AACb,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,CAAC;CACf;AAED,SAAS;AACT,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;CAC3E;AAED,WAAW;AACX,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,YAAY;AACZ,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,WAAW;AACX,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;CAC3E;AAMD,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,kBAAkB;AAClB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,WAAW;IACX,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEtE,aAAa;IACb,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAE/E,aAAa;IACb,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjC,WAAW;IACX,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAMD,eAAe;AACf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACtD;AAED,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,CAAC;KACb,EAAE,CAAC;IACJ,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,SAAS;AACT,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAMD,cAAc;AACd,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,MAAM,CAAC,EAAE,cAAc,GAAG;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QAC/D,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,oCAAoC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,sCAAsC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,4BAA4B;QAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,wBAAwB;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,wBAAwB;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,yBAAyB;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,wBAAwB;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,8BAA8B;QAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc;IACd,OAAO,CAAC,EAAE;QACR,oBAAoB;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,8BAA8B;QAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,0BAA0B;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,sBAAsB;QACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,gBAAgB;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,6CAA6C;QAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,wBAAwB;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,4BAA4B;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,sCAAsC;QACtC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH"}

package/lib/types.js

@@ -0,0 +1,6 @@
+/**
+ * @zhin.js/ai - AI Service Types
+ * 统一的 AI 服务类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/ai",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "AI Service for Zhin.js - Multi-model LLM integration with Agent capabilities",
   "type": "module",
   "main": "./lib/index.js",
@@ -45,22 +45,22 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf lib"
-  },
   "dependencies": {
     "eventsource-parser": "^3.0.0",
     "segment-matcher": "latest"
   },
   "peerDependencies": {
-    "@zhin.js/core": "workspace:*",
-    "@zhin.js/logger": "workspace:*"
+    "@zhin.js/core": "1.0.25",
+    "@zhin.js/logger": "0.1.9"
   },
   "devDependencies": {
     "@types/node": "latest",
     "typescript": "^5.3.0",
-    "@zhin.js/core": "workspace:*",
-    "@zhin.js/logger": "workspace:*"
+    "@zhin.js/core": "1.0.25",
+    "@zhin.js/logger": "0.1.9"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf lib"
   }
-}
+}