@zhin.js/core 1.1.0 → 1.1.2

package/src/ai/types.ts

@@ -1,348 +0,0 @@
-/**
- * @zhin.js/ai - AI Service Types
- * 统一的 AI 服务类型定义
- */
-
-// ============================================================================
-// 基础类型
-// ============================================================================
-
-/** 消息角色 */
-export type MessageRole = 'system' | 'user' | 'assistant' | 'tool' | 'tool_call' | 'tool_result';
-
-/** 聊天消息 */
-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' } }
-  | { type: 'video_url'; video_url: { url: string } }
-  | { type: 'face'; face: { id: string; text?: string } };
-
-/** 工具调用 */
-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?: unknown[];
-  description?: string;
-  default?: unknown;
-  /** JSON Schema allows arbitrary extension properties */
-  [key: string]: any; // eslint-disable-line @typescript-eslint/no-explicit-any -- JSON Schema spec requires open index
-}
-
-// ============================================================================
-// 请求/响应类型
-// ============================================================================
-
-/** 聊天补全请求 */
-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;
-  /** 是否启用模型思考（如 qwen3 的 <think> 模式）。设为 false 可跳过思考加速响应。 */
-  think?: boolean;
-}
-
-/** 聊天补全响应 */
-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 类型
-// ============================================================================
-
-/** Provider 能力声明 */
-export interface ProviderCapabilities {
-  vision?: boolean;
-  streaming?: boolean;
-  toolCalling?: boolean;
-  thinking?: boolean;
-}
-
-/** Provider 配置 */
-export interface ProviderConfig {
-  apiKey?: string;
-  /**
-   * Authorization 头前缀。默认 `'Bearer '`；设为 `''` 时仅用 apiKey 作为值（部分 API 要求 `Authorization: <key>`）。
-   */
-  authScheme?: 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 {
-  name: string;
-  models: string[];
-  
-  /** 聊天补全 */
-  chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
-  
-  /** 流式聊天补全 */
-  chatStream(request: ChatCompletionRequest): AsyncIterable<ChatCompletionChunk>;
-  
-  /** 列出可用模型 */
-  listModels?(): Promise<string[]>;
-  
-  /** 检查连接 */
-  healthCheck?(): Promise<boolean>;
-
-  /** 上下文窗口大小（token 数），由 Provider 实现暴露 */
-  contextWindow?: number;
-
-  /** Provider 能力声明 */
-  capabilities?: ProviderCapabilities;
-}
-
-// ============================================================================
-// Agent 类型
-// ============================================================================
-
-/** Agent 工具 */
-export interface AgentTool {
-  name: string;
-  description: string;
-  parameters: JsonSchema;
-  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 {
-  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;
-}
-
-// ============================================================================
-// Session 类型
-// ============================================================================
-
-/** 会话配置 */
-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 Service 配置
-// ============================================================================
-
-/** 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;
-  defaultProvider?: string;
-  providers?: {
-    openai?: ProviderConfig;
-    anthropic?: ProviderConfig;
-    deepseek?: ProviderConfig;
-    moonshot?: ProviderConfig;
-    zhipu?: ProviderConfig;
-    ollama?: OllamaProviderConfig;
-    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;
-  };
-  /** 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） */
-    enabled?: boolean;
-    /** 触发前缀列表（默认 ['#', 'AI:']） */
-    prefixes?: string[];
-    /** 是否响应 @ 机器人（默认 true） */
-    respondToAt?: boolean;
-    /** 是否响应私聊（默认 true） */
-    respondToPrivate?: boolean;
-    /** 触发关键词（可选） */
-    keywords?: string[];
-    /** 忽略的前缀（命令前缀，避免与命令冲突，默认 ['/', '!', '！']） */
-    ignorePrefixes?: string[];
-    /** 超时时间（毫秒，默认 60000） */
-    timeout?: number;
-    /** 思考中提示语（可选，设置后会在处理前发送） */
-    thinkingMessage?: string;
-    /** 错误提示模板（默认 '❌ AI 处理失败: {error}'） */
-    errorTemplate?: string;
-  };
-}

package/src/bot.ts

@@ -1,37 +0,0 @@
-import type { SendOptions } from "./types.js";
-import { Message } from "./message.js";
-import { Notice } from "./notice.js";
-import { Request } from "./request.js";
-import { Adapter, Adapters } from "./adapter.js";
-/**
- * Bot接口：所有平台机器人需实现的统一接口。
- * 负责消息格式化、连接、断开、消息发送等。
- * @template Config 配置类型
- * @template Event 消息事件类型
- */
-export interface Bot<Config extends object= {},Event extends object = {}> {
-  $id:string
-  /** 机器人配置 */
-  $config: Config;
-  /** 是否已连接 */
-  $connected: boolean;
-  /** 格式化平台消息为标准Message结构 */
-  $formatMessage(event: Event): Message<Event>;
-  /** 格式化平台通知为标准Notice结构（适配器可选实现） */
-  $formatNotice?(event: any): Notice<any>;
-  /** 格式化平台请求为标准Request结构（适配器可选实现） */
-  $formatRequest?(event: any): Request<any>;
-  /** 连接机器人 */
-  $connect(): Promise<void>;
-  /** 断开机器人 */
-  $disconnect(): Promise<void>;
-  /** 撤回消息 */
-  $recallMessage(id: string): Promise<void>;
-  /** 发送消息返回消息id */
-  $sendMessage(options: SendOptions): Promise<string>;
-}
-export namespace Bot {
-  export type Config<K extends keyof Adapters = keyof Adapters> =Adapter.BotConfig<Adapter.InferBot<Adapters[K]>> & {
-    context: K;
-  }
-}

package/src/built/adapter-process.ts

@@ -1,177 +0,0 @@
-import { Adapter, Plugin, Bot, SendContent, SendOptions, MessageBase, Message, segment } from "@zhin.js/core";
-export class ProcessBot implements Bot<{ owner?: string },{content:string,ts:number}>{
-    $id=`${process.pid}`;
-    get logger() {
-        return this.adapter.logger;
-    }
-    $connected=false;
-    constructor(public adapter: ProcessAdapter, public $config: { owner?: string }={ owner: `${process.pid}` }) {
-        this.$listenInput=this.$listenInput.bind(this);
-    }
-    $listenInput:(data:Buffer<ArrayBufferLike>)=>void=function (this:ProcessBot,data){
-        const content = data.toString().trim();
-        if (content) {
-            this.adapter.emit('message.receive', this.$formatMessage({content,ts:Date.now()}));
-        }
-    }
-    async connect() {
-    }
-    async disconnect() {
-    }
-    $formatMessage(event: {content:string,ts:number}): Message<{content:string,ts:number}> {
-        const base:MessageBase={
-            $id: `${event.ts}`,
-            $adapter: 'process',
-            $bot: `${process.pid}`,
-            $sender: {
-                id: `${process.pid}`,
-                name: process.title,
-            },
-            $channel: {
-                id: `${process.pid}`,
-                type: 'private',
-            },
-            $content: [{type:'text',data:{text:event.content}}],
-            $raw: event.content,
-            $timestamp: event.ts,
-            $recall: async () => {
-                await this.$recallMessage(base.$id)
-            },
-            $reply: async (content: SendContent) => {
-                return await this.adapter.sendMessage({
-                    context: 'process',
-                    bot: base.$bot,
-                    content,
-                    id: base.$id,
-                    type: base.$channel.type,
-                });
-            },
-        }
-        return Message.from(event, base);
-    }
-    async $recallMessage(id: string) {
-    }
-    async $sendMessage(options: SendOptions) {
-        return `${Date.now()}`;
-    }
-    async $connect(): Promise<void> {
-        process.stdin.on('data', this.$listenInput);
-        this.$connected = true;
-    }
-    async $disconnect() {
-        process.stdin.removeListener('data', this.$listenInput);
-    }
-}
-export class ProcessAdapter extends Adapter<ProcessBot>{
-    constructor(plugin: Plugin) {
-        super(plugin, 'process', [{ owner: `${process.pid}` }]);
-        
-        // 注册适配器提供的 AI 工具
-        this.registerDefaultTools();
-        this.registerProcessTools();
-    }
-    
-    createBot(config: Adapter.BotConfig<ProcessBot>): ProcessBot {
-        return new ProcessBot(this, config);
-    }
-    
-    /**
-     * 注册 Process 适配器特有的工具
-     */
-    private registerProcessTools(): void {
-        // 获取进程信息
-        this.addTool({
-            name: 'process_get_info',
-            description: '获取当前进程的详细信息，包括 PID、内存使用、运行时间等',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            execute: async () => {
-                const memUsage = process.memoryUsage();
-                return {
-                    pid: process.pid,
-                    title: process.title,
-                    uptime: process.uptime(),
-                    platform: process.platform,
-                    arch: process.arch,
-                    nodeVersion: process.version,
-                    memory: {
-                        rss: Math.round(memUsage.rss / 1024 / 1024) + ' MB',
-                        heapTotal: Math.round(memUsage.heapTotal / 1024 / 1024) + ' MB',
-                        heapUsed: Math.round(memUsage.heapUsed / 1024 / 1024) + ' MB',
-                    },
-                    cwd: process.cwd(),
-                };
-            },
-        });
-        
-        // 获取环境变量
-        this.addTool({
-            name: 'process_get_env',
-            description: '获取指定的环境变量值',
-            parameters: {
-                type: 'object',
-                properties: {
-                    name: {
-                        type: 'string',
-                        description: '环境变量名称',
-                    },
-                },
-                required: ['name'],
-            },
-            execute: async (args) => {
-                const { name } = args;
-                // 安全起见，不返回敏感环境变量
-                const sensitive = ['PASSWORD', 'SECRET', 'TOKEN', 'KEY', 'CREDENTIAL'];
-                if (sensitive.some(s => name.toUpperCase().includes(s))) {
-                    return { error: '无法访问敏感环境变量' };
-                }
-                return { name, value: process.env[name] || null };
-            },
-        });
-        
-        // 输出到控制台
-        this.addTool({
-            name: 'process_console_log',
-            description: '向控制台输出信息',
-            parameters: {
-                type: 'object',
-                properties: {
-                    message: {
-                        type: 'string',
-                        description: '要输出的消息',
-                    },
-                    level: {
-                        type: 'string',
-                        enum: ['info', 'warn', 'error', 'debug'],
-                        description: '日志级别',
-                    },
-                },
-                required: ['message'],
-            },
-            execute: async (args) => {
-                const { message, level = 'info' } = args;
-                switch (level) {
-                    case 'warn':
-                        console.warn(message);
-                        break;
-                    case 'error':
-                        console.error(message);
-                        break;
-                    case 'debug':
-                        console.debug(message);
-                        break;
-                    default:
-                        console.log(message);
-                }
-                return { success: true, message: `已输出: ${message}` };
-            },
-        });
-    }
-}
-declare module '../adapter.js'{
-    interface Adapters{
-        process:ProcessAdapter
-    }
-}

package/src/built/agent-preset.ts

@@ -1,136 +0,0 @@
-/**
- * AgentPreset — 插件声明的专长 Agent 预设
- *
- * 核心概念：
- *   Tool    = 单个 AI 可调用的能力（函数）
- *   Skill   = 一组相关 Tool + 发现元数据（SKILL.md）
- *   Agent   = 针对特定领域的 Agent 预设（*.agent.md）
- *
- * Agent 预设以标准 *.agent.md 文件提供，框架自动扫描发现。
- * 主 Agent（ZhinAgent）可根据用户请求自动委派给匹配的专长 Agent。
- */
-
-import { Feature, type FeatureJSON } from '../feature.js';
-import type { Tool } from '../types.js';
-
-// ============================================================================
-// AgentPreset 接口
-// ============================================================================
-
-/**
- * Agent 预设（从 *.agent.md 文件解析或编程式注册）
- */
-export interface AgentPreset {
-  /** 预设名称（唯一标识） */
-  name: string;
-
-  /** 描述（AI 用来判断何时委派给此 Agent） */
-  description: string;
-
-  /** 自定义系统提示词（从 agent.md body 提取或显式指定） */
-  systemPrompt?: string;
-
-  /** 关联的工具列表 */
-  tools?: Tool[];
-
-  /** 触发关键词（用户消息匹配时优先考虑此 Agent） */
-  keywords?: string[];
-
-  /** 分类标签 */
-  tags?: string[];
-
-  /** 首选模型名 */
-  model?: string;
-
-  /** 首选 Provider 名 */
-  provider?: string;
-
-  /** 最大工具调用迭代次数 */
-  maxIterations?: number;
-
-  /** 来源插件名（由框架自动填充） */
-  pluginName?: string;
-
-  /** *.agent.md 文件的绝对路径 */
-  filePath?: string;
-}
-
-// ============================================================================
-// AgentPresetFeature
-// ============================================================================
-
-declare module '../plugin.js' {
-  namespace Plugin {
-    interface Contexts {
-      agentPreset: AgentPresetFeature;
-    }
-  }
-}
-
-export class AgentPresetFeature extends Feature<AgentPreset> {
-  readonly name = 'agentPreset' as const;
-  readonly icon = 'Bot';
-  readonly desc = 'Agent 预设';
-
-  readonly byName = new Map<string, AgentPreset>();
-
-  add(preset: AgentPreset, pluginName: string): () => void {
-    this.byName.set(preset.name, preset);
-    return super.add(preset, pluginName);
-  }
-
-  remove(preset: AgentPreset, pluginName?: string): boolean {
-    this.byName.delete(preset.name);
-    return super.remove(preset, pluginName);
-  }
-
-  get(name: string): AgentPreset | undefined {
-    return this.byName.get(name);
-  }
-
-  getAll(): AgentPreset[] {
-    return [...this.items];
-  }
-
-  search(query: string, options?: { maxResults?: number }): AgentPreset[] {
-    const maxResults = options?.maxResults ?? 5;
-    const lower = query.toLowerCase();
-    const scored = this.items
-      .map(preset => ({ preset, score: this.#scorePreset(preset, lower) }))
-      .filter(({ score }) => score > 0)
-      .sort((a, b) => b.score - a.score)
-      .slice(0, maxResults);
-    return scored.map(({ preset }) => preset);
-  }
-
-  #scorePreset(preset: AgentPreset, query: string): number {
-    let score = 0;
-    if (preset.name.toLowerCase().includes(query)) score += 10;
-    if (preset.description.toLowerCase().includes(query)) score += 5;
-    for (const kw of preset.keywords || []) {
-      if (kw.toLowerCase().includes(query) || query.includes(kw.toLowerCase())) score += 8;
-    }
-    for (const tag of preset.tags || []) {
-      if (tag.toLowerCase().includes(query)) score += 3;
-    }
-    return score;
-  }
-
-  toJSON(pluginName?: string): FeatureJSON {
-    const list = pluginName ? this.getByPlugin(pluginName) : this.items;
-    return {
-      name: this.name,
-      icon: this.icon,
-      desc: this.desc,
-      count: list.length,
-      items: list.map(p => ({
-        name: p.name,
-        desc: p.description,
-        keywords: p.keywords,
-        tags: p.tags,
-        model: p.model,
-        provider: p.provider,
-      })),
-    };
-  }
-}