@zhin.js/ai 0.0.2 → 1.0.1

package/lib/storage.js

@@ -0,0 +1,105 @@
+/**
+ * StorageBackend — Unified storage abstraction layer
+ *
+ * Provides a common interface for AI sub-systems (session, context, memory,
+ * user profile, follow-up) to switch between in-memory and database backends
+ * without changing business logic.
+ *
+ * Usage:
+ *   const backend = new MemoryStorageBackend<MyRecord>();
+ *   // ... later, when DB is ready:
+ *   const dbBackend = new DatabaseStorageBackend<MyRecord>(model, { keyField: 'session_id' });
+ *   service.upgradeBackend(dbBackend);
+ */
+/**
+ * In-memory storage backend.
+ */
+export class MemoryStorageBackend {
+    type = 'memory';
+    data = new Map();
+    async get(key) {
+        return this.data.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.data.set(key, value);
+    }
+    async delete(key) {
+        return this.data.delete(key);
+    }
+    async list(filter) {
+        const all = Array.from(this.data.values());
+        if (!filter)
+            return all;
+        return all.filter(item => {
+            for (const [k, v] of Object.entries(filter)) {
+                if (item[k] !== v)
+                    return false;
+            }
+            return true;
+        });
+    }
+    async clear() {
+        this.data.clear();
+    }
+}
+/**
+ * Database-backed storage backend.
+ */
+export class DatabaseStorageBackend {
+    model;
+    options;
+    type = 'database';
+    constructor(model, options) {
+        this.model = model;
+        this.options = options;
+    }
+    async get(key) {
+        const rows = await this.model
+            .select()
+            .where({ [this.options.keyField]: key });
+        return rows[0] ?? null;
+    }
+    async set(key, value) {
+        const existing = await this.get(key);
+        if (existing) {
+            await this.model
+                .update(value)
+                .where({ [this.options.keyField]: key });
+        }
+        else {
+            await this.model.create({ ...value, [this.options.keyField]: key });
+        }
+    }
+    async delete(key) {
+        try {
+            await this.model.delete({ [this.options.keyField]: key });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async list(filter) {
+        if (filter) {
+            return this.model.select().where(filter);
+        }
+        return this.model.select();
+    }
+    async clear() {
+        const all = await this.list();
+        for (const item of all) {
+            const key = item[this.options.keyField];
+            if (key)
+                await this.delete(key);
+        }
+    }
+}
+/**
+ * Helper to create a swappable backend ref.
+ * Call `swap(newBackend)` to atomically upgrade from memory to database.
+ */
+export function createSwappableBackend(initial) {
+    const ref = { backend: initial, swap: (next) => { ref.backend = next; } };
+    return ref;
+}
+//# sourceMappingURL=storage.js.map

package/lib/storage.js.map

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

package/lib/tone-detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ToneDetector — 轻量级情绪/语气检测
+ *
+ * 通过标点符号、emoji 密度、关键词分析用户语气，
+ * 生成一条 hint 注入 system prompt，让 AI 的回复匹配用户情绪。
+ *
+ * 零 LLM 开销，纯正则/统计分析。
+ */
+export type Tone = 'neutral' | 'frustrated' | 'excited' | 'questioning' | 'sad' | 'urgent';
+interface ToneResult {
+    tone: Tone;
+    hint: string;
+}
+/**
+ * 检测用户消息的情绪语气
+ */
+export declare function detectTone(message: string): ToneResult;
+export {};
+//# sourceMappingURL=tone-detector.d.ts.map

package/lib/tone-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tone-detector.d.ts","sourceRoot":"","sources":["../src/tone-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3F,UAAU,UAAU;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAQD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA+DtD"}

package/lib/tone-detector.js

@@ -0,0 +1,72 @@
+/**
+ * ToneDetector — 轻量级情绪/语气检测
+ *
+ * 通过标点符号、emoji 密度、关键词分析用户语气，
+ * 生成一条 hint 注入 system prompt，让 AI 的回复匹配用户情绪。
+ *
+ * 零 LLM 开销，纯正则/统计分析。
+ */
+// 常见负面情绪词
+const FRUSTRATED_WORDS = /不行|不对|又错|还是不|怎么回事|搞不定|烦死|崩溃|无语|什么鬼|bug|报错|失败|出问题/;
+const SAD_WORDS = /难过|伤心|失落|遗憾|可惜|唉|哎|不开心|郁闷|心累/;
+const URGENT_WORDS = /急|赶紧|马上|立刻|紧急|尽快|快点|asap|hurry/i;
+const EXCITED_WORDS = /太好了|太棒了|厉害|牛|可以|成功|搞定|完美|赞|nice|amazing|awesome|cool/i;
+/**
+ * 检测用户消息的情绪语气
+ */
+export function detectTone(message) {
+    const len = message.length;
+    if (len === 0)
+        return { tone: 'neutral', hint: '' };
+    // 统计特征
+    const exclamations = (message.match(/!/g) || []).length + (message.match(/！/g) || []).length;
+    const questions = (message.match(/\?/g) || []).length + (message.match(/？/g) || []).length;
+    const ellipsis = (message.match(/\.\.\./g) || []).length + (message.match(/…/g) || []).length;
+    const capsRatio = len > 5 ? (message.match(/[A-Z]/g) || []).length / len : 0;
+    // emoji 检测（常见 Unicode 范围）
+    const emojiCount = (message.match(/[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}]/gu) || []).length;
+    // 关键词检测
+    const isFrustrated = FRUSTRATED_WORDS.test(message);
+    const isSad = SAD_WORDS.test(message);
+    const isUrgent = URGENT_WORDS.test(message);
+    const isExcited = EXCITED_WORDS.test(message);
+    // 判定优先级: frustrated > urgent > sad > excited > questioning > neutral
+    if (isFrustrated || (exclamations >= 3 && !isExcited)) {
+        return {
+            tone: 'frustrated',
+            hint: '用户似乎有些沮丧或受挫，请用耐心、理解的语气回复，先表示共情再提供帮助。',
+        };
+    }
+    if (isUrgent) {
+        return {
+            tone: 'urgent',
+            hint: '用户似乎很着急，请直接给出解决方案，减少寒暄，优先效率。',
+        };
+    }
+    if (isSad || ellipsis >= 2) {
+        return {
+            tone: 'sad',
+            hint: '用户的语气似乎有些低落，请用温暖、关心的语气回复。',
+        };
+    }
+    if (isExcited || (emojiCount >= 2 && exclamations >= 1)) {
+        return {
+            tone: 'excited',
+            hint: '用户的心情不错，可以用更活泼、热情的语气回复。',
+        };
+    }
+    if (questions >= 2 || (questions >= 1 && len < 20)) {
+        return {
+            tone: 'questioning',
+            hint: '', // 提问是正常的，不需要特殊 hint
+        };
+    }
+    if (capsRatio > 0.5 && len > 10) {
+        return {
+            tone: 'frustrated',
+            hint: '用户使用了大量大写字母，可能在表达强烈情绪，请注意语气。',
+        };
+    }
+    return { tone: 'neutral', hint: '' };
+}
+//# sourceMappingURL=tone-detector.js.map

package/lib/tone-detector.js.map

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

package/lib/types.d.ts

@@ -3,7 +3,7 @@
  * 统一的 AI 服务类型定义
  */
 /** 消息角色 */
-export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool' | 'tool_call' | 'tool_result';
 /** 聊天消息 */
 export interface ChatMessage {
     role: MessageRole;
@@ -53,9 +53,10 @@ export interface JsonSchema {
     properties?: Record<string, JsonSchema>;
     required?: string[];
     items?: JsonSchema;
-    enum?: any[];
+    enum?: unknown[];
     description?: string;
-    default?: any;
+    default?: unknown;
+    /** JSON Schema allows arbitrary extension properties */
     [key: string]: any;
 }
 /** 聊天补全请求 */
@@ -77,6 +78,8 @@ export interface ChatCompletionRequest {
     presence_penalty?: number;
     frequency_penalty?: number;
     user?: string;
+    /** 是否启用模型思考（如 qwen3 的 <think> 模式）。设为 false 可跳过思考加速响应。 */
+    think?: boolean;
 }
 /** 聊天补全响应 */
 export interface ChatCompletionResponse {
@@ -114,14 +117,26 @@ export interface ChatCompletionChunkChoice {
     delta: Partial<ChatMessage>;
     finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
 }
+/** Provider 能力声明 */
+export interface ProviderCapabilities {
+    vision?: boolean;
+    streaming?: boolean;
+    toolCalling?: boolean;
+    thinking?: boolean;
+}
 /** Provider 配置 */
 export interface ProviderConfig {
     apiKey?: string;
     baseUrl?: string;
     defaultModel?: string;
+    models?: string[];
     timeout?: number;
     maxRetries?: number;
     headers?: Record<string, string>;
+    /** 上下文窗口大小（token 数），各 Provider 映射到自身参数 */
+    contextWindow?: number;
+    /** Provider 能力声明 */
+    capabilities?: ProviderCapabilities;
 }
 /** Provider 接口 */
 export interface AIProvider {
@@ -135,13 +150,56 @@ export interface AIProvider {
     listModels?(): Promise<string[]>;
     /** 检查连接 */
     healthCheck?(): Promise<boolean>;
+    /** 上下文窗口大小（token 数），由 Provider 实现暴露 */
+    contextWindow?: number;
+    /** Provider 能力声明 */
+    capabilities?: ProviderCapabilities;
+}
+/**
+ * 通用工具执行上下文。
+ *
+ * 定义了平台无关的字段，IM 应用通过 core 的 IMToolContext 扩展。
+ * 非 IM 应用可直接使用此接口。
+ */
+export interface ToolContext {
+    /** 来源平台标识 */
+    platform?: string;
+    /** 发送者 ID */
+    senderId?: string;
+    /** 场景 / 频道 ID */
+    sceneId?: string;
+    /** 额外数据（应用自行扩展） */
+    [key: string]: unknown;
 }
 /** Agent 工具 */
 export interface AgentTool {
     name: string;
     description: string;
     parameters: JsonSchema;
-    execute: (args: Record<string, any>) => Promise<any>;
+    execute: (args: Record<string, any>) => Promise<unknown>;
+    /** 工具标签，用于分类和快速匹配 */
+    tags?: string[];
+    /** 触发关键词，用户消息包含这些词时优先选择此工具 */
+    keywords?: string[];
+    /** 所需权限级别 (0=所有人, 1=群管理, 2=群主, 3=Bot管理员, 4=拥有者) */
+    permissionLevel?: number;
+    /** 是否允许预执行（opt-in），默认 false */
+    preExecutable?: boolean;
+    /** 工具分类（如 file / shell / web），用于 formatToolTitle 等展示 */
+    kind?: string;
+}
+/**
+ * 工具过滤选项
+ * 在 Agent.run() / runStream() 中启用程序化工具预过滤，
+ * 省去额外的 AI 意图分析往返
+ */
+export interface ToolFilterOptions {
+    /** 调用者权限级别 (0-4)，高于工具要求才能使用 */
+    callerPermissionLevel?: number;
+    /** 最大返回工具数量 (默认 10) */
+    maxTools?: number;
+    /** 最低相关性得分阈值，低于此分数的工具被过滤掉 (默认 0.1) */
+    minScore?: number;
 }
 /** Agent 配置 */
 export interface AgentConfig {
@@ -180,6 +238,12 @@ export interface Session {
     updatedAt: number;
     metadata?: Record<string, any>;
 }
+/** Ollama-specific fields for AIConfig typing (mirrors OllamaConfig) */
+export interface OllamaProviderConfig extends ProviderConfig {
+    host?: string;
+    models?: string[];
+    num_ctx?: number;
+}
 /** AI 服务配置 */
 export interface AIConfig {
     enabled?: boolean;
@@ -190,10 +254,7 @@ export interface AIConfig {
         deepseek?: ProviderConfig;
         moonshot?: ProviderConfig;
         zhipu?: ProviderConfig;
-        ollama?: ProviderConfig & {
-            host?: string;
-            models?: string[];
-        };
+        ollama?: OllamaProviderConfig;
         custom?: ProviderConfig[];
     };
     sessions?: {
@@ -218,6 +279,21 @@ export interface AIConfig {
         /** 自定义总结提示词 */
         summaryPrompt?: string;
     };
+    /** Agent 工具开关与执行安全 */
+    agent?: {
+        /** 禁用的工具名列表，这些工具不会下发给 AI */
+        disabledTools?: string[];
+        /** 仅允许的工具名列表；若设置则只下发列表中的工具（与 disabledTools 二选一，allowedTools 优先） */
+        allowedTools?: string[];
+        /** bash 执行策略：deny=禁止执行，allowlist=仅允许列表内命令，full=不限制 */
+        execSecurity?: 'deny' | 'allowlist' | 'full';
+        /** 预设命令白名单模式：readonly / network / development / custom（默认 custom，使用自定义 execAllowlist） */
+        execPreset?: 'readonly' | 'network' | 'development' | 'custom';
+        /** allowlist 模式下允许的命令（支持正则字符串，如 "^ls "、"^cat "），与 preset 合并 */
+        execAllowlist?: string[];
+        /** allowlist 未命中时：true=需审批（当前实现为拒绝并提示），false=直接拒绝 */
+        execAsk?: boolean;
+    };
     /** AI 触发配置 */
     trigger?: {
         /** 是否启用（默认 true） */

package/lib/types.d.ts.map

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

package/package.json

@@ -1,66 +1,37 @@
 {
   "name": "@zhin.js/ai",
-  "version": "0.0.2",
-  "description": "AI Service for Zhin.js - Multi-model LLM integration with Agent capabilities",
+  "version": "1.0.1",
+  "description": "Framework-agnostic AI engine: providers, agent loop, sessions, memory, compaction",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
       "import": "./lib/index.js"
-    },
-    "./providers/*": {
-      "types": "./lib/providers/*.d.ts",
-      "import": "./lib/providers/*.js"
     }
   },
-  "keywords": [
-    "zhin",
-    "bot",
-    "service",
-    "ai",
-    "llm",
-    "openai",
-    "claude",
-    "anthropic",
-    "deepseek",
-    "ollama",
-    "agent",
-    "tool-use",
-    "function-calling"
-  ],
-  "author": {
-    "name": "lc-cn",
-    "email": "admin@liucl.cn",
-    "url": "https://github.com/lc-cn"
+  "dependencies": {
+    "@zhin.js/logger": "0.1.24"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.1"
   },
-  "license": "MIT",
   "repository": {
-    "url": "git+https://github.com/zhinjs/zhin.git",
     "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
     "directory": "packages/ai"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
-  "dependencies": {
-    "eventsource-parser": "^3.0.0",
-    "segment-matcher": "latest"
-  },
-  "peerDependencies": {
-    "@zhin.js/core": "1.0.25",
-    "@zhin.js/logger": "0.1.9"
-  },
-  "devDependencies": {
-    "@types/node": "latest",
-    "typescript": "^5.3.0",
-    "@zhin.js/core": "1.0.25",
-    "@zhin.js/logger": "0.1.9"
-  },
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf lib"
+    "clean": "rimraf lib",
+    "test": "vitest run --config ../../vitest.config.ts"
   }
 }