@h-ai/ai 0.1.0-alpha.24 → 0.1.0-alpha.25

package/README.md

@@ -90,6 +90,13 @@ for await (const chunk of ai.llm.chatStream({ messages })) {
     process.stdout.write(delta)
   }
 }
+
+// 临时模型：单次请求绕过配置注册模型，直接指定端点与凭据（chat/chatStream/ask/askStream 均支持）
+// 临时客户端按 TTL 缓存（llm.tempModelCacheTtl，默认 10 分钟），与常驻模型客户端隔离
+const temp = await ai.llm.chat({
+  messages,
+  tempModel: { model: 'claude-3-5-sonnet', apiKey: 'sk-temp', baseUrl: 'https://temp.endpoint/v1' },
+})
 ```
 
 ### 工具调用
@@ -159,6 +166,7 @@ llm:
   baseUrl: ${HAI_AI_LLM_BASE_URL:https://api.openai.com/v1}
   model: ${HAI_AI_LLM_MODEL:gpt-4o-mini}
   timeout: 60000
+  tempModelCacheTtl: 600000 # 临时模型客户端缓存 TTL（毫秒，默认 10 分钟）
   scenarios:
     chat: fast
     reasoning: strong

package/dist/{ai-reasoning-types-C1uvQosU.d.ts → ai-reasoning-types-DkMYFvyX.d.ts}

@@ -666,6 +666,31 @@ type ToolMessage = OpenAI.Chat.Completions.ChatCompletionToolMessageParam;
 type ChatMessage = OpenAI.Chat.Completions.ChatCompletionMessageParam | DeveloperMessage;
 /** OpenAI function calling 工具定义格式 */
 type ToolDefinition = OpenAI.Chat.Completions.ChatCompletionTool;
+/**
+ * 临时模型配置
+ *
+ * 单次请求级别的临时模型端点，绕过配置中注册的模型与场景映射，
+ * 直接指定 API Key / Base URL / 模型名等参数。适用于运行时动态切换模型、
+ * 多租户各自携带凭据等场景。其客户端实例按 TTL 缓存（见 `LLMConfig.tempModelCacheTtl`），
+ * 与常驻模型客户端缓存隔离。
+ *
+ * 未指定的字段回退到全局 LLM 配置：`apiKey` / `baseUrl` 回退全局值或环境变量，
+ * `maxTokens` / `temperature` / `timeout` 回退全局默认值。
+ */
+interface TempModelConfig {
+    /** 模型名称（传给 API 的实际模型名） */
+    model: string;
+    /** API Key（未指定时回退全局配置 / 环境变量） */
+    apiKey?: string;
+    /** API 基础 URL（未指定时回退全局配置 / 环境变量 / 默认 OpenAI） */
+    baseUrl?: string;
+    /** 最大 Token 数（未指定时回退全局配置；请求显式指定 `max_tokens` 时以请求为准） */
+    maxTokens?: number;
+    /** 采样温度（未指定时回退全局配置；请求显式指定 `temperature` 时以请求为准） */
+    temperature?: number;
+    /** 请求超时时间（毫秒，未指定时回退全局配置） */
+    timeout?: number;
+}
 /**
  * 聊天完成请求参数
  *
@@ -684,6 +709,8 @@ type ChatCompletionRequest = Omit<OpenAI.Chat.ChatCompletionCreateParamsNonStrea
     sessionId?: string;
     /** 是否持久化对话记录（默认 true；传入 false 时跳过记录，适用于内部调用如实体提取） */
     enablePersist?: boolean;
+    /** 临时模型配置（传入后绕过配置注册的模型，使用临时端点；优先级高于 `model`） */
+    tempModel?: TempModelConfig;
 };
 /** Token 使用统计 */
 type TokenUsage = OpenAI.CompletionUsage;
@@ -851,6 +878,8 @@ interface AskOptions {
     temperature?: number;
     /** 是否持久化对话记录（默认 true；传入 false 时跳过记录） */
     enablePersist?: boolean;
+    /** 临时模型配置（传入后绕过配置注册的模型，使用临时端点；优先级高于 `model`） */
+    tempModel?: TempModelConfig;
 }
 /**
  * 对话记录
@@ -1976,6 +2005,7 @@ declare const LLMConfigSchema: z.ZodObject<{
     maxTokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     temperature: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tempModelCacheTtl: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     models: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         model: z.ZodString;
@@ -2411,6 +2441,7 @@ declare const AIConfigSchema: z.ZodObject<{
         maxTokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         temperature: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        tempModelCacheTtl: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             model: z.ZodString;
@@ -2839,4 +2870,4 @@ interface ReasoningOperations {
     runStream: (query: string, options?: ReasoningOptions) => AsyncIterable<ReasoningStreamEvent>;
 }
 
-export { type A2AOperations as $, type A2AConfig as A, type RetrievalConfig as B, type CompressConfig as C, RetrievalConfigSchema as D, type EmbeddingConfig as E, type FileConfig as F, type RetrievalSourceConfig as G, RetrievalSourceSchema as H, SummaryConfigSchema as I, TokenConfigSchema as J, type KnowledgeConfig as K, type LLMConfig as L, type MCPConfig as M, resolveModelEntry as N, type A2AAgentCardConfig as O, type A2AApiKeySecurity as P, type A2AAuthenticator as Q, type ResolveRequiredModelEntryOptions as R, type SummaryConfig as S, type TokenConfig as T, type A2ACallOptions as U, type A2ACallResult as V, type A2ACallerIdentity as W, type A2AClientCallRecord as X, type A2AContextInfo as Y, type A2AHandleResult as Z, type A2AMessageRecord as _, A2AConfigSchema as a, type ReasoningOperations as a$, type A2ASecurityConfig as a0, type A2ATaskFilter as a1, type AILLMFunctionsDeps as a2, type AIRelStore as a3, type AIRelStoreOptions as a4, type AIStoreProvider as a5, type AIVectorStore as a6, type AskOptions as a7, type AssistantMessage as a8, type ChatCompletionChoice as a9, type KnowledgeIngestResult as aA, type KnowledgeOperations as aB, type KnowledgeRetrieveItem as aC, type KnowledgeRetrieveOptions as aD, type KnowledgeRetrieveResult as aE, type KnowledgeSetupOptions as aF, type KnowledgeStore as aG, type LLMOperations as aH, type LLMProvider as aI, type MemoryClearOptions as aJ, type MemoryEntry as aK, type MemoryEntryInput as aL, type MemoryExtractOptions as aM, type MemoryInjectionOptions as aN, type MemoryListOptions as aO, type MemoryListPageOptions as aP, type MemoryOperations as aQ, type MemoryRecallOptions as aR, type MemoryUpdateInput as aS, type MessageContent as aT, type MessageRole as aU, type ObjectRef as aV, type RagContextItem as aW, type RagOperations as aX, type RagOptions as aY, type RagResult as aZ, type RagStreamEvent as a_, type ChatCompletionChunk as aa, type ChatCompletionDelta as ab, type ChatCompletionRequest as ac, type ChatCompletionResponse as ad, type ChatHistoryOptions as ae, type ChatMessage as af, type ChatRecord as ag, type Citation as ah, type DefineToolOptions as ai, type DeveloperMessage as aj, type EntityDocumentRelation as ak, type EntityDocumentResult as al, type EntityListOptions as am, type EntityQueryOptions as an, type ImageContent as ao, type InteractionScope as ap, type KnowledgeAskOptions as aq, type KnowledgeAskResult as ar, type KnowledgeDocumentInfo as as, type KnowledgeDocumentListOptions as at, type KnowledgeDocumentRemoveOptions as au, type KnowledgeEntity as av, type KnowledgeIngestBatchProgress as aw, type KnowledgeIngestBatchResult as ax, type KnowledgeIngestFileInput as ay, type KnowledgeIngestInput as az, A2ASkillConfigSchema as b, type ReasoningOptions as b0, type ReasoningResult as b1, type ReasoningStep as b2, type ReasoningStepType as b3, type ReasoningStrategy as b4, type ReasoningStreamEvent as b5, type RetrievalOperations as b6, type RetrievalRequest as b7, type RetrievalResult as b8, type RetrievalResultItem as b9, type RetrievalSource as ba, type SSEDecoder as bb, type SSEEvent as bc, type SessionInfo as bd, type StoreFilter as be, type StorePage as bf, type StoreScope as bg, type StreamOperations as bh, type StreamProcessor as bi, type StreamResult as bj, type SystemMessage as bk, type TextContent as bl, type TokenUsage as bm, type Tool as bn, type ToolCall as bo, type ToolDefinition as bp, type ToolErrorType as bq, type ToolMessage as br, type ToolRegistryOperations as bs, type ToolsOperations as bt, type UserMessage as bu, type WhereClause as bv, type WhereOperator as bw, type WhereValue as bx, type AIConfig as c, type AIConfigInput as d, AIConfigSchema as e, CompressConfigSchema as f, EmbeddingConfigSchema as g, type EntityType as h, EntityTypeSchema as i, FileConfigSchema as j, KnowledgeConfigSchema as k, LLMConfigSchema as l, MCPConfigSchema as m, type MCPServerCapabilities as n, MCPServerCapabilitiesSchema as o, type MCPServerConfig as p, MCPServerConfigSchema as q, type MemoryConfig as r, MemoryConfigSchema as s, type MemoryType as t, MemoryTypeSchema as u, type ModelEntry as v, ModelEntrySchema as w, type ModelScenario as x, ModelScenarioSchema as y, type ResolvedModelConfig as z };
+export { type A2AOperations as $, type A2AConfig as A, type RetrievalConfig as B, type CompressConfig as C, RetrievalConfigSchema as D, type EmbeddingConfig as E, type FileConfig as F, type RetrievalSourceConfig as G, RetrievalSourceSchema as H, SummaryConfigSchema as I, TokenConfigSchema as J, type KnowledgeConfig as K, type LLMConfig as L, type MCPConfig as M, resolveModelEntry as N, type A2AAgentCardConfig as O, type A2AApiKeySecurity as P, type A2AAuthenticator as Q, type ResolveRequiredModelEntryOptions as R, type SummaryConfig as S, type TokenConfig as T, type A2ACallOptions as U, type A2ACallResult as V, type A2ACallerIdentity as W, type A2AClientCallRecord as X, type A2AContextInfo as Y, type A2AHandleResult as Z, type A2AMessageRecord as _, A2AConfigSchema as a, type ReasoningOperations as a$, type A2ASecurityConfig as a0, type A2ATaskFilter as a1, type AILLMFunctionsDeps as a2, type AIRelStore as a3, type AIRelStoreOptions as a4, type AIStoreProvider as a5, type AIVectorStore as a6, type AskOptions as a7, type AssistantMessage as a8, type ChatCompletionChoice as a9, type KnowledgeIngestResult as aA, type KnowledgeOperations as aB, type KnowledgeRetrieveItem as aC, type KnowledgeRetrieveOptions as aD, type KnowledgeRetrieveResult as aE, type KnowledgeSetupOptions as aF, type KnowledgeStore as aG, type LLMOperations as aH, type LLMProvider as aI, type MemoryClearOptions as aJ, type MemoryEntry as aK, type MemoryEntryInput as aL, type MemoryExtractOptions as aM, type MemoryInjectionOptions as aN, type MemoryListOptions as aO, type MemoryListPageOptions as aP, type MemoryOperations as aQ, type MemoryRecallOptions as aR, type MemoryUpdateInput as aS, type MessageContent as aT, type MessageRole as aU, type ObjectRef as aV, type RagContextItem as aW, type RagOperations as aX, type RagOptions as aY, type RagResult as aZ, type RagStreamEvent as a_, type ChatCompletionChunk as aa, type ChatCompletionDelta as ab, type ChatCompletionRequest as ac, type ChatCompletionResponse as ad, type ChatHistoryOptions as ae, type ChatMessage as af, type ChatRecord as ag, type Citation as ah, type DefineToolOptions as ai, type DeveloperMessage as aj, type EntityDocumentRelation as ak, type EntityDocumentResult as al, type EntityListOptions as am, type EntityQueryOptions as an, type ImageContent as ao, type InteractionScope as ap, type KnowledgeAskOptions as aq, type KnowledgeAskResult as ar, type KnowledgeDocumentInfo as as, type KnowledgeDocumentListOptions as at, type KnowledgeDocumentRemoveOptions as au, type KnowledgeEntity as av, type KnowledgeIngestBatchProgress as aw, type KnowledgeIngestBatchResult as ax, type KnowledgeIngestFileInput as ay, type KnowledgeIngestInput as az, A2ASkillConfigSchema as b, type ReasoningOptions as b0, type ReasoningResult as b1, type ReasoningStep as b2, type ReasoningStepType as b3, type ReasoningStrategy as b4, type ReasoningStreamEvent as b5, type RetrievalOperations as b6, type RetrievalRequest as b7, type RetrievalResult as b8, type RetrievalResultItem as b9, type RetrievalSource as ba, type SSEDecoder as bb, type SSEEvent as bc, type SessionInfo as bd, type StoreFilter as be, type StorePage as bf, type StoreScope as bg, type StreamOperations as bh, type StreamProcessor as bi, type StreamResult as bj, type SystemMessage as bk, type TempModelConfig as bl, type TextContent as bm, type TokenUsage as bn, type Tool as bo, type ToolCall as bp, type ToolDefinition as bq, type ToolErrorType as br, type ToolMessage as bs, type ToolRegistryOperations as bt, type ToolsOperations as bu, type UserMessage as bv, type WhereClause as bw, type WhereOperator as bx, type WhereValue as by, type AIConfig as c, type AIConfigInput as d, AIConfigSchema as e, CompressConfigSchema as f, EmbeddingConfigSchema as g, type EntityType as h, EntityTypeSchema as i, FileConfigSchema as j, KnowledgeConfigSchema as k, LLMConfigSchema as l, MCPConfigSchema as m, type MCPServerCapabilities as n, MCPServerCapabilitiesSchema as o, type MCPServerConfig as p, MCPServerConfigSchema as q, type MemoryConfig as r, MemoryConfigSchema as s, type MemoryType as t, MemoryTypeSchema as u, type ModelEntry as v, ModelEntrySchema as w, type ModelScenario as x, ModelScenarioSchema as y, type ResolvedModelConfig as z };

package/dist/{ai-types-DTMq_ZRJ.d.ts → ai-types-DNjsxTn_.d.ts}

@@ -1,6 +1,6 @@
 import * as _h_ai_core from '@h-ai/core';
 import { HaiResult } from '@h-ai/core';
-import { af as ChatMessage, ap as InteractionScope, aN as MemoryInjectionOptions, aY as RagOptions, b0 as ReasoningOptions, bs as ToolRegistryOperations, bd as SessionInfo, aH as LLMOperations, aQ as MemoryOperations, aX as RagOperations, a$ as ReasoningOperations, c as AIConfig, d as AIConfigInput, a5 as AIStoreProvider, bt as ToolsOperations, bh as StreamOperations, b6 as RetrievalOperations, aB as KnowledgeOperations, $ as A2AOperations } from './ai-reasoning-types-C1uvQosU.js';
+import { af as ChatMessage, ap as InteractionScope, aN as MemoryInjectionOptions, aY as RagOptions, b0 as ReasoningOptions, bt as ToolRegistryOperations, bd as SessionInfo, aH as LLMOperations, aQ as MemoryOperations, aX as RagOperations, a$ as ReasoningOperations, c as AIConfig, d as AIConfigInput, a5 as AIStoreProvider, bu as ToolsOperations, bh as StreamOperations, b6 as RetrievalOperations, aB as KnowledgeOperations, $ as A2AOperations } from './ai-reasoning-types-DkMYFvyX.js';
 import { z } from 'zod';
 import { Buffer } from 'node:buffer';
 

package/dist/browser.d.ts

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

package/dist/browser.js

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

package/dist/{chunk-B43IUMC7.js → chunk-CB44CSOG.js}

@@ -249,6 +249,8 @@ var LLMConfigSchema = z.object({
   temperature: z.number().min(0).max(2).optional().default(0.7),
   /** 全局请求超时时间（各模型 fallback，毫秒，默认 `60000`） */
   timeout: z.number().positive().optional().default(6e4),
+  /** 临时模型客户端缓存存活时间（毫秒，默认 `600000` = 10 分钟；超时后临时模型客户端实例失效并重建） */
+  tempModelCacheTtl: z.number().positive().optional().default(6e5),
   /** 多模型配置列表（各字段可选，未指定时回退到全局默认值） */
   models: z.array(ModelEntrySchema).optional(),
   /** 场景模型映射（场景名 → 模型 ID 或直接模型名称，各场景均可选） */
@@ -434,7 +436,8 @@ var AIConfigSchema = z.object({
     model: "gpt-4o-mini",
     maxTokens: 4096,
     temperature: 0.7,
-    timeout: 6e4
+    timeout: 6e4,
+    tempModelCacheTtl: 6e5
   }),
   /** MCP 配置 */
   mcp: MCPConfigSchema.optional(),
@@ -459,5 +462,5 @@ var AIConfigSchema = z.object({
 });
 
 export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, aiM, resolveModelEntry };
-//# sourceMappingURL=chunk-B43IUMC7.js.map
-//# sourceMappingURL=chunk-B43IUMC7.js.map
+//# sourceMappingURL=chunk-CB44CSOG.js.map
+//# sourceMappingURL=chunk-CB44CSOG.js.map

package/dist/chunk-CB44CSOG.js.map

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

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { ac as ChatCompletionRequest, ad as ChatCompletionResponse, aa as ChatCompletionChunk, aE as KnowledgeRetrieveResult, ar as KnowledgeAskResult, aA as KnowledgeIngestResult, as as KnowledgeDocumentInfo, aK as MemoryEntry, bf as StorePage, aL as MemoryEntryInput, aS as MemoryUpdateInput, bd as SessionInfo, ag as ChatRecord, aZ as RagResult, b1 as ReasoningResult, O as A2AAgentCardConfig, _ as A2AMessageRecord, V as A2ACallResult } from '../ai-reasoning-types-C1uvQosU.js';
+import { ac as ChatCompletionRequest, ad as ChatCompletionResponse, aa as ChatCompletionChunk, aE as KnowledgeRetrieveResult, ar as KnowledgeAskResult, aA as KnowledgeIngestResult, as as KnowledgeDocumentInfo, aK as MemoryEntry, bf as StorePage, aL as MemoryEntryInput, aS as MemoryUpdateInput, bd as SessionInfo, ag as ChatRecord, aZ as RagResult, b1 as ReasoningResult, O as A2AAgentCardConfig, _ as A2AMessageRecord, V as A2ACallResult } from '../ai-reasoning-types-DkMYFvyX.js';
 import { HaiResult } from '@h-ai/core';
 import '@a2a-js/sdk/server';
 import '@h-ai/datapipe';

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,5 +1,5 @@
-import { HaiAIError, aiM, AIConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, resolveModelEntry } from './chunk-B43IUMC7.js';
-export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-B43IUMC7.js';
+import { HaiAIError, aiM, AIConfigSchema, RetrievalConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, TokenConfigSchema, SummaryConfigSchema, CompressConfigSchema, resolveModelEntry } from './chunk-CB44CSOG.js';
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-CB44CSOG.js';
 import { core, err, ok } from '@h-ai/core';
 import { datapipe } from '@h-ai/datapipe';
 import { A2AClient } from '@a2a-js/sdk/client';
@@ -8,6 +8,7 @@ import OpenAI2 from 'openai';
 import { Buffer } from 'buffer';
 import { nanoid } from 'nanoid';
 import { z } from 'zod';
+import process from 'process';
 import { reldb } from '@h-ai/reldb';
 import { vecdb } from '@h-ai/vecdb';
 
@@ -169,13 +170,33 @@ function createA2AOperations(options, deps) {
         return err(HaiAIError.STORE_FAILED, aiM("ai_a2aListMessagesFailed", { params: { error: String(error) } }), error);
       }
     },
-    async callRemoteAgent(remoteUrl, message, _options) {
+    async callRemoteAgent(remoteUrl, message, options2) {
       const startTime = Date.now();
       try {
-        let client = clientCache.get(remoteUrl);
+        const customHeaders = options2?.headers;
+        const timeoutMs = options2?.timeout;
+        const hasCustomOptions = customHeaders || timeoutMs;
+        let client = hasCustomOptions ? void 0 : clientCache.get(remoteUrl);
         if (!client) {
-          client = new A2AClient(remoteUrl);
-          clientCache.set(remoteUrl, client);
+          const clientOptions = hasCustomOptions ? {
+            fetchImpl: ((input, init) => {
+              const existingHeaders = init?.headers ? Object.fromEntries(new Headers(init.headers).entries()) : {};
+              const mergedHeaders = {
+                ...existingHeaders,
+                ...customHeaders
+              };
+              const fetchInit = {
+                ...init,
+                headers: mergedHeaders,
+                ...timeoutMs ? { signal: AbortSignal.timeout(timeoutMs) } : {}
+              };
+              return globalThis.fetch(input, fetchInit);
+            })
+          } : void 0;
+          client = new A2AClient(remoteUrl, clientOptions);
+          if (!hasCustomOptions) {
+            clientCache.set(remoteUrl, client);
+          }
         }
         const params = {
           message: {
@@ -2392,6 +2413,8 @@ function toOpenAIMessage(message) {
 function createOpenAIProvider(deps) {
   const { config } = deps;
   const clientCache = /* @__PURE__ */ new Map();
+  const tempClientCache = /* @__PURE__ */ new Map();
+  const tempCacheTtl = config.llm.tempModelCacheTtl ?? 6e5;
   function getClient(apiKey, baseURL, timeout) {
     const key = `${apiKey}::${baseURL}::${timeout}`;
     let client = clientCache.get(key);
@@ -2401,7 +2424,23 @@ function createOpenAIProvider(deps) {
     }
     return client;
   }
-  function resolveClient(requestModel) {
+  function getTempClient(apiKey, baseURL, timeout) {
+    const now = Date.now();
+    for (const [k, v] of tempClientCache) {
+      if (v.expiresAt <= now)
+        tempClientCache.delete(k);
+    }
+    const key = `${apiKey}::${baseURL}::${timeout}`;
+    const cached = tempClientCache.get(key);
+    if (cached)
+      return cached.client;
+    const client = new OpenAI2({ apiKey, baseURL, timeout });
+    tempClientCache.set(key, { client, expiresAt: now + tempCacheTtl });
+    return client;
+  }
+  function resolveClient(requestModel, tempModel) {
+    if (tempModel)
+      return resolveTempClient(tempModel);
     const resolvedResult = resolveModelEntry(config.llm, "chat", requestModel, {
       missingApiKeyMessage: aiM("ai_configError", { params: { error: "API Key is required for chat" } })
     });
@@ -2410,19 +2449,34 @@ function createOpenAIProvider(deps) {
     const { apiKey, baseUrl, timeout, model } = resolvedResult.data;
     return ok({ client: getClient(apiKey ?? "", baseUrl ?? "https://api.openai.com/v1", timeout), model });
   }
+  function resolveTempClient(tempModel) {
+    const apiKey = tempModel.apiKey ?? config.llm.apiKey ?? process.env.HAI_AI_LLM_API_KEY ?? process.env.OPENAI_API_KEY;
+    if (!apiKey)
+      return err(HaiAIError.CONFIGURATION_ERROR, aiM("ai_configError", { params: { error: "API Key is required for temp model" } }));
+    const baseUrl = tempModel.baseUrl ?? config.llm.baseUrl ?? process.env.HAI_AI_LLM_BASE_URL ?? process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1";
+    const timeout = tempModel.timeout ?? config.llm.timeout ?? 6e4;
+    return ok({
+      client: getTempClient(apiKey, baseUrl, timeout),
+      model: tempModel.model,
+      maxTokens: tempModel.maxTokens ?? config.llm.maxTokens,
+      temperature: tempModel.temperature ?? config.llm.temperature
+    });
+  }
   return {
     async chat(request) {
-      const clientResult = resolveClient(request.model);
+      const clientResult = resolveClient(request.model, request.tempModel);
       if (!clientResult.success)
         return clientResult;
-      const { client, model } = clientResult.data;
-      const { objectId: _objectId, sessionId: _sessionId, ...openaiRequest } = request;
+      const { client, model, maxTokens, temperature } = clientResult.data;
+      const { objectId: _objectId, sessionId: _sessionId, tempModel: _tempModel, ...openaiRequest } = request;
       const openaiMessages = request.messages.map(toOpenAIMessage);
       try {
         const response = await client.chat.completions.create({
           ...openaiRequest,
           messages: openaiMessages,
           model,
+          ...maxTokens !== void 0 && openaiRequest.max_tokens == null ? { max_tokens: maxTokens } : {},
+          ...temperature !== void 0 && openaiRequest.temperature == null ? { temperature } : {},
           stream: false
         });
         return ok(response);
@@ -2432,16 +2486,18 @@ function createOpenAIProvider(deps) {
       }
     },
     async *chatStream(request) {
-      const clientResult = resolveClient(request.model);
+      const clientResult = resolveClient(request.model, request.tempModel);
       if (!clientResult.success)
         throw new Error(clientResult.error.message);
-      const { client, model } = clientResult.data;
-      const { objectId: _objectId, sessionId: _sessionId, ...openaiRequest } = request;
+      const { client, model, maxTokens, temperature } = clientResult.data;
+      const { objectId: _objectId, sessionId: _sessionId, tempModel: _tempModel, ...openaiRequest } = request;
       const openaiMessages = request.messages.map(toOpenAIMessage);
       const stream = await client.chat.completions.create({
         ...openaiRequest,
         messages: openaiMessages,
         model,
+        ...maxTokens !== void 0 && openaiRequest.max_tokens == null ? { max_tokens: maxTokens } : {},
+        ...temperature !== void 0 && openaiRequest.temperature == null ? { temperature } : {},
         stream: true
       });
       for await (const chunk of stream) {
@@ -2540,7 +2596,7 @@ function createAILLMFunctions(config, deps) {
     let finishReason = null;
     const toolCalls = [];
     let streamId = "";
-    let resolvedModel = request.model ?? "";
+    let resolvedModel = request.model ?? request.tempModel?.model ?? "";
     for await (const chunk of provider.chatStream(request)) {
       yield chunk;
       if (!shouldRecord)
@@ -2643,7 +2699,8 @@ function createAILLMFunctions(config, deps) {
         temperature: options?.temperature,
         objectId: options?.objectId,
         sessionId: options?.sessionId,
-        enablePersist: options?.enablePersist
+        enablePersist: options?.enablePersist,
+        tempModel: options?.tempModel
       });
       if (!result.success)
         return result;
@@ -2661,7 +2718,8 @@ function createAILLMFunctions(config, deps) {
         temperature: options?.temperature,
         objectId: options?.objectId,
         sessionId: options?.sessionId,
-        enablePersist: options?.enablePersist
+        enablePersist: options?.enablePersist,
+        tempModel: options?.tempModel
       })) {
         const delta = chunk.choices[0]?.delta?.content;
         if (delta)