@longzai-intelligence-model-gateway/core 0.0.1 → 0.0.4

package/dist/index.d.ts

@@ -1,73 +1,185 @@
-import { z } from "zod";
-import { DomainError } from "@longzai-intelligence/error";
-import { ApplicationMapper, DomainEvent, Entity, OrmMapper, Result } from "@longzai-intelligence/shared-kernel";
-
+import * as z from "zod";
+import { DomainError } from "@longzai-intelligence-error/core";
+import { ApplicationMapper, DomainEvent, Entity, Result } from "@longzai-intelligence-shared-kernel/core";
 //#region src/types/error.d.ts
 /**
  * 统一错误类型定义
  * 包含错误分类、错误码、重试建议和降级建议
  */
-/** 错误分类 */
+/**
+ * 错误分类
+ */
 type ErrorCategory = 'client' | 'server' | 'provider';
-/** 错误码 */
+/**
+ * 错误码
+ */
 declare enum ErrorCode {
+  /**
+   * 无效请求
+   */
   INVALID_REQUEST = "invalid_request",
+  /**
+   * 认证失败
+   */
   AUTHENTICATION_FAILED = "authentication_failed",
+  /**
+   * 权限不足
+   */
   PERMISSION_DENIED = "permission_denied",
+  /**
+   * 模型未找到
+   */
   MODEL_NOT_FOUND = "model_not_found",
+  /**
+   * 预算超限
+   */
   BUDGET_EXCEEDED = "budget_exceeded",
+  /**
+   * 速率限制超限
+   */
   RATE_LIMIT_EXCEEDED = "rate_limit_exceeded",
+  /**
+   * 无效 API 密钥
+   */
   INVALID_API_KEY = "invalid_api_key",
+  /**
+   * 内部错误
+   */
   INTERNAL_ERROR = "internal_error",
+  /**
+   * 路由错误
+   */
   ROUTING_ERROR = "routing_error",
+  /**
+   * 数据库错误
+   */
   DATABASE_ERROR = "database_error",
+  /**
+   * 缓存错误
+   */
   CACHE_ERROR = "cache_error",
+  /**
+   * 供应商不可用
+   */
   PROVIDER_UNAVAILABLE = "provider_unavailable",
+  /**
+   * 供应商速率限制
+   */
   PROVIDER_RATE_LIMITED = "provider_rate_limited",
+  /**
+   * 供应商超时
+   */
   PROVIDER_TIMEOUT = "provider_timeout",
+  /**
+   * 供应商错误
+   */
   PROVIDER_ERROR = "provider_error",
+  /**
+   * 模型过载
+   */
   MODEL_OVERLOADED = "model_overloaded",
+  /**
+   * 上下文长度超限
+   */
   CONTEXT_LENGTH_EXCEEDED = "context_length_exceeded"
 }
-/** 重试建议 */
+/**
+ * 重试建议
+ */
 type RetrySuggestion = {
-  /** 是否可重试 */retryable: boolean; /** 建议重试次数 */
-  maxRetries: number; /** 建议重试间隔（毫秒） */
-  retryAfter: number; /** 可重试的错误码 */
+  /**
+   * 是否可重试
+   */
+  retryable: boolean;
+  /**
+   * 建议重试次数
+   */
+  maxRetries: number;
+  /**
+   * 建议重试间隔（毫秒）
+   */
+  retryAfter: number;
+  /**
+   * 可重试的错误码
+   */
   retryableCodes: ErrorCode[];
 };
-/** 降级建议 */
+/**
+ * 降级建议
+ */
 type FallbackSuggestion = {
-  /** 是否可降级 */fallbackable: boolean; /** 备用模型 */
-  fallbackModel?: string; /** 备用供应商 */
-  fallbackProvider?: string; /** 是否可返回缓存 */
+  /**
+   * 是否可降级
+   */
+  fallbackable: boolean;
+  /**
+   * 备用模型
+   */
+  fallbackModel?: string;
+  /**
+   * 备用供应商
+   */
+  fallbackProvider?: string;
+  /**
+   * 是否可返回缓存
+   */
   cacheAvailable: boolean;
 };
-/** 网关错误详情 */
+/**
+ * 网关错误详情
+ */
 type GatewayErrorDetail = {
-  /** 错误码 */code: ErrorCode; /** 错误分类 */
-  category: ErrorCategory; /** 错误消息 */
-  message: string; /** 详细错误信息 */
-  detail?: string; /** 重试建议 */
-  retry: RetrySuggestion; /** 降级建议 */
-  fallback: FallbackSuggestion; /** 供应商原始错误 */
+  /**
+   * 错误码
+   */
+  code: ErrorCode;
+  /**
+   * 错误分类
+   */
+  category: ErrorCategory;
+  /**
+   * 错误消息
+   */
+  message: string;
+  /**
+   * 详细错误信息
+   */
+  detail?: string;
+  /**
+   * 重试建议
+   */
+  retry: RetrySuggestion;
+  /**
+   * 降级建议
+   */
+  fallback: FallbackSuggestion;
+  /**
+   * 供应商原始错误
+   */
   providerError?: {
     provider: string;
     code?: string;
     message?: string;
   };
 };
-/** 网关错误（兼容 OpenAI 错误格式） */
+/**
+ * 网关错误（兼容 OpenAI 错误格式）
+ */
 type GatewayError = {
   error: {
     message: string;
     type: string;
     code: ErrorCode;
-    param?: string; /** 网关扩展字段 */
+    param?: string;
+    /**
+     * 网关扩展字段
+     */
     gateway?: GatewayErrorDetail;
   };
 };
-/** HTTP 状态码映射 */
+/**
+ * HTTP 状态码映射
+ */
 declare const ERROR_STATUS_MAP: Record<ErrorCategory, number>;
 //#endregion
 //#region src/types/request.d.ts
@@ -75,11 +187,17 @@ declare const ERROR_STATUS_MAP: Record<ErrorCategory, number>;
  * 统一请求类型定义
  * 完全兼容 OpenAI API 格式，并扩展路由策略、优先级、预算限制等参数
  */
-/** 消息角色 */
+/**
+ * 消息角色
+ */
 type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
-/** 消息内容类型 */
+/**
+ * 消息内容类型
+ */
 type MessageContentType = 'text' | 'image_url';
-/** 消息内容项 */
+/**
+ * 消息内容项
+ */
 type MessageContentPart = {
   type: MessageContentType;
   text?: string;
@@ -88,74 +206,200 @@ type MessageContentPart = {
     detail?: 'auto' | 'low' | 'high';
   };
 };
-/** 工具调用函数 */
+/**
+ * 工具调用函数
+ */
 type ToolCallFunction = {
-  /** 调用名称 */name: string; /** 调用参数（JSON字符串） */
+  /**
+   * 调用名称
+   */
+  name: string;
+  /**
+   * 调用参数（JSON字符串）
+   */
   arguments: string;
 };
-/** 工具调用 */
+/**
+ * 工具调用
+ */
 type ToolCall = {
-  /** 工具调用ID */id: string; /** 调用类型，固定为 function */
-  type: 'function'; /** 调用的函数 */
+  /**
+   * 工具调用ID
+   */
+  id: string;
+  /**
+   * 调用类型，固定为 function
+   */
+  type: 'function';
+  /**
+   * 调用的函数
+   */
   function: ToolCallFunction;
 };
-/** 聊天消息 */
+/**
+ * 聊天消息
+ */
 type ChatMessage = {
-  /** 消息角色 */role: MessageRole; /** 消息文本内容（与content二选一） */
-  content?: string | MessageContentPart[]; /** 工具调用列表（assistant角色） */
-  tool_calls?: ToolCall[]; /** 工具调用ID（tool角色） */
-  tool_call_id?: string; /** 消息名称 */
+  /**
+   * 消息角色
+   */
+  role: MessageRole;
+  /**
+   * 消息文本内容（与content二选一）
+   */
+  content?: string | MessageContentPart[];
+  /**
+   * 工具调用列表（assistant角色）
+   */
+  tool_calls?: ToolCall[];
+  /**
+   * 工具调用ID（tool角色）
+   */
+  tool_call_id?: string;
+  /**
+   * 消息名称
+   */
   name?: string;
 };
-/** 函数定义 */
+/**
+ * 函数定义
+ */
 type FunctionDefinition = {
-  /** 函数名称 */name: string; /** 函数描述 */
-  description?: string; /** 函数参数 JSON Schema */
+  /**
+   * 函数名称
+   */
+  name: string;
+  /**
+   * 函数功能描述（供模型理解该函数的用途及调用时机）
+   */
+  description?: string;
+  /**
+   * 函数参数 JSON Schema
+   */
   parameters?: Record<string, unknown>;
 };
-/** 工具定义 */
+/**
+ * 工具定义
+ */
 type ToolDefinition = {
-  /** 工具类型 */type: 'function'; /** 函数定义 */
+  /**
+   * 工具类型
+   */
+  type: 'function';
+  /**
+   * 函数定义
+   */
   function: FunctionDefinition;
 };
-/** 响应格式 */
+/**
+ * 响应格式
+ */
 type ResponseFormat = {
   type: 'text' | 'json_object' | 'json_schema';
   json_schema?: Record<string, unknown>;
 };
-/** 路由策略扩展参数 */
+/**
+ * 路由策略扩展参数
+ */
 type RoutingExtension = {
-  /** 路由策略 */routingStrategy?: 'model-name' | 'cost-first' | 'performance-first' | 'quality-first'; /** 请求优先级 */
-  priority?: 'low' | 'normal' | 'high'; /** 预算限制（美元） */
-  budgetLimit?: number; /** 请求超时时间（毫秒） */
-  timeout?: number; /** 是否禁用缓存 */
-  noCache?: boolean; /** 调用者标签（用于成本归因） */
+  /**
+   * 路由策略
+   */
+  routingStrategy?: 'model-name' | 'cost-first' | 'performance-first' | 'quality-first';
+  /**
+   * 请求优先级
+   */
+  priority?: 'low' | 'normal' | 'high';
+  /**
+   * 预算限制（美元）
+   */
+  budgetLimit?: number;
+  /**
+   * 请求超时时间（毫秒）
+   */
+  timeout?: number;
+  /**
+   * 是否禁用缓存
+   */
+  noCache?: boolean;
+  /**
+   * 调用者标签（用于成本归因）
+   */
   tags?: Record<string, string>;
 };
-/** 聊天补全请求（兼容 OpenAI ChatCompletion） */
+/**
+ * 聊天补全请求（兼容 OpenAI ChatCompletion）
+ */
 type ChatCompletionRequest = RoutingExtension & {
-  /** 模型名称或别名 */model: string; /** 消息列表 */
-  messages: ChatMessage[]; /** 生成温度 (0-2) */
-  temperature?: number; /** 核采样概率 */
-  top_p?: number; /** 生成数量 */
-  n?: number; /** 是否流式输出 */
-  stream?: boolean; /** 停止词 */
-  stop?: string | string[]; /** 最大输出 Token 数 */
-  max_tokens?: number; /** 存在惩罚 (-2 到 2) */
-  presence_penalty?: number; /** 频率惩罚 (-2 到 2) */
-  frequency_penalty?: number; /** 随机种子 */
-  seed?: number; /** 工具定义列表 */
-  tools?: ToolDefinition[]; /** 工具选择策略 */
+  /**
+   * 模型名称或别名
+   */
+  model: string;
+  /**
+   * 消息列表
+   */
+  messages: ChatMessage[];
+  /**
+   * 生成温度 (0-2)
+   */
+  temperature?: number;
+  /**
+   * 核采样概率
+   */
+  top_p?: number;
+  /**
+   * 生成数量
+   */
+  n?: number;
+  /**
+   * 是否流式输出
+   */
+  stream?: boolean;
+  /**
+   * 停止词
+   */
+  stop?: string | string[];
+  /**
+   * 最大输出 Token 数
+   */
+  max_tokens?: number;
+  /**
+   * 存在惩罚 (-2 到 2)
+   */
+  presence_penalty?: number;
+  /**
+   * 频率惩罚 (-2 到 2)
+   */
+  frequency_penalty?: number;
+  /**
+   * 随机种子
+   */
+  seed?: number;
+  /**
+   * 工具定义列表
+   */
+  tools?: ToolDefinition[];
+  /**
+   * 工具选择策略
+   */
   tool_choice?: 'none' | 'auto' | 'required' | {
     type: 'function';
     function: {
       name: string;
     };
-  }; /** 响应格式 */
-  response_format?: ResponseFormat; /** 用户标识 */
+  };
+  /**
+   * 响应格式
+   */
+  response_format?: ResponseFormat;
+  /**
+   * 用户标识
+   */
   user?: string;
 };
-/** 文本补全请求（兼容 OpenAI Completion） */
+/**
+ * 文本补全请求（兼容 OpenAI Completion）
+ */
 type CompletionRequest = RoutingExtension & {
   model: string;
   prompt: string | string[];
@@ -170,7 +414,9 @@ type CompletionRequest = RoutingExtension & {
   seed?: number;
   user?: string;
 };
-/** 嵌入请求（兼容 OpenAI Embedding） */
+/**
+ * 嵌入请求（兼容 OpenAI Embedding）
+ */
 type EmbeddingRequest = RoutingExtension & {
   model: string;
   input: string | string[];
@@ -180,19 +426,34 @@ type EmbeddingRequest = RoutingExtension & {
 };
 //#endregion
 //#region src/types/response.d.ts
-/** 响应消息 */
+/**
+ * 响应消息
+ */
 type ResponseMessage = {
   role: 'assistant';
   content: string | null;
   tool_calls?: ToolCall[];
 };
-/** 补全选择项 */
+/**
+ * 补全选择项
+ */
 type ChatChoice = {
-  /** 选择项索引 */index: number; /** 消息内容 */
-  message: ResponseMessage; /** 结束原因 */
+  /**
+   * 选择项索引
+   */
+  index: number;
+  /**
+   * 消息内容
+   */
+  message: ResponseMessage;
+  /**
+   * 结束原因
+   */
   finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
 };
-/** 流式补全增量 */
+/**
+ * 流式补全增量
+ */
 type ChatChunkDelta = {
   role?: 'assistant';
   content?: string | null;
@@ -206,25 +467,49 @@ type ChatChunkDelta = {
     };
   }>;
 };
-/** 流式选择项 */
+/**
+ * 流式选择项
+ */
 type ChatStreamChoice = {
   index: number;
   delta: ChatChunkDelta;
   finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
 };
-/** Token 使用量 */
+/**
+ * Token 使用量
+ */
 type TokenUsage = {
   prompt_tokens: number;
   completion_tokens: number;
   total_tokens: number;
 };
-/** 网关扩展响应字段 */
+/**
+ * 网关扩展响应字段
+ */
 type GatewayExtension = {
-  /** 实际使用的模型ID */gateway_model?: string; /** 实际使用的供应商 */
-  gateway_provider?: string; /** 请求延迟（毫秒） */
-  gateway_latency_ms?: number; /** 请求成本（美元） */
-  gateway_cost?: number; /** 是否命中缓存 */
-  gateway_cache_hit?: boolean; /** 路由决策信息 */
+  /**
+   * 实际使用的模型ID
+   */
+  gateway_model?: string;
+  /**
+   * 实际使用的供应商
+   */
+  gateway_provider?: string;
+  /**
+   * 请求延迟（毫秒）
+   */
+  gateway_latency_ms?: number;
+  /**
+   * 请求成本（美元）
+   */
+  gateway_cost?: number;
+  /**
+   * 是否命中缓存
+   */
+  gateway_cache_hit?: boolean;
+  /**
+   * 路由决策信息
+   */
   gateway_routing?: {
     strategy: string;
     original_model?: string;
@@ -232,7 +517,9 @@ type GatewayExtension = {
     routed_provider: string;
   };
 };
-/** 聊天补全响应（兼容 OpenAI ChatCompletion） */
+/**
+ * 聊天补全响应（兼容 OpenAI ChatCompletion）
+ */
 type ChatCompletionResponse = GatewayExtension & {
   id: string;
   object: 'chat.completion';
@@ -242,7 +529,9 @@ type ChatCompletionResponse = GatewayExtension & {
   usage: TokenUsage;
   system_fingerprint?: string;
 };
-/** 流式聊天补全块 */
+/**
+ * 流式聊天补全块
+ */
 type ChatCompletionChunk = GatewayExtension & {
   id: string;
   object: 'chat.completion.chunk';
@@ -250,13 +539,17 @@ type ChatCompletionChunk = GatewayExtension & {
   model: string;
   choices: ChatStreamChoice[];
 };
-/** 文本补全选择项 */
+/**
+ * 文本补全选择项
+ */
 type CompletionChoice = {
   index: number;
   text: string;
   finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
 };
-/** 文本补全响应（兼容 OpenAI Completion） */
+/**
+ * 文本补全响应（兼容 OpenAI Completion）
+ */
 type CompletionResponse = GatewayExtension & {
   id: string;
   object: 'text_completion';
@@ -265,13 +558,17 @@ type CompletionResponse = GatewayExtension & {
   choices: CompletionChoice[];
   usage: TokenUsage;
 };
-/** 嵌入数据项 */
+/**
+ * 嵌入数据项
+ */
 type EmbeddingData = {
   object: 'embedding';
   index: number;
   embedding: number[] | string;
 };
-/** 嵌入响应（兼容 OpenAI Embedding） */
+/**
+ * 嵌入响应（兼容 OpenAI Embedding）
+ */
 type EmbeddingResponse = GatewayExtension & {
   id: string;
   object: 'list';
@@ -280,14 +577,18 @@ type EmbeddingResponse = GatewayExtension & {
   data: EmbeddingData[];
   usage: TokenUsage;
 };
-/** 模型信息（兼容 OpenAI Model） */
+/**
+ * 模型信息（兼容 OpenAI Model）
+ */
 type ModelInfo = {
   id: string;
   object: 'model';
   created: number;
   owned_by: string;
 };
-/** 模型列表响应 */
+/**
+ * 模型列表响应
+ */
 type ModelListResponse = {
   object: 'list';
   data: ModelInfo[];
@@ -298,61 +599,159 @@ type ModelListResponse = {
  * 执行策略类型定义
  * 包含重试策略、超时策略、降级策略
  */
-/** 重试策略 */
+/**
+ * 重试策略
+ */
 type RetryStrategy = {
-  /** 最大重试次数（默认3次） */maxRetries: number; /** 初始重试间隔（毫秒，默认1000） */
-  initialInterval: number; /** 最大重试间隔（毫秒，默认30000） */
-  maxInterval: number; /** 退避乘数（默认2） */
-  multiplier: number; /** 可重试的HTTP状态码 */
-  retryableStatusCodes: number[]; /** 可重试的错误码 */
+  /**
+   * 最大重试次数（默认3次）
+   */
+  maxRetries: number;
+  /**
+   * 初始重试间隔（毫秒，默认1000）
+   */
+  initialInterval: number;
+  /**
+   * 最大重试间隔（毫秒，默认30000）
+   */
+  maxInterval: number;
+  /**
+   * 退避乘数（默认2）
+   */
+  multiplier: number;
+  /**
+   * 可重试的HTTP状态码
+   */
+  retryableStatusCodes: number[];
+  /**
+   * 可重试的错误码
+   */
   retryableErrorCodes: string[];
 };
-/** 超时策略 */
+/**
+ * 超时策略
+ */
 type TimeoutStrategy = {
-  /** 连接超时（毫秒，默认10000） */connectTimeout: number; /** 读取超时（毫秒，默认60000） */
-  readTimeout: number; /** 写入超时（毫秒，默认10000） */
-  writeTimeout: number; /** 总请求超时（毫秒，默认120000） */
-  requestTimeout: number;
-};
-/** 降级动作类型 */
-type FallbackAction = 'fallback_model' | 'cache_result' | 'default_response' | 'reject';
-/** 降级策略 */
-type FallbackStrategy = {
-  /** 降级动作列表（按优先级排序） */actions: FallbackAction[]; /** 备用模型列表 */
-  fallbackModels: string[]; /** 是否允许返回缓存 */
-  allowCache: boolean; /** 默认响应内容 */
-  defaultResponse?: string; /** 最大降级次数 */
+  /**
+   * 连接超时（毫秒，默认10000）
+   */
+  connectTimeout: number;
+  /**
+   * 读取超时（毫秒，默认60000）
+   */
+  readTimeout: number;
+  /**
+   * 写入超时（毫秒，默认10000）
+   */
+  writeTimeout: number;
+  /**
+   * 总请求超时（毫秒，默认120000）
+   */
+  requestTimeout: number;
+};
+/**
+ * 降级动作类型
+ */
+type FallbackAction = 'fallback_model' | 'cache_result' | 'default_response' | 'reject';
+/**
+ * 降级策略
+ */
+type FallbackStrategy = {
+  /**
+   * 降级动作列表（按优先级排序）
+   */
+  actions: FallbackAction[];
+  /**
+   * 备用模型列表
+   */
+  fallbackModels: string[];
+  /**
+   * 是否允许返回缓存
+   */
+  allowCache: boolean;
+  /**
+   * 默认响应内容
+   */
+  defaultResponse?: string;
+  /**
+   * 最大降级次数
+   */
   maxFallbacks: number;
 };
-/** 执行策略（组合重试、超时、降级） */
+/**
+ * 执行策略（组合重试、超时、降级）
+ */
 type ExecutionStrategy = {
-  /** 重试策略 */retry: RetryStrategy; /** 超时策略 */
-  timeout: TimeoutStrategy; /** 降级策略 */
+  /**
+   * 重试策略
+   */
+  retry: RetryStrategy;
+  /**
+   * 超时策略
+   */
+  timeout: TimeoutStrategy;
+  /**
+   * 降级策略
+   */
   fallback: FallbackStrategy;
 };
-/** 默认重试策略 */
+/**
+ * 默认重试策略
+ */
 declare const DEFAULT_RETRY_STRATEGY: RetryStrategy;
-/** 默认超时策略 */
+/**
+ * 默认超时策略
+ */
 declare const DEFAULT_TIMEOUT_STRATEGY: TimeoutStrategy;
-/** 默认降级策略 */
+/**
+ * 默认降级策略
+ */
 declare const DEFAULT_FALLBACK_STRATEGY: FallbackStrategy;
-/** 默认执行策略 */
+/**
+ * 默认执行策略
+ */
 declare const DEFAULT_EXECUTION_STRATEGY: ExecutionStrategy;
 //#endregion
 //#region src/utils/cost.d.ts
 /**
  * 成本计算工具函数
  */
-/** 模型定价信息 */
+/**
+ * 模型定价信息
+ */
 type ModelPricing = {
-  /** 输入 Token 价格（美元/千Token） */inputPrice: number; /** 输出 Token 价格（美元/千Token） */
+  /**
+   * 输入 Token 价格（美元/千Token）
+   */
+  inputPrice: number;
+  /**
+   * 输出 Token 价格（美元/千Token）
+   */
   outputPrice: number;
 };
-/** 计算单次请求成本 */
+/**
+ * 计算单次请求成本
+ *
+ * @param pricing - 模型定价信息（输入/输出单价，美元/千Token）
+ * @param inputTokens - 输入 Token 数量
+ * @param outputTokens - 输出 Token 数量
+ * @returns 请求总成本（美元），精确到小数点后8位
+ */
 declare function calculateCost(pricing: ModelPricing, inputTokens: number, outputTokens: number): number;
-/** 格式化成本显示 */
+/**
+ * 格式化成本显示
+ *
+ * @param cost - 成本金额（美元）
+ * @returns 格式化后的成本字符串，根据金额大小选择不同精度
+ */
 declare function formatCost(cost: number): string;
-/** 计算预算使用百分比 */
+/**
+ * 计算预算使用百分比
+ *
+ * @param used - 已使用金额（美元）
+ * @param limit - 预算上限（美元）
+ * @returns 预算使用百分比（0-100），精确到小数点后2位；上限非正数时返回 0
+ */
 declare function budgetUsagePercent(used: number, limit: number): number;
 //#endregion
 //#region src/utils/crypto.d.ts
@@ -360,26 +759,47 @@ declare function budgetUsagePercent(used: number, limit: number): number;
  * 加密解密工具函数
  * 使用 AES-256-GCM 算法加密 API 密钥等敏感数据
  */
-/** 加密文本 */
+/**
+ * 加密文本
+ *
+ * @param plaintext - 待加密的明文字符串
+ * @param secret - 用于派生加密密钥的原始密钥
+ * @returns Base64 编码的密文（包含 IV 和认证标签）
+ */
 declare function encrypt(plaintext: string, secret: string): Promise<string>;
-/** 解密文本 */
+/**
+ * 解密文本
+ *
+ * @param ciphertext - encrypt 生成的 Base64 密文（含 IV 和认证标签）
+ * @param secret - 用于派生解密密钥的原始密钥（须与加密时一致）
+ * @returns 解密后的明文字符串
+ */
 declare function decrypt(ciphertext: string, secret: string): Promise<string>;
 //#endregion
 //#region src/utils/token.d.ts
 /**
  * Token 计数工具函数
  * 提供基于字符数的粗略 Token 估算
+ *
+ * @param text - 待估算的文本内容
+ * @returns 估算的 Token 数量
  */
-/** 粗略估算文本的 Token 数（中文约1.5字/Token，英文约4字符/Token） */
 declare function estimateTokens(text: string): number;
-/** 估算消息列表的 Token 数 */
+/**
+ * 估算消息列表的 Token 数
+ *
+ * @param messages - 聊天消息列表（content 可为字符串或多模态内容数组）
+ * @returns 消息列表的估算 Token 总数（每条消息额外计入约 4 个 Token 的角色标记开销）
+ */
 declare function estimateMessagesTokens(messages: Array<{
   role: string;
   content?: string | unknown[];
 }>): number;
 //#endregion
 //#region src/cache/cache.dto.d.ts
-/** 缓存条目响应 DTO */
+/**
+ * 缓存条目响应 DTO
+ */
 type CacheEntryResponseDTO = {
   id: string;
   requestHash: string;
@@ -391,7 +811,9 @@ type CacheEntryResponseDTO = {
   expiresAt: string;
   createdAt: string;
 };
-/** 创建缓存条目请求 DTO */
+/**
+ * 创建缓存条目请求 DTO
+ */
 type CreateCacheEntryRequestDTO = {
   requestHash: string;
   requestVector?: string | null;
@@ -402,19 +824,40 @@ type CreateCacheEntryRequestDTO = {
 };
 //#endregion
 //#region src/cache/cache.port.d.ts
-/** 缓存端口接口 */
+/**
+ * 缓存端口接口
+ */
 type CachePort = {
-  /** 根据请求哈希获取缓存条目 */getByHash(requestHash: string): Promise<Result<CacheEntryResponseDTO | null, DomainError>>; /** 创建缓存条目 */
-  create(input: CreateCacheEntryRequestDTO): Promise<Result<CacheEntryResponseDTO, DomainError>>; /** 记录缓存命中 */
-  recordHit(id: string): Promise<Result<CacheEntryResponseDTO, DomainError>>; /** 删除缓存条目 */
-  delete(id: string): Promise<Result<boolean, DomainError>>; /** 清理过期缓存 */
+  /**
+   * 根据请求哈希获取缓存条目
+   */
+  getByHash(requestHash: string): Promise<Result<CacheEntryResponseDTO | null, DomainError>>;
+  /**
+   * 创建缓存条目
+   */
+  create(input: CreateCacheEntryRequestDTO): Promise<Result<CacheEntryResponseDTO, DomainError>>;
+  /**
+   * 记录缓存命中
+   */
+  recordHit(id: string): Promise<Result<CacheEntryResponseDTO, DomainError>>;
+  /**
+   * 删除缓存条目
+   */
+  delete(id: string): Promise<Result<boolean, DomainError>>;
+  /**
+   * 清理过期缓存
+   */
   deleteExpired(): Promise<Result<number, DomainError>>;
 };
-/** 缓存端口令牌 */
+/**
+ * 缓存端口令牌
+ */
 declare const CACHE_PORT_TOKEN: unique symbol;
 //#endregion
 //#region src/cache/cache.schema.d.ts
-/** 创建缓存条目的校验 Schema */
+/**
+ * 创建缓存条目的校验 Schema
+ */
 declare const createCacheEntrySchema: z.ZodObject<{
   requestHash: z.ZodString;
   requestVector: z.ZodOptional<z.ZodString>;
@@ -423,11 +866,15 @@ declare const createCacheEntrySchema: z.ZodObject<{
   similarityThreshold: z.ZodOptional<z.ZodNumber>;
   ttlSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-/** 创建缓存条目的输入类型 */
+/**
+ * 创建缓存条目的输入类型
+ */
 type CreateCacheEntryInput = z.infer<typeof createCacheEntrySchema>;
 //#endregion
 //#region src/cache/cache.types.d.ts
-/** 缓存策略配置 */
+/**
+ * 缓存策略配置
+ */
 type CachePolicy = {
   enabled: boolean;
   ttlSeconds: number;
@@ -435,22 +882,47 @@ type CachePolicy = {
 };
 //#endregion
 //#region src/cache/cache.error.d.ts
-/** 缓存领域错误 */
+/**
+ * 缓存领域错误
+ */
 declare class CacheError extends DomainError {
+  /**
+   * 构造缓存错误
+   *
+   * @param message - 错误消息
+   */
   constructor(message: string);
 }
 //#endregion
 //#region src/cache/cache.event.d.ts
-/** 缓存命中事件 */
+/**
+ * 缓存命中事件
+ */
 declare class CacheHitEvent extends DomainEvent {
   readonly cacheEntryId: string;
   readonly modelId: string;
+  /**
+   * 事件类型标识
+   */
   static readonly TYPE = "cache:hit";
+  /**
+   * 实例事件类型
+   */
   readonly type = "cache:hit";
+  /**
+   * 构造缓存命中事件
+   *
+   * @param eventId - 事件唯一标识
+   * @param cacheEntryId - 缓存条目唯一标识
+   * @param modelId - 关联的模型标识
+   */
   constructor(eventId: string, cacheEntryId: string, modelId: string);
 }
 //#endregion
 //#region src/cache/cache-entry.entity.d.ts
+/**
+ * 缓存条目属性
+ */
 type CacheEntryProps = {
   requestHash: string;
   requestVector: string | null;
@@ -465,22 +937,88 @@ type CacheEntryProps = {
  * 缓存条目实体
  */
 declare class CacheEntryEntity extends Entity<CacheEntryProps> {
+  /**
+   * 获取请求哈希值
+   *
+   * @returns 请求内容的哈希值
+   */
   get requestHash(): string;
+  /**
+   * 获取请求向量
+   *
+   * @returns 请求的语义向量，无向量时为 null
+   */
   get requestVector(): string | null;
+  /**
+   * 获取响应数据
+   *
+   * @returns 缓存的响应数据
+   */
   get responseData(): string;
+  /**
+   * 获取模型标识
+   *
+   * @returns 关联的模型 ID
+   */
   get modelId(): string;
+  /**
+   * 获取相似度阈值
+   *
+   * @returns 语义匹配的相似度阈值
+   */
   get similarityThreshold(): number;
+  /**
+   * 获取命中次数
+   *
+   * @returns 缓存被命中的次数
+   */
   get hitCount(): number;
+  /**
+   * 获取过期时间
+   *
+   * @returns 缓存条目的过期时间（ISO 格式）
+   */
   get expiresAt(): string;
+  /**
+   * 获取创建时间
+   *
+   * @returns 缓存条目的创建时间（ISO 格式）
+   */
   get createdAt(): string;
+  /**
+   * 私有构造函数
+   *
+   * @param id - 缓存条目唯一标识
+   * @param props - 缓存条目属性
+   */
   private constructor();
+  /**
+   * 创建新的缓存条目实体
+   *
+   * @param id - 缓存条目唯一标识
+   * @param props - 缓存条目创建属性（不含自动生成的 hitCount 和 createdAt）
+   * @returns 新创建的缓存条目实体
+   */
   static create(id: string, props: Omit<CacheEntryProps, 'hitCount' | 'createdAt'> & {
     ttlSeconds?: number;
   }): CacheEntryEntity;
+  /**
+   * 从持久化数据重建缓存条目实体
+   *
+   * @param id - 缓存条目唯一标识
+   * @param props - 缓存条目完整属性
+   * @returns 重建的缓存条目实体
+   */
   static reconstitute(id: string, props: CacheEntryProps): CacheEntryEntity;
-  /** 记录缓存命中 */
+  /**
+   * 记录缓存命中
+   */
   recordHit(): void;
-  /** 检查是否过期 */
+  /**
+   * 检查是否过期
+   *
+   * @returns 是否已过期
+   */
   isExpired(): boolean;
 }
 //#endregion
@@ -495,150 +1033,310 @@ declare const CacheEntryMapper: ApplicationMapper<CacheEntryEntity, CacheEntryRe
  * 缓存条目仓储接口
  */
 type CacheRepository = {
-  /** 根据请求哈希获取缓存条目 */getByHash(requestHash: string): Promise<Result<CacheEntryEntity | null, DomainError>>; /** 创建缓存条目 */
-  create(entity: CacheEntryEntity): Promise<Result<CacheEntryEntity, DomainError>>; /** 记录缓存命中 */
-  recordHit(id: string): Promise<Result<CacheEntryEntity, DomainError>>; /** 删除缓存条目 */
-  delete(id: string): Promise<Result<boolean, DomainError>>; /** 清理过期缓存 */
+  /**
+   * 根据请求哈希获取缓存条目
+   */
+  getByHash(requestHash: string): Promise<Result<CacheEntryEntity | null, DomainError>>;
+  /**
+   * 创建缓存条目
+   */
+  create(entity: CacheEntryEntity): Promise<Result<CacheEntryEntity, DomainError>>;
+  /**
+   * 记录缓存命中
+   */
+  recordHit(id: string): Promise<Result<CacheEntryEntity, DomainError>>;
+  /**
+   * 删除缓存条目
+   */
+  delete(id: string): Promise<Result<boolean, DomainError>>;
+  /**
+   * 清理过期缓存
+   */
   deleteExpired(): Promise<Result<number, DomainError>>;
 };
 //#endregion
-//#region src/cache/cache.orm-entity.d.ts
+//#region src/ports/model-repository.port.d.ts
 /**
- * 缓存条目数据库行类型
+ * 模型仓储端口
+ *
+ * @typeParam TModel - 模型实体类型，由实现方绑定
  */
-type CacheEntryRow = {
-  id: string;
-  requestHash: string;
-  requestVector: string | null;
-  responseData: string;
-  modelId: string;
-  similarityThreshold: number;
-  hitCount: number;
-  expiresAt: string;
-  createdAt: string;
+type ModelRepositoryPort<TModel = unknown> = {
+  getById(id: string): Promise<Result<TModel | null, DomainError>>;
+  getByModelId(modelId: string): Promise<Result<TModel | null, DomainError>>;
+  query(params: ModelQueryParams): Promise<Result<ModelQueryResult<TModel>, DomainError>>;
+  save(entity: TModel): Promise<Result<TModel, DomainError>>;
+  delete(id: string): Promise<Result<boolean, DomainError>>;
+};
+/**
+ * 模型查询参数
+ */
+type ModelQueryParams = {
+  /**
+   * 模型状态过滤
+   */
+  status?: string;
+  /**
+   * 供应商 ID 过滤
+   */
+  providerId?: string;
+  /**
+   * 当前页码
+   */
+  page?: number;
+  /**
+   * 每页条数
+   */
+  pageSize?: number;
+  /**
+   * 排序字段
+   */
+  sortBy?: string;
+  /**
+   * 排序方向
+   */
+  sortOrder?: 'asc' | 'desc';
 };
-//#endregion
-//#region src/cache/cache.orm-mapper.d.ts
 /**
- * 缓存条目 ORM 映射器
+ * 模型查询结果
+ *
+ * @typeParam TModel - 模型实体类型
  */
-declare const CacheEntryOrmMapper: OrmMapper<CacheEntryEntity, CacheEntryRow>;
+type ModelQueryResult<TModel> = {
+  /**
+   * 当前页模型列表
+   */
+  items: TModel[];
+  /**
+   * 总记录数
+   */
+  total: number;
+  /**
+   * 当前页码
+   */
+  page: number;
+  /**
+   * 每页条数
+   */
+  pageSize: number;
+  /**
+   * 总页数
+   */
+  totalPages: number;
+};
+/**
+ * 模型仓储端口 DI 令牌
+ */
+declare const MODEL_REPOSITORY_PORT_TOKEN: unique symbol;
 //#endregion
-//#region src/cache/cache.orm-repository.d.ts
+//#region src/ports/routing-rule-repository.port.d.ts
 /**
- * 基于 Drizzle 的缓存条目仓储实现
+ * 路由规则仓储端口
+ *
+ * @typeParam TRoutingRule - 路由规则实体类型，由实现方绑定
  */
-declare class DrizzleCacheRepository implements CacheRepository {
-  private readonly db;
-  private readonly schema;
-  constructor(db: any, schema: any);
-  /** 根据请求哈希获取缓存条目 */
-  getByHash(requestHash: string): Promise<Result<CacheEntryEntity | null, DomainError>>;
-  /** 创建缓存条目 */
-  create(entity: CacheEntryEntity): Promise<Result<CacheEntryEntity, DomainError>>;
-  /** 记录缓存命中 */
-  recordHit(id: string): Promise<Result<CacheEntryEntity, DomainError>>;
-  /** 删除缓存条目 */
+type RoutingRuleRepositoryPort<TRoutingRule = unknown> = {
+  getById(id: string): Promise<Result<TRoutingRule | null, DomainError>>;
+  getActiveRules(): Promise<Result<TRoutingRule[], DomainError>>;
+  create(entity: TRoutingRule): Promise<Result<TRoutingRule, DomainError>>;
+  update(entity: TRoutingRule): Promise<Result<TRoutingRule, DomainError>>;
   delete(id: string): Promise<Result<boolean, DomainError>>;
-  /** 清理过期缓存 */
-  deleteExpired(): Promise<Result<number, DomainError>>;
-}
+};
+/**
+ * 路由规则仓储端口 DI 令牌
+ */
+declare const ROUTING_RULE_REPOSITORY_PORT_TOKEN: unique symbol;
 //#endregion
-//#region src/cache/usecases/get-cache-entry.usecase.d.ts
+//#region src/ports/llm-complete.port.d.ts
 /**
- * 获取缓存条目用例
+ * LLM 调用消息
  *
- * 根据请求哈希查询缓存条目，若条目已过期则自动删除并返回 null，
- * 若条目有效则记录命中并返回实体
+ * 兼容 OpenAI Chat Completion 消息格式。
  */
-declare class GetCacheEntryUseCase {
-  private readonly repository;
-  constructor(repository: CacheRepository);
-  execute(requestHash: string): Promise<Result<CacheEntryEntity | null, DomainError>>;
-}
-//#endregion
-//#region src/cache/usecases/create-cache-entry.usecase.d.ts
+type CompleteMessage = {
+  /**
+   * 消息角色
+   */
+  role: 'system' | 'user' | 'assistant' | 'tool';
+  /**
+   * 消息内容
+   */
+  content: string;
+  /**
+   * 工具调用 ID（role 为 tool 时使用）
+   */
+  toolCallId?: string;
+};
 /**
- * 创建缓存条目用例
+ * 结构化输出 Schema 描述
  *
- * 接收创建请求 DTO，构造实体并持久化到仓储
+ * 调用方提供 JSON Schema 描述期望的输出结构，
+ * model-gateway 透传至底层 provider 约束输出。
  */
-declare class CreateCacheEntryUseCase {
-  private readonly repository;
-  constructor(repository: CacheRepository);
-  execute(input: CreateCacheEntryRequestDTO): Promise<Result<CacheEntryEntity, DomainError>>;
-}
-//#endregion
-//#region src/cache/usecases/record-cache-hit.usecase.d.ts
+type CompleteSchema = {
+  /**
+   * JSON Schema 名称
+   */
+  name: string;
+  /**
+   * JSON Schema 描述
+   */
+  description?: string;
+  /**
+   * JSON Schema 定义
+   */
+  schema: Record<string, unknown>;
+  /**
+   * 是否严格模式
+   */
+  strict?: boolean;
+};
 /**
- * 记录缓存命中用例
+ * Complete 调用选项
  *
- * 对指定缓存条目增加命中计数
+ * 路由、采样、约束相关可选参数。
  */
-declare class RecordCacheHitUseCase {
-  private readonly repository;
-  constructor(repository: CacheRepository);
-  execute(id: string): Promise<Result<CacheEntryEntity, DomainError>>;
-}
-//#endregion
-//#region src/cache/usecases/delete-cache-entry.usecase.d.ts
+type CompleteOptions = {
+  /**
+   * 指定供应商，未提供时由 routing rules 决策
+   */
+  provider?: string;
+  /**
+   * 采样温度
+   */
+  temperature?: number;
+  /**
+   * 最大生成 token 数
+   */
+  maxTokens?: number;
+  /**
+   * 结构化输出 Schema
+   */
+  schema?: CompleteSchema;
+  /**
+   * 调用方用户标识，用于成本归集与可观测性
+   */
+  userId?: string;
+  /**
+   * 调用方元数据，透传至可观测性层
+   */
+  metadata?: Record<string, unknown>;
+};
 /**
- * 删除缓存条目用例
+ * Complete 调用请求
  *
- * 根据条目 ID 从仓储中删除指定缓存条目
+ * 与 spec 契约 complete(req: { provider?, model, messages, schema?, temperature?, maxTokens?, userId?,
+ * metadata? }) 一致。
  */
-declare class DeleteCacheEntryUseCase {
-  private readonly repository;
-  constructor(repository: CacheRepository);
-  execute(id: string): Promise<Result<boolean, DomainError>>;
-}
-//#endregion
-//#region src/cache/usecases/cleanup-cache-entries.usecase.d.ts
+type CompleteRequest = {
+  /**
+   * 指定供应商，未提供时由 routing rules 决策
+   */
+  provider?: string;
+  /**
+   * 模型标识
+   */
+  model: string;
+  /**
+   * 消息列表
+   */
+  messages: CompleteMessage[];
+  /**
+   * 结构化输出 Schema
+   */
+  schema?: CompleteSchema;
+  /**
+   * 采样温度
+   */
+  temperature?: number;
+  /**
+   * 最大生成 token 数
+   */
+  maxTokens?: number;
+  /**
+   * 调用方用户标识
+   */
+  userId?: string;
+  /**
+   * 调用方元数据
+   */
+  metadata?: Record<string, unknown>;
+};
+/**
+ * 调用结束原因
+ */
+type FinishReason = 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'error';
 /**
- * 清理过期缓存条目用例
+ * Complete 调用用量统计
  *
- * 删除仓储中所有已过期的缓存条目，返回清理数量
+ * 用于成本归集与可观测性。
  */
-declare class CleanupCacheEntriesUseCase {
-  private readonly repository;
-  constructor(repository: CacheRepository);
-  execute(): Promise<Result<number, DomainError>>;
-}
-//#endregion
-//#region src/cache/cache.memory-adapter.d.ts
+type CompleteUsage = {
+  /**
+   * 输入 token 数
+   */
+  inputTokens: number;
+  /**
+   * 输出 token 数
+   */
+  outputTokens: number;
+  /**
+   * 本次调用成本（美元）
+   */
+  cost: number;
+};
 /**
- * 内存缓存适配器（Strategy M）
+ * Complete 调用响应
  *
- * 使用 Map 存储缓存条目，无外部依赖，适用于轻量级场景
- */
-declare class CacheMemoryAdapter implements CachePort {
-  /** 内存存储 */
-  private readonly store;
-  /** 构造函数 */
-  constructor();
-  /** 根据请求哈希获取缓存条目 */
-  getByHash(requestHash: string): Promise<Result<CacheEntryResponseDTO | null, DomainError>>;
-  /** 创建缓存条目 */
-  create(input: CreateCacheEntryRequestDTO): Promise<Result<CacheEntryResponseDTO, DomainError>>;
-  /** 记录缓存命中 */
-  recordHit(id: string): Promise<Result<CacheEntryResponseDTO, DomainError>>;
-  /** 删除缓存条目 */
-  delete(id: string): Promise<Result<boolean, DomainError>>;
-  /** 清理过期缓存 */
-  deleteExpired(): Promise<Result<number, DomainError>>;
-}
-//#endregion
-//#region src/cache/cache.sqlite-adapter.d.ts
+ * 与 spec 契约 Promise<{ content, usage: { inputTokens, outputTokens, cost }, finishReason,
+ * providerUsed, modelUsed }> 一致。
+ */
+type CompleteResponse = {
+  /**
+   * 模型生成内容
+   */
+  content: string;
+  /**
+   * 用量统计
+   */
+  usage: CompleteUsage;
+  /**
+   * 调用结束原因
+   */
+  finishReason: FinishReason;
+  /**
+   * 实际使用的供应商标识
+   */
+  providerUsed: string;
+  /**
+   * 实际使用的模型标识
+   */
+  modelUsed: string;
+};
 /**
- * 创建 SQLite 缓存端口适配器（Strategy L）
+ * LLM Complete 端口
  *
- * 封装 DrizzleCacheRepository → UseCase 组合 → CachePortAdapter 链路
+ * model-gateway 的统一 LLM 调用入口契约。
+ * 调用方通过此端口提交 complete 请求，由实现层完成路由决策、成本归集与可观测性采集。
  *
- * @param db - Drizzle 数据库实例
- * @param schema - 数据库 Schema 对象（需包含 cacheEntries 表）
- * @returns CachePort 实例
+ * @example
+ *   ```ts
+ *   const result = await llmCompletePort.complete('Summarize this article', {
+ *     model: 'gpt-4',
+ *     temperature: 0.3,
+ *     maxTokens: 500,
+ *     userId: 'user-123',
+ *   });
+ *   ```;
+ */
+type LlmCompletePort = {
+  complete(prompt: string, options?: CompleteOptions): Promise<Result<string, DomainError>>;
+  completeRequest(request: CompleteRequest): Promise<Result<CompleteResponse, DomainError>>;
+};
+/**
+ * LLM Complete 端口 DI 令牌
  */
-declare function createCacheSqliteAdapter(db: any, schema: any): CachePort;
+declare const LLM_COMPLETE_PORT_TOKEN: unique symbol;
 //#endregion
 //#region src/ports/event-publisher.port.d.ts
 /**
@@ -682,4 +1380,4 @@ type EventPublisherPort = {
  */
 declare const EVENT_PUBLISHER_PORT_TOKEN: unique symbol;
 //#endregion
-export { CACHE_PORT_TOKEN, CacheEntryEntity, CacheEntryMapper, CacheEntryOrmMapper, type CacheEntryResponseDTO, type CacheEntryRow, CacheError, CacheHitEvent, CacheMemoryAdapter, type CachePolicy, type CachePort, type CacheRepository, type ChatChoice, type ChatChunkDelta, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, type ChatStreamChoice, CleanupCacheEntriesUseCase, type CompletionChoice, type CompletionRequest, type CompletionResponse, type CreateCacheEntryInput, type CreateCacheEntryRequestDTO, CreateCacheEntryUseCase, DEFAULT_EXECUTION_STRATEGY, DEFAULT_FALLBACK_STRATEGY, DEFAULT_RETRY_STRATEGY, DEFAULT_TIMEOUT_STRATEGY, DeleteCacheEntryUseCase, DrizzleCacheRepository, ERROR_STATUS_MAP, EVENT_PUBLISHER_PORT_TOKEN, type EmbeddingData, type EmbeddingRequest, type EmbeddingResponse, type ErrorCategory, ErrorCode, type EventPublisherPort, type EventSubscriber, type ExecutionStrategy, type FallbackAction, type FallbackStrategy, type FunctionDefinition, type GatewayError, type GatewayErrorDetail, type GatewayExtension, GetCacheEntryUseCase, type MessageContentPart, type MessageContentType, type MessageRole, type ModelInfo, type ModelListResponse, type ModelPricing, RecordCacheHitUseCase, type ResponseFormat, type ResponseMessage, type RetryStrategy, type RoutingExtension, type TimeoutStrategy, type TokenUsage, type ToolCall, type ToolCallFunction, type ToolDefinition, budgetUsagePercent, calculateCost, createCacheEntrySchema, createCacheSqliteAdapter, decrypt, encrypt, estimateMessagesTokens, estimateTokens, formatCost };
+export { CACHE_PORT_TOKEN, CacheEntryEntity, CacheEntryMapper, type CacheEntryResponseDTO, CacheError, CacheHitEvent, type CachePolicy, type CachePort, type CacheRepository, type ChatChoice, type ChatChunkDelta, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, type ChatStreamChoice, type CompleteOptions, type CompleteRequest, type CompleteResponse, type CompleteUsage, type CompletionChoice, type CompletionRequest, type CompletionResponse, type CreateCacheEntryInput, type CreateCacheEntryRequestDTO, DEFAULT_EXECUTION_STRATEGY, DEFAULT_FALLBACK_STRATEGY, DEFAULT_RETRY_STRATEGY, DEFAULT_TIMEOUT_STRATEGY, ERROR_STATUS_MAP, EVENT_PUBLISHER_PORT_TOKEN, type EmbeddingData, type EmbeddingRequest, type EmbeddingResponse, type ErrorCategory, ErrorCode, type EventPublisherPort, type EventSubscriber, type ExecutionStrategy, type FallbackAction, type FallbackStrategy, type FinishReason, type FunctionDefinition, type GatewayError, type GatewayErrorDetail, type GatewayExtension, LLM_COMPLETE_PORT_TOKEN, type LlmCompletePort, MODEL_REPOSITORY_PORT_TOKEN, type MessageContentPart, type MessageContentType, type MessageRole, type ModelInfo, type ModelListResponse, type ModelPricing, type ModelRepositoryPort, ROUTING_RULE_REPOSITORY_PORT_TOKEN, type ResponseFormat, type ResponseMessage, type RetryStrategy, type RoutingExtension, type RoutingRuleRepositoryPort, type TimeoutStrategy, type TokenUsage, type ToolCall, type ToolCallFunction, type ToolDefinition, budgetUsagePercent, calculateCost, createCacheEntrySchema, decrypt, encrypt, estimateMessagesTokens, estimateTokens, formatCost };