@h-ai/ai 0.1.0-alpha.37 → 0.1.0-alpha.39

package/dist/{ai-audio-ws-protocol-BK5753o1.d.ts → ai-audio-ws-protocol-DbZZvH52.d.ts}

@@ -1,6 +1,6 @@
 import * as _h_ai_core from '@h-ai/core';
 import { HaiResult } from '@h-ai/core';
-import { aG as ChatMessage, af as InteractionScope, O as MemoryType, br as RagOptions, bv as ReasoningOptions, c2 as ToolRegistryOperations, bd as MemoryEntry, bK as SessionInfo, b6 as LLMOperations, bj as MemoryOperations, bq as RagOperations, bu as ReasoningOperations, c as AIConfig, d as AIConfigInput, av as AIStoreProvider, c4 as ToolsOperations, bO as StreamOperations, bB as RetrievalOperations, b0 as KnowledgeOperations, ap as A2AOperations, q as AudioOperations, l as AudioFormat } from './ai-reasoning-types-CslaY4xX.js';
+import { aG as ChatMessage, af as InteractionScope, O as MemoryType, br as RagOptions, bv as ReasoningOptions, c2 as ToolRegistryOperations, bd as MemoryEntry, bK as SessionInfo, b6 as LLMOperations, bj as MemoryOperations, bq as RagOperations, bu as ReasoningOperations, c as AIConfig, d as AIConfigInput, av as AIStoreProvider, c4 as ToolsOperations, bO as StreamOperations, bB as RetrievalOperations, b0 as KnowledgeOperations, ap as A2AOperations, q as AudioOperations, l as AudioFormat } from './ai-reasoning-types-B8PH0w2_.js';
 import * as zod from 'zod';
 import { z } from 'zod';
 import { Buffer } from 'node:buffer';

package/dist/{ai-reasoning-types-CslaY4xX.d.ts → ai-reasoning-types-B8PH0w2_.d.ts}

@@ -1869,6 +1869,8 @@ interface MemoryExtractOptions {
      * 避免回退到全局 .env 配置。优先级高于全局 config.models 查找。
      */
     tempModel?: TempModelConfig;
+    /** 取消整条记忆提取链（包括事实抽取与 native 对账 LLM 调用） */
+    signal?: AbortSignal;
 }
 /**
  * 记忆检索选项

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, f as ApiType, g as ApiTypeSchema, h as AudioCapabilitiesRequest, i as AudioConfig, j as AudioConfigSchema, k as AudioContent, l as AudioFormat, m as AudioInputStream, n as AudioModelCapabilities, o as AudioModelEntry, p as AudioModelEntrySchema, q as AudioOperations, r as AudioProviderName, s as AudioProviderSchema, C as CompressConfig, t as CompressConfigSchema, E as EmbeddingConfig, u as EmbeddingConfigSchema, v as EntityType, w as EntityTypeSchema, F as FileConfig, x as FileConfigSchema, K as KnowledgeConfig, y as KnowledgeConfigSchema, L as LLMConfig, z as LLMConfigSchema, M as MCPConfig, B as MCPConfigSchema, D as MCPServerCapabilities, G as MCPServerCapabilitiesSchema, H as MCPServerConfig, I as MCPServerConfigSchema, J as MemoryConfig, N as MemoryConfigSchema, O as MemoryType, P as MemoryTypeSchema, Q as ModelEntry, R as ModelEntrySchema, S as ModelScenario, T as ModelScenarioSchema, U as ResolveRequiredModelEntryOptions, V as ResolvedAudioModel, W as ResolvedModelConfig, X as RetrievalConfig, Y as RetrievalConfigSchema, Z as RetrievalSourceConfig, _ as RetrievalSourceSchema, $ as SummaryConfig, a0 as SummaryConfigSchema, a1 as SynthesisEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a5 as SynthesisTextSegment, a6 as TokenConfig, a7 as TokenConfigSchema, a8 as TranscriptionEvent, a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, ac as resolveAudioModel, ad as resolveModelApi, ae as resolveModelEntry } from './ai-reasoning-types-CslaY4xX.js';
-export { A as AIFunctions, a as AIInitOptions, b as AUDIO_WS_PATH, c as AudioFormatSchema, d as AudioWsClientMessage, e as AudioWsClientMessageSchema, f as AudioWsDoneMessage, g as AudioWsDoneMessageSchema, h as AudioWsEndMessage, i as AudioWsErrorMessage, j as AudioWsSegmentDoneMessage, k as AudioWsSegmentStartedMessage, l as AudioWsServerMessage, m as AudioWsSpeechMessage, n as AudioWsStartMessage, o as AudioWsStartMessageSchema, p as AudioWsTextMessage, q as AudioWsTextMessageSchema, r as AudioWsTranscriptMessage, C as CompressionStrategy, s as CompressionStrategySchema, H as HaiAIError } from './ai-audio-ws-protocol-BK5753o1.js';
+export { A as A2AConfig, a as A2AConfigSchema, b as A2ASkillConfigSchema, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, f as ApiType, g as ApiTypeSchema, h as AudioCapabilitiesRequest, i as AudioConfig, j as AudioConfigSchema, k as AudioContent, l as AudioFormat, m as AudioInputStream, n as AudioModelCapabilities, o as AudioModelEntry, p as AudioModelEntrySchema, q as AudioOperations, r as AudioProviderName, s as AudioProviderSchema, C as CompressConfig, t as CompressConfigSchema, E as EmbeddingConfig, u as EmbeddingConfigSchema, v as EntityType, w as EntityTypeSchema, F as FileConfig, x as FileConfigSchema, K as KnowledgeConfig, y as KnowledgeConfigSchema, L as LLMConfig, z as LLMConfigSchema, M as MCPConfig, B as MCPConfigSchema, D as MCPServerCapabilities, G as MCPServerCapabilitiesSchema, H as MCPServerConfig, I as MCPServerConfigSchema, J as MemoryConfig, N as MemoryConfigSchema, O as MemoryType, P as MemoryTypeSchema, Q as ModelEntry, R as ModelEntrySchema, S as ModelScenario, T as ModelScenarioSchema, U as ResolveRequiredModelEntryOptions, V as ResolvedAudioModel, W as ResolvedModelConfig, X as RetrievalConfig, Y as RetrievalConfigSchema, Z as RetrievalSourceConfig, _ as RetrievalSourceSchema, $ as SummaryConfig, a0 as SummaryConfigSchema, a1 as SynthesisEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a5 as SynthesisTextSegment, a6 as TokenConfig, a7 as TokenConfigSchema, a8 as TranscriptionEvent, a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, ac as resolveAudioModel, ad as resolveModelApi, ae as resolveModelEntry } from './ai-reasoning-types-B8PH0w2_.js';
+export { A as AIFunctions, a as AIInitOptions, b as AUDIO_WS_PATH, c as AudioFormatSchema, d as AudioWsClientMessage, e as AudioWsClientMessageSchema, f as AudioWsDoneMessage, g as AudioWsDoneMessageSchema, h as AudioWsEndMessage, i as AudioWsErrorMessage, j as AudioWsSegmentDoneMessage, k as AudioWsSegmentStartedMessage, l as AudioWsServerMessage, m as AudioWsSpeechMessage, n as AudioWsStartMessage, o as AudioWsStartMessageSchema, p as AudioWsTextMessage, q as AudioWsTextMessageSchema, r as AudioWsTranscriptMessage, C as CompressionStrategy, s as CompressionStrategySchema, H as HaiAIError } from './ai-audio-ws-protocol-DbZZvH52.js';
 export { A2AClientOperations, AIApiAdapter, AIClient, AIClientConfig, AudioClientConfig, AudioClientOperations, AudioTicketRequest, StreamOptions, StreamProgress, collectStreamContent, createA2AClient, createAIClient, createAudioClient, createUnconfiguredAudioClient, 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, AUDIO_WS_PATH, ApiTypeSchema, AudioConfigSchema, AudioFormatSchema, AudioModelEntrySchema, AudioProviderSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveAudioModel, resolveModelApi, resolveModelEntry } from './chunk-5XL4QDIJ.js';
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, AUDIO_WS_PATH, ApiTypeSchema, AudioConfigSchema, AudioFormatSchema, AudioModelEntrySchema, AudioProviderSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveAudioModel, resolveModelApi, resolveModelEntry } from './chunk-OZYROB52.js';
 export { collectStreamContent, createA2AClient, createAIClient, createAudioClient, createUnconfiguredAudioClient, parseSSE } from './chunk-ELH2IPOE.js';
 export { HaiAIError } from './chunk-P3GND76X.js';
 //# sourceMappingURL=browser.js.map

package/dist/{chunk-5XL4QDIJ.js → chunk-OZYROB52.js}

@@ -580,5 +580,5 @@ var AudioWsDoneMessageSchema = AudioWsDoneMessageSchema$1;
 var AudioWsClientMessageSchema = AudioWsClientMessageSchema$1;
 
 export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, AUDIO_WS_PATH, ApiTypeSchema, AudioConfigSchema, AudioFormatSchema, AudioModelEntrySchema, AudioProviderSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, aiM, resolveAudioModel, resolveModelApi, resolveModelEntry };
-//# sourceMappingURL=chunk-5XL4QDIJ.js.map
-//# sourceMappingURL=chunk-5XL4QDIJ.js.map
+//# sourceMappingURL=chunk-OZYROB52.js.map
+//# sourceMappingURL=chunk-OZYROB52.js.map

package/dist/chunk-OZYROB52.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../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","../src/audio/ai-audio-ws-protocol.ts"],"names":["z","CONTRACT_AUDIO_WS_PATH","ContractAudioFormatSchema","ContractAudioWsStartMessageSchema","ContractAudioWsTextMessageSchema","ContractAudioWsDoneMessageSchema","ContractAudioWsClientMessageSchema"],"mappings":"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","file":"chunk-OZYROB52.js","sourcesContent":["/**\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, TempModelConfig } 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  /** 作用域（JSON 对象，key-value 匹配过滤。用于子 session 记忆隔离等场景） */\n  scope?: Record<string, unknown>\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  /** 作用域（JSON 对象，key-value 匹配过滤。用于子 session 记忆隔离等场景） */\n  scope?: Record<string, unknown>\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  /** 作用域（JSON 对象，提取的记忆将关联此 scope） */\n  scope?: Record<string, unknown>\n  /**\n   * 临时模型配置（携带凭据的模型请求）。\n   *\n   * 用于传递运行时解析的 apiKey / baseUrl 等凭证，\n   * 避免回退到全局 .env 配置。优先级高于全局 config.models 查找。\n   */\n  tempModel?: TempModelConfig\n  /** 取消整条记忆提取链（包括事实抽取与 native 对账 LLM 调用） */\n  signal?: AbortSignal\n}\n\n// ─── 检索选项 ───\n\n/**\n * 记忆检索选项\n */\nexport interface MemoryRecallOptions {\n  /** 返回数量（默认使用配置的 defaultTopK） */\n  topK?: number\n  /**\n   * 候选池倍数（覆盖配置的 candidateMultiplier）\n   *\n   * 检索时先取回 `topK × candidateMultiplier` 条候选再按 scope / 类型 / 重要性过滤，\n   * 最后截取 topK。scope 过滤较严（如按 topic / persona 隔离）时应调大，避免漏召回。\n   */\n  candidateMultiplier?: number\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 最低重要性 */\n  minImportance?: number\n  /** 时间衰减权重 [0, 1]（0 = 不考虑时间，1 = 仅按时间排序） */\n  recencyWeight?: number\n  /** 限定主体 ID */\n  objectId?: string\n  /** 限定作用域（key-value 匹配过滤，用于子 session 记忆隔离等场景） */\n  scope?: Record<string, unknown>\n}\n\n// ─── 注入选项 ───\n\n/**\n * 记忆注入选项（`injectMemories` 使用）\n *\n * 控制记忆注入行为：检索数量、Token 预算、注入位置等。\n */\nexport interface MemoryInjectionOptions {\n  /** 注入的记忆数量（默认 5） */\n  topK?: number\n  /**\n   * 候选池倍数（覆盖配置的 candidateMultiplier）\n   *\n   * 透传给底层 `recall`，scope 过滤较严时应调大以避免漏召回。\n   */\n  candidateMultiplier?: number\n  /** 记忆占用的最大 token 预算（默认不限） */\n  maxTokens?: number\n  /** 注入位置：system = 追加到 system 消息末尾，before-last = 插入在最后一条用户消息之前 */\n  position?: 'system' | 'before-last'\n  /** 限定主体 ID */\n  objectId?: string\n  /** 限定作用域（key-value 匹配过滤，用于子 session 记忆隔离等场景） */\n  scope?: Record<string, unknown>\n  /** 限定记忆类型 */\n  types?: MemoryType[]\n  /** 最低重要性阈值 */\n  minImportance?: number\n}\n\n// ─── 列表与清空选项 ───\n\n/**\n * 记忆列表选项\n */\nexport interface MemoryListOptions {\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 限定主体 ID */\n  objectId?: string\n  /** 限定作用域（key-value 匹配过滤，用于子 session / 主题 / 角色记忆隔离等场景） */\n  scope?: Record<string, unknown>\n  /** 最大返回数 */\n  limit?: number\n}\n\n/**\n * 记忆分页选项\n */\nexport interface MemoryListPageOptions {\n  /** 过滤类型 */\n  types?: MemoryType[]\n  /** 限定主体 ID */\n  objectId?: string\n  /** 限定作用域（key-value 匹配过滤，用于子 session / 主题 / 角色记忆隔离等场景） */\n  scope?: Record<string, unknown>\n  /** 偏移量 */\n  offset?: number\n  /** 每页数量（默认 20） */\n  limit?: number\n}\n\n/**\n * 记忆清空选项\n *\n * 安全语义：未传任何过滤条件时清空全部；传入 objectId / types / scope 时\n * 仅删除同时匹配所有给定条件的记忆，避免误删其他主体或类型的记忆。\n */\nexport interface MemoryClearOptions {\n  /** 仅清空指定类型 */\n  types?: MemoryType[]\n  /** 仅清空指定主体 */\n  objectId?: string\n  /** 仅清空匹配指定作用域的记忆（key-value 匹配过滤） */\n  scope?: Record<string, unknown>\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 */\n\n/**\n * 按 ID 访问单条记忆（get / update / remove）时的归属校验作用域。\n *\n * 传入后，Provider 先读取记忆再校验：`entry.objectId` 必须等于 `objectId`，且 `entry.scope`\n * 包含 `scope` 的全部 key-value；不匹配时统一返回 `MEMORY_NOT_FOUND`（避免通过错误差异\n * 枚举其他主体的记忆）。不传时不做归属校验（向后兼容）；处理不可信输入的 memoryId 时必须传入。\n */\nexport interface MemoryAccessScope {\n  /** 归属主体 ID（必须与记忆 entry.objectId 一致） */\n  objectId: string\n  /** 业务作用域（entry.scope 必须包含这些 key-value） */\n  scope?: Record<string, unknown>\n}\n\n/**\n * 记忆作用域绑定（`ai.memory.scoped()` 使用）\n *\n * 绑定后，所有操作自动携带 `objectId` 与 `scope`，无需每次手动传入，\n * 从根本上避免「忘记传 objectId 导致跨租户越权」的安全隐患。\n */\nexport interface ScopedMemoryBinding {\n  /** 归属主体 ID（所有操作自动绑定） */\n  objectId: string\n  /** 业务作用域（所有操作自动绑定并作为归属校验的一部分，如 `{ topicId, personaId }`） */\n  scope?: Record<string, unknown>\n}\n\n/**\n * 全局清空选项（`ai.memory.admin.clearAll()` 使用）\n *\n * 危险操作：清空整个记忆后端的全部数据。必须显式传入 `confirm: true`，\n * 防止误调用；普通 `clear()` 不再支持通过省略参数隐式清空全局。\n */\nexport interface MemoryClearAllOptions {\n  /** 必须显式为 `true`，否则拒绝执行 */\n  confirm: true\n}\n\n/**\n * 记忆管理接口（`ai.memory.admin`）\n *\n * 承载危险的全局操作，与业务作用域操作明确分离。\n */\nexport interface MemoryAdminOperations {\n  /**\n   * 清空整个记忆后端的全部数据（跨所有主体 / 作用域）\n   *\n   * @param options - 必须传入 `{ confirm: true }`\n   * @returns 成功返回 ok(undefined)；未确认返回 MEMORY_STORE_FAILED\n   */\n  clearAll: (options: MemoryClearAllOptions) => Promise<HaiResult<void>>\n}\n\n/**\n * 记忆核心操作（Provider 实现层）\n *\n * 各 Provider（native / mem0）实现这一组操作。公共入口 `ai.memory` 在其基础上\n * 叠加作用域绑定（`scoped`）与管理接口（`admin`），并对 `clear` 施加空过滤保护。\n */\nexport interface MemoryCoreOperations {\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   * @param accessScope - 可选归属校验（不匹配返回 MEMORY_NOT_FOUND）\n   * @returns 更新后的完整记忆条目\n   */\n  update: (memoryId: string, updates: MemoryUpdateInput, accessScope?: MemoryAccessScope) => Promise<HaiResult<MemoryEntry>>\n\n  /**\n   * 按 ID 获取单条记忆\n   *\n   * @param memoryId - 记忆 ID\n   * @param accessScope - 可选归属校验（不匹配返回 MEMORY_NOT_FOUND）\n   * @returns 记忆条目，不存在时返回 MEMORY_NOT_FOUND\n   */\n  get: (memoryId: string, accessScope?: MemoryAccessScope) => Promise<HaiResult<MemoryEntry>>\n\n  /**\n   * 删除单条记忆\n   *\n   * 同时从 Store 中移除持久化数据。\n   *\n   * @param memoryId - 记忆 ID\n   * @param accessScope - 可选归属校验（不匹配返回 MEMORY_NOT_FOUND）\n   * @returns 成功返回 ok(undefined)\n   */\n  remove: (memoryId: string, accessScope?: MemoryAccessScope) => 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/**\n * 作用域绑定的记忆操作（`ai.memory.scoped()` 返回）\n *\n * 所有操作自动携带绑定的 `objectId` 与 `scope`，无需重复传入；`get` / `update` / `remove`\n * 自动施加归属校验（跨租户访问返回 `MEMORY_NOT_FOUND`）；`clear` 仅清空绑定作用域内的记忆，\n * 永远不会误清全局。\n */\nexport interface ScopedMemoryOperations {\n  /** 从对话中提取记忆（自动绑定 objectId / scope） */\n  extract: (messages: ChatMessage[], options?: Omit<MemoryExtractOptions, 'objectId' | 'scope'>) => Promise<HaiResult<MemoryEntry[]>>\n  /** 检索相关记忆（自动绑定 objectId / scope） */\n  recall: (query: string, options?: Omit<MemoryRecallOptions, 'objectId' | 'scope'>) => Promise<HaiResult<MemoryEntry[]>>\n  /** 注入相关记忆（自动绑定 objectId / scope） */\n  injectMemories: (messages: ChatMessage[], options?: Omit<MemoryInjectionOptions, 'objectId' | 'scope'>) => Promise<HaiResult<ChatMessage[]>>\n  /** 添加记忆（自动绑定 objectId / scope） */\n  add: (entry: Omit<MemoryEntryInput, 'objectId' | 'scope'>) => Promise<HaiResult<MemoryEntry>>\n  /** 更新记忆（自动施加归属校验） */\n  update: (memoryId: string, updates: MemoryUpdateInput) => Promise<HaiResult<MemoryEntry>>\n  /** 按 ID 获取记忆（自动施加归属校验） */\n  get: (memoryId: string) => Promise<HaiResult<MemoryEntry>>\n  /** 删除记忆（自动施加归属校验） */\n  remove: (memoryId: string) => Promise<HaiResult<void>>\n  /** 列出记忆（自动绑定 objectId / scope） */\n  list: (options?: Omit<MemoryListOptions, 'objectId' | 'scope'>) => Promise<HaiResult<MemoryEntry[]>>\n  /** 分页列出记忆（自动绑定 objectId / scope） */\n  listPage: (options?: Omit<MemoryListPageOptions, 'objectId' | 'scope'>) => Promise<HaiResult<StorePage<MemoryEntry>>>\n  /** 清空绑定作用域内的记忆（自动绑定 objectId / scope，不会误清全局） */\n  clear: (options?: Omit<MemoryClearOptions, 'objectId' | 'scope'>) => Promise<HaiResult<void>>\n}\n\n/**\n * 公共记忆操作接口（通过 `ai.memory` 访问）\n *\n * 在核心操作基础上增加：\n * - `scoped(binding)`：返回自动绑定 objectId / scope 的安全实例（多租户推荐入口）；\n * - `admin`：承载危险的全局操作（如 `clearAll`）；\n * - `clear`：拒绝空过滤调用（无 objectId / types / scope 时返回错误），防止误清全局。\n */\nexport interface MemoryOperations extends MemoryCoreOperations {\n  /**\n   * 创建绑定作用域的记忆实例\n   *\n   * @param binding - 作用域绑定（objectId + 可选 scope）\n   * @returns 所有操作自动携带该作用域的记忆实例\n   */\n  scoped: (binding: ScopedMemoryBinding) => ScopedMemoryOperations\n  /** 管理接口（危险的全局操作，需显式确认） */\n  admin: MemoryAdminOperations\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_toolTimeout\": \"Tool '{name}' timed out or was cancelled after {ms}ms\",\n  \"ai_toolAlreadyRegistered\": \"Tool '{name}' is already registered; use replace() to replace it explicitly\",\n  \"ai_toolForbidden\": \"Tool '{name}' execution is not authorized\",\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_generateObjectFailed\": \"Structured output parsing failed: {error}\",\n  \"ai_generateObjectRepair\": \"The previous output could not be parsed into the required structure ({error}). Output only JSON conforming to the schema, with no extra text.\",\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_memoryEphemeralFallbackDenied\": \"Memory provider 'mem0' cannot map vector backend '{backend}' to a persistent store; refusing silent in-memory fallback. Set memory.allowEphemeralFallback=true to allow ephemeral storage, or use a qdrant/pgvector backend.\",\n  \"ai_memoryClearRequiresFilter\": \"clear() requires at least one filter (objectId / types / scope); to wipe all memories use ai.memory.admin.clearAll({ confirm: true })\",\n  \"ai_memoryClearAllUnconfirmed\": \"admin.clearAll() requires explicit confirmation: pass { confirm: true }\",\n  \"ai_memoryEnrichFailed\": \"Memory enrichment failed: {error}\",\n  \"ai_memoryPromoteFailed\": \"Memory promotion (long-term consolidation) failed: {error}\",\n\n  \"ai_personaNotFound\": \"Persona '{id}' not found\",\n  \"ai_personaSaveFailed\": \"Persona save 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  \"ai_turnNotFound\": \"Conversation turn '{turnId}' not found\",\n  \"ai_turnInvalidState\": \"Conversation turn '{turnId}' is already committed\",\n  \"ai_contextBusy\": \"Context manager is busy: a generation is already in progress (concurrency='reject')\",\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_audioNotInitialized\": \"Audio service not initialized. Call ai.init() first.\",\n  \"ai_audioInvalidRequest\": \"Invalid audio request: {reason}\",\n  \"ai_audioModelNotFound\": \"Audio model '{model}' not found. Register it in audio.models of ai.init().\",\n  \"ai_audioMissingApiKey\": \"Audio provider '{provider}' is missing credentials (API Key or App/Access Key).\",\n  \"ai_audioUnsupportedInput\": \"Provider '{provider}' does not support this input mode: {reason}\",\n  \"ai_audioUpstreamError\": \"Audio upstream service error: {error}\",\n  \"ai_audioProtocolError\": \"Audio protocol error: {error}\",\n  \"ai_audioConnectionFailed\": \"Audio connection failed: {error}\",\n  \"ai_audioTimeout\": \"Audio request timed out\",\n  \"ai_audioInputTooLarge\": \"Input audio exceeds size limit ({limit} bytes)\",\n  \"ai_audioCancelled\": \"Audio request was cancelled\",\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_toolTimeout\": \"工具 '{name}' 在 {ms}ms 后超时或被取消\",\n  \"ai_toolAlreadyRegistered\": \"工具 '{name}' 已注册；如需替换请显式调用 replace()\",\n  \"ai_toolForbidden\": \"工具 '{name}' 未获执行授权\",\n  \"ai_configError\": \"AI 配置校验失败：{error}\",\n\n  \"ai_llmRecordFailed\": \"对话记录保存失败：{error}\",\n  \"ai_llmHistoryFailed\": \"对话历史查询失败：{error}\",\n\n  \"ai_generateObjectFailed\": \"结构化输出解析失败：{error}\",\n  \"ai_generateObjectRepair\": \"上一次输出无法解析为要求的结构（{error}）。请只输出符合 schema 的 JSON，不要包含额外文本。\",\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_memoryEphemeralFallbackDenied\": \"记忆 provider 'mem0' 无法将向量后端 '{backend}' 映射为持久化存储，拒绝静默退回内存存储。请设置 memory.allowEphemeralFallback=true 允许临时存储，或改用 qdrant/pgvector 后端。\",\n  \"ai_memoryClearRequiresFilter\": \"clear() 至少需传入一个过滤条件（objectId / types / scope）；要清空全部记忆请使用 ai.memory.admin.clearAll({ confirm: true })\",\n  \"ai_memoryClearAllUnconfirmed\": \"admin.clearAll() 需要显式确认：请传入 { confirm: true }\",\n  \"ai_memoryEnrichFailed\": \"记忆注入失败：{error}\",\n  \"ai_memoryPromoteFailed\": \"记忆固化（长期化）失败：{error}\",\n\n  \"ai_personaNotFound\": \"角色 '{id}' 不存在\",\n  \"ai_personaSaveFailed\": \"角色保存失败：{error}\",\n\n  \"ai_contextCompressFailed\": \"上下文压缩失败：{error}\",\n  \"ai_contextSummarizeFailed\": \"上下文总结失败：{error}\",\n  \"ai_contextTokenEstimateFailed\": \"Token 估算失败：{error}\",\n  \"ai_turnNotFound\": \"对话轮次 '{turnId}' 不存在\",\n  \"ai_turnInvalidState\": \"对话轮次 '{turnId}' 已提交，无法重复提交\",\n  \"ai_contextBusy\": \"上下文管理器正忙：已有一个生成正在进行（concurrency='reject'）\",\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_audioNotInitialized\": \"Audio 服务未初始化，请先调用 ai.init()\",\n  \"ai_audioInvalidRequest\": \"语音请求参数无效：{reason}\",\n  \"ai_audioModelNotFound\": \"语音模型 '{model}' 未找到，请在 ai.init() 的 audio.models 中注册\",\n  \"ai_audioMissingApiKey\": \"语音平台 '{provider}' 缺少凭据（API Key 或 App/Access Key）\",\n  \"ai_audioUnsupportedInput\": \"平台 '{provider}' 不支持此输入方式：{reason}\",\n  \"ai_audioUpstreamError\": \"语音上游服务错误：{error}\",\n  \"ai_audioProtocolError\": \"语音协议错误：{error}\",\n  \"ai_audioConnectionFailed\": \"语音连接失败：{error}\",\n  \"ai_audioTimeout\": \"语音请求超时\",\n  \"ai_audioInputTooLarge\": \"输入音频超过大小上限（{limit} 字节）\",\n  \"ai_audioCancelled\": \"语音请求已取消\",\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 * LLM API 协议枚举\n *\n * 决定底层通过哪种 API 协议与模型交互（对使用方透明，公共请求/响应形状保持一致）：\n *\n * - `chat` — OpenAI Chat Completions API（`/v1/chat/completions`，默认，兼容绝大多数厂商）\n * - `responses` — OpenAI Responses API（`/v1/responses`，新一代有状态接口）\n * - `anthropic` — Anthropic Messages API（Claude 原生协议，需安装 `@anthropic-ai/sdk`）\n */\nexport const ApiTypeSchema = z.enum(['chat', 'responses', 'anthropic'])\n\n/** LLM API 协议类型 */\nexport type ApiType = z.infer<typeof ApiTypeSchema>\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 协议（可选，未指定时回退全局 `api`，再回退 `chat`；决定走 Chat Completions / Responses / Anthropic） */\n  api: ApiTypeSchema.optional(),\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  /** 全局 API 协议（各模型 fallback，默认 `'chat'`；可选 `chat` / `responses` / `anthropic`） */\n  api: ApiTypeSchema.optional().default('chat'),\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  /** 临时模型客户端缓存存活时间（毫秒，默认 `600000` = 10 分钟；超时后临时模型客户端实例失效并重建） */\n  tempModelCacheTtl: z.number().positive().optional().default(600000),\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 协议（模型条目 > 全局配置 > `chat`） */\n  api: ApiType\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    api: entry?.api ?? llmConfig.api ?? 'chat',\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/**\n * 解析某次 chat 请求应使用的 API 协议（不校验 API Key）\n *\n * 供 LLM Provider 路由层选择底层实现使用：优先取显式模型条目的 `api`，\n * 其次全局 `api`，最后回退 `chat`。临时模型的 `api` 由调用方单独传入优先。\n *\n * @param llmConfig - LLM 配置\n * @param explicitModel - 显式指定的模型名/ID（可选）\n * @param tempApi - 临时模型显式指定的 API 协议（可选，最高优先级）\n * @returns 解析出的 API 协议\n */\nexport function resolveModelApi(llmConfig: LLMConfig, explicitModel?: string, tempApi?: ApiType): ApiType {\n  if (tempApi)\n    return tempApi\n  const entry = explicitModel\n    ? llmConfig.models?.find(m => m.id === explicitModel || m.model === explicitModel)\n    : undefined\n  return entry?.api ?? llmConfig.api ?? 'chat'\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 * 配置对话记忆的提取、存储与检索参数。两种 provider 均为嵌入式，复用同一套\n * vecdb / reldb / LLM / Embedding；模型通过 LLMConfigSchema.scenarios.extraction\n * 解析，apiKey / baseUrl 统一使用 LLM 配置。\n *\n * @example\n * ```ts\n * const memoryConfig = {\n *   provider: 'native',\n *   maxEntriesPerObject: 1000,\n *   maxEntriesGlobal: 100000,\n *   embeddingEnabled: true,\n *   recencyDecay: 0.95,\n *   defaultTopK: 10,\n * }\n * ```\n */\nexport const MemoryConfigSchema = z.object({\n  /** 记忆后端：native = 逐条写回；mem0 = 批量 ADD/UPDATE/DELETE 合并（均为嵌入式，复用 HAI 组件） */\n  provider: z.enum(['native', 'mem0']).default('native'),\n  /**\n   * 是否允许在配置了持久化向量后端但 mem0 无法映射时退回内存存储（默认 false）\n   *\n   * 仅影响 `provider='mem0'`：mem0 TS 仅支持 qdrant / pgvector。当底层 vecdb 是\n   * lancedb / chroma / 未知后端时，默认 fail-fast（初始化失败），避免服务重启后记忆静默丢失；\n   * 仅当显式设为 true 时才退回 mem0 自带 in-memory 存储（数据不持久）。\n   */\n  allowEphemeralFallback: z.boolean().default(false),\n  /**\n   * 单个主体（objectId）的最大记忆条数（默认 1000）\n   *\n   * native 淘汰按 objectId 分区触发：某个主体写入超过此上限时，只淘汰该主体自身\n   * 最低优先级的条目，不会波及其他主体的记忆。\n   */\n  maxEntriesPerObject: z.number().int().positive().default(1000),\n  /**\n   * 全局最大记忆条数（默认 100000）\n   *\n   * 跨所有主体的总量上限，作为整体保护阈值；超过时淘汰全局最低优先级条目。\n   */\n  maxEntriesGlobal: z.number().int().positive().default(100000),\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   * 候选池倍数（默认 5）\n   *\n   * 检索时先从向量后端取回 `topK × candidateMultiplier` 条候选，再按 scope / 重要性等\n   * 条件在内存中过滤，最后截取 topK。用于修正「向量后端仅返回 topK，随后被 scope 过滤\n   * 掉大部分、导致同一主体下特定主题/角色记忆漏召回」的问题：候选池越大，scope 命中越充分。\n   *\n   * native provider 会对全部候选评分，故此值仅影响向量预取宽度；mem0 provider 无法下推\n   * scope，必须依赖更大的候选池才能保证 scope 内记忆被召回。\n   */\n  candidateMultiplier: z.number().int().positive().default(5),\n  /** 写回 / 合并时检索相关记忆的数量（native 与 mem0 共用，默认 20） */\n  writebackRelatedTopK: z.number().int().positive().default(20),\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// ─── Audio 配置 Schema ───\n\n/**\n * 语音平台枚举\n *\n * 决定 `ai.audio` 底层调用哪个厂商（对使用方透明，公共请求/响应形状保持一致）：\n *\n * - `openai` — OpenAI Audio API（transcriptions / speech）\n * - `mimo` — 小米 MiMo（Chat Completions 风格 ASR / TTS）\n * - `qwen` — 阿里云百炼 Qwen Realtime（DashScope WebSocket ASR / TTS）\n * - `doubao` — 火山引擎豆包语音（二进制 WebSocket ASR / TTS）\n */\nexport const AudioProviderSchema = z.enum(['openai', 'mimo', 'qwen', 'doubao'])\n\n/** 语音平台类型 */\nexport type AudioProviderName = z.infer<typeof AudioProviderSchema>\n\n/**\n * 语音模型条目 Schema\n *\n * 定义单个语音模型：唯一 ID、所属平台、厂商模型名及凭据。凭据未提供时回退到对应平台的环境变量。\n *\n * @example\n * ```ts\n * const model = { id: 'asr', provider: 'qwen', model: 'qwen3-asr-flash-realtime', operations: ['transcribe'] }\n * ```\n */\nexport const AudioModelEntrySchema = z.object({\n  /** 模型唯一标识（用于场景解析与请求显式指定） */\n  id: z.string(),\n  /** 所属语音平台 */\n  provider: AudioProviderSchema,\n  /** 厂商模型名（传给厂商 API 的实际模型名） */\n  model: z.string(),\n  /** 模型允许执行的操作；解析模型时会在调用厂商前校验 */\n  operations: z.union([\n    z.tuple([z.literal('transcribe')]),\n    z.tuple([z.literal('synthesize')]),\n    z.tuple([z.literal('transcribe'), z.literal('synthesize')]),\n  ]),\n  /** API Key 覆盖（未提供时回退对应平台环境变量） */\n  apiKey: z.string().optional(),\n  /** HTTP / WebSocket 端点覆盖（未提供时使用平台默认端点） */\n  baseUrl: z.string().optional(),\n  /** 火山引擎 App Key（`X-Api-App-Key`，旧版控制台 ASR 需要） */\n  appKey: z.string().optional(),\n  /** 火山引擎 Access Key（`X-Api-Access-Key`，旧版控制台 ASR 需要） */\n  accessKey: z.string().optional(),\n  /** 火山引擎资源 ID（`X-Api-Resource-Id`；未提供时使用平台默认资源 ID） */\n  resourceId: z.string().optional(),\n  /** 阿里云百炼业务空间 ID（`X-DashScope-WorkSpace`，可选） */\n  workspaceId: z.string().optional(),\n  /** 请求超时（毫秒，默认 60000） */\n  timeout: z.number().positive().optional(),\n})\n\n/** 语音模型条目类型 */\nexport type AudioModelEntry = z.infer<typeof AudioModelEntrySchema>\n\n/**\n * Audio 配置 Schema\n *\n * 注册语音模型并映射默认识别 / 合成模型。调用方通常无需指定模型，仅在临时切换时通过 `request.model` 覆盖。\n *\n * @example\n * ```ts\n * ai.init({\n *   audio: {\n *     models: [\n *       { id: 'asr', provider: 'qwen', model: 'qwen3-asr-flash-realtime', operations: ['transcribe'] },\n *       { id: 'tts', provider: 'qwen', model: 'qwen3-tts-flash-realtime', operations: ['synthesize'] },\n *     ],\n *     transcribeModel: 'asr',\n *     synthesizeModel: 'tts',\n *   },\n * })\n * ```\n */\nexport const AudioConfigSchema = z.object({\n  /** 注册的语音模型列表 */\n  models: z.array(AudioModelEntrySchema).optional(),\n  /** 默认识别模型 ID（`ai.audio.transcribe*` 未指定 model 时使用） */\n  transcribeModel: z.string().optional(),\n  /** 默认合成模型 ID（`ai.audio.synthesize*` 未指定 model 时使用） */\n  synthesizeModel: z.string().optional(),\n  /** 单次音频字节上限（默认 10 MiB，防止资源耗尽） */\n  maxAudioBytes: z.number().int().positive().default(10 * 1024 * 1024),\n  /** 实时连接最长持续时间（毫秒，默认 5 分钟） */\n  maxStreamDurationMs: z.number().int().positive().default(5 * 60 * 1000),\n})\n\n/** Audio 配置类型 */\nexport type AudioConfig = z.infer<typeof AudioConfigSchema>\n\n/**\n * 已解析的语音模型配置\n *\n * 由 `resolveAudioModel()` 返回，凭据已合并环境变量、端点已应用平台默认值。\n */\nexport interface ResolvedAudioModel {\n  /** 模型条目 ID */\n  id: string\n  /** 所属平台 */\n  provider: AudioProviderName\n  /** 厂商模型名 */\n  model: string\n  /** API Key（条目 > 平台环境变量） */\n  apiKey: string | undefined\n  /** 端点（条目 > 平台默认） */\n  baseUrl: string\n  /** 火山引擎 App Key */\n  appKey: string | undefined\n  /** 火山引擎 Access Key */\n  accessKey: string | undefined\n  /** 火山引擎资源 ID（条目 > 平台默认） */\n  resourceId: string\n  /** 阿里云百炼业务空间 ID */\n  workspaceId: string | undefined\n  /** 请求超时（毫秒） */\n  timeout: number\n}\n\n/** 各平台默认端点 */\nconst AUDIO_PROVIDER_DEFAULT_BASE_URL: Record<AudioProviderName, string> = {\n  openai: 'https://api.openai.com/v1',\n  mimo: 'https://api.xiaomimimo.com/v1',\n  qwen: 'wss://dashscope.aliyuncs.com/api-ws/v1/realtime',\n  doubao: 'wss://openspeech.bytedance.com',\n}\n\n/** 火山引擎默认资源 ID（按操作类型区分 ASR / TTS） */\nfunction doubaoDefaultResourceId(operation: 'transcribe' | 'synthesize'): string {\n  return operation === 'transcribe' ? 'volc.bigasr.sauc.duration' : 'seed-tts-2.0'\n}\n\n/** 读取指定平台的 API Key 环境变量（凭据未在配置中提供时的回退） */\nfunction audioProviderEnvApiKey(provider: AudioProviderName): string | undefined {\n  switch (provider) {\n    case 'openai':\n      return process.env.HAI_AI_AUDIO_OPENAI_API_KEY ?? process.env.OPENAI_API_KEY\n    case 'mimo':\n      return process.env.HAI_AI_AUDIO_MIMO_API_KEY ?? process.env.MIMO_API_KEY\n    case 'qwen':\n      return process.env.HAI_AI_AUDIO_QWEN_API_KEY ?? process.env.DASHSCOPE_API_KEY\n    case 'doubao':\n      return process.env.HAI_AI_AUDIO_DOUBAO_API_KEY ?? process.env.VOLC_API_KEY\n  }\n}\n\n/**\n * 解析语音操作应使用的模型配置\n *\n * 解析优先级：请求显式 `model` > 场景默认（transcribe/synthesize）；凭据回退到平台环境变量。\n *\n * @param audioConfig - Audio 配置\n * @param operation - 操作类型（识别 / 合成），决定使用哪个默认模型\n * @param explicit - 请求显式指定的模型 ID（最高优先级）\n * @returns 成功返回已解析模型；无匹配模型返回 `AUDIO_MODEL_NOT_FOUND`；缺少凭据返回 `CONFIGURATION_ERROR`\n */\nexport function resolveAudioModel(\n  audioConfig: AudioConfig,\n  operation: 'transcribe' | 'synthesize',\n  explicit?: string,\n): HaiResult<ResolvedAudioModel> {\n  const targetId = explicit ?? (operation === 'transcribe' ? audioConfig.transcribeModel : audioConfig.synthesizeModel)\n  if (!targetId)\n    return err(HaiAIError.AUDIO_MODEL_NOT_FOUND, aiM('ai_audioModelNotFound', { params: { model: `<${operation}>` } }))\n\n  const entry = audioConfig.models?.find(m => m.id === targetId || m.model === targetId)\n  if (!entry)\n    return err(HaiAIError.AUDIO_MODEL_NOT_FOUND, aiM('ai_audioModelNotFound', { params: { model: targetId } }))\n\n  const operations: readonly string[] = entry.operations\n  if (!operations.includes(operation)) {\n    return err(\n      HaiAIError.AUDIO_UNSUPPORTED_INPUT,\n      aiM('ai_audioUnsupportedInput', { params: { provider: entry.provider, reason: `model ${entry.id} does not support ${operation}` } }),\n    )\n  }\n\n  const apiKey = entry.apiKey ?? audioProviderEnvApiKey(entry.provider)\n  const hasDoubaoLegacy = Boolean(entry.appKey && entry.accessKey)\n  if (!apiKey && !(entry.provider === 'doubao' && hasDoubaoLegacy))\n    return err(HaiAIError.CONFIGURATION_ERROR, aiM('ai_audioMissingApiKey', { params: { provider: entry.provider } }))\n\n  return ok({\n    id: entry.id,\n    provider: entry.provider,\n    model: entry.model,\n    apiKey,\n    baseUrl: entry.baseUrl ?? AUDIO_PROVIDER_DEFAULT_BASE_URL[entry.provider],\n    appKey: entry.appKey ?? process.env.VOLC_APP_KEY,\n    accessKey: entry.accessKey ?? process.env.VOLC_ACCESS_KEY,\n    resourceId: entry.resourceId ?? (entry.provider === 'doubao' ? doubaoDefaultResourceId(operation) : ''),\n    workspaceId: entry.workspaceId,\n    timeout: entry.timeout ?? 60000,\n  })\n}\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: { maxEntriesPerObject: 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    api: 'chat',\n    maxTokens: 4096,\n    temperature: 0.7,\n    timeout: 60000,\n    tempModelCacheTtl: 600000,\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  /** Audio 配置（语音识别 / 语音合成） */\n  audio: AudioConfigSchema.optional(),\n})\n\n/** AI 配置类型（校验后的完整类型） */\nexport type AIConfig = z.infer<typeof AIConfigSchema>\n\n/** AI 配置输入类型（允许部分字段） */\nexport type AIConfigInput = z.input<typeof AIConfigSchema>\n","/**\n * @h-ai/ai — 统一语音 WebSocket 协议\n *\n * 定义浏览器 / 远程客户端与 `@h-ai/serv` 语音入口之间的统一 WebSocket 消息协议。\n * 客户端与服务端共享此协议，客户端不接收任何厂商原生事件；音频以二进制帧传输，\n * 控制与文本以 JSON 帧传输。\n * @module audio/ai-audio-ws-protocol\n */\n\nimport type { AudioFormat } from './ai-audio-types.js'\n\nimport {\n  AUDIO_WS_PATH as CONTRACT_AUDIO_WS_PATH,\n  AudioFormatSchema as ContractAudioFormatSchema,\n  AudioWsClientMessageSchema as ContractAudioWsClientMessageSchema,\n  AudioWsDoneMessageSchema as ContractAudioWsDoneMessageSchema,\n  AudioWsStartMessageSchema as ContractAudioWsStartMessageSchema,\n  AudioWsTextMessageSchema as ContractAudioWsTextMessageSchema,\n} from '@h-ai/api-contract'\n\n/** 统一语音入口的默认路径（相对 API 前缀） */\nexport const AUDIO_WS_PATH = CONTRACT_AUDIO_WS_PATH\n\n// ─── 客户端 → 服务端 ───\n\n/**\n * 会话起始消息（客户端首个 JSON 帧）\n *\n * 表达本次语音操作：识别或合成，及可选的模型 / 语言 / 音色 / 格式等参数。\n */\nexport interface AudioWsStartMessage {\n  type: 'start'\n  /** 操作类型 */\n  operation: 'transcribe' | 'synthesize'\n  /**\n   * 是否流式返回增量结果\n   *\n   * 识别操作：`true` 时服务端桥接为持续音频输入并流式返回临时结果；\n   * `false`（默认）时服务端缓冲完整音频后返回单条最终结果。\n   */\n  stream?: boolean\n  /** 模型 ID（不传时使用服务端默认模型） */\n  model?: string\n  /** 识别语言提示 */\n  language?: string\n  /** 领域提示词 / 热词（识别） */\n  contextHints?: string[]\n  /** 合成音色 */\n  voice?: string\n  /** 合成自然语言风格指令 */\n  instruction?: string\n  /** 音频格式（识别时为输入格式，合成时为输出格式） */\n  format?: AudioFormat\n  /** 采样率 */\n  sampleRate?: number\n  /** 声道数 */\n  channels?: 1 | 2\n}\n\n/** 文本输入帧（合成操作时携带待合成文本） */\nexport interface AudioWsTextMessage {\n  type: 'text'\n  /** 调用方分配的稳定文本段 ID */\n  segmentId: string\n  /** 待合成文本片段 */\n  text: string\n}\n\n/** 输入结束帧（音频 / 文本输入全部发送完毕） */\nexport interface AudioWsDoneMessage {\n  type: 'done'\n}\n\n/** 客户端 JSON 控制消息（音频输入以二进制帧发送，不走 JSON） */\nexport type AudioWsClientMessage = AudioWsStartMessage | AudioWsTextMessage | AudioWsDoneMessage\n\n// ─── 运行时校验 Schema（客户端与服务端共享） ───\n//\n// TypeScript 类型在网络运行时不生效：不可信客户端可发送任意 JSON。以下 Zod schema\n// 在协议边界对每一帧做运行时结构校验，非法帧在进入业务逻辑前即被拒绝。\n\n/** 合法音频格式 */\nexport const AudioFormatSchema = ContractAudioFormatSchema\n\n/** 单个字符串控制字段最大长度（model / language / voice / instruction 等） */\n/** 会话起始帧 Schema */\nexport const AudioWsStartMessageSchema = ContractAudioWsStartMessageSchema\n\n/** 文本输入帧 Schema（segmentId 非空且长度受限） */\nexport const AudioWsTextMessageSchema = ContractAudioWsTextMessageSchema\n\n/** 输入结束帧 Schema */\nexport const AudioWsDoneMessageSchema = ContractAudioWsDoneMessageSchema\n\n/** 客户端 JSON 控制消息 Schema（按 type 判别） */\nexport const AudioWsClientMessageSchema = ContractAudioWsClientMessageSchema\n\n// ─── 服务端 → 客户端 ───\n\n/** 语音起止事件（识别操作时服务端 VAD 检测到语音开始 / 结束） */\nexport interface AudioWsSpeechMessage {\n  type: 'speech_started' | 'speech_stopped'\n}\n\n/** 识别结果帧（识别操作时返回当前语句的完整文本） */\nexport interface AudioWsTranscriptMessage {\n  type: 'transcript'\n  /** 当前语句的完整识别文本 */\n  text: string\n  /** 是否为该语句的最终结果 */\n  final: boolean\n}\n\n/**\n * 合成文本段开始；后续二进制帧均属于该段，直到收到对应的 `segment_done`。\n *\n * 携带服务端解析 Provider 后的真实输出音频参数，供浏览器正确标注音频格式。\n */\nexport interface AudioWsSegmentStartedMessage {\n  type: 'segment_started'\n  segmentId: string\n  text: string\n  /** 真实输出音频格式（来自服务端解析后的 Provider 输出，非客户端请求参数） */\n  format: AudioFormat\n  /** 采样率（Hz）；pcm16 等裸音频必填 */\n  sampleRate?: number\n  /** 声道数（默认单声道） */\n  channels?: 1 | 2\n}\n\n/** 合成文本段的音频已全部发送。 */\nexport interface AudioWsSegmentDoneMessage {\n  type: 'segment_done'\n  segmentId: string\n}\n\n/** 错误帧（领域语义错误码，不暴露厂商协议细节） */\nexport interface AudioWsErrorMessage {\n  type: 'error'\n  /** 领域错误码（如 `hai:ai:054`） */\n  code: string\n  /** 错误消息 */\n  message: string\n}\n\n/** 结束帧（服务端已发送全部结果，随后关闭连接） */\nexport interface AudioWsEndMessage {\n  type: 'end'\n}\n\n/** 服务端 JSON 消息（合成音频以二进制帧返回，不走 JSON） */\nexport type AudioWsServerMessage\n  = | AudioWsSpeechMessage\n    | AudioWsTranscriptMessage\n    | AudioWsSegmentStartedMessage\n    | AudioWsSegmentDoneMessage\n    | AudioWsErrorMessage\n    | AudioWsEndMessage\n"]}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, a8 as TranscriptionEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a1 as SynthesisEvent, aD as ChatCompletionRequest, aE as ChatCompletionResponse, aB as ChatCompletionChunk, b3 as KnowledgeRetrieveResult, aS as KnowledgeAskResult, a$ as KnowledgeIngestResult, aT as KnowledgeDocumentInfo, bd as MemoryEntry, bM as StorePage, be as MemoryEntryInput, bl as MemoryUpdateInput, bK as SessionInfo, aH as ChatRecord, bs as RagResult, bw as ReasoningResult, ag as A2AAgentCardConfig, ao as A2AMessageRecord, ak as A2ACallResult } from '../ai-reasoning-types-CslaY4xX.js';
+import { a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, a8 as TranscriptionEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a1 as SynthesisEvent, aD as ChatCompletionRequest, aE as ChatCompletionResponse, aB as ChatCompletionChunk, b3 as KnowledgeRetrieveResult, aS as KnowledgeAskResult, a$ as KnowledgeIngestResult, aT as KnowledgeDocumentInfo, bd as MemoryEntry, bM as StorePage, be as MemoryEntryInput, bl as MemoryUpdateInput, bK as SessionInfo, aH as ChatRecord, bs as RagResult, bw as ReasoningResult, ag as A2AAgentCardConfig, ao as A2AMessageRecord, ak as A2ACallResult } from '../ai-reasoning-types-B8PH0w2_.js';
 import { HaiResult } from '@h-ai/core';
 import '@a2a-js/sdk/server';
 import '@h-ai/datapipe';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { af as InteractionScope } from './ai-reasoning-types-CslaY4xX.js';
-export { ag as A2AAgentCardConfig, ah as A2AApiKeySecurity, ai as A2AAuthenticator, aj as A2ACallOptions, ak as A2ACallResult, al as A2ACallerIdentity, A as A2AConfig, a as A2AConfigSchema, am as A2AContextInfo, an as A2AHandleResult, ao as A2AMessageRecord, ap as A2AOperations, aq as A2ASecurityConfig, b as A2ASkillConfigSchema, ar as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, as as AILLMFunctionsDeps, at as AIRelStore, au as AIRelStoreOptions, av as AIStoreProvider, aw as AIVectorBackend, ax as AIVectorStore, f as ApiType, g as ApiTypeSchema, ay as AskOptions, az as AssistantMessage, h as AudioCapabilitiesRequest, i as AudioConfig, j as AudioConfigSchema, k as AudioContent, l as AudioFormat, m as AudioInputStream, n as AudioModelCapabilities, o as AudioModelEntry, p as AudioModelEntrySchema, q as AudioOperations, r as AudioProviderName, s as AudioProviderSchema, aA as ChatCompletionChoice, aB as ChatCompletionChunk, aC as ChatCompletionDelta, aD as ChatCompletionRequest, aE as ChatCompletionResponse, aF as ChatHistoryOptions, aG as ChatMessage, aH as ChatRecord, aI as Citation, C as CompressConfig, t as CompressConfigSchema, aJ as DefineToolOptions, aK as DeveloperMessage, E as EmbeddingConfig, u as EmbeddingConfigSchema, aL as EntityDocumentRelation, aM as EntityDocumentResult, aN as EntityListOptions, aO as EntityQueryOptions, v as EntityType, w as EntityTypeSchema, F as FileConfig, x as FileConfigSchema, aP as GenerateObjectRequest, aQ as ImageContent, aR as KnowledgeAskOptions, aS as KnowledgeAskResult, K as KnowledgeConfig, y as KnowledgeConfigSchema, aT as KnowledgeDocumentInfo, aU as KnowledgeDocumentListOptions, aV as KnowledgeDocumentRemoveOptions, aW as KnowledgeEntity, aX as KnowledgeIngestBatchProgress, aY as KnowledgeIngestBatchResult, aZ as KnowledgeIngestFileInput, a_ as KnowledgeIngestInput, a$ as KnowledgeIngestResult, b0 as KnowledgeOperations, b1 as KnowledgeRetrieveItem, b2 as KnowledgeRetrieveOptions, b3 as KnowledgeRetrieveResult, b4 as KnowledgeSetupOptions, b5 as KnowledgeStore, L as LLMConfig, z as LLMConfigSchema, b6 as LLMOperations, b7 as LLMProvider, M as MCPConfig, B as MCPConfigSchema, D as MCPServerCapabilities, G as MCPServerCapabilitiesSchema, H as MCPServerConfig, I as MCPServerConfigSchema, b8 as MemoryAccessScope, b9 as MemoryAdminOperations, ba as MemoryClearAllOptions, bb as MemoryClearOptions, J as MemoryConfig, N as MemoryConfigSchema, bc as MemoryCoreOperations, bd as MemoryEntry, be as MemoryEntryInput, bf as MemoryExtractOptions, bg as MemoryInjectionOptions, bh as MemoryListOptions, bi as MemoryListPageOptions, bj as MemoryOperations, bk as MemoryRecallOptions, O as MemoryType, P as MemoryTypeSchema, bl as MemoryUpdateInput, bm as MessageContent, bn as MessageRole, Q as ModelEntry, R as ModelEntrySchema, S as ModelScenario, T as ModelScenarioSchema, bo as ObjectRef, bp as RagContextItem, bq as RagOperations, br as RagOptions, bs as RagResult, bt as RagStreamEvent, bu as ReasoningOperations, bv as ReasoningOptions, bw as ReasoningResult, bx as ReasoningStep, by as ReasoningStepType, bz as ReasoningStrategy, bA as ReasoningStreamEvent, U as ResolveRequiredModelEntryOptions, V as ResolvedAudioModel, W as ResolvedModelConfig, X as RetrievalConfig, Y as RetrievalConfigSchema, bB as RetrievalOperations, bC as RetrievalRequest, bD as RetrievalResult, bE as RetrievalResultItem, bF as RetrievalSource, Z as RetrievalSourceConfig, _ as RetrievalSourceSchema, bG as SSEDecoder, bH as SSEEvent, bI as ScopedMemoryBinding, bJ as ScopedMemoryOperations, bK as SessionInfo, bL as StoreFilter, bM as StorePage, bN as StoreScope, bO as StreamOperations, bP as StreamProcessor, bQ as StreamResult, $ as SummaryConfig, a0 as SummaryConfigSchema, a1 as SynthesisEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a5 as SynthesisTextSegment, bR as SystemMessage, bS as TempModelConfig, bT as TextContent, a6 as TokenConfig, a7 as TokenConfigSchema, bU as TokenUsage, bV as Tool, bW as ToolAuthorizationRequest, bX as ToolAuthorizer, bY as ToolCall, bZ as ToolDefinition, b_ as ToolErrorType, b$ as ToolExecutionContext, c0 as ToolExecutionOptions, c1 as ToolMessage, c2 as ToolRegistryOperations, c3 as ToolRegistryOptions, c4 as ToolsOperations, a8 as TranscriptionEvent, a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, c5 as UserMessage, c6 as WhereClause, c7 as WhereOperator, c8 as WhereValue, ac as resolveAudioModel, ad as resolveModelApi, ae as resolveModelEntry } from './ai-reasoning-types-CslaY4xX.js';
-import { A as AIFunctions, M as McpServerOptions } from './ai-audio-ws-protocol-BK5753o1.js';
-export { a as AIInitOptions, t as AIMCPFunctionsDeps, b as AUDIO_WS_PATH, c as AudioFormatSchema, d as AudioWsClientMessage, e as AudioWsClientMessageSchema, f as AudioWsDoneMessage, g as AudioWsDoneMessageSchema, h as AudioWsEndMessage, i as AudioWsErrorMessage, j as AudioWsSegmentDoneMessage, k as AudioWsSegmentStartedMessage, l as AudioWsServerMessage, m as AudioWsSpeechMessage, n as AudioWsStartMessage, o as AudioWsStartMessageSchema, p as AudioWsTextMessage, q as AudioWsTextMessageSchema, r as AudioWsTranscriptMessage, u as CommitTurnInput, v as CompressOperations, w as CompressOptions, x as CompressResult, C as CompressionStrategy, s as CompressionStrategySchema, y as ConsolidateOptions, z as ConsolidateResult, B as ContextChatOptions, D as ContextChatResult, E as ContextDeps, F as ContextManager, G as ContextManagerOptions, I as ContextOperations, J as ContextResetOptions, K as ContextStreamEvent, L as ConversationTurn, N as ConversationTurnStatus, O as EmbeddingItem, P as EmbeddingOperations, Q as EmbeddingProvider, R as EmbeddingRequest, S as EmbeddingResponse, T as FileOperations, U as FileParseMethod, V as FileParseOptions, W as FileParseRequest, X as FileParseResult, H as HaiAIError, Y as MCPContext, Z as MCPOperations, _ as MCPPrompt, $ as MCPPromptArgument, a0 as MCPPromptContent, a1 as MCPPromptMessage, a2 as MCPProvider, a3 as MCPResource, a4 as MCPResourceContent, a5 as MCPToolDefinition, a6 as MCPToolHandler, a7 as OutputFormat, a8 as PersonaOperations, a9 as PersonaProfile, aa as PersonaProfileInput, ab as PersonaProfileUpdate, ac as PersonaScopeOptions, ad as RerankDocument, ae as RerankItem, af as RerankOperations, ag as RerankRequest, ah as RerankResponse, ai as SummaryOperations, aj as SummaryOptions, ak as SummaryResult, al as TokenOperations } from './ai-audio-ws-protocol-BK5753o1.js';
+import { af as InteractionScope } from './ai-reasoning-types-B8PH0w2_.js';
+export { ag as A2AAgentCardConfig, ah as A2AApiKeySecurity, ai as A2AAuthenticator, aj as A2ACallOptions, ak as A2ACallResult, al as A2ACallerIdentity, A as A2AConfig, a as A2AConfigSchema, am as A2AContextInfo, an as A2AHandleResult, ao as A2AMessageRecord, ap as A2AOperations, aq as A2ASecurityConfig, b as A2ASkillConfigSchema, ar as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, as as AILLMFunctionsDeps, at as AIRelStore, au as AIRelStoreOptions, av as AIStoreProvider, aw as AIVectorBackend, ax as AIVectorStore, f as ApiType, g as ApiTypeSchema, ay as AskOptions, az as AssistantMessage, h as AudioCapabilitiesRequest, i as AudioConfig, j as AudioConfigSchema, k as AudioContent, l as AudioFormat, m as AudioInputStream, n as AudioModelCapabilities, o as AudioModelEntry, p as AudioModelEntrySchema, q as AudioOperations, r as AudioProviderName, s as AudioProviderSchema, aA as ChatCompletionChoice, aB as ChatCompletionChunk, aC as ChatCompletionDelta, aD as ChatCompletionRequest, aE as ChatCompletionResponse, aF as ChatHistoryOptions, aG as ChatMessage, aH as ChatRecord, aI as Citation, C as CompressConfig, t as CompressConfigSchema, aJ as DefineToolOptions, aK as DeveloperMessage, E as EmbeddingConfig, u as EmbeddingConfigSchema, aL as EntityDocumentRelation, aM as EntityDocumentResult, aN as EntityListOptions, aO as EntityQueryOptions, v as EntityType, w as EntityTypeSchema, F as FileConfig, x as FileConfigSchema, aP as GenerateObjectRequest, aQ as ImageContent, aR as KnowledgeAskOptions, aS as KnowledgeAskResult, K as KnowledgeConfig, y as KnowledgeConfigSchema, aT as KnowledgeDocumentInfo, aU as KnowledgeDocumentListOptions, aV as KnowledgeDocumentRemoveOptions, aW as KnowledgeEntity, aX as KnowledgeIngestBatchProgress, aY as KnowledgeIngestBatchResult, aZ as KnowledgeIngestFileInput, a_ as KnowledgeIngestInput, a$ as KnowledgeIngestResult, b0 as KnowledgeOperations, b1 as KnowledgeRetrieveItem, b2 as KnowledgeRetrieveOptions, b3 as KnowledgeRetrieveResult, b4 as KnowledgeSetupOptions, b5 as KnowledgeStore, L as LLMConfig, z as LLMConfigSchema, b6 as LLMOperations, b7 as LLMProvider, M as MCPConfig, B as MCPConfigSchema, D as MCPServerCapabilities, G as MCPServerCapabilitiesSchema, H as MCPServerConfig, I as MCPServerConfigSchema, b8 as MemoryAccessScope, b9 as MemoryAdminOperations, ba as MemoryClearAllOptions, bb as MemoryClearOptions, J as MemoryConfig, N as MemoryConfigSchema, bc as MemoryCoreOperations, bd as MemoryEntry, be as MemoryEntryInput, bf as MemoryExtractOptions, bg as MemoryInjectionOptions, bh as MemoryListOptions, bi as MemoryListPageOptions, bj as MemoryOperations, bk as MemoryRecallOptions, O as MemoryType, P as MemoryTypeSchema, bl as MemoryUpdateInput, bm as MessageContent, bn as MessageRole, Q as ModelEntry, R as ModelEntrySchema, S as ModelScenario, T as ModelScenarioSchema, bo as ObjectRef, bp as RagContextItem, bq as RagOperations, br as RagOptions, bs as RagResult, bt as RagStreamEvent, bu as ReasoningOperations, bv as ReasoningOptions, bw as ReasoningResult, bx as ReasoningStep, by as ReasoningStepType, bz as ReasoningStrategy, bA as ReasoningStreamEvent, U as ResolveRequiredModelEntryOptions, V as ResolvedAudioModel, W as ResolvedModelConfig, X as RetrievalConfig, Y as RetrievalConfigSchema, bB as RetrievalOperations, bC as RetrievalRequest, bD as RetrievalResult, bE as RetrievalResultItem, bF as RetrievalSource, Z as RetrievalSourceConfig, _ as RetrievalSourceSchema, bG as SSEDecoder, bH as SSEEvent, bI as ScopedMemoryBinding, bJ as ScopedMemoryOperations, bK as SessionInfo, bL as StoreFilter, bM as StorePage, bN as StoreScope, bO as StreamOperations, bP as StreamProcessor, bQ as StreamResult, $ as SummaryConfig, a0 as SummaryConfigSchema, a1 as SynthesisEvent, a2 as SynthesisRequest, a3 as SynthesisResult, a4 as SynthesisStreamRequest, a5 as SynthesisTextSegment, bR as SystemMessage, bS as TempModelConfig, bT as TextContent, a6 as TokenConfig, a7 as TokenConfigSchema, bU as TokenUsage, bV as Tool, bW as ToolAuthorizationRequest, bX as ToolAuthorizer, bY as ToolCall, bZ as ToolDefinition, b_ as ToolErrorType, b$ as ToolExecutionContext, c0 as ToolExecutionOptions, c1 as ToolMessage, c2 as ToolRegistryOperations, c3 as ToolRegistryOptions, c4 as ToolsOperations, a8 as TranscriptionEvent, a9 as TranscriptionRequest, aa as TranscriptionResult, ab as TranscriptionStreamRequest, c5 as UserMessage, c6 as WhereClause, c7 as WhereOperator, c8 as WhereValue, ac as resolveAudioModel, ad as resolveModelApi, ae as resolveModelEntry } from './ai-reasoning-types-B8PH0w2_.js';
+import { A as AIFunctions, M as McpServerOptions } from './ai-audio-ws-protocol-DbZZvH52.js';
+export { a as AIInitOptions, t as AIMCPFunctionsDeps, b as AUDIO_WS_PATH, c as AudioFormatSchema, d as AudioWsClientMessage, e as AudioWsClientMessageSchema, f as AudioWsDoneMessage, g as AudioWsDoneMessageSchema, h as AudioWsEndMessage, i as AudioWsErrorMessage, j as AudioWsSegmentDoneMessage, k as AudioWsSegmentStartedMessage, l as AudioWsServerMessage, m as AudioWsSpeechMessage, n as AudioWsStartMessage, o as AudioWsStartMessageSchema, p as AudioWsTextMessage, q as AudioWsTextMessageSchema, r as AudioWsTranscriptMessage, u as CommitTurnInput, v as CompressOperations, w as CompressOptions, x as CompressResult, C as CompressionStrategy, s as CompressionStrategySchema, y as ConsolidateOptions, z as ConsolidateResult, B as ContextChatOptions, D as ContextChatResult, E as ContextDeps, F as ContextManager, G as ContextManagerOptions, I as ContextOperations, J as ContextResetOptions, K as ContextStreamEvent, L as ConversationTurn, N as ConversationTurnStatus, O as EmbeddingItem, P as EmbeddingOperations, Q as EmbeddingProvider, R as EmbeddingRequest, S as EmbeddingResponse, T as FileOperations, U as FileParseMethod, V as FileParseOptions, W as FileParseRequest, X as FileParseResult, H as HaiAIError, Y as MCPContext, Z as MCPOperations, _ as MCPPrompt, $ as MCPPromptArgument, a0 as MCPPromptContent, a1 as MCPPromptMessage, a2 as MCPProvider, a3 as MCPResource, a4 as MCPResourceContent, a5 as MCPToolDefinition, a6 as MCPToolHandler, a7 as OutputFormat, a8 as PersonaOperations, a9 as PersonaProfile, aa as PersonaProfileInput, ab as PersonaProfileUpdate, ac as PersonaScopeOptions, ad as RerankDocument, ae as RerankItem, af as RerankOperations, ag as RerankRequest, ah as RerankResponse, ai as SummaryOperations, aj as SummaryOptions, ak as SummaryResult, al as TokenOperations } from './ai-audio-ws-protocol-DbZZvH52.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { TaskStore as A2ATaskStore, AgentExecutor, ExecutionEventBus, RequestContext, ServerCallContext } from '@a2a-js/sdk/server';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { aiM, AIConfigSchema, MemoryConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, AudioConfigSchema, resolveModelEntry, resolveAudioModel, resolveModelApi } from './chunk-5XL4QDIJ.js';
-export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, AUDIO_WS_PATH, ApiTypeSchema, AudioConfigSchema, AudioFormatSchema, AudioModelEntrySchema, AudioProviderSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveAudioModel, resolveModelApi, resolveModelEntry } from './chunk-5XL4QDIJ.js';
+import { aiM, AIConfigSchema, MemoryConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, AudioConfigSchema, resolveModelEntry, resolveAudioModel, resolveModelApi } from './chunk-OZYROB52.js';
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, AUDIO_WS_PATH, ApiTypeSchema, AudioConfigSchema, AudioFormatSchema, AudioModelEntrySchema, AudioProviderSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveAudioModel, resolveModelApi, resolveModelEntry } from './chunk-OZYROB52.js';
 import { HaiAIError } from './chunk-P3GND76X.js';
 export { HaiAIError } from './chunk-P3GND76X.js';
 import { core, err, ok } from '@h-ai/core';
@@ -4862,7 +4862,8 @@ Only extract memories of these types: ${options.types.join(", ")}`;
         { role: "system", content: options?.systemPrompt ?? MEMORY_EXTRACTION_SYSTEM_PROMPT },
         { role: "user", content: userPrompt }
       ],
-      temperature: 0.1
+      temperature: 0.1,
+      signal: options?.signal
     });
     if (!chatResult.success) {
       logger15.warn("Memory extraction LLM call failed", { error: chatResult.error });
@@ -5194,7 +5195,8 @@ async function extractMemories2(context, messages, options) {
     minImportance: options?.minImportance,
     systemPrompt: options?.systemPrompt ?? context.systemPrompt,
     objectId,
-    tempModel: options?.tempModel
+    tempModel: options?.tempModel,
+    signal: options?.signal
   });
   if (!extracted.success)
     return extracted;
@@ -5560,7 +5562,8 @@ async function extractAndConsolidate(deps, messages, options) {
     minImportance: options?.minImportance,
     objectId: options?.objectId,
     systemPrompt: options?.systemPrompt ?? deps.systemPrompt,
-    tempModel: options?.tempModel
+    tempModel: options?.tempModel,
+    signal: options?.signal
   });
   if (!extractResult.success)
     return extractResult;
@@ -5594,7 +5597,8 @@ async function extractAndConsolidate(deps, messages, options) {
         })
       }
     ],
-    temperature: 0.1
+    temperature: 0.1,
+    signal: options?.signal
   });
   if (!consolidationResult.success) {
     return err(HaiAIError.MEMORY_EXTRACT_FAILED, aiM("ai_memoryExtractFailed", { params: { error: String(consolidationResult.error.message) } }), consolidationResult.error);