@h-ai/ai 0.1.0-alpha8 → 0.1.0-alpha9

package/dist/{ai-reasoning-types-YcmdAlAU.d.ts → ai-reasoning-types-CGUgkLF7.d.ts}

@@ -233,18 +233,20 @@ interface KnowledgeStore {
         id: string;
         name: string;
         type: string;
+        collection: string;
         aliases?: string[];
         description?: string;
     }) => Promise<void>;
-    /** 按名称模糊搜索实体（匹配 name 和 aliases） */
-    findEntitiesByName: (keyword: string) => Promise<Array<{
+    /** 按名称模糊搜索实体（匹配 name 和 aliases，可按 collection 过滤） */
+    findEntitiesByName: (keyword: string, collection?: string) => Promise<Array<{
         id: string;
         name: string;
         type: string;
         aliases: string[];
     }>>;
-    /** 列出实体（支持类型过滤和关键词搜索） */
+    /** 列出实体（支持 collection / 类型 / 关键词搜索） */
     listEntities: (options?: {
+        collection?: string;
         type?: string;
         keyword?: string;
         limit?: number;
@@ -257,8 +259,15 @@ interface KnowledgeStore {
         createdAt: string | null;
         updatedAt: string | null;
     }>>;
-    /** 批量删除实体本体（由 removeDocument / deleteCollection 调用以完成数据闭环） */
+    /** 批量删除实体本体 */
     deleteEntities: (entityIds: string[]) => Promise<void>;
+    /**
+     * 删除指定文档在指定 collection 中的所有实体本体
+     *
+     * 使用子查询，必须在 removeDocumentEntityRelations 之前调用（关联行删除后子查询结果为空）。
+     * removeDocument 使用此方法完成实体数据闭环，无需两步查询。
+     */
+    deleteDocumentEntities: (documentId: string, collection: string) => Promise<void>;
     /** 插入文档-实体关联 */
     insertEntityDocument: (relation: {
         entityId: string;
@@ -298,13 +307,12 @@ interface KnowledgeStore {
         }>;
     }>>;
     /**
-     * 删除文档相关的实体关联，返回受影响的实体 ID 列表
+     * 删除文档相关的实体关联行
      *
-     * 仅删除关联行，不删除实体本体。
-     * 上层在执行完整删除流程时（如 removeDocument），需用返回的 entityIds 再调用 deleteEntities 完成数据闭环。
-     * 重新摄入场景（ingest re-ingest）可忽略返回值，因为实体本体会立即被 upsertEntity 重建。
+     * 仅删除 entity_document 关联行，不删除实体本体。
+     * 调用前应先执行 deleteDocumentEntities，否则子查询结果为空导致实体无法清理。
      */
-    removeDocumentEntityRelations: (documentId: string, collection: string) => Promise<string[]>;
+    removeDocumentEntityRelations: (documentId: string, collection: string) => Promise<void>;
     /** 保存文档元数据 */
     upsertDocument: (doc: {
         documentId: string;
@@ -1289,6 +1297,8 @@ interface EntityDocumentResult {
  * 实体列表查询选项
  */
 interface EntityListOptions {
+    /** 集合名过滤（不指定则返回所有 collection 的实体） */
+    collection?: string;
     /** 实体类型过滤 */
     type?: EntityType;
     /** 关键词搜索（模糊匹配实体名称和别名） */

package/dist/{ai-types-Dy8dOY4z.d.ts → ai-types-CRCjluXI.d.ts}

@@ -1,6 +1,6 @@
 import * as _h_ai_core from '@h-ai/core';
 import { HaiResult } from '@h-ai/core';
-import { af as ChatMessage, ao as InteractionScope, aM as MemoryInjectionOptions, aX as RagOptions, a$ as ReasoningOptions, br as ToolRegistryOperations, bc as SessionInfo, aG as LLMOperations, aP as MemoryOperations, aW as RagOperations, a_ as ReasoningOperations, c as AIConfig, d as AIConfigInput, a5 as AIStoreProvider, bs as ToolsOperations, bg as StreamOperations, b5 as RetrievalOperations, aA as KnowledgeOperations, $ as A2AOperations } from './ai-reasoning-types-YcmdAlAU.js';
+import { af as ChatMessage, ao as InteractionScope, aM as MemoryInjectionOptions, aX as RagOptions, a$ as ReasoningOptions, br as ToolRegistryOperations, bc as SessionInfo, aG as LLMOperations, aP as MemoryOperations, aW as RagOperations, a_ as ReasoningOperations, c as AIConfig, d as AIConfigInput, a5 as AIStoreProvider, bs as ToolsOperations, bg as StreamOperations, b5 as RetrievalOperations, aA as KnowledgeOperations, $ as A2AOperations } from './ai-reasoning-types-CGUgkLF7.js';
 import { z } from 'zod';
 import { Buffer } from 'node:buffer';
 

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
-export { A as A2AConfig, a as A2AConfigSchema, b as A2ASkillConfigSchema, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, C as CompressConfig, f as CompressConfigSchema, E as EmbeddingConfig, g as EmbeddingConfigSchema, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, K as KnowledgeConfig, k as KnowledgeConfigSchema, L as LLMConfig, l as LLMConfigSchema, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, r as MemoryConfig, s as MemoryConfigSchema, t as MemoryType, u as MemoryTypeSchema, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, G as RetrievalSourceConfig, H as RetrievalSourceSchema, S as SummaryConfig, I as SummaryConfigSchema, T as TokenConfig, J as TokenConfigSchema, N as resolveModelEntry } from './ai-reasoning-types-YcmdAlAU.js';
-export { A as AIFunctions, a as AIInitOptions, C as CompressionStrategy, b as CompressionStrategySchema, H as HaiAIError } from './ai-types-Dy8dOY4z.js';
+export { A as A2AConfig, a as A2AConfigSchema, b as A2ASkillConfigSchema, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, C as CompressConfig, f as CompressConfigSchema, E as EmbeddingConfig, g as EmbeddingConfigSchema, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, K as KnowledgeConfig, k as KnowledgeConfigSchema, L as LLMConfig, l as LLMConfigSchema, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, r as MemoryConfig, s as MemoryConfigSchema, t as MemoryType, u as MemoryTypeSchema, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, G as RetrievalSourceConfig, H as RetrievalSourceSchema, S as SummaryConfig, I as SummaryConfigSchema, T as TokenConfig, J as TokenConfigSchema, N as resolveModelEntry } from './ai-reasoning-types-CGUgkLF7.js';
+export { A as AIFunctions, a as AIInitOptions, C as CompressionStrategy, b as CompressionStrategySchema, H as HaiAIError } from './ai-types-CRCjluXI.js';
 export { A2AClientOperations, AIApiAdapter, AIClient, AIClientConfig, StreamOptions, StreamProgress, collectStreamContent, createA2AClient, createAIClient, parseSSE } from './client/index.js';
 import '@a2a-js/sdk/server';
 import '@h-ai/core';

package/dist/browser.js

@@ -1,4 +1,4 @@
-export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-5P2VX6FO.js';
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-6PPXWQ7I.js';
 export { collectStreamContent, createA2AClient, createAIClient, parseSSE } from './chunk-ABP7RKIP.js';
 //# sourceMappingURL=browser.js.map
 //# sourceMappingURL=browser.js.map

package/dist/{chunk-5P2VX6FO.js → chunk-6PPXWQ7I.js}

@@ -458,5 +458,5 @@ var AIConfigSchema = z.object({
 });
 
 export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, aiM, resolveModelEntry };
-//# sourceMappingURL=chunk-5P2VX6FO.js.map
-//# sourceMappingURL=chunk-5P2VX6FO.js.map
+//# sourceMappingURL=chunk-6PPXWQ7I.js.map
+//# sourceMappingURL=chunk-6PPXWQ7I.js.map

package/dist/chunk-6PPXWQ7I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-types.ts","../src/compress/ai-compress-types.ts","../src/knowledge/ai-knowledge-types.ts","../src/memory/ai-memory-types.ts","../messages/en-US.json","../messages/zh-CN.json","../src/ai-i18n.ts","../src/ai-config.ts"],"names":["z","core"],"mappings":"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","file":"chunk-6PPXWQ7I.js","sourcesContent":["/**\n * @h-ai/ai — 公共类型定义\n *\n * 聚合导出模块根类型和子功能类型，供外部通过 `@h-ai/ai` 一站式引入。\n * @module ai-types\n */\n\nimport type { ErrorInfo, HaiResult } from '@h-ai/core'\nimport type { A2AOperations } from './a2a/ai-a2a-types.js'\n\nimport type { AIConfig, AIConfigInput } from './ai-config.js'\nimport type { CompressOperations } from './compress/ai-compress-types.js'\nimport type { ContextOperations } from './context/ai-context-types.js'\nimport type { EmbeddingOperations } from './embedding/ai-embedding-types.js'\nimport type { FileOperations } from './file/ai-file-types.js'\nimport type { KnowledgeOperations } from './knowledge/ai-knowledge-types.js'\nimport type { LLMOperations, StreamOperations, ToolsOperations } from './llm/ai-llm-types.js'\nimport type { MCPOperations } from './mcp/ai-mcp-types.js'\nimport type { MemoryOperations } from './memory/ai-memory-types.js'\nimport type { RagOperations } from './rag/ai-rag-types.js'\nimport type { ReasoningOperations } from './reasoning/ai-reasoning-types.js'\nimport type { RerankOperations } from './rerank/ai-rerank-types.js'\nimport type { RetrievalOperations } from './retrieval/ai-retrieval-types.js'\nimport type { AIStoreProvider } from './store/ai-store-types.js'\nimport type { SummaryOperations } from './summary/ai-summary-types.js'\nimport type { TokenOperations } from './token/ai-token-types.js'\nimport { core } from '@h-ai/core'\n\n// ─── 错误定义（照 @h-ai/core 范式） ───\n\n/**\n * AI 错误信息映射（错误码:HTTP状态码）。\n *\n * 错误码采用 3 位数字格式（000-999），HTTP 状态码遵循标准 HTTP 规范。\n * 完整错误码将自动生成为：`hai:ai:NNN`\n */\nconst AIErrorInfo = {\n  // 通用 (000-009)\n  INTERNAL_ERROR: '000:500',\n\n  // 初始化 (010-019)\n  NOT_INITIALIZED: '010:500',\n  CONFIGURATION_ERROR: '011:500',\n  INIT_IN_PROGRESS: '012:500',\n  RERANK_API_ERROR: '020:502',\n  RERANK_INVALID_REQUEST: '021:400',\n\n  // LLM (100-199)\n  API_ERROR: '100:502',\n  INVALID_REQUEST: '101:400',\n  RATE_LIMITED: '102:429',\n  TIMEOUT: '103:504',\n  MODEL_NOT_FOUND: '104:404',\n  CONTEXT_LENGTH_EXCEEDED: '105:400',\n  LLM_RECORD_FAILED: '106:500',\n  LLM_HISTORY_FAILED: '107:500',\n\n  // MCP (200-299)\n  MCP_CONNECTION_ERROR: '200:502',\n  MCP_PROTOCOL_ERROR: '201:502',\n  MCP_TOOL_ERROR: '202:500',\n  MCP_RESOURCE_ERROR: '203:500',\n  MCP_SERVER_ERROR: '204:502',\n\n  // Embedding (300-399)\n  EMBEDDING_API_ERROR: '300:502',\n  EMBEDDING_MODEL_NOT_FOUND: '301:404',\n  EMBEDDING_INPUT_TOO_LONG: '302:400',\n\n  // 工具 (400-499)\n  TOOL_NOT_FOUND: '400:404',\n  TOOL_VALIDATION_FAILED: '401:400',\n  TOOL_EXECUTION_FAILED: '402:500',\n  TOOL_TIMEOUT: '403:504',\n\n  // Reasoning (500-599)\n  REASONING_FAILED: '500:500',\n  REASONING_MAX_ROUNDS: '501:400',\n  REASONING_STRATEGY_NOT_FOUND: '502:404',\n\n  // Retrieval (600-699)\n  RETRIEVAL_FAILED: '600:500',\n  RETRIEVAL_SOURCE_NOT_FOUND: '601:404',\n\n  // RAG (700-799)\n  RAG_FAILED: '700:500',\n  RAG_CONTEXT_BUILD_FAILED: '701:500',\n\n  // Knowledge (800-899)\n  KNOWLEDGE_SETUP_FAILED: '800:500',\n  KNOWLEDGE_INGEST_FAILED: '801:500',\n  KNOWLEDGE_RETRIEVE_FAILED: '802:500',\n  KNOWLEDGE_ENTITY_EXTRACT_FAILED: '803:500',\n  KNOWLEDGE_NOT_SETUP: '804:500',\n  KNOWLEDGE_COLLECTION_NOT_FOUND: '805:404',\n\n  // Memory (900-949)\n  MEMORY_EXTRACT_FAILED: '900:500',\n  MEMORY_STORE_FAILED: '901:500',\n  MEMORY_RECALL_FAILED: '902:500',\n  MEMORY_NOT_FOUND: '903:404',\n  MEMORY_ENRICH_FAILED: '904:500',\n\n  // File (030-049)\n  FILE_PARSE_FAILED: '030:500',\n  FILE_UNSUPPORTED_FORMAT: '031:400',\n  FILE_OCR_FAILED: '032:500',\n  FILE_INVALID_CONTENT: '033:400',\n\n  // Context (950-999)\n  CONTEXT_COMPRESS_FAILED: '950:500',\n  CONTEXT_SUMMARIZE_FAILED: '951:500',\n  CONTEXT_TOKEN_ESTIMATE_FAILED: '952:500',\n  CONTEXT_BUDGET_EXCEEDED: '953:400',\n\n  // Store (960-969)\n  STORE_FAILED: '960:500',\n  STORE_NOT_AVAILABLE: '961:503',\n\n  // Session (970-979)\n  SESSION_NOT_FOUND: '970:404',\n  SESSION_FAILED: '971:500',\n\n  // A2A (980-999)\n  A2A_NOT_CONFIGURED: '980:500',\n  A2A_HANDLE_FAILED: '981:500',\n  A2A_REMOTE_CALL_FAILED: '982:502',\n  A2A_AUTH_FAILED: '983:401',\n  A2A_LIST_MESSAGES_FAILED: '984:500',\n} as const satisfies ErrorInfo\n\n/**\n * AI 模块标准错误定义对象。\n *\n * 通过 `HaiAIError.ERROR_CODE_NAME` 访问具体错误定义，如：\n * ```ts\n * const def = HaiAIError.NOT_INITIALIZED\n * // => { code: 'hai:ai:010', httpStatus: 500, system: 'hai', module: 'ai' }\n * ```\n */\nexport const HaiAIError = core.error.buildHaiErrorsDef('ai', AIErrorInfo)\n\n// ─── 初始化选项 ───\n\n/**\n * AI 初始化运行时选项\n *\n * 用于传入运行时对象（如自定义 StoreProvider），\n * 这些对象无法通过 Zod 配置 Schema 传递。\n */\nexport interface AIInitOptions {\n  /**\n   * 自定义存储 Provider\n   *\n   * 提供后 AI 模块将使用此 Provider 而非默认的 reldb+vecdb 实现，\n   * 此时不需要提前初始化 reldb/vecdb。\n   */\n  storeProvider?: AIStoreProvider\n}\n\n// ─── AIFunctions 接口 ───\n\n/**\n * AI 服务接口（通过 `ai` 对象访问）\n *\n * 所有 AI 功能的统一入口，需先调用 `init()` 初始化后才能使用 `llm`、`mcp` 操作。\n * `tools` 和 `stream` 为纯函数，无需初始化即可使用。\n *\n * @example\n * ```ts\n * import { ai } from '@h-ai/ai'\n *\n * await ai.init({ llm: { model: 'gpt-4o-mini' } })\n * const result = await ai.llm.chat({ messages: [{ role: 'user', content: '你好' }] })\n * ai.close()\n * ```\n */\nexport interface AIFunctions {\n  /**\n   * 初始化 AI 服务\n   *\n   * 使用 Zod Schema 校验配置，失败返回 `CONFIGURATION_ERROR`。\n   * 重复调用会先关闭旧实例再重新初始化。\n   *\n   * @param config - AI 配置（可选，默认使用空对象并应用 Schema 默认值）\n   * @param options - 运行时选项（可选，用于传入自定义 StoreProvider 等运行时对象）\n   * @returns 成功返回 `ok(undefined)`；配置校验失败返回 `err(HaiAIError.CONFIGURATION_ERROR)`\n   */\n  init: (config?: AIConfigInput, options?: AIInitOptions) => Promise<HaiResult<void>>\n  /**\n   * 关闭 AI 服务，释放内部状态\n   *\n   * 关闭后 `llm`、`mcp` 操作将返回 `NOT_INITIALIZED` 错误。\n   * 重复关闭不会报错。\n   */\n  close: () => void\n  /** 当前配置（未初始化时为 `null`） */\n  readonly config: AIConfig | null\n  /** 是否已初始化（`init()` 成功后为 `true`，`close()` 后为 `false`） */\n  readonly isInitialized: boolean\n  /** LLM 操作（聊天、流式、模型列表），需要先调用 `init()` */\n  readonly llm: LLMOperations\n  /** MCP 操作（工具/资源/提示词注册与调用），需要先调用 `init()` */\n  readonly mcp: MCPOperations\n  /** 工具操作（定义工具与注册表），纯函数，无需初始化 */\n  readonly tools: ToolsOperations\n  /** 流处理操作（流处理器、SSE 编解码），纯函数，无需初始化 */\n  readonly stream: StreamOperations\n  /** Embedding 操作（向量嵌入），需要先调用 `init()` */\n  readonly embedding: EmbeddingOperations\n  /** 推理操作（ReAct / CoT / Plan-Execute），需要先调用 `init()` */\n  readonly reasoning: ReasoningOperations\n  /** 检索操作（向量检索），需要先调用 `init()` */\n  readonly retrieval: RetrievalOperations\n  /** RAG 操作（检索增强生成），需要先调用 `init()` */\n  readonly rag: RagOperations\n  /** Knowledge 操作（知识库管理与检索），需要先调用 `init()` 和 `knowledge.setup()` */\n  readonly knowledge: KnowledgeOperations\n  /** Memory 操作（记忆提取、存储、检索、注入），需要先调用 `init()` */\n  readonly memory: MemoryOperations\n  /** Token 操作（Token 估算），需要先调用 `init()` */\n  readonly token: TokenOperations\n  /** Summary 操作（消息摘要生成），需要先调用 `init()` */\n  readonly summary: SummaryOperations\n  /** Compress 操作（上下文压缩），需要先调用 `init()` */\n  readonly compress: CompressOperations\n  /** Context 操作（有状态上下文管理器，编排 LLM + Memory + RAG + Reasoning），需要先调用 `init()` */\n  readonly context: ContextOperations\n  /** Rerank 操作（文档重排序），需要先调用 `init()` */\n  readonly rerank: RerankOperations\n  /** File 操作（文件内容解析），需要先调用 `init()` */\n  readonly file: FileOperations\n  /** A2A 操作（Agent-to-Agent 协议），需要先调用 `init()` 并配置 `a2a` */\n  readonly a2a: A2AOperations\n}\n","/**\n * @h-ai/ai — Compress 子功能类型\n *\n * 定义上下文压缩操作的类型接口：滑动窗口、摘要、混合三种策略。\n * 在对话超出模型上下文窗口时，自动压缩历史消息以保持对话连续性。\n * @module ai-compress-types\n */\n\nimport type { HaiResult } from '@h-ai/core'\n\nimport type { ChatMessage } from '../llm/ai-llm-types.js'\n\nimport { z } from 'zod'\n\n// ─── 压缩策略枚举 ───\n\n/** 压缩策略枚举 */\nexport const CompressionStrategySchema = z.enum(['summary', 'sliding-window', 'hybrid'])\n\n/** 压缩策略类型 */\nexport type CompressionStrategy = z.infer<typeof CompressionStrategySchema>\n\n// ─── 压缩选项与结果 ───\n\n/**\n * 上下文压缩选项\n */\nexport interface CompressOptions {\n  /** 压缩策略（默认使用配置的 defaultStrategy） */\n  strategy?: CompressionStrategy\n  /** 目标 token 数（默认使用配置的 defaultMaxTokens，0 表示取模型 maxTokens 的 80%） */\n  maxTokens?: number\n  /** 保留 system 消息（默认 true） */\n  preserveSystem?: boolean\n  /** 保留最近 N 条消息不压缩（默认使用配置的 preserveLastN） */\n  preserveLastN?: number\n  /** 摘要用的模型 */\n  summaryModel?: string\n}\n\n/**\n * 上下文压缩结果\n */\nexport interface CompressResult {\n  /** 压缩后的消息列表 */\n  messages: ChatMessage[]\n  /** 原始消息的估算 token 数 */\n  originalTokens: number\n  /** 压缩后的估算 token 数 */\n  compressedTokens: number\n  /** 被移除/合并的消息数 */\n  removedCount: number\n  /** 生成的摘要文本（仅 summary/hybrid 策略有值） */\n  summary?: string\n}\n\n// ─── Compress 操作接口 ───\n\n/**\n * Compress 操作接口\n *\n * 管理对话消息的压缩，支持三种策略：\n * - `sliding-window`：移除最旧的消息，保留最近 N 条\n * - `summary`：使用 LLM 生成摘要替换旧消息\n * - `hybrid`：先滑动窗口，不够则回退到摘要\n *\n * @example\n * ```ts\n * const result = await compressOps.tryCompress(messages, {\n *   strategy: 'hybrid',\n *   maxTokens: 4000,\n * })\n * if (result.success) {\n *   const compressed = result.data.messages\n * }\n * ```\n */\nexport interface CompressOperations {\n  /**\n   * 尝试压缩消息列表，使其不超过指定 Token 预算\n   *\n   * 如果当前 token 数未超限则直接返回（不压缩），因此命名为 tryCompress。\n   *\n   * @param messages - 消息列表\n   * @param options - 压缩选项\n   * @returns 压缩结果\n   */\n  tryCompress: (messages: ChatMessage[], options?: CompressOptions) => Promise<HaiResult<CompressResult>>\n}\n","/**\n * @h-ai/ai — Knowledge 子功能类型\n *\n * 定义知识库操作的类型接口：文档导入、实体索引、信源追踪检索。\n * @module ai-knowledge-types\n */\n\nimport type { HaiError, HaiResult } from '@h-ai/core'\nimport type { ChunkOptionsInput, CleanOptionsInput } from '@h-ai/datapipe'\n\nimport type { ChatMessage } from '../llm/ai-llm-types.js'\nimport type { Citation } from '../retrieval/ai-retrieval-types.js'\n\nimport { z } from 'zod'\n\n// ─── 实体类型枚举 ───\n\n/**\n * 内置实体类型枚举（预设值，可通过配置 `entityTypes` 扩展）\n */\nexport const EntityTypeSchema = z.enum(['person', 'project', 'concept', 'organization', 'location', 'event', 'other'])\n\n/** 实体类型（字符串，支持内置类型及用户自定义类型） */\nexport type EntityType = string\n\n// ─── 实体 ───\n\n/**\n * 知识实体\n *\n * 表示从文档中提取的命名实体（人名、项目名、概念等），\n * 存储在 KnowledgeStore 中用于倒排索引查询。\n *\n * @example\n * ```ts\n * const entity: KnowledgeEntity = {\n *   id: 'ent-001',\n *   name: '张三',\n *   type: 'person',\n *   aliases: ['小张', 'Zhang San'],\n * }\n * ```\n */\nexport interface KnowledgeEntity {\n  /** 实体唯一标识 */\n  id: string\n  /** 实体名称 */\n  name: string\n  /** 实体类型 */\n  type: EntityType\n  /** 别名列表（可选） */\n  aliases?: string[]\n  /** 描述（可选） */\n  description?: string\n  /** 创建时间 */\n  createdAt?: string\n  /** 更新时间 */\n  updatedAt?: string\n}\n\n/**\n * 文档-实体关联记录\n *\n * 倒排索引中的一条记录，记录实体与文档/分块的关联关系。\n */\nexport interface EntityDocumentRelation {\n  /** 实体 ID */\n  entityId: string\n  /** 文档 ID（对应向量存储中的 documentId） */\n  documentId: string\n  /** 分块 ID（对应向量存储中的向量记录 ID） */\n  chunkId?: string\n  /** 集合名 */\n  collection: string\n  /** 关联强度 [0, 1]（默认 1.0） */\n  relevance?: number\n  /** 实体在该文档中的上下文片段（可选） */\n  context?: string\n  /** 创建时间 */\n  createdAt?: string\n}\n\n// ─── 知识库操作输入/输出 ───\n\n/**\n * 知识库初始化选项\n */\nexport interface KnowledgeSetupOptions {\n  /** 集合名（可选，默认使用配置中的 collection） */\n  collection?: string\n  /** 向量维度（可选，默认使用配置中的 dimension） */\n  dimension?: number\n}\n\n/**\n * 文档导入输入\n *\n * @example\n * ```ts\n * const input: KnowledgeIngestInput = {\n *   documentId: 'doc-001',\n *   content: '# 项目文档\\n\\n张三负责了核心模块...',\n *   title: '项目文档',\n *   url: 'https://docs.example.com/project',\n *   metadata: { author: '李四' },\n * }\n * ```\n */\nexport interface KnowledgeIngestInput {\n  /** 文档唯一标识（必填，用于关联信源和实体） */\n  documentId: string\n  /** 文档原始内容文本 */\n  content: string\n  /** 文档标题（可选，存入 metadata 用于信源展示） */\n  title?: string\n  /** 文档 URL / 路径（可选，存入 metadata 用于信源展示） */\n  url?: string\n  /** 集合名（可选，默认使用配置中的 collection） */\n  collection?: string\n  /** 附加元数据（可选，合并到每个 chunk 的 metadata 中） */\n  metadata?: Record<string, unknown>\n  /** 是否启用实体提取（可选，覆盖全局配置） */\n  enableEntityExtraction?: boolean\n  /**\n   * 文本清洗选项（可选，覆盖全局配置默认值）\n   *\n   * 字段含义与 @h-ai/datapipe CleanOptionsInput 完全一致，\n   * 支持 removeHtml、removeUrls、normalizeWhitespace、customReplacements 等。\n   */\n  cleanOptions?: CleanOptionsInput\n  /**\n   * 分块选项（可选，覆盖全局配置默认值）\n   *\n   * 字段含义与 @h-ai/datapipe ChunkOptionsInput 完全一致，\n   * 支持 mode、maxSize、overlap、separator、markdownMinLevel 等完整选项。\n   */\n  chunkOptions?: ChunkOptionsInput\n}\n\n/**\n * 文档导入结果\n */\nexport interface KnowledgeIngestResult {\n  /** 文档 ID */\n  documentId: string\n  /** 生成的分块数量 */\n  chunkCount: number\n  /** 提取的实体列表（未启用实体提取时为空数组） */\n  entities: KnowledgeEntity[]\n  /** 处理耗时（毫秒） */\n  duration: number\n}\n\n/**\n * 知识检索选项\n */\nexport interface KnowledgeRetrieveOptions {\n  /** 集合名（可选，默认使用配置中的 collection） */\n  collection?: string\n  /** 返回的最大结果数（默认 10） */\n  topK?: number\n  /** 最低相似度（默认无限制） */\n  minScore?: number\n  /** 是否启用实体增强检索（默认 true） */\n  enableEntityBoost?: boolean\n  /** 元数据过滤条件 */\n  filter?: Record<string, unknown>\n}\n\n/**\n * 知识检索结果项\n */\nexport interface KnowledgeRetrieveItem {\n  /** 分块 ID */\n  id: string\n  /** 分块内容 */\n  content: string\n  /** 综合得分（向量相似度 + 实体加权） */\n  score: number\n  /** 结构化信源引用 */\n  citation: Citation\n  /** 元数据 */\n  metadata?: Record<string, unknown>\n  /** 命中的实体名称列表（实体增强检索时填充） */\n  matchedEntities?: string[]\n}\n\n/**\n * 知识检索结果\n */\nexport interface KnowledgeRetrieveResult {\n  /** 检索结果列表（按综合分数降序） */\n  items: KnowledgeRetrieveItem[]\n  /** 去重后的信源引用列表 */\n  citations: Citation[]\n  /** 查询文本 */\n  query: string\n  /** 查询耗时（毫秒） */\n  duration: number\n}\n\n/**\n * 知识问答选项\n */\nexport interface KnowledgeAskOptions extends KnowledgeRetrieveOptions {\n  /** LLM 模型名称覆盖 */\n  model?: string\n  /** 系统提示词覆盖 */\n  systemPrompt?: string\n  /** 温度覆盖 */\n  temperature?: number\n  /** 消息历史（多轮对话） */\n  messages?: ChatMessage[]\n}\n\n/**\n * 知识问答结果\n */\nexport interface KnowledgeAskResult {\n  /** LLM 生成的回答 */\n  answer: string\n  /** 使用的上下文 */\n  context: KnowledgeRetrieveItem[]\n  /** 去重后的信源引用列表 */\n  citations: Citation[]\n  /** 查询文本 */\n  query: string\n  /** 使用的模型 */\n  model: string\n  /** Token 使用统计 */\n  usage?: {\n    prompt_tokens: number\n    completion_tokens: number\n    total_tokens: number\n  }\n}\n\n/**\n * 实体查询选项\n */\nexport interface EntityQueryOptions {\n  /** 集合名（可选，默认使用配置中的 collection） */\n  collection?: string\n  /** 实体类型过滤 */\n  type?: EntityType\n}\n\n/**\n * 实体关联文档结果\n */\nexport interface EntityDocumentResult {\n  /** 实体信息 */\n  entity: KnowledgeEntity\n  /** 关联文档列表 */\n  documents: Array<{\n    documentId: string\n    chunkId?: string\n    collection: string\n    relevance: number\n    context?: string\n  }>\n}\n\n/**\n * 实体列表查询选项\n */\nexport interface EntityListOptions {\n  /** 集合名过滤（不指定则返回所有 collection 的实体） */\n  collection?: string\n  /** 实体类型过滤 */\n  type?: EntityType\n  /** 关键词搜索（模糊匹配实体名称和别名） */\n  keyword?: string\n  /** 最大返回数 */\n  limit?: number\n}\n\n// ─── 文件导入类型 ───\n\n/**\n * 文件导入输入（从文件路径读取内容后自动 ingest）\n *\n * 仅 Node.js 端可用。\n *\n * @example\n * ```ts\n * await knowledge.ingestFile({\n *   filePath: '/data/docs/README.md',\n *   documentId: 'readme',\n * })\n * ```\n */\nexport interface KnowledgeIngestFileInput {\n  /** 文件路径（绝对路径或相对路径） */\n  filePath: string\n  /** 文档唯一标识（可选，默认从文件名派生） */\n  documentId?: string\n  /** 文档标题（可选，默认为文件名） */\n  title?: string\n  /** 文件编码（默认 'utf-8'） */\n  encoding?: BufferEncoding\n  /** 集合名（可选，默认使用配置中的 collection） */\n  collection?: string\n  /** 附加元数据 */\n  metadata?: Record<string, unknown>\n  /** 是否启用实体提取 */\n  enableEntityExtraction?: boolean\n  /** 清洗选项 */\n  cleanOptions?: CleanOptionsInput\n  /** 分块选项 */\n  chunkOptions?: ChunkOptionsInput\n}\n\n// ─── 文档管理类型 ───\n\n/**\n * 文档信息（列表展示用）\n */\nexport interface KnowledgeDocumentInfo {\n  /** 文档 ID */\n  documentId: string\n  /** 文档标题 */\n  title?: string\n  /** 文档来源 URL / 路径 */\n  url?: string\n  /** 分块数量 */\n  chunkCount: number\n  /** 关联实体数 */\n  entityCount: number\n  /** 创建时间（Unix 毫秒） */\n  createdAt: number\n}\n\n/**\n * 文档列表查询选项\n */\nexport interface KnowledgeDocumentListOptions {\n  /** 集合名覆盖（不指定则使用配置中的 default） */\n  collection?: string\n  /** 偏移量 */\n  offset?: number\n  /** 每页数量（默认 20） */\n  limit?: number\n}\n\n/**\n * 文档删除选项\n */\nexport interface KnowledgeDocumentRemoveOptions {\n  /** 集合名覆盖 */\n  collection?: string\n}\n\n// ─── 批量导入类型 ───\n\n/**\n * 批量导入进度回调参数\n */\nexport interface KnowledgeIngestBatchProgress {\n  /** 已完成数量 */\n  completed: number\n  /** 总数量 */\n  total: number\n  /** 当前文档 ID */\n  currentDocumentId: string\n  /** 当前文档导入结果（失败时为 undefined） */\n  result?: KnowledgeIngestResult\n  /** 当前文档导入错误（成功时为 undefined） */\n  error?: HaiError\n}\n\n/**\n * 批量导入结果\n */\nexport interface KnowledgeIngestBatchResult {\n  /** 成功导入的文档数 */\n  successCount: number\n  /** 失败的文档数 */\n  failureCount: number\n  /** 各文档导入结果 */\n  results: Array<{ documentId: string, result?: KnowledgeIngestResult, error?: HaiError }>\n  /** 总耗时（毫秒） */\n  duration: number\n}\n\n// ─── Knowledge 操作接口 ───\n\n/**\n * Knowledge 操作接口（通过 `ai.knowledge` 访问）\n *\n * 知识库管理与检索的统一入口，编排 datapipe + KnowledgeStore + embedding + LLM。\n *\n * ## 生命周期\n *\n * 每个 collection 在使用前必须先调用 `setup()`，支持多次调用以初始化不同分区：\n *\n * ```ts\n * await ai.knowledge.setup()                          // 使用配置默认 collection\n * await ai.knowledge.setup({ collection: 'kb-prod' }) // 初始化额外分区\n * ```\n *\n * ## 单 collection 示例\n *\n * ```ts\n * // 初始化\n * await ai.knowledge.setup()\n *\n * // 导入文档\n * await ai.knowledge.ingest({\n *   documentId: 'doc-001',\n *   content: markdownContent,\n *   title: '项目文档',\n * })\n *\n * // 查询（带信源追踪）\n * const result = await ai.knowledge.retrieve('张三负责了哪些模块？')\n *\n * // 问答（RAG + 信源引用）\n * const answer = await ai.knowledge.ask('张三负责了哪些模块？')\n * ```\n *\n * ## 多 collection（多分区）示例\n *\n * ```ts\n * // 分别初始化两个知识库分区\n * await ai.knowledge.setup({ collection: 'kb-product' })\n * await ai.knowledge.setup({ collection: 'kb-support' })\n *\n * // 写入不同分区\n * await ai.knowledge.ingest({ documentId: 'p-001', content: '...', collection: 'kb-product' })\n * await ai.knowledge.ingest({ documentId: 's-001', content: '...', collection: 'kb-support' })\n *\n * // 从指定分区检索（对未 setup 的 collection 发起任何操作都会返回 KNOWLEDGE_NOT_SETUP 错误）\n * const result = await ai.knowledge.retrieve('query', { collection: 'kb-support' })\n * ```\n */\nexport interface KnowledgeOperations {\n  /**\n   * 初始化知识库（幂等，支持多次调用以初始化不同 collection）\n   *\n   * 创建向量集合和实体表。每个 collection 需独立调用本方法，\n   * 未 setup 的 collection 执行以下操作时均会返回 `KNOWLEDGE_NOT_SETUP` 错误：\n   * `ingest` / `ingestFile` / `ingestBatch` / `retrieve` / `ask` /\n   * `findByEntity` / `listDocuments` / `removeDocument`。\n   *\n   * @param options - 初始化选项（collection 名称、向量维度）\n   * @returns 成功返回 ok(undefined)\n   */\n  setup: (options?: KnowledgeSetupOptions) => Promise<HaiResult<void>>\n\n  /**\n   * 导入文档\n   *\n   * 执行流程：clean → chunk → embed → 向量存储 → 实体提取 → 实体存储\n   *\n   * @param input - 文档导入输入\n   * @returns 导入结果（分块数、实体列表等）\n   */\n  ingest: (input: KnowledgeIngestInput) => Promise<HaiResult<KnowledgeIngestResult>>\n\n  /**\n   * 知识检索（带实体增强 + 信源追踪）\n   *\n   * @param query - 查询文本\n   * @param options - 检索选项\n   * @returns 检索结果（带 citations）\n   */\n  retrieve: (query: string, options?: KnowledgeRetrieveOptions) => Promise<HaiResult<KnowledgeRetrieveResult>>\n\n  /**\n   * 知识问答（RAG + 信源引用）\n   *\n   * @param query - 用户问题\n   * @param options - 问答选项\n   * @returns 问答结果（回答 + 信源）\n   */\n  ask: (query: string, options?: KnowledgeAskOptions) => Promise<HaiResult<KnowledgeAskResult>>\n\n  /**\n   * 按实体查询关联文档\n   *\n   * @param entityName - 实体名称\n   * @param options - 查询选项\n   * @returns 实体关联文档列表\n   */\n  findByEntity: (entityName: string, options?: EntityQueryOptions) => Promise<HaiResult<EntityDocumentResult[]>>\n\n  /**\n   * 列出所有实体\n   *\n   * @param options - 列表选项\n   * @returns 实体列表\n   */\n  listEntities: (options?: EntityListOptions) => Promise<HaiResult<KnowledgeEntity[]>>\n\n  /**\n   * 列出已导入的文档列表\n   *\n   * @param options - 列表选项\n   * @returns 文档信息列表\n   */\n  listDocuments: (options?: KnowledgeDocumentListOptions) => Promise<HaiResult<KnowledgeDocumentInfo[]>>\n\n  /**\n   * 删除已导入的文档（同时删除向量和实体关联）\n   *\n   * @param documentId - 文档 ID\n   * @param options - 删除选项\n   * @returns 成功返回 ok(undefined)\n   */\n  removeDocument: (documentId: string, options?: KnowledgeDocumentRemoveOptions) => Promise<HaiResult<void>>\n\n  /**\n   * 从文件路径导入文档（仅 Node.js 端可用）\n   *\n   * 读取文件内容后自动调用 ingest() 完成导入。\n   *\n   * @param input - 文件导入输入\n   * @returns 导入结果\n   */\n  ingestFile: (input: KnowledgeIngestFileInput) => Promise<HaiResult<KnowledgeIngestResult>>\n\n  /**\n   * 批量导入文档\n   *\n   * 依次执行 ingest()，通过 onProgress 回调报告进度，单个文档失败不中断整体流程。\n   *\n   * @param inputs - 文档导入输入列表\n   * @param onProgress - 每完成一个文档后的回调\n   * @returns 批量导入汇总结果\n   */\n  ingestBatch: (\n    inputs: KnowledgeIngestInput[],\n    onProgress?: (progress: KnowledgeIngestBatchProgress) => void,\n  ) => Promise<HaiResult<KnowledgeIngestBatchResult>>\n\n  /**\n   * 删除整个 collection（幂等）\n   *\n   * 同时清除：vecdb 向量集合、实体-文档关联、文档元数据、collection 注册记录。\n   * 删除后 collection 需重新执行 `setup` 才可使用。\n   *\n   * @param collection - 要删除的 collection 名称，默认使用 config.collection\n   * @returns 成功返回 ok(undefined)；store 不可用时返回 `KNOWLEDGE_SETUP_FAILED`\n   */\n  deleteCollection: (collection?: string) => Promise<HaiResult<void>>\n}\n","/**\n * @h-ai/ai — Memory 子功能类型\n *\n * 定义记忆管理操作的类型接口：提取、存储、检索、注入。\n * 支持从对话中自动提取关键事实、偏好、事件等记忆，并在后续对话中检索注入。\n * @module ai-memory-types\n */\n\nimport type { HaiResult } from '@h-ai/core'\n\nimport type { ChatMessage } from '../llm/ai-llm-types.js'\nimport type { StorePage } from '../store/ai-store-types.js'\n\nimport { z } from 'zod'\n\n// ─── 记忆类型枚举 ───\n\n/**\n * 记忆类型枚举 Schema\n *\n * 定义系统支持的五种记忆类型，用于对提取和存储的记忆进行分类：\n * - `fact` — 客观事实（如「用户是后端工程师」「项目使用 TypeScript」）\n * - `preference` — 用户偏好（如「喜欢简洁的代码风格」「偏好中文回复」）\n * - `event` — 事件/时间线信息（如「上周部署了 v2.0」「昨天修复了登录 Bug」）\n * - `entity` — 命名实体（如人名、产品名、组织名等，便于后续实体关联）\n * - `instruction` — 用户给出的持久指令（如「以后都用函数式写法」「回复不超过 200 字」）\n *\n * @example\n * ```ts\n * import { MemoryTypeSchema } from '@h-ai/ai'\n *\n * // 校验字符串是否为合法记忆类型\n * const result = MemoryTypeSchema.safeParse('preference') // { success: true }\n *\n * // 用于配置或过滤\n * await ai.memory.recall('编程语言', { types: ['preference', 'fact'] })\n * ```\n */\nexport const MemoryTypeSchema = z.enum(['fact', 'preference', 'event', 'entity', 'instruction'])\n\n/** 记忆类型 */\nexport type MemoryType = z.infer<typeof MemoryTypeSchema>\n\n// ─── 记忆条目 ───\n\n/**\n * 记忆条目输入（手动添加时使用）\n *\n * @example\n * ```ts\n * const input: MemoryEntryInput = {\n *   content: '用户偏好使用中文回复',\n *   type: 'preference',\n *   importance: 0.8,\n *   objectId: 'user-001',\n * }\n * ```\n */\nexport interface MemoryEntryInput {\n  /** 记忆内容 */\n  content: string\n  /** 记忆类型 */\n  type: MemoryType\n  /** 重要性评分 [0, 1]（可选，默认 0.5） */\n  importance?: number\n  /** 所属主体 ID（不指定时为全局记忆） */\n  objectId?: string\n  /** 附加元数据 */\n  metadata?: Record<string, unknown>\n}\n\n/**\n * 完整的记忆条目\n */\nexport interface MemoryEntry {\n  /** 记忆唯一标识 */\n  id: string\n  /** 记忆内容 */\n  content: string\n  /** 记忆类型 */\n  type: MemoryType\n  /** 重要性评分 [0, 1] */\n  importance: number\n  /** 所属主体 ID */\n  objectId?: string\n  /** 附加元数据 */\n  metadata?: Record<string, unknown>\n  /** 向量（embedding 已计算时填充） */\n  vector?: number[]\n  /** 创建时间（Unix 毫秒） */\n  createdAt: number\n  /** 最近访问时间（Unix 毫秒） */\n  lastAccessedAt: number\n  /** 被检索次数 */\n  accessCount: number\n}\n\n// ─── 提取选项 ───\n\n/**\n * 记忆提取选项\n */\nexport interface MemoryExtractOptions {\n  /** 只提取指定类型 */\n  types?: MemoryType[]\n  /** 指定提取用的模型 */\n  model?: string\n  /** 自定义提取 systemPrompt（覆盖模块配置与内置默认提示词） */\n  systemPrompt?: string\n  /** 过滤低重要性条目（默认 0） */\n  minImportance?: number\n  /** 所属主体 ID（关联到提取结果） */\n  objectId?: string\n}\n\n// ─── 检索选项 ───\n\n/**\n * 记忆检索选项\n */\nexport interface MemoryRecallOptions {\n  /** 返回数量（默认使用配置的 defaultTopK） */\n  topK?: number\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 最低重要性 */\n  minImportance?: number\n  /** 时间衰减权重 [0, 1]（0 = 不考虑时间，1 = 仅按时间排序） */\n  recencyWeight?: number\n  /** 限定主体 ID */\n  objectId?: string\n}\n\n// ─── 注入选项 ───\n\n/**\n * 记忆注入选项（`injectMemories` 使用）\n *\n * 控制记忆注入行为：检索数量、Token 预算、注入位置等。\n */\nexport interface MemoryInjectionOptions {\n  /** 注入的记忆数量（默认 5） */\n  topK?: number\n  /** 记忆占用的最大 token 预算（默认不限） */\n  maxTokens?: number\n  /** 注入位置：system = 追加到 system 消息末尾，before-last = 插入在最后一条用户消息之前 */\n  position?: 'system' | 'before-last'\n  /** 限定主体 ID */\n  objectId?: string\n}\n\n// ─── 列表与清空选项 ───\n\n/**\n * 记忆列表选项\n */\nexport interface MemoryListOptions {\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 限定主体 ID */\n  objectId?: string\n  /** 最大返回数 */\n  limit?: number\n}\n\n/**\n * 记忆分页选项\n */\nexport interface MemoryListPageOptions {\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 限定主体 ID */\n  objectId?: string\n  /** 偏移量 */\n  offset?: number\n  /** 每页数量（默认 20） */\n  limit?: number\n}\n\n/**\n * 记忆清空选项\n */\nexport interface MemoryClearOptions {\n  /** 仅清空指定类型 */\n  types?: MemoryType[]\n  /** 仅清空指定主体 */\n  objectId?: string\n}\n\n/**\n * 记忆条目更新输入\n *\n * 所有字段均为可选，仅传入需要更新的字段。\n */\nexport interface MemoryUpdateInput {\n  /** 更新记忆内容（同时重新计算向量） */\n  content?: string\n  /** 更新记忆类型 */\n  type?: MemoryType\n  /** 更新重要性 */\n  importance?: number\n  /** 更新元数据 */\n  metadata?: Record<string, unknown>\n}\n\n// ─── Memory 操作接口 ───\n\n/**\n * Memory 操作接口（通过 `ai.memory` 访问）\n *\n * 管理对话中产生的关键事实、用户偏好、长期知识的提取、存储与检索。\n * 需要先调用 `ai.init()` 初始化后使用。\n *\n * @example\n * ```ts\n * // 从对话中自动提取记忆\n * const extracted = await ai.memory.extract(messages, {\n *   objectId: 'user-001',\n *   systemPrompt: 'Only extract durable user preferences and explicit long-term instructions.',\n * })\n *\n * // 手动添加记忆\n * await ai.memory.add({ content: '用户偏好中文', type: 'preference', objectId: 'user-001' })\n *\n * // 检索相关记忆\n * const memories = await ai.memory.recall('用户的语言偏好', { objectId: 'user-001' })\n *\n * // 将记忆注入消息列表\n * const enriched = await ai.memory.injectMemories(newMessages, { objectId: 'user-001' })\n * const response = await ai.llm.chat({ messages: enriched.value })\n * ```\n */\nexport interface MemoryOperations {\n  /**\n   * 从对话消息中自动提取记忆条目\n   *\n   * 使用 LLM 分析对话内容，提取值得记住的事实、偏好、事件等。\n   * 提取的记忆会自动持久化到 Store（含向量计算）。\n   *\n   * @param messages - 对话消息列表\n   * @param options - 提取选项\n   * @returns 提取到的记忆条目列表\n   */\n  extract: (messages: ChatMessage[], options?: MemoryExtractOptions) => Promise<HaiResult<MemoryEntry[]>>\n\n  /**\n   * 根据查询检索最相关的记忆\n   *\n   * 综合向量相似度、重要性、时间衰减进行排序。\n   *\n   * @param query - 查询文本\n   * @param options - 检索选项\n   * @returns 相关记忆列表\n   */\n  recall: (query: string, options?: MemoryRecallOptions) => Promise<HaiResult<MemoryEntry[]>>\n\n  /**\n   * 将相关记忆注入到消息列表中\n   *\n   * 工作流程：\n   * 1. 从消息列表中提取最后一条用户消息作为检索查询\n   * 2. 调用 `recall` 检索最相关的记忆条目\n   * 3. 将记忆格式化为文本块，按指定位置注入消息列表\n   *\n   * @param messages - 原始消息列表\n   * @param options - 注入选项（数量、位置、Token 预算等）\n   * @returns 注入记忆后的新消息列表（不修改原数组）\n   */\n  injectMemories: (messages: ChatMessage[], options?: MemoryInjectionOptions) => Promise<HaiResult<ChatMessage[]>>\n\n  /**\n   * 手动添加一条记忆\n   *\n   * 记忆会自动持久化到 Store（含向量计算）。\n   *\n   * @param entry - 记忆条目输入\n   * @returns 存储后的完整记忆条目\n   */\n  add: (entry: MemoryEntryInput) => Promise<HaiResult<MemoryEntry>>\n\n  /**\n   * 更新一条已有记忆\n   *\n   * 仅更新传入的字段，其余字段保持不变。\n   * 若 content 被更新，会重新计算向量。\n   * 更新结果自动持久化到 Store。\n   *\n   * @param memoryId - 记忆 ID\n   * @param updates - 需要更新的字段\n   * @returns 更新后的完整记忆条目\n   */\n  update: (memoryId: string, updates: MemoryUpdateInput) => Promise<HaiResult<MemoryEntry>>\n\n  /**\n   * 按 ID 获取单条记忆\n   *\n   * @param memoryId - 记忆 ID\n   * @returns 记忆条目，不存在时返回 MEMORY_NOT_FOUND\n   */\n  get: (memoryId: string) => Promise<HaiResult<MemoryEntry>>\n\n  /**\n   * 删除单条记忆\n   *\n   * 同时从 Store 中移除持久化数据。\n   *\n   * @param memoryId - 记忆 ID\n   * @returns 成功返回 ok(undefined)\n   */\n  remove: (memoryId: string) => Promise<HaiResult<void>>\n\n  /**\n   * 获取记忆列表\n   *\n   * @param options - 列表选项\n   * @returns 记忆条目列表\n   */\n  list: (options?: MemoryListOptions) => Promise<HaiResult<MemoryEntry[]>>\n\n  /**\n   * 分页获取记忆列表\n   *\n   * @param options - 分页选项\n   * @returns 分页结果\n   */\n  listPage: (options?: MemoryListPageOptions) => Promise<HaiResult<StorePage<MemoryEntry>>>\n\n  /**\n   * 清空记忆\n   *\n   * 同时从 Store 中移除持久化数据。\n   *\n   * @param options - 清空选项（可按类型/主体过滤）\n   */\n  clear: (options?: MemoryClearOptions) => Promise<HaiResult<void>>\n}\n","{\n  \"$schema\": \"https://inlang.com/schema/inlang-message-format\",\n\n  \"ai_notInitialized\": \"AI service not initialized. Call ai.init() first.\",\n  \"ai_initFailed\": \"Failed to initialize AI service: {error}\",\n  \"ai_initInProgress\": \"AI service initialization is already in progress.\",\n\n  \"ai_requestTimeout\": \"Request timeout\",\n  \"ai_internalError\": \"Internal error: {error}\",\n\n  \"ai_mcpToolNotFound\": \"MCP tool '{name}' not found\",\n  \"ai_mcpToolFailed\": \"MCP tool '{name}' execution failed: {error}\",\n  \"ai_mcpResourceNotFound\": \"MCP resource '{uri}' not found\",\n  \"ai_mcpResourceFailed\": \"MCP resource '{uri}' read failed: {error}\",\n  \"ai_mcpPromptNotFound\": \"MCP prompt '{name}' not found\",\n  \"ai_mcpPromptMissingArg\": \"MCP prompt '{name}' missing required argument '{arg}'\",\n  \"ai_mcpPromptFailed\": \"MCP prompt '{name}' execution failed: {error}\",\n\n  \"ai_toolNotFound\": \"Tool '{name}' not found\",\n  \"ai_toolInvalidJson\": \"Invalid JSON in tool call arguments\",\n  \"ai_configError\": \"AI config validation failed: {error}\",\n\n  \"ai_llmRecordFailed\": \"Chat record save failed: {error}\",\n  \"ai_llmHistoryFailed\": \"Chat history query failed: {error}\",\n\n  \"ai_embeddingApiFailed\": \"Embedding API call failed: {error}\",\n  \"ai_embeddingModelNotFound\": \"Embedding model '{model}' not found\",\n  \"ai_embeddingInputTooLong\": \"Embedding input text exceeds maximum length\",\n\n  \"ai_reasoningFailed\": \"Reasoning execution failed: {error}\",\n  \"ai_reasoningMaxRounds\": \"Reasoning rounds limit reached ({rounds} rounds)\",\n  \"ai_reasoningStrategyNotFound\": \"Reasoning strategy '{strategy}' not found\",\n\n  \"ai_retrievalFailed\": \"Retrieval execution failed: {error}\",\n  \"ai_retrievalSourceNotFound\": \"Retrieval source '{source}' not configured\",\n\n  \"ai_ragFailed\": \"RAG execution failed: {error}\",\n  \"ai_ragContextBuildFailed\": \"RAG context build failed: {error}\",\n\n  \"ai_knowledgeSetupFailed\": \"Knowledge base setup failed: {error}\",\n  \"ai_knowledgeIngestFailed\": \"Knowledge ingestion failed: {error}\",\n  \"ai_knowledgeRetrieveFailed\": \"Knowledge retrieval failed: {error}\",\n  \"ai_knowledgeEntityExtractFailed\": \"Entity extraction failed: {error}\",\n  \"ai_knowledgeNotSetup\": \"Knowledge base not initialized. Call ai.knowledge.setup() first.\",\n  \"ai_knowledgeCollectionNotFound\": \"Knowledge collection '{collection}' not found\",\n\n  \"ai_memoryExtractFailed\": \"Memory extraction failed: {error}\",\n  \"ai_memoryStoreFailed\": \"Memory storage failed: {error}\",\n  \"ai_memoryRecallFailed\": \"Memory recall failed: {error}\",\n  \"ai_memoryNotFound\": \"Memory entry '{id}' not found\",\n  \"ai_memoryEnrichFailed\": \"Memory enrichment failed: {error}\",\n\n  \"ai_contextCompressFailed\": \"Context compression failed: {error}\",\n  \"ai_contextSummarizeFailed\": \"Context summarization failed: {error}\",\n  \"ai_contextTokenEstimateFailed\": \"Token estimation failed: {error}\",\n\n  \"ai_storeFailed\": \"Store operation failed: {error}\",\n  \"ai_storeNotAvailable\": \"Store backend not available, degraded to memory mode\",\n  \"ai_sessionNotFound\": \"Session '{id}' not found\",\n  \"ai_sessionFailed\": \"Session operation failed: {error}\",\n\n  \"ai_rerankApiFailed\": \"Rerank API call failed: {error}\",\n  \"ai_rerankInvalidRequest\": \"Invalid rerank request: {reason}\",\n  \"ai_fileParseFailed\": \"File parsing failed: {error}\",\n  \"ai_fileUnsupportedFormat\": \"Unsupported file format: {mimeType}\",\n  \"ai_fileOcrFailed\": \"OCR recognition failed: {error}\",\n  \"ai_fileInvalidContent\": \"Invalid file content: {reason}\",\n  \"ai_configMissingApiKey\": \"API Key is required for scenario '{scenario}'\",\n\n  \"ai_a2aNotConfigured\": \"A2A service not configured. Provide 'a2a' config in ai.init().\",\n  \"ai_a2aHandleFailed\": \"A2A request handling failed: {error}\",\n  \"ai_a2aRemoteCallFailed\": \"A2A remote call to '{url}' failed: {error}\",\n  \"ai_a2aAuthFailed\": \"A2A authentication failed: {error}\",\n  \"ai_a2aListMessagesFailed\": \"A2A message listing failed: {error}\"\n}\n","{\n  \"$schema\": \"https://inlang.com/schema/inlang-message-format\",\n\n  \"ai_notInitialized\": \"AI 服务未初始化，请先调用 ai.init()\",\n  \"ai_initFailed\": \"AI 服务初始化失败：{error}\",\n  \"ai_initInProgress\": \"AI 服务正在初始化中，请勿重复调用。\",\n\n  \"ai_requestTimeout\": \"请求超时\",\n  \"ai_internalError\": \"内部错误：{error}\",\n\n  \"ai_mcpToolNotFound\": \"MCP 工具 '{name}' 未找到\",\n  \"ai_mcpToolFailed\": \"MCP 工具 '{name}' 执行失败：{error}\",\n  \"ai_mcpResourceNotFound\": \"MCP 资源 '{uri}' 未找到\",\n  \"ai_mcpResourceFailed\": \"MCP 资源 '{uri}' 读取失败：{error}\",\n  \"ai_mcpPromptNotFound\": \"MCP 提示词 '{name}' 未找到\",\n  \"ai_mcpPromptMissingArg\": \"MCP 提示词 '{name}' 缺少必需参数 '{arg}'\",\n  \"ai_mcpPromptFailed\": \"MCP 提示词 '{name}' 执行失败：{error}\",\n\n  \"ai_toolNotFound\": \"工具 '{name}' 未找到\",\n  \"ai_toolInvalidJson\": \"工具调用参数 JSON 格式无效\",\n  \"ai_configError\": \"AI 配置校验失败：{error}\",\n\n  \"ai_llmRecordFailed\": \"对话记录保存失败：{error}\",\n  \"ai_llmHistoryFailed\": \"对话历史查询失败：{error}\",\n\n  \"ai_embeddingApiFailed\": \"Embedding API 调用失败：{error}\",\n  \"ai_embeddingModelNotFound\": \"Embedding 模型 '{model}' 未找到\",\n  \"ai_embeddingInputTooLong\": \"Embedding 输入文本超过最大长度限制\",\n\n  \"ai_reasoningFailed\": \"推理执行失败：{error}\",\n  \"ai_reasoningMaxRounds\": \"推理轮次已达上限（{rounds} 轮）\",\n  \"ai_reasoningStrategyNotFound\": \"推理策略 '{strategy}' 不存在\",\n\n  \"ai_retrievalFailed\": \"检索执行失败：{error}\",\n  \"ai_retrievalSourceNotFound\": \"检索源 '{source}' 未配置\",\n\n  \"ai_ragFailed\": \"RAG 执行失败：{error}\",\n  \"ai_ragContextBuildFailed\": \"RAG 上下文构建失败：{error}\",\n\n  \"ai_knowledgeSetupFailed\": \"知识库初始化失败：{error}\",\n  \"ai_knowledgeIngestFailed\": \"知识入库失败：{error}\",\n  \"ai_knowledgeRetrieveFailed\": \"知识检索失败：{error}\",\n  \"ai_knowledgeEntityExtractFailed\": \"实体提取失败：{error}\",\n  \"ai_knowledgeNotSetup\": \"知识库未初始化，请先调用 ai.knowledge.setup()\",\n  \"ai_knowledgeCollectionNotFound\": \"知识集合 '{collection}' 不存在\",\n\n  \"ai_memoryExtractFailed\": \"记忆提取失败：{error}\",\n  \"ai_memoryStoreFailed\": \"记忆存储失败：{error}\",\n  \"ai_memoryRecallFailed\": \"记忆召回失败：{error}\",\n  \"ai_memoryNotFound\": \"记忆条目 '{id}' 不存在\",\n  \"ai_memoryEnrichFailed\": \"记忆注入失败：{error}\",\n\n  \"ai_contextCompressFailed\": \"上下文压缩失败：{error}\",\n  \"ai_contextSummarizeFailed\": \"上下文总结失败：{error}\",\n  \"ai_contextTokenEstimateFailed\": \"Token 估算失败：{error}\",\n\n  \"ai_storeFailed\": \"存储操作失败：{error}\",\n  \"ai_storeNotAvailable\": \"存储后端不可用，已降级为内存模式\",\n  \"ai_sessionNotFound\": \"会话 '{id}' 不存在\",\n  \"ai_sessionFailed\": \"会话操作失败：{error}\",\n\n  \"ai_rerankApiFailed\": \"Rerank API 调用失败：{error}\",\n  \"ai_rerankInvalidRequest\": \"Rerank 请求参数无效：{reason}\",\n  \"ai_fileParseFailed\": \"文件解析失败：{error}\",\n  \"ai_fileUnsupportedFormat\": \"不支持的文件格式：{mimeType}\",\n  \"ai_fileOcrFailed\": \"OCR 识别失败：{error}\",\n  \"ai_fileInvalidContent\": \"文件内容无效：{reason}\",\n  \"ai_configMissingApiKey\": \"场景 '{scenario}' 需要提供 API Key\",\n\n  \"ai_a2aNotConfigured\": \"A2A 服务未配置，请在 ai.init() 中提供 'a2a' 配置。\",\n  \"ai_a2aHandleFailed\": \"A2A 请求处理失败：{error}\",\n  \"ai_a2aRemoteCallFailed\": \"A2A 远端调用 '{url}' 失败：{error}\",\n  \"ai_a2aAuthFailed\": \"A2A 认证失败：{error}\",\n  \"ai_a2aListMessagesFailed\": \"A2A 消息查询失败：{error}\"\n}\n","/**\n * @h-ai/ai — i18n 消息获取器\n *\n * 模块内部使用，不对外导出。\n *\n * @internal\n * @module ai-i18n\n */\n\nimport { core } from '@h-ai/core'\nimport messagesEnUS from '../messages/en-US.json'\nimport messagesZhCN from '../messages/zh-CN.json'\n\ntype AiMessageKey = keyof typeof messagesZhCN\n\n/**\n * 获取 AI 模块本地化文案\n *\n * @internal\n */\nexport const aiM = core.i18n.createMessageGetter<AiMessageKey>({\n  'zh-CN': messagesZhCN,\n  'en-US': messagesEnUS,\n})\n","/**\n * @h-ai/ai — 错误码 + 配置 Schema\n *\n * 定义 AI 模块的错误码常量、Zod Schema 和配置类型。\n * @module ai-config\n */\n\nimport type { HaiResult } from '@h-ai/core'\nimport process from 'node:process'\nimport { err, ok } from '@h-ai/core'\nimport { ChunkOptionsSchema, CleanOptionsSchema } from '@h-ai/datapipe'\nimport { z } from 'zod'\nimport { aiM } from './ai-i18n.js'\n\nimport { HaiAIError } from './ai-types.js'\nimport { CompressionStrategySchema } from './compress/ai-compress-types.js'\n\n// ─── LLM 配置 Schema ───\n\n// ─── 多模型配置 ───\n\n/**\n * 模型场景枚举\n *\n * 预定义的模型使用场景，用于自动选择合适的模型。\n *\n * - `default` — 默认场景（兜底）\n * - `chat` — 对话场景\n * - `reasoning` — 推理场景（ReAct、CoT，需要强逻辑能力）\n * - `plan` — Plan-Execute 规划阶段（需要强推理）\n * - `execute` — Plan-Execute 执行阶段（需要工具调用能力）\n * - `extraction` — 信息提取场景（记忆提取、实体抽取）\n * - `summary` — 摘要/压缩场景（上下文摘要）\n * - `embedding` — 向量嵌入场景\n * - `rerank` — 文档重排序场景\n * - `ocr` — 图片 OCR 识别场景（视觉模型）\n * - `fast` — 快速响应场景（低延迟优先）\n */\nexport const ModelScenarioSchema = z.enum(['default', 'chat', 'reasoning', 'plan', 'execute', 'extraction', 'summary', 'embedding', 'rerank', 'ocr', 'fast'])\n\n/** 模型场景类型 */\nexport type ModelScenario = z.infer<typeof ModelScenarioSchema>\n\n/**\n * 模型条目 Schema\n *\n * 定义单个模型的配置信息，包含唯一 ID、模型名称和可选参数覆盖。\n *\n * @example\n * ```ts\n * const model = {\n *   id: 'gpt-4o',\n *   model: 'gpt-4o',\n *   maxTokens: 8192,\n *   temperature: 0.3,\n * }\n * ```\n */\nexport const ModelEntrySchema = z.object({\n  /** 模型唯一标识（用于 ModelResolver 解析） */\n  id: z.string(),\n  /** 模型名称（传给 API 的实际模型名） */\n  model: z.string(),\n  /** API Key 覆盖（可选，未提供时使用全局配置） */\n  apiKey: z.string().optional(),\n  /** Base URL 覆盖（可选） */\n  baseUrl: z.url().optional(),\n  /** 最大 Token 数覆盖（可选） */\n  maxTokens: z.number().positive().optional(),\n  /** 温度覆盖（可选） */\n  temperature: z.number().min(0).max(2).optional(),\n  /** 超时覆盖（可选，毫秒） */\n  timeout: z.number().positive().optional(),\n})\n\n/** 模型条目类型 */\nexport type ModelEntry = z.infer<typeof ModelEntrySchema>\n\n/**\n * LLM 配置 Schema\n *\n * 配置大模型调用参数：模型名称、API Key、Base URL、温度等。\n * 支持多模型注册和场景映射。\n *\n * 顶层 `apiKey`、`baseUrl`、`maxTokens`、`temperature`、`timeout` 作为全局默认值，\n * 当 `models` 条目中未指定对应字段时，自动回退到这些全局默认值。\n * 通过 `resolveModelEntry()` 统一解析。\n *\n * @example\n * ```ts\n * const llmConfig = {\n *   // 全局默认值（各模型未指定时回退到此处）\n *   apiKey: 'sk-xxx',\n *   baseUrl: 'https://api.openai.com/v1',\n *   model: 'gpt-4o-mini',\n *   maxTokens: 4096,\n *   temperature: 0.7,\n *   timeout: 60000,\n *   // 多模型注册（各字段可选，未指定时回退到全局默认值）\n *   models: [\n *     { id: 'fast', model: 'gpt-4o-mini', temperature: 0.3 },\n *     { id: 'strong', model: 'gpt-4o', maxTokens: 8192 },\n *     { id: 'rerank', model: 'rerank-english-v3.0', baseUrl: 'https://api.cohere.com' },\n *   ],\n *   // 场景映射（场景名 → 模型 ID 或模型名称）\n *   scenarios: { chat: 'fast', reasoning: 'strong', rerank: 'rerank' },\n * }\n * ```\n */\nexport const LLMConfigSchema = z.object({\n  /** 全局 API Key（各模型 fallback；未提供时回退到 `process.env.HAI_AI_LLM_API_KEY` 或 `process.env.OPENAI_API_KEY`） */\n  apiKey: z.string().optional(),\n  /** 全局 API 基础 URL（各模型 fallback；未提供时回退到 `process.env.HAI_AI_LLM_BASE_URL` 或 `process.env.OPENAI_BASE_URL`） */\n  baseUrl: z.url().optional(),\n  /** 默认模型名称（默认 `'gpt-4o-mini'`） */\n  model: z.string().optional().default('gpt-4o-mini'),\n  /** 全局最大 Token 数（各模型 fallback，默认 `4096`） */\n  maxTokens: z.number().positive().optional().default(4096),\n  /** 全局采样温度（各模型 fallback，范围 `[0, 2]`，默认 `0.7`） */\n  temperature: z.number().min(0).max(2).optional().default(0.7),\n  /** 全局请求超时时间（各模型 fallback，毫秒，默认 `60000`） */\n  timeout: z.number().positive().optional().default(60000),\n  /** 多模型配置列表（各字段可选，未指定时回退到全局默认值） */\n  models: z.array(ModelEntrySchema).optional(),\n  /** 场景模型映射（场景名 → 模型 ID 或直接模型名称，各场景均可选） */\n  scenarios: z.object(Object.fromEntries(ModelScenarioSchema.options.map(k => [k, z.string().optional()])) as Record<ModelScenario, z.ZodOptional<z.ZodString>>).optional(),\n})\n\n/** LLM 配置类型 */\nexport type LLMConfig = z.infer<typeof LLMConfigSchema>\n\n/**\n * 已解析的模型配置\n *\n * 由 `resolveModelEntry()` 返回，包含模型名称和完整的参数配置（已合并全局默认值和环境变量）。\n */\nexport interface ResolvedModelConfig {\n  /** 模型名称（传给 API 的实际模型名） */\n  model: string\n  /** API Key（模型条目 > 全局配置 > 环境变量） */\n  apiKey: string | undefined\n  /** API 基础 URL（模型条目 > 全局配置 > 环境变量 > 默认 OpenAI） */\n  baseUrl: string\n  /** 最大 Token 数（模型条目 > 全局配置） */\n  maxTokens: number\n  /** 采样温度（模型条目 > 全局配置） */\n  temperature: number\n  /** 请求超时时间（毫秒）（模型条目 > 全局配置） */\n  timeout: number\n}\n\n/**\n * 必需模型解析选项\n */\nexport interface ResolveRequiredModelEntryOptions {\n  /** 缺少 API Key 时的自定义错误消息 */\n  missingApiKeyMessage?: string\n}\n\n/**\n * 根据场景解析完整模型配置，并要求必须存在 API Key\n *\n * 用于需要访问远程模型 API 的场景，避免各子模块重复编写\n * `if (!resolved.apiKey)` 之类的配置校验逻辑。\n *\n * @param llmConfig - LLM 配置\n * @param scenario - 使用场景\n * @param explicit - 调用方显式指定的模型名称（最高优先级）\n * @param options - 必需校验选项\n * @returns 成功返回已解析模型配置，失败返回 `CONFIGURATION_ERROR`\n */\nexport function resolveModelEntry(\n  llmConfig: LLMConfig,\n  scenario: ModelScenario,\n  explicit?: string,\n  options?: ResolveRequiredModelEntryOptions,\n): HaiResult<ResolvedModelConfig> {\n  let entry: ModelEntry | undefined\n  let modelName: string\n\n  if (explicit) {\n    // 显式指定的模型名，尝试匹配 models 条目\n    entry = llmConfig.models?.find(m => m.id === explicit || m.model === explicit)\n    modelName = entry?.model ?? explicit\n  }\n  else {\n    // 从场景映射查找\n    const modelId = llmConfig.scenarios?.[scenario] ?? llmConfig.scenarios?.default\n    if (modelId) {\n      entry = llmConfig.models?.find(m => m.id === modelId)\n      modelName = entry?.model ?? modelId\n    }\n    else {\n      modelName = llmConfig.model ?? 'gpt-4o-mini'\n    }\n  }\n\n  const resolved: ResolvedModelConfig = {\n    model: modelName,\n    apiKey: entry?.apiKey ?? llmConfig.apiKey ?? process.env.HAI_AI_LLM_API_KEY ?? process.env.OPENAI_API_KEY,\n    baseUrl: entry?.baseUrl ?? llmConfig.baseUrl ?? process.env.HAI_AI_LLM_BASE_URL ?? process.env.OPENAI_BASE_URL ?? 'https://api.openai.com/v1',\n    maxTokens: entry?.maxTokens ?? llmConfig.maxTokens ?? 4096,\n    temperature: entry?.temperature ?? llmConfig.temperature ?? 0.7,\n    timeout: entry?.timeout ?? llmConfig.timeout ?? 60000,\n  }\n\n  if (!resolved.apiKey) {\n    return err(HaiAIError.CONFIGURATION_ERROR, options?.missingApiKeyMessage ?? aiM('ai_configMissingApiKey', { params: { scenario } }))\n  }\n\n  return ok(resolved)\n}\n\n// ─── MCP 配置 Schema ───\n\n/** MCP 服务器能力 Schema */\nexport const MCPServerCapabilitiesSchema = z.object({\n  /** 是否支持工具调用（默认 `true`） */\n  tools: z.boolean().optional().default(true),\n  /** 是否支持资源访问（默认 `true`） */\n  resources: z.boolean().optional().default(true),\n  /** 是否支持提示词模板（默认 `true`） */\n  prompts: z.boolean().optional().default(true),\n})\n\n/** MCP 服务器能力类型 */\nexport type MCPServerCapabilities = z.infer<typeof MCPServerCapabilitiesSchema>\n\n/** MCP 服务器配置 Schema */\nexport const MCPServerConfigSchema = z.object({\n  /** 服务器名称 */\n  name: z.string(),\n  /** 服务器版本（默认 `'1.0.0'`） */\n  version: z.string().optional().default('1.0.0'),\n  /** 服务器能力声明 */\n  capabilities: MCPServerCapabilitiesSchema.optional(),\n})\n\n/** MCP 服务器配置类型 */\nexport type MCPServerConfig = z.infer<typeof MCPServerConfigSchema>\n\n/**\n * MCP 配置 Schema\n *\n * 配置 MCP（Model Context Protocol）服务器参数。\n *\n * @example\n * ```ts\n * const mcpConfig = {\n *   server: {\n *     name: 'my-app',\n *     version: '1.0.0',\n *     capabilities: { tools: true, resources: true, prompts: true },\n *   },\n * }\n * ```\n */\nexport const MCPConfigSchema = z.object({\n  /** 服务器配置 */\n  server: MCPServerConfigSchema.optional(),\n})\n\n/** MCP 配置类型 */\nexport type MCPConfig = z.infer<typeof MCPConfigSchema>\n\n// ─── 统一 AI 配置 ───\n\n/**\n * Embedding 配置 Schema\n *\n * 配置文本向量化参数。\n * 模型通过 LLMConfigSchema.scenarios.embedding 解析，\n * apiKey / baseUrl 统一使用 LLM 配置。\n *\n * @example\n * ```ts\n * const embeddingConfig = {\n *   dimensions: 1536,\n *   batchSize: 100,\n * }\n * ```\n */\nexport const EmbeddingConfigSchema = z.object({\n  /** 向量维度（可选，部分模型支持指定维度） */\n  dimensions: z.number().int().positive().optional(),\n  /** 批量大小（单次请求最多处理的文本数，默认 100） */\n  batchSize: z.number().int().positive().default(100),\n})\n\n/** Embedding 配置类型 */\nexport type EmbeddingConfig = z.infer<typeof EmbeddingConfigSchema>\n\n// ─── Knowledge 配置 Schema ───\n\nexport { CompressionStrategySchema } from './compress/ai-compress-types.js'\nexport type { CompressionStrategy } from './compress/ai-compress-types.js'\n\n/**\n * Knowledge 配置 Schema\n *\n * 配置知识库管理参数：向量集合、分块策略、实体提取等。\n * 模型通过 LLMConfigSchema.scenarios 解析，\n * apiKey / baseUrl 统一使用 LLM 配置。\n *\n * @example\n * ```ts\n * const knowledgeConfig = {\n *   collection: 'my-knowledge',\n *   dimension: 1536,\n *   enableEntityExtraction: true\n * }\n * ```\n */\nexport const KnowledgeConfigSchema = z.object({\n  /** 默认向量集合名（默认 'hai_ai_knowledge'） */\n  collection: z.string().default('hai_ai_knowledge'),\n  /** 向量维度（默认 1536，需与 embedding 模型匹配） */\n  dimension: z.number().int().positive().default(1536),\n  /** 是否启用实体提取（默认 true） */\n  enableEntityExtraction: z.boolean().default(true),\n  /**\n   * 默认文本清洗选项\n   *\n   * 字段含义与 @h-ai/datapipe CleanOptionsInput 完全一致，\n   * 支持 removeHtml、removeUrls、normalizeWhitespace、customReplacements 等。\n   */\n  cleanOptions: CleanOptionsSchema.default(CleanOptionsSchema.parse({})),\n  /**\n   * 默认分块选项\n   *\n   * 字段含义与 @h-ai/datapipe ChunkOptionsInput 完全一致，\n   * 支持 mode、maxSize、overlap、separator、markdownMinLevel 等完整选项。\n   */\n  chunkOptions: ChunkOptionsSchema.default(ChunkOptionsSchema.parse({\n    mode: 'markdown',\n    maxSize: 1500,\n    overlap: 200,\n  })),\n  /** 实体查询命中的额外加权系数（默认 0.15，叠加到向量分数上） */\n  entityBoostWeight: z.number().min(0).max(1).default(0.15),\n  /** 自定义实体类型列表（不指定时使用内置默认类型） */\n  entityTypes: z.array(z.string()).optional(),\n  /** 自定义实体提取系统提示词（不指定时使用内置默认提示词） */\n  systemPrompt: z.string().optional(),\n})\n\n/** Knowledge 配置类型 */\nexport type KnowledgeConfig = z.infer<typeof KnowledgeConfigSchema>\n\n// ─── Memory 配置 Schema ───\n\n// EntityTypeSchema / EntityType 定义在 knowledge/ai-knowledge-types.ts 中\nexport { EntityTypeSchema } from './knowledge/ai-knowledge-types.js'\nexport type { EntityType } from './knowledge/ai-knowledge-types.js'\n\n/**\n * Memory 配置 Schema\n *\n * 配置对话记忆的提取、存储与检索参数。\n * 模型通过 LLMConfigSchema.scenarios.extraction 解析，\n * apiKey / baseUrl 统一使用 LLM 配置。\n *\n * @example\n * ```ts\n * const memoryConfig = {\n *   maxEntries: 1000,\n *   embeddingEnabled: true,\n *   recencyDecay: 0.95,\n *   defaultTopK: 10,\n * }\n * ```\n */\nexport const MemoryConfigSchema = z.object({\n  /** 最大记忆条数（默认 1000） */\n  maxEntries: z.number().int().positive().default(1000),\n  /** 自定义记忆提取 systemPrompt（可选，覆盖内置默认提示词） */\n  systemPrompt: z.string().optional(),\n  /** 时间衰减系数（默认 0.95，每次检索乘以此系数调整 recency 权重） */\n  recencyDecay: z.number().min(0).max(1).default(0.95),\n  /** 是否启用向量检索（默认 true，关闭则仅使用关键词匹配） */\n  embeddingEnabled: z.boolean().default(true),\n  /** 检索时默认返回数量（默认 10） */\n  defaultTopK: z.number().int().positive().default(10),\n})\n\n/** Memory 配置类型 */\nexport type MemoryConfig = z.infer<typeof MemoryConfigSchema>\n// MemoryTypeSchema / MemoryType 定义在 memory/ai-memory-types.ts 中\nexport { MemoryTypeSchema } from './memory/ai-memory-types.js'\nexport type { MemoryType } from './memory/ai-memory-types.js'\n\n/**\n * Token 配置 Schema\n *\n * 配置 Token 估算参数。\n *\n * @example\n * ```ts\n * const tokenConfig = { tokenRatio: 0.25 }\n * ```\n */\nexport const TokenConfigSchema = z.object({\n  /** Token 估算每字符系数（默认 0.25，即 4 字符 ≈ 1 token） */\n  tokenRatio: z.number().positive().default(0.25),\n})\n\n/** Token 配置类型 */\nexport type TokenConfig = z.infer<typeof TokenConfigSchema>\n\n/**\n * Summary 配置 Schema\n *\n * 配置摘要生成参数。\n * 模型通过 LLMConfigSchema.scenarios.summary 解析，\n * apiKey / baseUrl 统一使用 LLM 配置。\n *\n * @example\n * ```ts\n * const summaryConfig = { systemPrompt: 'You are a summarizer.' }\n * ```\n */\nexport const SummaryConfigSchema = z.object({\n  /** 自定义摘要 systemPrompt（可选，覆盖内置默认提示词） */\n  systemPrompt: z.string().optional(),\n})\n\n/** Summary 配置类型 */\nexport type SummaryConfig = z.infer<typeof SummaryConfigSchema>\n\n/**\n * Compress 配置 Schema\n *\n * 配置上下文压缩参数：压缩策略、Token 预算、保留消息数。\n *\n * @example\n * ```ts\n * const compressConfig = {\n *   defaultStrategy: 'hybrid',\n *   defaultMaxTokens: 4000,\n *   preserveLastN: 4,\n * }\n * ```\n */\nexport const CompressConfigSchema = z.object({\n  /** 默认压缩策略（默认 'hybrid'） */\n  defaultStrategy: CompressionStrategySchema.default('hybrid'),\n  /** 默认 Token 预算（默认 0 表示取模型上限的 80%） */\n  defaultMaxTokens: z.number().int().min(0).default(0),\n  /** 默认保留最近消息数（默认 4） */\n  preserveLastN: z.number().int().min(0).default(4),\n})\n\n/** Compress 配置类型 */\nexport type CompressConfig = z.infer<typeof CompressConfigSchema>\n\n// ─── File 配置 Schema ───\n\n/**\n * File 配置 Schema\n *\n * 配置文件解析参数：OCR 提示词。\n * OCR 使用的视觉模型通过 `llm.scenarios.ocr` 指定。\n */\nexport const FileConfigSchema = z.object({\n  /** OCR 系统提示词（可选，覆盖内置默认提示词） */\n  systemPrompt: z.string().optional(),\n})\n\n/** File 配置类型 */\nexport type FileConfig = z.infer<typeof FileConfigSchema>\n\n// ─── Retrieval 配置 Schema ───\n\n/**\n * 检索源配置 Schema\n *\n * 与 `RetrievalSource` 接口字段对齐，支持在 `ai.init()` 中预注册检索源。\n */\nexport const RetrievalSourceSchema = z.object({\n  /** 来源唯一标识 */\n  id: z.string(),\n  /** vecdb collection 名称 */\n  collection: z.string(),\n  /** 信源显示名 */\n  name: z.string().optional(),\n  /** 信源 URL / 路径 */\n  url: z.string().optional(),\n  /** 最大返回条数（默认 5） */\n  topK: z.number().int().positive().optional(),\n  /** 最低相似度 0~1（低于此值的结果被过滤） */\n  minScore: z.number().min(0).max(1).optional(),\n  /** 元数据过滤条件 */\n  filter: z.record(z.string(), z.unknown()).optional(),\n})\n\n/** 检索源配置类型 */\nexport type RetrievalSourceConfig = z.infer<typeof RetrievalSourceSchema>\n\n/**\n * Retrieval 配置 Schema\n *\n * 在 `ai.init()` 时预注册检索源，等价于初始化后逐条调用 `ai.retrieval.addSource()`。\n *\n * @example\n * ```ts\n * ai.init({\n *   llm: { apiKey: 'sk-xxx', model: 'gpt-4o-mini' },\n *   retrieval: {\n *     sources: [\n *       { id: 'docs', collection: 'documentation', name: '产品文档', topK: 5, minScore: 0.7 },\n *       { id: 'faq',  collection: 'faq', name: '常见问题' },\n *     ],\n *   },\n * })\n * ```\n */\nexport const RetrievalConfigSchema = z.object({\n  /** 预注册检索源列表 */\n  sources: z.array(RetrievalSourceSchema).optional(),\n})\n\n/** Retrieval 配置类型 */\nexport type RetrievalConfig = z.infer<typeof RetrievalConfigSchema>\n\n// ─── A2A 配置 Schema ───\n\n/** A2A Agent Skill 配置 Schema */\nexport const A2ASkillConfigSchema = z.object({\n  /** 技能 ID */\n  id: z.string(),\n  /** 技能名称 */\n  name: z.string(),\n  /** 技能描述 */\n  description: z.string().optional(),\n  /** 标签列表 */\n  tags: z.array(z.string()).optional(),\n})\n\n/**\n * A2A 配置 Schema\n *\n * 配置 Agent-to-Agent 协议参数：Agent Card、认证等。\n *\n * @example\n * ```ts\n * ai.init({\n *   llm: { apiKey: 'sk-xxx', model: 'gpt-4o-mini' },\n *   a2a: {\n *     agentCard: {\n *       name: 'my-agent',\n *       description: 'An example agent',\n *       url: 'https://example.com',\n *       skills: [{ id: 'chat', name: 'General Chat' }],\n *     },\n *   },\n * })\n * ```\n */\nexport const A2AConfigSchema = z.object({\n  /** Agent Card 配置 */\n  agentCard: z.object({\n    /** Agent 名称 */\n    name: z.string(),\n    /** Agent 描述 */\n    description: z.string().optional(),\n    /** Agent 对外 URL */\n    url: z.string(),\n    /** Agent 版本 */\n    version: z.string().optional(),\n    /** Agent 技能列表 */\n    skills: z.array(A2ASkillConfigSchema).optional(),\n  }),\n  /** A2A 安全认证配置 */\n  security: z.object({\n    /** API Key 认证（通过 IAM apiKey.verifyApiKey 验证） */\n    apiKey: z.object({\n      /** API Key 的传递位置（默认 header） */\n      in: z.enum(['header', 'query']).default('header'),\n      /** 参数名（默认 x-api-key） */\n      name: z.string().default('x-api-key'),\n    }).optional(),\n  }).optional(),\n})\n\n/** A2A 配置类型 */\nexport type A2AConfig = z.infer<typeof A2AConfigSchema>\n\n/**\n * AI 配置 Schema\n *\n * 统一 AI 模块配置：LLM、MCP、Embedding、Knowledge、Retrieval、Memory、Token、Summary、Compress、File。\n * 模型通过 LLM.scenarios 映射场景，子系统不再独立配置 apiKey / baseUrl / model。\n *\n * @example\n * ```ts\n * ai.init({\n *   llm: {\n *     apiKey: 'sk-xxx',\n *     model: 'gpt-4o-mini',\n *     maxTokens: 4096,\n *     models: [\n *       { id: 'rerank', model: 'rerank-english-v3.0', baseUrl: 'https://api.cohere.com' },\n *     ],\n *     scenarios: {\n *       extraction: 'gpt-4o',\n *       summary: 'gpt-4o-mini',\n *       embedding: 'text-embedding-3-small',\n *       rerank: 'rerank',\n *       ocr: 'gpt-4o',\n *     },\n *   },\n *   embedding: { dimensions: 1536 },\n *   knowledge: {\n *     collection: 'docs',\n *     enableEntityExtraction: true,\n *     cleanOptions: { removeHtml: true },\n *     chunkOptions: { mode: 'markdown', maxSize: 1500, overlap: 200 },\n *   },\n *   retrieval: {\n *     sources: [\n *       { id: 'docs', collection: 'documentation', name: '产品文档', topK: 5, minScore: 0.7 },\n *     ],\n *   },\n *   memory: { maxEntries: 500, embeddingEnabled: true },\n *   token: { tokenRatio: 0.25 },\n *   summary: { systemPrompt: 'You are a summarizer.' },\n *   compress: { defaultStrategy: 'hybrid', preserveLastN: 4 },\n * })\n * ```\n */\nexport const AIConfigSchema = z.object({\n  /** LLM 配置（可选，所有字段有默认值） */\n  llm: LLMConfigSchema.default({\n    model: 'gpt-4o-mini',\n    maxTokens: 4096,\n    temperature: 0.7,\n    timeout: 60000,\n  }),\n  /** MCP 配置 */\n  mcp: MCPConfigSchema.optional(),\n  /** Embedding 配置 */\n  embedding: EmbeddingConfigSchema.optional(),\n  /** Knowledge 配置 */\n  knowledge: KnowledgeConfigSchema.optional(),\n  /** Memory 配置 */\n  memory: MemoryConfigSchema.optional(),\n  /** Token 配置 */\n  token: TokenConfigSchema.optional(),\n  /** Summary 配置 */\n  summary: SummaryConfigSchema.optional(),\n  /** Compress 配置 */\n  compress: CompressConfigSchema.optional(),\n  /** Retrieval 配置（预注册检索源） */\n  retrieval: RetrievalConfigSchema.optional(),\n  /** File 解析配置 */\n  file: FileConfigSchema.optional(),\n  /** A2A 配置（Agent-to-Agent 协议） */\n  a2a: A2AConfigSchema.optional(),\n})\n\n/** AI 配置类型（校验后的完整类型） */\nexport type AIConfig = z.infer<typeof AIConfigSchema>\n\n/** AI 配置输入类型（允许部分字段） */\nexport type AIConfigInput = z.input<typeof AIConfigSchema>\n"]}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { ac as ChatCompletionRequest, ad as ChatCompletionResponse, aa as ChatCompletionChunk, aD as KnowledgeRetrieveResult, aq as KnowledgeAskResult, az as KnowledgeIngestResult, ar as KnowledgeDocumentInfo, aJ as MemoryEntry, be as StorePage, aK as MemoryEntryInput, aR as MemoryUpdateInput, bc as SessionInfo, ag as ChatRecord, aY as RagResult, b0 as ReasoningResult, O as A2AAgentCardConfig, _ as A2AMessageRecord, V as A2ACallResult } from '../ai-reasoning-types-YcmdAlAU.js';
+import { ac as ChatCompletionRequest, ad as ChatCompletionResponse, aa as ChatCompletionChunk, aD as KnowledgeRetrieveResult, aq as KnowledgeAskResult, az as KnowledgeIngestResult, ar as KnowledgeDocumentInfo, aJ as MemoryEntry, be as StorePage, aK as MemoryEntryInput, aR as MemoryUpdateInput, bc as SessionInfo, ag as ChatRecord, aY as RagResult, b0 as ReasoningResult, O as A2AAgentCardConfig, _ as A2AMessageRecord, V as A2ACallResult } from '../ai-reasoning-types-CGUgkLF7.js';
 import { HaiResult } from '@h-ai/core';
 import '@a2a-js/sdk/server';
 import '@h-ai/datapipe';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { O as A2AAgentCardConfig, P as A2AApiKeySecurity, Q as A2AAuthenticator, U as A2ACallOptions, V as A2ACallResult, W as A2ACallerIdentity, X as A2AClientCallRecord, A as A2AConfig, a as A2AConfigSchema, Y as A2AContextInfo, Z as A2AHandleResult, _ as A2AMessageRecord, $ as A2AOperations, a0 as A2ASecurityConfig, b as A2ASkillConfigSchema, a1 as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, a2 as AILLMFunctionsDeps, a3 as AIRelStore, a4 as AIRelStoreOptions, a5 as AIStoreProvider, a6 as AIVectorStore, a7 as AskOptions, a8 as AssistantMessage, a9 as ChatCompletionChoice, aa as ChatCompletionChunk, ab as ChatCompletionDelta, ac as ChatCompletionRequest, ad as ChatCompletionResponse, ae as ChatHistoryOptions, af as ChatMessage, ag as ChatRecord, ah as Citation, C as CompressConfig, f as CompressConfigSchema, ai as DefineToolOptions, E as EmbeddingConfig, g as EmbeddingConfigSchema, aj as EntityDocumentRelation, ak as EntityDocumentResult, al as EntityListOptions, am as EntityQueryOptions, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, an as ImageContent, ao as InteractionScope, ap as KnowledgeAskOptions, aq as KnowledgeAskResult, K as KnowledgeConfig, k as KnowledgeConfigSchema, ar as KnowledgeDocumentInfo, as as KnowledgeDocumentListOptions, at as KnowledgeDocumentRemoveOptions, au as KnowledgeEntity, av as KnowledgeIngestBatchProgress, aw as KnowledgeIngestBatchResult, ax as KnowledgeIngestFileInput, ay as KnowledgeIngestInput, az as KnowledgeIngestResult, aA as KnowledgeOperations, aB as KnowledgeRetrieveItem, aC as KnowledgeRetrieveOptions, aD as KnowledgeRetrieveResult, aE as KnowledgeSetupOptions, aF as KnowledgeStore, L as LLMConfig, l as LLMConfigSchema, aG as LLMOperations, aH as LLMProvider, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, aI as MemoryClearOptions, r as MemoryConfig, s as MemoryConfigSchema, aJ as MemoryEntry, aK as MemoryEntryInput, aL as MemoryExtractOptions, aM as MemoryInjectionOptions, aN as MemoryListOptions, aO as MemoryListPageOptions, aP as MemoryOperations, aQ as MemoryRecallOptions, t as MemoryType, u as MemoryTypeSchema, aR as MemoryUpdateInput, aS as MessageContent, aT as MessageRole, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, aU as ObjectRef, aV as RagContextItem, aW as RagOperations, aX as RagOptions, aY as RagResult, aZ as RagStreamEvent, a_ as ReasoningOperations, a$ as ReasoningOptions, b0 as ReasoningResult, b1 as ReasoningStep, b2 as ReasoningStepType, b3 as ReasoningStrategy, b4 as ReasoningStreamEvent, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, b5 as RetrievalOperations, b6 as RetrievalRequest, b7 as RetrievalResult, b8 as RetrievalResultItem, b9 as RetrievalSource, G as RetrievalSourceConfig, H as RetrievalSourceSchema, ba as SSEDecoder, bb as SSEEvent, bc as SessionInfo, bd as StoreFilter, be as StorePage, bf as StoreScope, bg as StreamOperations, bh as StreamProcessor, bi as StreamResult, S as SummaryConfig, I as SummaryConfigSchema, bj as SystemMessage, bk as TextContent, T as TokenConfig, J as TokenConfigSchema, bl as TokenUsage, bm as Tool, bn as ToolCall, bo as ToolDefinition, bp as ToolErrorType, bq as ToolMessage, br as ToolRegistryOperations, bs as ToolsOperations, bt as UserMessage, bu as WhereClause, bv as WhereOperator, bw as WhereValue, N as resolveModelEntry } from './ai-reasoning-types-YcmdAlAU.js';
-import { A as AIFunctions } from './ai-types-Dy8dOY4z.js';
-export { a as AIInitOptions, c as AIMCPFunctionsDeps, d as CompressOperations, e as CompressOptions, f as CompressResult, C as CompressionStrategy, b as CompressionStrategySchema, g as ContextChatOptions, h as ContextChatResult, i as ContextDeps, j as ContextManager, k as ContextManagerOptions, l as ContextOperations, m as ContextStreamEvent, E as EmbeddingItem, n as EmbeddingOperations, o as EmbeddingProvider, p as EmbeddingRequest, q as EmbeddingResponse, F as FileOperations, r as FileParseMethod, s as FileParseOptions, t as FileParseRequest, u as FileParseResult, H as HaiAIError, M as MCPContext, v as MCPOperations, w as MCPPrompt, x as MCPPromptArgument, y as MCPPromptContent, z as MCPPromptMessage, B as MCPProvider, D as MCPResource, G as MCPResourceContent, I as MCPToolDefinition, J as MCPToolHandler, K as McpServerOptions, O as OutputFormat, R as RerankDocument, L as RerankItem, N as RerankOperations, P as RerankRequest, Q as RerankResponse, S as SummaryOperations, T as SummaryOptions, U as SummaryResult, V as TokenOperations } from './ai-types-Dy8dOY4z.js';
+export { O as A2AAgentCardConfig, P as A2AApiKeySecurity, Q as A2AAuthenticator, U as A2ACallOptions, V as A2ACallResult, W as A2ACallerIdentity, X as A2AClientCallRecord, A as A2AConfig, a as A2AConfigSchema, Y as A2AContextInfo, Z as A2AHandleResult, _ as A2AMessageRecord, $ as A2AOperations, a0 as A2ASecurityConfig, b as A2ASkillConfigSchema, a1 as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, a2 as AILLMFunctionsDeps, a3 as AIRelStore, a4 as AIRelStoreOptions, a5 as AIStoreProvider, a6 as AIVectorStore, a7 as AskOptions, a8 as AssistantMessage, a9 as ChatCompletionChoice, aa as ChatCompletionChunk, ab as ChatCompletionDelta, ac as ChatCompletionRequest, ad as ChatCompletionResponse, ae as ChatHistoryOptions, af as ChatMessage, ag as ChatRecord, ah as Citation, C as CompressConfig, f as CompressConfigSchema, ai as DefineToolOptions, E as EmbeddingConfig, g as EmbeddingConfigSchema, aj as EntityDocumentRelation, ak as EntityDocumentResult, al as EntityListOptions, am as EntityQueryOptions, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, an as ImageContent, ao as InteractionScope, ap as KnowledgeAskOptions, aq as KnowledgeAskResult, K as KnowledgeConfig, k as KnowledgeConfigSchema, ar as KnowledgeDocumentInfo, as as KnowledgeDocumentListOptions, at as KnowledgeDocumentRemoveOptions, au as KnowledgeEntity, av as KnowledgeIngestBatchProgress, aw as KnowledgeIngestBatchResult, ax as KnowledgeIngestFileInput, ay as KnowledgeIngestInput, az as KnowledgeIngestResult, aA as KnowledgeOperations, aB as KnowledgeRetrieveItem, aC as KnowledgeRetrieveOptions, aD as KnowledgeRetrieveResult, aE as KnowledgeSetupOptions, aF as KnowledgeStore, L as LLMConfig, l as LLMConfigSchema, aG as LLMOperations, aH as LLMProvider, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, aI as MemoryClearOptions, r as MemoryConfig, s as MemoryConfigSchema, aJ as MemoryEntry, aK as MemoryEntryInput, aL as MemoryExtractOptions, aM as MemoryInjectionOptions, aN as MemoryListOptions, aO as MemoryListPageOptions, aP as MemoryOperations, aQ as MemoryRecallOptions, t as MemoryType, u as MemoryTypeSchema, aR as MemoryUpdateInput, aS as MessageContent, aT as MessageRole, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, aU as ObjectRef, aV as RagContextItem, aW as RagOperations, aX as RagOptions, aY as RagResult, aZ as RagStreamEvent, a_ as ReasoningOperations, a$ as ReasoningOptions, b0 as ReasoningResult, b1 as ReasoningStep, b2 as ReasoningStepType, b3 as ReasoningStrategy, b4 as ReasoningStreamEvent, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, b5 as RetrievalOperations, b6 as RetrievalRequest, b7 as RetrievalResult, b8 as RetrievalResultItem, b9 as RetrievalSource, G as RetrievalSourceConfig, H as RetrievalSourceSchema, ba as SSEDecoder, bb as SSEEvent, bc as SessionInfo, bd as StoreFilter, be as StorePage, bf as StoreScope, bg as StreamOperations, bh as StreamProcessor, bi as StreamResult, S as SummaryConfig, I as SummaryConfigSchema, bj as SystemMessage, bk as TextContent, T as TokenConfig, J as TokenConfigSchema, bl as TokenUsage, bm as Tool, bn as ToolCall, bo as ToolDefinition, bp as ToolErrorType, bq as ToolMessage, br as ToolRegistryOperations, bs as ToolsOperations, bt as UserMessage, bu as WhereClause, bv as WhereOperator, bw as WhereValue, N as resolveModelEntry } from './ai-reasoning-types-CGUgkLF7.js';
+import { A as AIFunctions } from './ai-types-CRCjluXI.js';
+export { a as AIInitOptions, c as AIMCPFunctionsDeps, d as CompressOperations, e as CompressOptions, f as CompressResult, C as CompressionStrategy, b as CompressionStrategySchema, g as ContextChatOptions, h as ContextChatResult, i as ContextDeps, j as ContextManager, k as ContextManagerOptions, l as ContextOperations, m as ContextStreamEvent, E as EmbeddingItem, n as EmbeddingOperations, o as EmbeddingProvider, p as EmbeddingRequest, q as EmbeddingResponse, F as FileOperations, r as FileParseMethod, s as FileParseOptions, t as FileParseRequest, u as FileParseResult, H as HaiAIError, M as MCPContext, v as MCPOperations, w as MCPPrompt, x as MCPPromptArgument, y as MCPPromptContent, z as MCPPromptMessage, B as MCPProvider, D as MCPResource, G as MCPResourceContent, I as MCPToolDefinition, J as MCPToolHandler, K as McpServerOptions, O as OutputFormat, R as RerankDocument, L as RerankItem, N as RerankOperations, P as RerankRequest, Q as RerankResponse, S as SummaryOperations, T as SummaryOptions, U as SummaryResult, V as TokenOperations } from './ai-types-CRCjluXI.js';
 export { TaskStore as A2ATaskStore, AgentExecutor, ExecutionEventBus, RequestContext, ServerCallContext } from '@a2a-js/sdk/server';
 export { AgentCapabilities, AgentCard, AgentProvider, AgentSkill, Artifact, DataPart, FilePart, FileWithBytes, FileWithUri, Message, MessageSendParams, Part, PushNotificationConfig, Task, TaskArtifactUpdateEvent, TaskIdParams, TaskQueryParams, TaskState, TaskStatus, TaskStatusUpdateEvent, TextPart } from '@a2a-js/sdk';
 import '@h-ai/core';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { HaiAIError, aiM, AIConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, resolveModelEntry } from './chunk-5P2VX6FO.js';
-export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-5P2VX6FO.js';
+import { HaiAIError, aiM, AIConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, resolveModelEntry } from './chunk-6PPXWQ7I.js';
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-6PPXWQ7I.js';
 import { core, err, ok } from '@h-ai/core';
 import { datapipe } from '@h-ai/datapipe';
 import { A2AClient } from '@a2a-js/sdk/client';
@@ -1772,6 +1772,7 @@ function createKnowledgeOperations(config, llm, embedding, datapipe2, store) {
                 id: entityId,
                 name: entity.name,
                 type: entity.type,
+                collection,
                 aliases: entity.aliases,
                 description: entity.description
               });
@@ -1871,7 +1872,7 @@ function createKnowledgeOperations(config, llm, embedding, datapipe2, store) {
           if (queryEntityNames.length > 0) {
             const entityMap = /* @__PURE__ */ new Map();
             for (const name of queryEntityNames) {
-              const entities = await store.findEntitiesByName(name);
+              const entities = await store.findEntitiesByName(name, collection);
               for (const e of entities)
                 entityMap.set(e.id, e);
             }
@@ -2022,6 +2023,7 @@ ${contextText}
       }
       try {
         const rows = await store.listEntities({
+          collection: options?.collection,
           type: options?.type,
           keyword: options?.keyword,
           limit: options?.limit
@@ -2085,10 +2087,9 @@ ${contextText}
             logger7.warn("Failed to delete some vectors", { documentId, error: vecError });
           }
         }
-        const entityIds = await store.removeDocumentEntityRelations(documentId, collection);
+        await store.deleteDocumentEntities(documentId, collection);
+        await store.removeDocumentEntityRelations(documentId, collection);
         await store.removeDocument(documentId, collection);
-        if (entityIds.length > 0)
-          await store.deleteEntities(entityIds);
         logger7.debug("Document removed", { documentId, collection });
         return ok(void 0);
       } catch (error) {
@@ -4510,6 +4511,7 @@ function buildKnowledgeSchemaStatements(dbType) {
   id          ${pk} PRIMARY KEY,
   name        ${textCol} NOT NULL,
   type        ${textCol} NOT NULL,
+  collection  ${textCol} NOT NULL,
   aliases     ${longText},
   description ${longText},
   created_at  BIGINT DEFAULT 0,
@@ -4517,6 +4519,7 @@ function buildKnowledgeSchemaStatements(dbType) {
 )`,
     `CREATE INDEX IF NOT EXISTS idx_hai_ai_knowledge_entity_name ON hai_ai_knowledge_entity(name)`,
     `CREATE INDEX IF NOT EXISTS idx_hai_ai_knowledge_entity_type ON hai_ai_knowledge_entity(type)`,
+    `CREATE INDEX IF NOT EXISTS idx_hai_ai_knowledge_entity_collection ON hai_ai_knowledge_entity(collection)`,
     `CREATE TABLE IF NOT EXISTS hai_ai_knowledge_entity_document (
   entity_id   ${pk} NOT NULL,
   document_id ${pk} NOT NULL,
@@ -4569,18 +4572,21 @@ var DbKnowledgeStore = class {
   }
   async upsertEntity(entity) {
     const now = Date.now();
-    const params = [entity.id, entity.name, entity.type, entity.aliases ? JSON.stringify(entity.aliases) : null, entity.description ?? null, now, now];
-    const stmt = this.dbType === "mysql" ? `INSERT INTO hai_ai_knowledge_entity (id, name, type, aliases, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?) ON DUPLICATE KEY UPDATE name = VALUES(name), type = VALUES(type), aliases = VALUES(aliases), description = VALUES(description), updated_at = VALUES(updated_at)` : `INSERT INTO hai_ai_knowledge_entity (id, name, type, aliases, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?) ON CONFLICT(id) DO UPDATE SET name = excluded.name, type = excluded.type, aliases = excluded.aliases, description = excluded.description, updated_at = excluded.updated_at`;
+    const params = [entity.id, entity.name, entity.type, entity.collection, entity.aliases ? JSON.stringify(entity.aliases) : null, entity.description ?? null, now, now];
+    const stmt = this.dbType === "mysql" ? `INSERT INTO hai_ai_knowledge_entity (id, name, type, collection, aliases, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?) ON DUPLICATE KEY UPDATE name = VALUES(name), type = VALUES(type), collection = VALUES(collection), aliases = VALUES(aliases), description = VALUES(description), updated_at = VALUES(updated_at)` : `INSERT INTO hai_ai_knowledge_entity (id, name, type, collection, aliases, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(id) DO UPDATE SET name = excluded.name, type = excluded.type, collection = excluded.collection, aliases = excluded.aliases, description = excluded.description, updated_at = excluded.updated_at`;
     const result = await this.sql.execute(stmt, params);
     if (!result.success)
       throw new Error(`upsertEntity failed: ${String(result.error)}`);
   }
-  async findEntitiesByName(keyword) {
+  async findEntitiesByName(keyword, collection) {
     const pattern = `%${keyword}%`;
-    const result = await this.sql.query(
-      `SELECT id, name, type, aliases FROM hai_ai_knowledge_entity WHERE name LIKE ? OR aliases LIKE ?`,
-      [pattern, pattern]
-    );
+    let stmt = `SELECT id, name, type, aliases FROM hai_ai_knowledge_entity WHERE (name LIKE ? OR aliases LIKE ?)`;
+    const params = [pattern, pattern];
+    if (collection) {
+      stmt += " AND collection = ?";
+      params.push(collection);
+    }
+    const result = await this.sql.query(stmt, params);
     if (!result.success)
       return [];
     return result.data.map((row) => ({
@@ -4593,6 +4599,10 @@ var DbKnowledgeStore = class {
   async listEntities(options) {
     let stmt = "SELECT id, name, type, aliases, description, created_at, updated_at FROM hai_ai_knowledge_entity WHERE 1=1";
     const params = [];
+    if (options?.collection) {
+      stmt += " AND collection = ?";
+      params.push(options.collection);
+    }
     if (options?.type) {
       stmt += " AND type = ?";
       params.push(options.type);
@@ -4660,7 +4670,7 @@ var DbKnowledgeStore = class {
     }));
   }
   async findByEntityName(entityName, options) {
-    const entities = await this.findEntitiesByName(entityName);
+    const entities = await this.findEntitiesByName(entityName, options?.collection);
     let filtered = entities;
     if (options?.type)
       filtered = filtered.filter((e) => e.type === options.type);
@@ -4680,17 +4690,17 @@ var DbKnowledgeStore = class {
       documents: docsByEntity.get(entity.id) ?? []
     }));
   }
-  async removeDocumentEntityRelations(documentId, collection) {
-    const affected = await this.sql.query(
-      "SELECT DISTINCT entity_id FROM hai_ai_knowledge_entity_document WHERE document_id = ? AND collection = ?",
-      [documentId, collection]
+  async deleteDocumentEntities(documentId, collection) {
+    await this.sql.execute(
+      "DELETE FROM hai_ai_knowledge_entity WHERE collection = ? AND id IN (SELECT DISTINCT entity_id FROM hai_ai_knowledge_entity_document WHERE document_id = ? AND collection = ?)",
+      [collection, documentId, collection]
     );
-    const entityIds = affected.success ? affected.data.map((r) => r.entity_id) : [];
+  }
+  async removeDocumentEntityRelations(documentId, collection) {
     await this.sql.execute(
       "DELETE FROM hai_ai_knowledge_entity_document WHERE document_id = ? AND collection = ?",
       [documentId, collection]
     );
-    return entityIds;
   }
   async upsertDocument(doc) {
     const params = [doc.documentId, doc.collection, doc.title ?? null, doc.url ?? null, doc.chunkCount, doc.createdAt];
@@ -4793,15 +4803,10 @@ var DbKnowledgeStore = class {
     const exists = await this.vecdb.collection.exists(collection);
     if (exists.success && exists.data)
       await this.vecdb.collection.drop(collection);
-    const entityResult = await this.sql.query(
-      "SELECT DISTINCT entity_id FROM hai_ai_knowledge_entity_document WHERE collection = ?",
-      [collection]
-    );
-    const entityIds = entityResult.success ? entityResult.data.map((r) => r.entity_id) : [];
     await this.sql.execute("DELETE FROM hai_ai_knowledge_entity_document WHERE collection = ?", [collection]);
     await this.sql.execute("DELETE FROM hai_ai_knowledge_document WHERE collection = ?", [collection]);
+    await this.sql.execute("DELETE FROM hai_ai_knowledge_entity WHERE collection = ?", [collection]);
     await this.sql.execute("DELETE FROM hai_ai_knowledge_collections WHERE collection = ?", [collection]);
-    await this.deleteEntities(entityIds);
   }
 };
 function createDbStoreProvider(deps) {