@huyooo/ai-chat-core 0.3.21 → 0.3.23

package/dist/llm-config.d.ts

@@ -3,7 +3,7 @@
  *
  * LLMConfig.models 是模型的唯一真相源：
  * - key = 模型 ID（自定义字符串）
- * - value = ModelConfig（路由 + 元数据）
+ * - value = ModelConfig（出站端点 + 元数据）
  * - 前端只展示这里配置的模型
  * - 每个模型必须显式指定 family，不做任何隐式推导
  */
@@ -11,8 +11,8 @@ import type { ProtocolFactory } from './protocols';
 import type { ModelFamilyConfig, ModelFamilyId } from './families';
 /** 运行时可解析的配置值。用于登录态 token、按用户切换的 key 等动态配置。 */
 export type RuntimeConfigValue = string | (() => string | null | undefined);
-/** 单条模型访问路径 */
-export interface ModelRoute {
+/** 单条模型出站端点（与 catalog 的 protocolBaseUrl / protocolPath 编译对齐） */
+export interface ModelEndpoint {
     /** 基础 URL */
     baseUrl: string;
     /** 访问 key（代理 token 或厂商 key） */
@@ -28,10 +28,10 @@ export interface ModelRoute {
     /** 额外请求头。用于官方代理 app-id、OpenRouter HTTP-Referer/X-Title 等。 */
     headers?: Record<string, RuntimeConfigValue>;
 }
-/** 模型配置（路由 + 元数据） */
+/** 模型配置（出站端点 + 元数据） */
 export interface ModelConfig {
-    /** 路由链（数组顺序 = 降级优先级） */
-    routes: ModelRoute[];
+    /** 该模型的唯一出站端点（与 Mongo offering 编译结果 1:1） */
+    endpoint: ModelEndpoint;
     /** 显示名称（不传则从预设库补全，再 fallback 到 modelId） */
     displayName?: string;
     /**
@@ -65,10 +65,16 @@ export interface CompressionConfig {
 }
 /** 完整 LLM 配置 */
 export interface LLMConfig {
+    /**
+     * 默认模型 ID（接入方配置，调用方未指定 model 时使用）
+     *
+     * 必须是 models 中已配置的 key。
+     */
+    defaultModel: string;
     /**
      * 模型配置（唯一真相源）
      *
-     * key = 模型 ID，value = 路由 + 元数据。
+     * key = 模型 ID，value = 出站端点 + 元数据。
      * 前端模型选择器只展示这里 visible !== false 的模型。
      */
     models: Record<string, ModelConfig>;
@@ -76,7 +82,7 @@ export interface LLMConfig {
      * 自定义协议工厂（可插拔）
      *
      * key = 自定义 protocolId，value = Protocol 工厂函数。
-     * ModelRoute.protocol 引用此处的 key 或内置 protocolId。
+     * ModelEndpoint.protocol 引用此处的 key 或内置 protocolId。
      */
     protocols?: Record<string, ProtocolFactory>;
     /**
@@ -89,13 +95,11 @@ export interface LLMConfig {
     /** 压缩模型配置（可选） */
     compression?: CompressionConfig;
 }
-/** 解析 route 的完整 API URL */
-export declare function resolveRouteUrl(route: ModelRoute): string;
-/**
- * 获取模型的 route 链（按优先级）
- */
-export declare function getRouteChain(config: LLMConfig, modelId: string): ModelRoute[];
-/**
- * 查找第一个支持指定 protocol 的 route
- */
-export declare function findRouteByProtocol(config: LLMConfig, protocolId: string): ModelRoute | undefined;
+/** 解析对话使用的模型 ID（options.model 优先，否则 LLMConfig.defaultModel） */
+export declare function resolveChatModel(config: LLMConfig, modelId?: string): string;
+/** 解析 endpoint 的完整 API URL */
+export declare function resolveEndpointUrl(endpoint: ModelEndpoint): string;
+/** 获取模型出站端点 */
+export declare function getModelEndpoint(config: LLMConfig, modelId: string): ModelEndpoint | undefined;
+/** 查找第一个使用指定 protocol 的模型出站端点 */
+export declare function findEndpointByProtocol(config: LLMConfig, protocolId: string): ModelEndpoint | undefined;

package/dist/protocols/index.d.ts

@@ -18,6 +18,7 @@
  */
 export type { ProtocolId, RawEventType, RawEvent, RawOutputPart, RawToolCall, RawTokenUsage, ProtocolMessage, ProtocolToolDefinition, ProtocolRequestOptions, Protocol, ProtocolConfig, ProtocolAttachment, ProtocolFactory, } from './types';
 export { getBaseProtocol } from './types';
+export { BUILTIN_PROTOCOL_IDS, BUILTIN_PROTOCOL_FACTORIES, getBuiltinProtocolFactories, isRegisteredProtocolId, } from './registry';
 export { ArkProtocol, createArkProtocol } from './ark';
 export { DeepSeekProtocol, createDeepSeekProtocol } from './deepseek';
 export { QwenProtocol, createQwenProtocol, createQwenTextProtocol } from './qwen';

package/dist/protocols/protocol-ids.d.ts

@@ -0,0 +1,3 @@
+/** 内置 Protocol ID 列表（单一真源，ProtocolId 类型由此推导） */
+export declare const BUILTIN_PROTOCOL_IDS: readonly ["ark_v1", "deepseek_v1", "qwen_v1", "qwen_text_v1", "glm_v1", "moonshot_v1", "minimax_v1", "vercel_gateway_v1", "anthropic_v1", "gemini_v1", "openai_v1", "openai_chat_v1", "grok_v1"];
+export type ProtocolId = (typeof BUILTIN_PROTOCOL_IDS)[number];

package/dist/protocols/registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 内置 Protocol 注册表（工厂 + ID 白名单，单一真源）
+ */
+import { type ProtocolId } from './protocol-ids';
+import { createArkProtocol } from './ark';
+import { createDeepSeekProtocol } from './deepseek';
+import { createQwenProtocol, createQwenTextProtocol } from './qwen';
+import { createGlmProtocol } from './glm';
+import { createMoonshotProtocol } from './moonshot';
+import { createMiniMaxProtocol } from './minimax';
+import { createVercelGatewayProtocol } from './vercel-gateway';
+import { createAnthropicProtocol } from './anthropic';
+import { createGeminiProtocol } from './gemini';
+import { createOpenAIProtocol } from './openai';
+import { createOpenAIChatProtocol } from './openai-chat';
+import { createGrokProtocol } from './grok';
+import type { Protocol, ProtocolConfig } from './types';
+export { BUILTIN_PROTOCOL_IDS } from './protocol-ids';
+/** 内置协议工厂（ModelAdapter 默认注册） */
+export declare const BUILTIN_PROTOCOL_FACTORIES: {
+    ark_v1: typeof createArkProtocol;
+    deepseek_v1: typeof createDeepSeekProtocol;
+    qwen_v1: typeof createQwenProtocol;
+    qwen_text_v1: typeof createQwenTextProtocol;
+    glm_v1: typeof createGlmProtocol;
+    moonshot_v1: typeof createMoonshotProtocol;
+    minimax_v1: typeof createMiniMaxProtocol;
+    vercel_gateway_v1: typeof createVercelGatewayProtocol;
+    anthropic_v1: typeof createAnthropicProtocol;
+    gemini_v1: typeof createGeminiProtocol;
+    openai_v1: typeof createOpenAIProtocol;
+    openai_chat_v1: typeof createOpenAIChatProtocol;
+    grok_v1: typeof createGrokProtocol;
+};
+/** 供 ModelAdapter 合并自定义 protocols 时使用 */
+export declare function getBuiltinProtocolFactories(): Record<string, (config: ProtocolConfig) => Protocol>;
+/** 校验是否为已注册的内置 ProtocolId */
+export declare function isRegisteredProtocolId(value: string): value is ProtocolId;

package/dist/protocols/types.d.ts

@@ -13,11 +13,10 @@
  */
 import type { ModelFamilyConfig } from '../families';
 /**
- * 内置协议类型标识
- *
- * 默认带版本 _v1，当上游 API 有 breaking change 时新增 _v2、_v3 等。
+ * 内置协议类型标识（由 protocols/protocol-ids.ts 推导）
  */
-export type ProtocolId = 'ark_v1' | 'deepseek_v1' | 'qwen_v1' | 'qwen_text_v1' | 'glm_v1' | 'moonshot_v1' | 'minimax_v1' | 'vercel_gateway_v1' | 'anthropic_v1' | 'gemini_v1' | 'openai_v1' | 'openai_chat_v1' | 'grok_v1';
+export type { ProtocolId } from './protocol-ids';
+export { BUILTIN_PROTOCOL_IDS } from './protocol-ids';
 /** 从 ProtocolId 提取 base 协议（如 anthropic_v1 → anthropic） */
 export declare function getBaseProtocol(protocol: string): string;
 /**
@@ -121,7 +120,8 @@ export interface ProtocolRequestOptions {
  */
 export interface ProtocolConfig {
     apiKey: string;
-    apiUrl?: string;
+    /** 由 ModelAdapter 从 ModelEndpoint.baseUrl 注入 */
+    apiUrl: string;
     headers?: Record<string, string>;
 }
 /**

package/dist/server-chat-endpoint.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ai-server 平台对话：catalog item → 出站 endpoint（env 注入，策略来自 Mongo supplier）
+ */
+import type { ChatModelCatalogItem } from './chat-catalog-types';
+import type { ModelEndpoint } from './llm-config';
+/** ai-server 编译 endpoint 所需环境变量 */
+export interface ServerChatEnv {
+    llmProxyBaseUrl: string;
+    llmProxyApiKey?: string;
+    supplierApiKeys: {
+        'volcengine-doubao'?: string;
+        'aliyun-qwen'?: string;
+        deepseek?: string;
+        'zhipu-glm'?: string;
+        'moonshot-kimi'?: string;
+        minimax?: string;
+    };
+}
+/** 服务端出站策略标签（metadata.upstream） */
+export declare function getServerChatUpstream(item: Pick<ChatModelCatalogItem, 'serverUpstream' | 'proxyPathPrefix'>): 'llm-proxy' | 'direct';
+/** 将 catalog 项解析为 ai-server 平台对话 endpoint；Mongo 策略或 env 不完整时返回 null */
+export declare function resolveServerChatEndpoint(item: ChatModelCatalogItem, env: ServerChatEnv): ModelEndpoint | null;

package/dist/types.d.ts

@@ -61,8 +61,10 @@ export interface ToolExecutionAuditHooks {
 }
 /** Agent 配置 */
 export interface AgentConfig {
-    /** 统一 LLM 配置（endpoints + models 降级链） */
+    /** 统一 LLM 配置（每模型单 endpoint） */
     llmConfig: import('./llm-config').LLMConfig;
+    /** 基础 system prompt（接入方必填，ask/agent 共用） */
+    systemPrompt: string;
     /** 当前工作目录（必传，浏览器安全：不使用 process.cwd()） */
     cwd: string;
     /** 最大模型轮次（可选，默认不限制） */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huyooo/ai-chat-core",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "description": "AI Chat Core - HybridAgent with Doubao + Gemini",
   "type": "module",
   "main": "./dist/index.js",

package/dist/constants.d.ts

@@ -1,11 +0,0 @@
-/**
- * 常量定义
- *
- * 非模型相关的常量。模型数据唯一来源为 LLMConfig。
- */
-export declare const DEFAULT_ARK_URL = "https://ark.cn-beijing.volces.com/api/v3";
-export declare const DEFAULT_AIMLAPI_URL = "https://api.aimlapi.com/v1";
-/** 默认模型 ID（仅用于应用层未指定时的 fallback，不是唯一真相源） */
-export declare const DEFAULT_MODEL = "doubao-seed-2-0-pro-260215";
-/** agent 模式提示词（核心库通用，不引用具体工具名） */
-export declare const AGENT_MODE_PROMPT = "\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 AI \u52A9\u624B\uFF0C\u5177\u5907\u81EA\u4E3B\u6267\u884C\u590D\u6742\u4EFB\u52A1\u7684\u80FD\u529B\u3002\n\n## \u5DE5\u4F5C\u65B9\u5F0F\n1. **\u5206\u6790\u4EFB\u52A1**\uFF1A\u7406\u89E3\u7528\u6237\u9700\u6C42\uFF0C\u62C6\u89E3\u4E3A\u53EF\u6267\u884C\u7684\u6B65\u9AA4\n2. **\u9010\u6B65\u6267\u884C**\uFF1A\u6309\u6B65\u9AA4\u4F9D\u6B21\u8C03\u7528\u5DE5\u5177\uFF0C\u68C0\u67E5\u6BCF\u6B65\u7ED3\u679C\n3. **\u81EA\u6211\u9A8C\u8BC1**\uFF1A\u5DE5\u5177\u6267\u884C\u540E\u68C0\u67E5\u7ED3\u679C\u662F\u5426\u7B26\u5408\u9884\u671F\n4. **\u81EA\u52A8\u7EA0\u6B63**\uFF1A\u53D1\u73B0\u95EE\u9898\u65F6\u5C1D\u8BD5\u66FF\u4EE3\u65B9\u6848\uFF0C\u4E0D\u8981\u505C\u4E0B\u6765\u95EE\u7528\u6237\n5. **\u603B\u7ED3\u6C47\u62A5**\uFF1A\u6240\u6709\u6B65\u9AA4\u5B8C\u6210\u540E\uFF0C\u7ED9\u51FA\u7B80\u6D01\u7684\u7ED3\u679C\u603B\u7ED3\n\n## \u8F93\u51FA\u89C4\u8303\n- \u4E0D\u4F7F\u7528\u8868\u60C5\u7B26\u53F7\uFF08emoji\uFF09\uFF0C\u9664\u975E\u7528\u6237\u8981\u6C42\n- \u4F7F\u7528 Markdown \u683C\u5F0F\u7EC4\u7EC7\u5185\u5BB9\n- \u4EE3\u7801\u5757\u4F7F\u7528\u6B63\u786E\u7684\u8BED\u8A00\u6807\u8BC6";

package/dist/model-catalog/adapters.d.ts

@@ -1,2 +0,0 @@
-import type { ModelAdapterDefinition } from '../model-catalog';
-export declare const MODEL_CATALOG_ADAPTERS: ModelAdapterDefinition[];

package/dist/model-catalog/constants.d.ts

@@ -1,5 +0,0 @@
-export declare const HUYOOO_AI_BASE_URL = "https://ai.huyooo.com/aiRestfulApi";
-export declare const ARK_CODING_CHAT_BASE_URL = "https://ark.cn-beijing.volces.com/api/coding/v3";
-export declare const ARK_CODING_ANTHROPIC_BASE_URL = "https://ark.cn-beijing.volces.com/api/coding";
-export declare const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
-export declare const SILICONFLOW_BASE_URL = "https://api.siliconflow.cn/v1";

package/dist/model-catalog/providers.d.ts

@@ -1,2 +0,0 @@
-import type { ModelProviderDefinition } from '../model-catalog';
-export declare const MODEL_CATALOG_PROVIDERS: ModelProviderDefinition[];

package/dist/model-catalog/service-entries.d.ts

@@ -1,3 +0,0 @@
-import type { ModelServiceCatalogEntry, ModelServicePlanDefinition } from '../model-catalog';
-export declare const MODEL_CATALOG_SERVICE_ENTRIES: ModelServiceCatalogEntry[];
-export declare const MODEL_CATALOG_SERVICE_PLANS: ModelServicePlanDefinition[];

package/dist/model-catalog/services/huyooo-official.d.ts

@@ -1,2 +0,0 @@
-import type { ProviderModelTemplate } from '../../model-catalog';
-export declare const HUYOOO_OFFICIAL_MODEL_TEMPLATES: ProviderModelTemplate[];

package/dist/model-catalog/services/model-proxy.d.ts

@@ -1,3 +0,0 @@
-import type { ProviderModelTemplate } from '../../model-catalog';
-export declare const OPENROUTER_MODEL_TEMPLATES: ProviderModelTemplate[];
-export declare const SILICONFLOW_MODEL_TEMPLATES: ProviderModelTemplate[];

package/dist/model-catalog/services/volcengine-coding-plan.d.ts

@@ -1,2 +0,0 @@
-import type { ProviderModelTemplate } from '../../model-catalog';
-export declare const VOLCENGINE_CODING_PLAN_MODEL_TEMPLATES: ProviderModelTemplate[];

package/dist/model-catalog.d.ts

@@ -1,69 +0,0 @@
-import type { ModelFamilyId } from './families';
-import type { ModelConfig, ModelRoute, RuntimeConfigValue } from './llm-config';
-import type { ProtocolId } from './protocols';
-import { MODEL_CATALOG_ADAPTERS } from './model-catalog/adapters';
-import { MODEL_CATALOG_PROVIDERS } from './model-catalog/providers';
-import { MODEL_CATALOG_SERVICE_ENTRIES, MODEL_CATALOG_SERVICE_PLANS } from './model-catalog/service-entries';
-export type ModelServicePlanKind = 'official' | 'provider_api_key' | 'compatible_gateway';
-export interface ModelProviderDefinition {
-    id: string;
-    name: string;
-    description?: string;
-}
-export interface ModelServicePlanDefinition {
-    id: string;
-    providerId: string;
-    name: string;
-    description: string;
-    kind: ModelServicePlanKind;
-    modelTemplateIds: string[];
-}
-export interface ModelAdapterDefinition {
-    id: ProtocolId;
-    name: string;
-    description?: string;
-    defaultBaseUrl: string;
-    defaultFamily: ModelFamilyId;
-}
-export interface ProviderModelTemplate {
-    id: string;
-    servicePlanId: string;
-    providerId: string;
-    displayName: string;
-    family: ModelFamilyId;
-    protocol: ProtocolId;
-    baseUrl: string;
-    path?: string;
-    providerModelId: string;
-    supportsThinking: boolean;
-    supportsVision: boolean;
-    contextWindowTokens: number;
-    maxOutputTokens: number;
-    defaultEnabled: boolean;
-    status?: 'stable' | 'preview' | 'deprecated';
-}
-export interface CompileModelTemplateOptions {
-    accessKey: RuntimeConfigValue;
-    modelId?: string;
-    headers?: ModelRoute['headers'];
-    vendorKey?: RuntimeConfigValue;
-    metadata?: Record<string, unknown>;
-}
-export interface ModelServiceCatalogEntry {
-    servicePlan: Omit<ModelServicePlanDefinition, 'modelTemplateIds'>;
-    modelTemplates: ProviderModelTemplate[];
-}
-export { MODEL_CATALOG_ADAPTERS, MODEL_CATALOG_PROVIDERS, MODEL_CATALOG_SERVICE_ENTRIES, MODEL_CATALOG_SERVICE_PLANS, };
-export declare function getModelAdapter(id: ProtocolId): ModelAdapterDefinition | null;
-export declare function getModelServiceEntry(id: string): ModelServiceCatalogEntry | null;
-export declare function getModelServicePlan(id: string): {
-    modelTemplateIds: string[];
-    name: string;
-    id: string;
-    description: string;
-    kind: ModelServicePlanKind;
-    providerId: string;
-} | null;
-export declare function getModelTemplate(id: string): ProviderModelTemplate | null;
-export declare function listModelTemplatesByServicePlan(servicePlanId: string): ProviderModelTemplate[];
-export declare function compileModelTemplate(template: ProviderModelTemplate, options: CompileModelTemplateOptions): [string, ModelConfig];