@h-ai/ai 0.1.0-alpha.10

package/dist/chunk-6PPXWQ7I.js

@@ -0,0 +1,462 @@
+import { core, err, ok } from '@h-ai/core';
+import { z } from 'zod';
+import process from 'process';
+import { ChunkOptionsSchema, CleanOptionsSchema } from '@h-ai/datapipe';
+
+// src/ai-types.ts
+var AIErrorInfo = {
+  // 通用 (000-009)
+  INTERNAL_ERROR: "000:500",
+  // 初始化 (010-019)
+  NOT_INITIALIZED: "010:500",
+  CONFIGURATION_ERROR: "011:500",
+  INIT_IN_PROGRESS: "012:500",
+  RERANK_API_ERROR: "020:502",
+  RERANK_INVALID_REQUEST: "021:400",
+  // LLM (100-199)
+  API_ERROR: "100:502",
+  INVALID_REQUEST: "101:400",
+  RATE_LIMITED: "102:429",
+  TIMEOUT: "103:504",
+  MODEL_NOT_FOUND: "104:404",
+  CONTEXT_LENGTH_EXCEEDED: "105:400",
+  LLM_RECORD_FAILED: "106:500",
+  LLM_HISTORY_FAILED: "107:500",
+  // MCP (200-299)
+  MCP_CONNECTION_ERROR: "200:502",
+  MCP_PROTOCOL_ERROR: "201:502",
+  MCP_TOOL_ERROR: "202:500",
+  MCP_RESOURCE_ERROR: "203:500",
+  MCP_SERVER_ERROR: "204:502",
+  // Embedding (300-399)
+  EMBEDDING_API_ERROR: "300:502",
+  EMBEDDING_MODEL_NOT_FOUND: "301:404",
+  EMBEDDING_INPUT_TOO_LONG: "302:400",
+  // 工具 (400-499)
+  TOOL_NOT_FOUND: "400:404",
+  TOOL_VALIDATION_FAILED: "401:400",
+  TOOL_EXECUTION_FAILED: "402:500",
+  TOOL_TIMEOUT: "403:504",
+  // Reasoning (500-599)
+  REASONING_FAILED: "500:500",
+  REASONING_MAX_ROUNDS: "501:400",
+  REASONING_STRATEGY_NOT_FOUND: "502:404",
+  // Retrieval (600-699)
+  RETRIEVAL_FAILED: "600:500",
+  RETRIEVAL_SOURCE_NOT_FOUND: "601:404",
+  // RAG (700-799)
+  RAG_FAILED: "700:500",
+  RAG_CONTEXT_BUILD_FAILED: "701:500",
+  // Knowledge (800-899)
+  KNOWLEDGE_SETUP_FAILED: "800:500",
+  KNOWLEDGE_INGEST_FAILED: "801:500",
+  KNOWLEDGE_RETRIEVE_FAILED: "802:500",
+  KNOWLEDGE_ENTITY_EXTRACT_FAILED: "803:500",
+  KNOWLEDGE_NOT_SETUP: "804:500",
+  KNOWLEDGE_COLLECTION_NOT_FOUND: "805:404",
+  // Memory (900-949)
+  MEMORY_EXTRACT_FAILED: "900:500",
+  MEMORY_STORE_FAILED: "901:500",
+  MEMORY_RECALL_FAILED: "902:500",
+  MEMORY_NOT_FOUND: "903:404",
+  MEMORY_ENRICH_FAILED: "904:500",
+  // File (030-049)
+  FILE_PARSE_FAILED: "030:500",
+  FILE_UNSUPPORTED_FORMAT: "031:400",
+  FILE_OCR_FAILED: "032:500",
+  FILE_INVALID_CONTENT: "033:400",
+  // Context (950-999)
+  CONTEXT_COMPRESS_FAILED: "950:500",
+  CONTEXT_SUMMARIZE_FAILED: "951:500",
+  CONTEXT_TOKEN_ESTIMATE_FAILED: "952:500",
+  CONTEXT_BUDGET_EXCEEDED: "953:400",
+  // Store (960-969)
+  STORE_FAILED: "960:500",
+  STORE_NOT_AVAILABLE: "961:503",
+  // Session (970-979)
+  SESSION_NOT_FOUND: "970:404",
+  SESSION_FAILED: "971:500",
+  // A2A (980-999)
+  A2A_NOT_CONFIGURED: "980:500",
+  A2A_HANDLE_FAILED: "981:500",
+  A2A_REMOTE_CALL_FAILED: "982:502",
+  A2A_AUTH_FAILED: "983:401",
+  A2A_LIST_MESSAGES_FAILED: "984:500"
+};
+var HaiAIError = core.error.buildHaiErrorsDef("ai", AIErrorInfo);
+var CompressionStrategySchema = z.enum(["summary", "sliding-window", "hybrid"]);
+var EntityTypeSchema = z.enum(["person", "project", "concept", "organization", "location", "event", "other"]);
+var MemoryTypeSchema = z.enum(["fact", "preference", "event", "entity", "instruction"]);
+
+// messages/en-US.json
+var en_US_default = {
+  $schema: "https://inlang.com/schema/inlang-message-format",
+  ai_notInitialized: "AI service not initialized. Call ai.init() first.",
+  ai_initFailed: "Failed to initialize AI service: {error}",
+  ai_initInProgress: "AI service initialization is already in progress.",
+  ai_requestTimeout: "Request timeout",
+  ai_internalError: "Internal error: {error}",
+  ai_mcpToolNotFound: "MCP tool '{name}' not found",
+  ai_mcpToolFailed: "MCP tool '{name}' execution failed: {error}",
+  ai_mcpResourceNotFound: "MCP resource '{uri}' not found",
+  ai_mcpResourceFailed: "MCP resource '{uri}' read failed: {error}",
+  ai_mcpPromptNotFound: "MCP prompt '{name}' not found",
+  ai_mcpPromptMissingArg: "MCP prompt '{name}' missing required argument '{arg}'",
+  ai_mcpPromptFailed: "MCP prompt '{name}' execution failed: {error}",
+  ai_toolNotFound: "Tool '{name}' not found",
+  ai_toolInvalidJson: "Invalid JSON in tool call arguments",
+  ai_configError: "AI config validation failed: {error}",
+  ai_llmRecordFailed: "Chat record save failed: {error}",
+  ai_llmHistoryFailed: "Chat history query failed: {error}",
+  ai_embeddingApiFailed: "Embedding API call failed: {error}",
+  ai_embeddingModelNotFound: "Embedding model '{model}' not found",
+  ai_embeddingInputTooLong: "Embedding input text exceeds maximum length",
+  ai_reasoningFailed: "Reasoning execution failed: {error}",
+  ai_reasoningMaxRounds: "Reasoning rounds limit reached ({rounds} rounds)",
+  ai_reasoningStrategyNotFound: "Reasoning strategy '{strategy}' not found",
+  ai_retrievalFailed: "Retrieval execution failed: {error}",
+  ai_retrievalSourceNotFound: "Retrieval source '{source}' not configured",
+  ai_ragFailed: "RAG execution failed: {error}",
+  ai_ragContextBuildFailed: "RAG context build failed: {error}",
+  ai_knowledgeSetupFailed: "Knowledge base setup failed: {error}",
+  ai_knowledgeIngestFailed: "Knowledge ingestion failed: {error}",
+  ai_knowledgeRetrieveFailed: "Knowledge retrieval failed: {error}",
+  ai_knowledgeEntityExtractFailed: "Entity extraction failed: {error}",
+  ai_knowledgeNotSetup: "Knowledge base not initialized. Call ai.knowledge.setup() first.",
+  ai_knowledgeCollectionNotFound: "Knowledge collection '{collection}' not found",
+  ai_memoryExtractFailed: "Memory extraction failed: {error}",
+  ai_memoryStoreFailed: "Memory storage failed: {error}",
+  ai_memoryRecallFailed: "Memory recall failed: {error}",
+  ai_memoryNotFound: "Memory entry '{id}' not found",
+  ai_memoryEnrichFailed: "Memory enrichment failed: {error}",
+  ai_contextCompressFailed: "Context compression failed: {error}",
+  ai_contextSummarizeFailed: "Context summarization failed: {error}",
+  ai_contextTokenEstimateFailed: "Token estimation failed: {error}",
+  ai_storeFailed: "Store operation failed: {error}",
+  ai_storeNotAvailable: "Store backend not available, degraded to memory mode",
+  ai_sessionNotFound: "Session '{id}' not found",
+  ai_sessionFailed: "Session operation failed: {error}",
+  ai_rerankApiFailed: "Rerank API call failed: {error}",
+  ai_rerankInvalidRequest: "Invalid rerank request: {reason}",
+  ai_fileParseFailed: "File parsing failed: {error}",
+  ai_fileUnsupportedFormat: "Unsupported file format: {mimeType}",
+  ai_fileOcrFailed: "OCR recognition failed: {error}",
+  ai_fileInvalidContent: "Invalid file content: {reason}",
+  ai_configMissingApiKey: "API Key is required for scenario '{scenario}'",
+  ai_a2aNotConfigured: "A2A service not configured. Provide 'a2a' config in ai.init().",
+  ai_a2aHandleFailed: "A2A request handling failed: {error}",
+  ai_a2aRemoteCallFailed: "A2A remote call to '{url}' failed: {error}",
+  ai_a2aAuthFailed: "A2A authentication failed: {error}",
+  ai_a2aListMessagesFailed: "A2A message listing failed: {error}"
+};
+
+// messages/zh-CN.json
+var zh_CN_default = {
+  $schema: "https://inlang.com/schema/inlang-message-format",
+  ai_notInitialized: "AI \u670D\u52A1\u672A\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u8C03\u7528 ai.init()",
+  ai_initFailed: "AI \u670D\u52A1\u521D\u59CB\u5316\u5931\u8D25\uFF1A{error}",
+  ai_initInProgress: "AI \u670D\u52A1\u6B63\u5728\u521D\u59CB\u5316\u4E2D\uFF0C\u8BF7\u52FF\u91CD\u590D\u8C03\u7528\u3002",
+  ai_requestTimeout: "\u8BF7\u6C42\u8D85\u65F6",
+  ai_internalError: "\u5185\u90E8\u9519\u8BEF\uFF1A{error}",
+  ai_mcpToolNotFound: "MCP \u5DE5\u5177 '{name}' \u672A\u627E\u5230",
+  ai_mcpToolFailed: "MCP \u5DE5\u5177 '{name}' \u6267\u884C\u5931\u8D25\uFF1A{error}",
+  ai_mcpResourceNotFound: "MCP \u8D44\u6E90 '{uri}' \u672A\u627E\u5230",
+  ai_mcpResourceFailed: "MCP \u8D44\u6E90 '{uri}' \u8BFB\u53D6\u5931\u8D25\uFF1A{error}",
+  ai_mcpPromptNotFound: "MCP \u63D0\u793A\u8BCD '{name}' \u672A\u627E\u5230",
+  ai_mcpPromptMissingArg: "MCP \u63D0\u793A\u8BCD '{name}' \u7F3A\u5C11\u5FC5\u9700\u53C2\u6570 '{arg}'",
+  ai_mcpPromptFailed: "MCP \u63D0\u793A\u8BCD '{name}' \u6267\u884C\u5931\u8D25\uFF1A{error}",
+  ai_toolNotFound: "\u5DE5\u5177 '{name}' \u672A\u627E\u5230",
+  ai_toolInvalidJson: "\u5DE5\u5177\u8C03\u7528\u53C2\u6570 JSON \u683C\u5F0F\u65E0\u6548",
+  ai_configError: "AI \u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A{error}",
+  ai_llmRecordFailed: "\u5BF9\u8BDD\u8BB0\u5F55\u4FDD\u5B58\u5931\u8D25\uFF1A{error}",
+  ai_llmHistoryFailed: "\u5BF9\u8BDD\u5386\u53F2\u67E5\u8BE2\u5931\u8D25\uFF1A{error}",
+  ai_embeddingApiFailed: "Embedding API \u8C03\u7528\u5931\u8D25\uFF1A{error}",
+  ai_embeddingModelNotFound: "Embedding \u6A21\u578B '{model}' \u672A\u627E\u5230",
+  ai_embeddingInputTooLong: "Embedding \u8F93\u5165\u6587\u672C\u8D85\u8FC7\u6700\u5927\u957F\u5EA6\u9650\u5236",
+  ai_reasoningFailed: "\u63A8\u7406\u6267\u884C\u5931\u8D25\uFF1A{error}",
+  ai_reasoningMaxRounds: "\u63A8\u7406\u8F6E\u6B21\u5DF2\u8FBE\u4E0A\u9650\uFF08{rounds} \u8F6E\uFF09",
+  ai_reasoningStrategyNotFound: "\u63A8\u7406\u7B56\u7565 '{strategy}' \u4E0D\u5B58\u5728",
+  ai_retrievalFailed: "\u68C0\u7D22\u6267\u884C\u5931\u8D25\uFF1A{error}",
+  ai_retrievalSourceNotFound: "\u68C0\u7D22\u6E90 '{source}' \u672A\u914D\u7F6E",
+  ai_ragFailed: "RAG \u6267\u884C\u5931\u8D25\uFF1A{error}",
+  ai_ragContextBuildFailed: "RAG \u4E0A\u4E0B\u6587\u6784\u5EFA\u5931\u8D25\uFF1A{error}",
+  ai_knowledgeSetupFailed: "\u77E5\u8BC6\u5E93\u521D\u59CB\u5316\u5931\u8D25\uFF1A{error}",
+  ai_knowledgeIngestFailed: "\u77E5\u8BC6\u5165\u5E93\u5931\u8D25\uFF1A{error}",
+  ai_knowledgeRetrieveFailed: "\u77E5\u8BC6\u68C0\u7D22\u5931\u8D25\uFF1A{error}",
+  ai_knowledgeEntityExtractFailed: "\u5B9E\u4F53\u63D0\u53D6\u5931\u8D25\uFF1A{error}",
+  ai_knowledgeNotSetup: "\u77E5\u8BC6\u5E93\u672A\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u8C03\u7528 ai.knowledge.setup()",
+  ai_knowledgeCollectionNotFound: "\u77E5\u8BC6\u96C6\u5408 '{collection}' \u4E0D\u5B58\u5728",
+  ai_memoryExtractFailed: "\u8BB0\u5FC6\u63D0\u53D6\u5931\u8D25\uFF1A{error}",
+  ai_memoryStoreFailed: "\u8BB0\u5FC6\u5B58\u50A8\u5931\u8D25\uFF1A{error}",
+  ai_memoryRecallFailed: "\u8BB0\u5FC6\u53EC\u56DE\u5931\u8D25\uFF1A{error}",
+  ai_memoryNotFound: "\u8BB0\u5FC6\u6761\u76EE '{id}' \u4E0D\u5B58\u5728",
+  ai_memoryEnrichFailed: "\u8BB0\u5FC6\u6CE8\u5165\u5931\u8D25\uFF1A{error}",
+  ai_contextCompressFailed: "\u4E0A\u4E0B\u6587\u538B\u7F29\u5931\u8D25\uFF1A{error}",
+  ai_contextSummarizeFailed: "\u4E0A\u4E0B\u6587\u603B\u7ED3\u5931\u8D25\uFF1A{error}",
+  ai_contextTokenEstimateFailed: "Token \u4F30\u7B97\u5931\u8D25\uFF1A{error}",
+  ai_storeFailed: "\u5B58\u50A8\u64CD\u4F5C\u5931\u8D25\uFF1A{error}",
+  ai_storeNotAvailable: "\u5B58\u50A8\u540E\u7AEF\u4E0D\u53EF\u7528\uFF0C\u5DF2\u964D\u7EA7\u4E3A\u5185\u5B58\u6A21\u5F0F",
+  ai_sessionNotFound: "\u4F1A\u8BDD '{id}' \u4E0D\u5B58\u5728",
+  ai_sessionFailed: "\u4F1A\u8BDD\u64CD\u4F5C\u5931\u8D25\uFF1A{error}",
+  ai_rerankApiFailed: "Rerank API \u8C03\u7528\u5931\u8D25\uFF1A{error}",
+  ai_rerankInvalidRequest: "Rerank \u8BF7\u6C42\u53C2\u6570\u65E0\u6548\uFF1A{reason}",
+  ai_fileParseFailed: "\u6587\u4EF6\u89E3\u6790\u5931\u8D25\uFF1A{error}",
+  ai_fileUnsupportedFormat: "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u683C\u5F0F\uFF1A{mimeType}",
+  ai_fileOcrFailed: "OCR \u8BC6\u522B\u5931\u8D25\uFF1A{error}",
+  ai_fileInvalidContent: "\u6587\u4EF6\u5185\u5BB9\u65E0\u6548\uFF1A{reason}",
+  ai_configMissingApiKey: "\u573A\u666F '{scenario}' \u9700\u8981\u63D0\u4F9B API Key",
+  ai_a2aNotConfigured: "A2A \u670D\u52A1\u672A\u914D\u7F6E\uFF0C\u8BF7\u5728 ai.init() \u4E2D\u63D0\u4F9B 'a2a' \u914D\u7F6E\u3002",
+  ai_a2aHandleFailed: "A2A \u8BF7\u6C42\u5904\u7406\u5931\u8D25\uFF1A{error}",
+  ai_a2aRemoteCallFailed: "A2A \u8FDC\u7AEF\u8C03\u7528 '{url}' \u5931\u8D25\uFF1A{error}",
+  ai_a2aAuthFailed: "A2A \u8BA4\u8BC1\u5931\u8D25\uFF1A{error}",
+  ai_a2aListMessagesFailed: "A2A \u6D88\u606F\u67E5\u8BE2\u5931\u8D25\uFF1A{error}"
+};
+
+// src/ai-i18n.ts
+var aiM = core.i18n.createMessageGetter({
+  "zh-CN": zh_CN_default,
+  "en-US": en_US_default
+});
+
+// src/ai-config.ts
+var ModelScenarioSchema = z.enum(["default", "chat", "reasoning", "plan", "execute", "extraction", "summary", "embedding", "rerank", "ocr", "fast"]);
+var ModelEntrySchema = z.object({
+  /** 模型唯一标识（用于 ModelResolver 解析） */
+  id: z.string(),
+  /** 模型名称（传给 API 的实际模型名） */
+  model: z.string(),
+  /** API Key 覆盖（可选，未提供时使用全局配置） */
+  apiKey: z.string().optional(),
+  /** Base URL 覆盖（可选） */
+  baseUrl: z.url().optional(),
+  /** 最大 Token 数覆盖（可选） */
+  maxTokens: z.number().positive().optional(),
+  /** 温度覆盖（可选） */
+  temperature: z.number().min(0).max(2).optional(),
+  /** 超时覆盖（可选，毫秒） */
+  timeout: z.number().positive().optional()
+});
+var LLMConfigSchema = z.object({
+  /** 全局 API Key（各模型 fallback；未提供时回退到 `process.env.HAI_AI_LLM_API_KEY` 或 `process.env.OPENAI_API_KEY`） */
+  apiKey: z.string().optional(),
+  /** 全局 API 基础 URL（各模型 fallback；未提供时回退到 `process.env.HAI_AI_LLM_BASE_URL` 或 `process.env.OPENAI_BASE_URL`） */
+  baseUrl: z.url().optional(),
+  /** 默认模型名称（默认 `'gpt-4o-mini'`） */
+  model: z.string().optional().default("gpt-4o-mini"),
+  /** 全局最大 Token 数（各模型 fallback，默认 `4096`） */
+  maxTokens: z.number().positive().optional().default(4096),
+  /** 全局采样温度（各模型 fallback，范围 `[0, 2]`，默认 `0.7`） */
+  temperature: z.number().min(0).max(2).optional().default(0.7),
+  /** 全局请求超时时间（各模型 fallback，毫秒，默认 `60000`） */
+  timeout: z.number().positive().optional().default(6e4),
+  /** 多模型配置列表（各字段可选，未指定时回退到全局默认值） */
+  models: z.array(ModelEntrySchema).optional(),
+  /** 场景模型映射（场景名 → 模型 ID 或直接模型名称，各场景均可选） */
+  scenarios: z.object(Object.fromEntries(ModelScenarioSchema.options.map((k) => [k, z.string().optional()]))).optional()
+});
+function resolveModelEntry(llmConfig, scenario, explicit, options) {
+  let entry;
+  let modelName;
+  if (explicit) {
+    entry = llmConfig.models?.find((m) => m.id === explicit || m.model === explicit);
+    modelName = entry?.model ?? explicit;
+  } else {
+    const modelId = llmConfig.scenarios?.[scenario] ?? llmConfig.scenarios?.default;
+    if (modelId) {
+      entry = llmConfig.models?.find((m) => m.id === modelId);
+      modelName = entry?.model ?? modelId;
+    } else {
+      modelName = llmConfig.model ?? "gpt-4o-mini";
+    }
+  }
+  const resolved = {
+    model: modelName,
+    apiKey: entry?.apiKey ?? llmConfig.apiKey ?? process.env.HAI_AI_LLM_API_KEY ?? process.env.OPENAI_API_KEY,
+    baseUrl: entry?.baseUrl ?? llmConfig.baseUrl ?? process.env.HAI_AI_LLM_BASE_URL ?? process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1",
+    maxTokens: entry?.maxTokens ?? llmConfig.maxTokens ?? 4096,
+    temperature: entry?.temperature ?? llmConfig.temperature ?? 0.7,
+    timeout: entry?.timeout ?? llmConfig.timeout ?? 6e4
+  };
+  if (!resolved.apiKey) {
+    return err(HaiAIError.CONFIGURATION_ERROR, options?.missingApiKeyMessage ?? aiM("ai_configMissingApiKey", { params: { scenario } }));
+  }
+  return ok(resolved);
+}
+var MCPServerCapabilitiesSchema = z.object({
+  /** 是否支持工具调用（默认 `true`） */
+  tools: z.boolean().optional().default(true),
+  /** 是否支持资源访问（默认 `true`） */
+  resources: z.boolean().optional().default(true),
+  /** 是否支持提示词模板（默认 `true`） */
+  prompts: z.boolean().optional().default(true)
+});
+var MCPServerConfigSchema = z.object({
+  /** 服务器名称 */
+  name: z.string(),
+  /** 服务器版本（默认 `'1.0.0'`） */
+  version: z.string().optional().default("1.0.0"),
+  /** 服务器能力声明 */
+  capabilities: MCPServerCapabilitiesSchema.optional()
+});
+var MCPConfigSchema = z.object({
+  /** 服务器配置 */
+  server: MCPServerConfigSchema.optional()
+});
+var EmbeddingConfigSchema = z.object({
+  /** 向量维度（可选，部分模型支持指定维度） */
+  dimensions: z.number().int().positive().optional(),
+  /** 批量大小（单次请求最多处理的文本数，默认 100） */
+  batchSize: z.number().int().positive().default(100)
+});
+var KnowledgeConfigSchema = z.object({
+  /** 默认向量集合名（默认 'hai_ai_knowledge'） */
+  collection: z.string().default("hai_ai_knowledge"),
+  /** 向量维度（默认 1536，需与 embedding 模型匹配） */
+  dimension: z.number().int().positive().default(1536),
+  /** 是否启用实体提取（默认 true） */
+  enableEntityExtraction: z.boolean().default(true),
+  /**
+   * 默认文本清洗选项
+   *
+   * 字段含义与 @h-ai/datapipe CleanOptionsInput 完全一致，
+   * 支持 removeHtml、removeUrls、normalizeWhitespace、customReplacements 等。
+   */
+  cleanOptions: CleanOptionsSchema.default(CleanOptionsSchema.parse({})),
+  /**
+   * 默认分块选项
+   *
+   * 字段含义与 @h-ai/datapipe ChunkOptionsInput 完全一致，
+   * 支持 mode、maxSize、overlap、separator、markdownMinLevel 等完整选项。
+   */
+  chunkOptions: ChunkOptionsSchema.default(ChunkOptionsSchema.parse({
+    mode: "markdown",
+    maxSize: 1500,
+    overlap: 200
+  })),
+  /** 实体查询命中的额外加权系数（默认 0.15，叠加到向量分数上） */
+  entityBoostWeight: z.number().min(0).max(1).default(0.15),
+  /** 自定义实体类型列表（不指定时使用内置默认类型） */
+  entityTypes: z.array(z.string()).optional(),
+  /** 自定义实体提取系统提示词（不指定时使用内置默认提示词） */
+  systemPrompt: z.string().optional()
+});
+var MemoryConfigSchema = z.object({
+  /** 最大记忆条数（默认 1000） */
+  maxEntries: z.number().int().positive().default(1e3),
+  /** 自定义记忆提取 systemPrompt（可选，覆盖内置默认提示词） */
+  systemPrompt: z.string().optional(),
+  /** 时间衰减系数（默认 0.95，每次检索乘以此系数调整 recency 权重） */
+  recencyDecay: z.number().min(0).max(1).default(0.95),
+  /** 是否启用向量检索（默认 true，关闭则仅使用关键词匹配） */
+  embeddingEnabled: z.boolean().default(true),
+  /** 检索时默认返回数量（默认 10） */
+  defaultTopK: z.number().int().positive().default(10)
+});
+var TokenConfigSchema = z.object({
+  /** Token 估算每字符系数（默认 0.25，即 4 字符 ≈ 1 token） */
+  tokenRatio: z.number().positive().default(0.25)
+});
+var SummaryConfigSchema = z.object({
+  /** 自定义摘要 systemPrompt（可选，覆盖内置默认提示词） */
+  systemPrompt: z.string().optional()
+});
+var CompressConfigSchema = z.object({
+  /** 默认压缩策略（默认 'hybrid'） */
+  defaultStrategy: CompressionStrategySchema.default("hybrid"),
+  /** 默认 Token 预算（默认 0 表示取模型上限的 80%） */
+  defaultMaxTokens: z.number().int().min(0).default(0),
+  /** 默认保留最近消息数（默认 4） */
+  preserveLastN: z.number().int().min(0).default(4)
+});
+var FileConfigSchema = z.object({
+  /** OCR 系统提示词（可选，覆盖内置默认提示词） */
+  systemPrompt: z.string().optional()
+});
+var RetrievalSourceSchema = z.object({
+  /** 来源唯一标识 */
+  id: z.string(),
+  /** vecdb collection 名称 */
+  collection: z.string(),
+  /** 信源显示名 */
+  name: z.string().optional(),
+  /** 信源 URL / 路径 */
+  url: z.string().optional(),
+  /** 最大返回条数（默认 5） */
+  topK: z.number().int().positive().optional(),
+  /** 最低相似度 0~1（低于此值的结果被过滤） */
+  minScore: z.number().min(0).max(1).optional(),
+  /** 元数据过滤条件 */
+  filter: z.record(z.string(), z.unknown()).optional()
+});
+var RetrievalConfigSchema = z.object({
+  /** 预注册检索源列表 */
+  sources: z.array(RetrievalSourceSchema).optional()
+});
+var A2ASkillConfigSchema = z.object({
+  /** 技能 ID */
+  id: z.string(),
+  /** 技能名称 */
+  name: z.string(),
+  /** 技能描述 */
+  description: z.string().optional(),
+  /** 标签列表 */
+  tags: z.array(z.string()).optional()
+});
+var A2AConfigSchema = z.object({
+  /** Agent Card 配置 */
+  agentCard: z.object({
+    /** Agent 名称 */
+    name: z.string(),
+    /** Agent 描述 */
+    description: z.string().optional(),
+    /** Agent 对外 URL */
+    url: z.string(),
+    /** Agent 版本 */
+    version: z.string().optional(),
+    /** Agent 技能列表 */
+    skills: z.array(A2ASkillConfigSchema).optional()
+  }),
+  /** A2A 安全认证配置 */
+  security: z.object({
+    /** API Key 认证（通过 IAM apiKey.verifyApiKey 验证） */
+    apiKey: z.object({
+      /** API Key 的传递位置（默认 header） */
+      in: z.enum(["header", "query"]).default("header"),
+      /** 参数名（默认 x-api-key） */
+      name: z.string().default("x-api-key")
+    }).optional()
+  }).optional()
+});
+var AIConfigSchema = z.object({
+  /** LLM 配置（可选，所有字段有默认值） */
+  llm: LLMConfigSchema.default({
+    model: "gpt-4o-mini",
+    maxTokens: 4096,
+    temperature: 0.7,
+    timeout: 6e4
+  }),
+  /** MCP 配置 */
+  mcp: MCPConfigSchema.optional(),
+  /** Embedding 配置 */
+  embedding: EmbeddingConfigSchema.optional(),
+  /** Knowledge 配置 */
+  knowledge: KnowledgeConfigSchema.optional(),
+  /** Memory 配置 */
+  memory: MemoryConfigSchema.optional(),
+  /** Token 配置 */
+  token: TokenConfigSchema.optional(),
+  /** Summary 配置 */
+  summary: SummaryConfigSchema.optional(),
+  /** Compress 配置 */
+  compress: CompressConfigSchema.optional(),
+  /** Retrieval 配置（预注册检索源） */
+  retrieval: RetrievalConfigSchema.optional(),
+  /** File 解析配置 */
+  file: FileConfigSchema.optional(),
+  /** A2A 配置（Agent-to-Agent 协议） */
+  a2a: A2AConfigSchema.optional()
+});
+
+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-6PPXWQ7I.js.map
+//# sourceMappingURL=chunk-6PPXWQ7I.js.map