@zhin.js/core 1.0.36 → 1.0.38

package/src/ai/subagent.ts

@@ -1,209 +0,0 @@
-/**
- * SubagentManager — 后台子任务执行管理器
- *
- * 职责：
- *   1. 接收主 agent 发起的 spawn 请求，创建后台子 agent
- *   2. 为子 agent 配备受限工具集（文件/Shell/网络，不含消息/spawn/技能）
- *   3. 管理子 agent 生命周期（运行跟踪、完成/失败回告）
- *   4. 完成后将结果投递回主流程，由主 agent 摘要后发送到原始频道
- */
-
-import { randomUUID } from 'crypto';
-import { Logger } from '@zhin.js/logger';
-import type { AIProvider, AgentTool } from './types.js';
-import { createAgent } from './agent.js';
-import type { ZhinAgentConfig } from './zhin-agent/config.js';
-import { applyExecPolicyToTools } from './zhin-agent/exec-policy.js';
-
-const logger = new Logger(null, 'Subagent');
-
-// ============================================================================
-// 类型
-// ============================================================================
-
-export interface SubagentOrigin {
-  platform: string;
-  botId: string;
-  sceneId: string;
-  senderId: string;
-  sceneType: string;
-}
-
-export interface SpawnOptions {
-  task: string;
-  label?: string;
-  origin: SubagentOrigin;
-}
-
-export type SubagentResultSender = (origin: SubagentOrigin, content: string) => Promise<void>;
-
-export interface SubagentManagerOptions {
-  provider: AIProvider;
-  workspace: string;
-  createTools: () => AgentTool[];
-  maxIterations?: number;
-  /** Exec policy config to enforce on subagent bash tools */
-  execPolicyConfig?: Required<ZhinAgentConfig>;
-}
-
-// ============================================================================
-// 子 agent 允许使用的工具名单
-// ============================================================================
-
-const SUBAGENT_ALLOWED_TOOLS = new Set([
-  'read_file',
-  'write_file',
-  'edit_file',
-  'list_dir',
-  'glob',
-  'grep',
-  'bash',
-  'web_search',
-  'web_fetch',
-]);
-
-// ============================================================================
-// SubagentManager
-// ============================================================================
-
-export class SubagentManager {
-  private provider: AIProvider;
-  private workspace: string;
-  private createTools: () => AgentTool[];
-  private maxIterations: number;
-  private execPolicyConfig: Required<ZhinAgentConfig> | null;
-  private runningTasks: Map<string, AbortController> = new Map();
-  private resultSender: SubagentResultSender | null = null;
-
-  constructor(options: SubagentManagerOptions) {
-    this.provider = options.provider;
-    this.workspace = options.workspace;
-    this.createTools = options.createTools;
-    this.maxIterations = options.maxIterations ?? 15;
-    this.execPolicyConfig = options.execPolicyConfig ?? null;
-  }
-
-  setSender(sender: SubagentResultSender): void {
-    this.resultSender = sender;
-  }
-
-  async spawn(options: SpawnOptions): Promise<string> {
-    const taskId = randomUUID().slice(0, 8);
-    const displayLabel =
-      options.label ||
-      options.task.slice(0, 30) + (options.task.length > 30 ? '...' : '');
-
-    const abortController = new AbortController();
-    this.runningTasks.set(taskId, abortController);
-
-    this.runSubagent(taskId, options.task, displayLabel, options.origin)
-      .catch((error) => {
-        logger.error({ error, taskId }, 'Subagent failed');
-      })
-      .finally(() => {
-        this.runningTasks.delete(taskId);
-      });
-
-    logger.info({ taskId, label: displayLabel }, 'Spawned subagent');
-    return `子任务 [${displayLabel}] 已启动 (id: ${taskId})，完成后会自动通知你。`;
-  }
-
-  getRunningCount(): number {
-    return this.runningTasks.size;
-  }
-
-  // ── 内部方法 ──────────────────────────────────────────────────────
-
-  private async runSubagent(
-    taskId: string,
-    task: string,
-    label: string,
-    origin: SubagentOrigin,
-  ): Promise<void> {
-    logger.info({ taskId, label }, 'Subagent starting task');
-
-    try {
-      const allTools = this.createTools();
-      let tools = allTools.filter(t => SUBAGENT_ALLOWED_TOOLS.has(t.name));
-      if (this.execPolicyConfig) {
-        tools = applyExecPolicyToTools(this.execPolicyConfig, tools);
-      }
-
-      const systemPrompt = this.buildSubagentPrompt(task);
-      const agent = createAgent(this.provider, {
-        systemPrompt,
-        tools,
-        maxIterations: this.maxIterations,
-      });
-
-      const result = await agent.run(task);
-      const finalResult = result.content || '任务已完成，但未生成最终响应。';
-
-      logger.info({ taskId }, 'Subagent completed successfully');
-      await this.announceResult(taskId, label, task, finalResult, origin, 'ok');
-    } catch (error) {
-      const errorMsg = `Error: ${error}`;
-      logger.error({ taskId, error }, 'Subagent failed');
-      await this.announceResult(taskId, label, task, errorMsg, origin, 'error');
-    }
-  }
-
-  private async announceResult(
-    taskId: string,
-    label: string,
-    task: string,
-    result: string,
-    origin: SubagentOrigin,
-    status: 'ok' | 'error',
-  ): Promise<void> {
-    if (!this.resultSender) {
-      logger.warn({ taskId }, 'No result sender configured, discarding subagent result');
-      return;
-    }
-
-    const statusText = status === 'ok' ? '已完成' : '执行失败';
-    const announceContent = `[后台任务 '${label}' ${statusText}]\n\n任务: ${task}\n\n结果:\n${result}`;
-
-    try {
-      await this.resultSender(origin, announceContent);
-      logger.debug({ taskId, origin }, 'Subagent announced result');
-    } catch (e) {
-      logger.error({ taskId, error: e }, 'Failed to announce subagent result');
-    }
-  }
-
-  private buildSubagentPrompt(task: string): string {
-    return `# 子任务 Agent
-
-你是一个被主 agent 派生出来执行特定任务的子 agent。
-
-## 你的任务
-${task}
-
-## 规则
-1. 专注完成分配的任务，不做其他事情
-2. 你的最终回复会被报告给主 agent，并转达给用户
-3. 不要发起对话或承担额外任务
-4. 回复要简洁但信息充分
-
-## 你可以做的
-- 读写工作区内的文件
-- 执行 Shell 命令
-- 搜索和抓取网页
-- 彻底完成任务
-
-## 你不能做的
-- 直接向用户发送消息
-- 派生其他子任务
-- 访问主 agent 的对话历史
-
-## 工作区
-你的工作区路径: ${this.workspace}
-
-完成任务后，请提供清晰的发现或操作摘要。`;
-  }
-
-  dispose(): void {
-    this.runningTasks.clear();
-  }
-}

package/src/ai/tone-detector.ts

@@ -1,89 +0,0 @@
-/**
- * ToneDetector — 轻量级情绪/语气检测
- *
- * 通过标点符号、emoji 密度、关键词分析用户语气，
- * 生成一条 hint 注入 system prompt，让 AI 的回复匹配用户情绪。
- *
- * 零 LLM 开销，纯正则/统计分析。
- */
-
-export type Tone = 'neutral' | 'frustrated' | 'excited' | 'questioning' | 'sad' | 'urgent';
-
-interface ToneResult {
-  tone: Tone;
-  hint: string;
-}
-
-// 常见负面情绪词
-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: string): ToneResult {
-  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: '' };
-}

package/src/ai/tools.ts

@@ -1,218 +0,0 @@
-/**
- * @zhin.js/ai - Built-in Tools
- * 内置工具集合 - 使用 ZhinTool 类定义
- */
-
-import { ZhinTool } from '../built/tool.js';
-import type { Tool } from '../types.js';
-
-/**
- * 计算器工具
- * 支持基本运算和数学函数
- */
-export const calculatorTool = new ZhinTool('calculator')
-  .desc('执行数学计算。支持基本运算（+、-、*、/、^）和数学函数（sin、cos、sqrt 等）')
-  .keyword('计算', '算', 'calc', '数学', '求值', '运算')
-  .tag('math', 'utility')
-  .param('expression', { type: 'string', description: '数学表达式，例如 "2 + 3 * 4" 或 "sqrt(16)"' }, true)
-  .execute(async ({ expression }) => {
-    try {
-      // 安全的数学表达式求值
-      const sanitized = (expression as string)
-        .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('获取当前时间和日期信息')
-  .keyword('时间', '日期', '几点', '今天', '现在', 'time', 'date')
-  .tag('time', 'utility')
-  .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: Intl.DateTimeFormatOptions = {
-      timeZone: (timezone as string) || '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）')
-  .keyword('搜索', '搜一下', '查找', '查一查', 'search', 'google')
-  .tag('search', 'web')
-  .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 代码（在安全沙箱中）')
-  .keyword('代码', '执行', '运行', 'code', 'js', 'javascript')
-  .tag('code', 'dev')
-  .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 请求获取数据')
-  .keyword('http', 'api', '请求', '接口', 'url', 'fetch')
-  .tag('http', 'web')
-  .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 as string, {
-        method: method as string,
-        headers: {
-          'Content-Type': 'application/json',
-          ...(headers as Record<string, string>),
-        },
-        body: body ? (body as string) : undefined,
-      });
-
-      const contentType = response.headers.get('content-type') || '';
-      let data: any;
-
-      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('记住用户告诉你的重要信息，以便后续对话中使用')
-  .keyword('记住', '记忆', '记下', 'remember', '别忘了')
-  .tag('memory', 'context')
-  .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(): ZhinTool[] {
-  return [
-    calculatorTool,
-    timeTool,
-  ];
-}
-
-/**
- * 获取所有可用的内置工具（包括可选工具）
- */
-export function getAllBuiltinTools(): ZhinTool[] {
-  return [
-    calculatorTool,
-    timeTool,
-    searchTool,
-    codeRunnerTool,
-    httpTool,
-    memoryTool,
-  ];
-}

package/src/ai/user-profile.ts

@@ -1,181 +0,0 @@
-/**
- * UserProfileStore — 用户画像存储
- *
- * 持久化存储用户偏好和特征，让 AI 跨会话记住用户的个性化信息。
- *
- *   ai_user_profiles 表：
- *   ┌──────────────────────────────────────────────────────────┐
- *   │ user_id  | key          | value         | updated_at     │
- *   │ u1       | name         | 小明          | 1700000000     │
- *   │ u1       | style        | 简洁正式      | 1700000001     │
- *   │ u1       | interests    | 编程,天气     | 1700000010     │
- *   └──────────────────────────────────────────────────────────┘
- */
-
-import { Logger } from '@zhin.js/logger';
-
-const logger = new Logger(null, 'UserProfile');
-
-// ============================================================================
-// 数据库模型
-// ============================================================================
-
-export const AI_USER_PROFILE_MODEL = {
-  user_id: { type: 'text' as const, nullable: false },
-  key: { type: 'text' as const, nullable: false },
-  value: { type: 'text' as const, nullable: false },
-  updated_at: { type: 'integer' as const, default: 0 },
-};
-
-// ============================================================================
-// 类型
-// ============================================================================
-
-interface ProfileRecord {
-  id?: number;
-  user_id: string;
-  key: string;
-  value: string;
-  updated_at: number;
-}
-
-/**
- * 数据库模型接口（与 RelatedModel 的链式查询 API 对齐）
- */
-interface DbModel {
-  select(...fields: string[]): any;  // 返回 Selection (thenable, 支持 .where())
-  create(data: Record<string, any>): Promise<any>;
-  update(data: Partial<any>): any;   // 返回 Updation (thenable, 支持 .where())
-  delete(condition: Record<string, any>): any; // 返回 Deletion (thenable, 支持 .where())
-}
-
-// ============================================================================
-// Store 接口
-// ============================================================================
-
-interface IProfileStore {
-  get(userId: string, key: string): Promise<string | null>;
-  getAll(userId: string): Promise<Record<string, string>>;
-  set(userId: string, key: string, value: string): Promise<void>;
-  delete(userId: string, key: string): Promise<boolean>;
-  dispose(): void;
-}
-
-// ============================================================================
-// 内存实现
-// ============================================================================
-
-class MemoryProfileStore implements IProfileStore {
-  private data: Map<string, Map<string, string>> = new Map();
-
-  async get(userId: string, key: string): Promise<string | null> {
-    return this.data.get(userId)?.get(key) ?? null;
-  }
-
-  async getAll(userId: string): Promise<Record<string, string>> {
-    const map = this.data.get(userId);
-    if (!map) return {};
-    return Object.fromEntries(map);
-  }
-
-  async set(userId: string, key: string, value: string): Promise<void> {
-    let map = this.data.get(userId);
-    if (!map) { map = new Map(); this.data.set(userId, map); }
-    map.set(key, value);
-  }
-
-  async delete(userId: string, key: string): Promise<boolean> {
-    return this.data.get(userId)?.delete(key) ?? false;
-  }
-
-  dispose(): void { this.data.clear(); }
-}
-
-// ============================================================================
-// 数据库实现
-// ============================================================================
-
-class DatabaseProfileStore implements IProfileStore {
-  constructor(private model: DbModel) {}
-
-  async get(userId: string, key: string): Promise<string | null> {
-    const records = await this.model.select().where({ user_id: userId, key }) as ProfileRecord[];
-    return records.length > 0 ? records[0].value : null;
-  }
-
-  async getAll(userId: string): Promise<Record<string, string>> {
-    const records = await this.model.select().where({ user_id: userId }) as ProfileRecord[];
-    const result: Record<string, string> = {};
-    for (const r of records) result[r.key] = r.value;
-    return result;
-  }
-
-  async set(userId: string, key: string, value: string): Promise<void> {
-    const existing = await this.model.select().where({ user_id: userId, key });
-    if (existing.length > 0) {
-      await this.model.update({ value, updated_at: Date.now() }).where({ user_id: userId, key });
-    } else {
-      await this.model.create({ user_id: userId, key, value, updated_at: Date.now() });
-    }
-  }
-
-  async delete(userId: string, key: string): Promise<boolean> {
-    const existing = await this.model.select().where({ user_id: userId, key });
-    if (existing.length === 0) return false;
-    await this.model.delete({ user_id: userId, key });
-    return true;
-  }
-
-  dispose(): void {}
-}
-
-// ============================================================================
-// UserProfileStore
-// ============================================================================
-
-export class UserProfileStore {
-  private store: IProfileStore;
-
-  constructor() {
-    this.store = new MemoryProfileStore();
-  }
-
-  upgradeToDatabase(model: DbModel): void {
-    const old = this.store;
-    this.store = new DatabaseProfileStore(model);
-    old.dispose();
-    logger.debug('UserProfileStore: upgraded to database storage');
-  }
-
-  async get(userId: string, key: string): Promise<string | null> {
-    return this.store.get(userId, key);
-  }
-
-  async getAll(userId: string): Promise<Record<string, string>> {
-    return this.store.getAll(userId);
-  }
-
-  async set(userId: string, key: string, value: string): Promise<void> {
-    return this.store.set(userId, key, value);
-  }
-
-  async delete(userId: string, key: string): Promise<boolean> {
-    return this.store.delete(userId, key);
-  }
-
-  /**
-   * 构建用户画像摘要，注入 system prompt
-   */
-  async buildProfileSummary(userId: string): Promise<string> {
-    const profile = await this.store.getAll(userId);
-    const entries = Object.entries(profile);
-    if (entries.length === 0) return '';
-
-    const lines = entries.map(([k, v]) => `- ${k}: ${v}`).join('\n');
-    return `[用户画像]\n${lines}`;
-  }
-
-  dispose(): void {
-    this.store.dispose();
-  }
-}