@huyooo/ai-chat-core 0.3.22 → 0.3.23

package/dist/adapter/model-adapter.d.ts

@@ -1,7 +1,7 @@
 /**
  * ModelAdapter - 模型适配器（Model 中心）
  *
- * 直接使用 LLMConfig.models 的 ModelRoute 链，按顺序尝试，支持降级。
+ * 每个模型仅一条出站端点（ModelConfig.endpoint），与目录 offering 1:1。
  */
 import type { ProtocolMessage, ProtocolToolDefinition, RawEvent } from '../protocols/types';
 import { type ModelFamilyConfig } from '../families';
@@ -17,10 +17,10 @@ export declare class ModelAdapter implements ProviderAdapter {
     private validateModels;
     private resolveRuntimeValue;
     private resolveHeaders;
-    private createProtocolForRoute;
+    private createProtocolForEndpoint;
     get supportedModels(): string[];
     supportsModel(model: string): boolean;
     getModelFamilyConfig(model: string): ModelFamilyConfig | undefined;
     streamOnce(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: StreamOnceOptions): AsyncGenerator<RawEvent>;
-    private streamWithFallback;
+    private streamModelEndpoint;
 }

package/dist/build-chat-integration-export.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 从 Mongo 编译后的 ChatModelCatalogItem 生成 ai-chat 接入说明（供 ai-server / Ones 导出）
+ */
+import type { ChatModelCatalogItem } from './chat-catalog-types';
+import type { LLMConfig } from './llm-config';
+export interface ChatModelIntegrationExport {
+    catalogItem: ChatModelCatalogItem;
+    /** BYOK：直连 protocolBaseUrl */
+    llmConfigByok: Pick<LLMConfig, 'models' | 'defaultModel'>;
+    /** 原厂可走 Huyooo 官方代理时提供 */
+    llmConfigOfficial?: Pick<LLMConfig, 'models' | 'defaultModel'>;
+    downstreamApis: {
+        modelOptions: {
+            method: 'POST';
+            path: string;
+            body?: {
+                supplierIds?: string[];
+            };
+        };
+        supplierOptions: {
+            method: 'POST';
+            path: string;
+        };
+        integrationExport: {
+            method: 'POST';
+            path: string;
+            body: {
+                offeringModelId: string;
+            };
+        };
+        reloadRuntime: {
+            method: 'POST';
+            path: string;
+        };
+    };
+    compileHints: string[];
+}
+/** 生成可复制/下发的接入导出包 */
+export declare function buildChatModelIntegrationExport(item: ChatModelCatalogItem): ChatModelIntegrationExport;

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

@@ -0,0 +1,23 @@
+/**
+ * 模型目录与 ChatRuntime 编译共用常量（llmProxy path 模板 + Mongo 字段读取）
+ * 目录事实（chatRuntimeProtocol / supplier 出站）一律来自 Mongo，runtime 不做常量兜底。
+ */
+import type { ProtocolId } from './protocols/types';
+/** 校验 Mongo chatRuntimeProtocol 是否为已注册 ProtocolId */
+export declare function isChatRuntimeProtocolId(value: string): value is ProtocolId;
+export type ChatServerUpstream = 'direct' | 'llm_proxy';
+export interface ChatServerSupplierPolicy {
+    serverUpstream: ChatServerUpstream;
+    proxyPathPrefix: string | null;
+}
+/** llmProxy 出站时按 protocolId 拼完整 path（编译规则，非 Mongo 兜底） */
+export declare const SERVER_LLM_PROXY_PATH_BY_PROTOCOL: Record<string, string>;
+/** 读取 Mongo modelAccessProtocol.chatRuntimeProtocol；缺失或无效 → null */
+export declare function resolveChatRuntimeProtocol(stored?: string | null): ProtocolId | null;
+/** 读取 Mongo aiSupplier.officialProxyBaseUrl；缺失 → null */
+export declare function resolveOfficialProxyBaseUrl(stored?: string | null): string | null;
+/** 读取 Mongo aiSupplier 出站策略；不完整 → null */
+export declare function resolveServerSupplierPolicy(stored?: {
+    serverUpstream?: ChatServerUpstream | null;
+    proxyPathPrefix?: string | null;
+}): ChatServerSupplierPolicy | null;

package/dist/chat-catalog-types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 对话模型目录 DTO（Mongo offering 编译结果，ai-server / SuperX / 下游共用）
+ */
+import type { ModelFamilyId } from './families';
+import type { ProtocolId } from './protocols/types';
+import type { CatalogSupplierKind } from './chat-supplier-constants';
+import type { ChatServerUpstream } from './chat-catalog-constants';
+export type { ChatServerUpstream };
+export interface ChatSupplierOption {
+    key: string;
+    label: string;
+    supplierKind: CatalogSupplierKind;
+    /** 是否可走 Huyooo 官方 AI 代理（原厂供应商） */
+    officialEligible: boolean;
+}
+export interface ChatModelCatalogItem {
+    offeringModelId: string;
+    profileId: string;
+    supplierId: string;
+    supplierName: string;
+    supplierKind: CatalogSupplierKind;
+    officialEligible: boolean;
+    /** 是否开放给平台对话（Mongo platformChat） */
+    platformChat: boolean;
+    displayName: string;
+    providerModelId: string;
+    protocolId: string;
+    chatRuntimeProtocol: ProtocolId;
+    protocolBaseUrl: string;
+    protocolPath: string;
+    family: ModelFamilyId;
+    supportsThinking: boolean;
+    supportsVision: boolean;
+    contextWindowTokens: number;
+    maxOutputTokens: number;
+    status: 'active' | 'deprecated';
+    tags?: string[];
+    /** 来自 aiSupplier：Huyooo 官方代理 baseUrl */
+    officialProxyBaseUrl?: string;
+    /** 来自 aiSupplier：ai-server 平台对话出站 */
+    serverUpstream?: 'direct' | 'llm_proxy';
+    proxyPathPrefix?: string | null;
+}
+/** 平台 / SuperX 默认对话 profileId（编译时解析为 offeringModelId） */
+export declare const DEFAULT_CHAT_PROFILE_ID = "doubao-seed-2-0-pro-260215";

package/dist/chat-runtime-protocol-options.d.ts

@@ -0,0 +1,5 @@
+export declare const CHAT_RUNTIME_PROTOCOL_OPTIONS: {
+    value: "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";
+    label: string;
+}[];
+export declare function formatChatRuntimeProtocolLabel(value?: string | null): string;

package/dist/chat-runtime.d.ts

@@ -17,6 +17,7 @@ import type { ToolExecutionHooks } from './orchestrator/types';
 /** 运行时配置 */
 export interface RuntimeConfig {
     llmConfig: LLMConfig;
+    systemPrompt: string;
     cwd: string;
     maxIterations?: number;
     maxDurationMs?: number;
@@ -47,7 +48,7 @@ export declare class ChatRuntime {
     /** 异步初始化工具（懒加载，允许桥接层显式触发） */
     private asyncInit;
     getModelFamilyConfig(model: string): ModelFamilyConfig | undefined;
-    getModelRouteInfo(model: string): {
+    getModelEndpointInfo(model: string): {
         available: boolean;
         familyConfig?: ModelFamilyConfig;
     };

package/dist/chat-supplier-constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 模型目录供应商分类（ai-server / Ones 共用，与 Mongo supplierKind 一致）
+ */
+export type CatalogSupplierKind = 'agent_vendor' | 'agent_proxy';
+/** 固定为代理的接入方（非原厂 API） */
+export declare const PROXY_SUPPLIER_IDS: readonly ["openrouter", "volcengine-ark-coding-plan", "volcengine-ark-agent-plan"];
+export declare function isProxySupplierId(supplierId: string): boolean;
+/** 未写入库的历史数据视为原厂 */
+export declare function normalizeCatalogSupplierKind(kind?: CatalogSupplierKind): CatalogSupplierKind;
+/** 按 supplierId 解析类型：OpenRouter / 方舟套餐等始终为代理 */
+export declare function resolveCatalogSupplierKind(supplierId: string, kind?: CatalogSupplierKind): CatalogSupplierKind;

package/dist/compile-chat-model-config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ChatModelCatalogItem → ModelConfig 统一编译（SuperX / ai-server 共用）
+ */
+import type { ChatModelCatalogItem } from './chat-catalog-types';
+import type { LLMConfig, ModelConfig, ModelEndpoint, RuntimeConfigValue } from './llm-config';
+import { type ServerChatEnv } from './server-chat-endpoint';
+export type ChatModelCompileAccess = {
+    mode: 'official';
+    accessKey: RuntimeConfigValue;
+    headers?: ModelEndpoint['headers'];
+} | {
+    mode: 'byok';
+    accessKey: RuntimeConfigValue;
+} | {
+    mode: 'server';
+    env: ServerChatEnv;
+};
+/** 将目录项编译为 ChatRuntime ModelConfig；server 模式在无法出站时返回 null */
+export declare function compileChatModelConfig(item: ChatModelCatalogItem, access: ChatModelCompileAccess): ModelConfig | null;
+export interface ResolveDefaultChatOfferingOptions {
+    preferredOfferingModelId?: string;
+    preferredProfileId?: string;
+}
+/** 从已编译 models 与 catalog 解析默认 offeringModelId */
+export declare function resolveDefaultChatOfferingModelId(catalog: ChatModelCatalogItem[], models: LLMConfig['models'], options?: ResolveDefaultChatOfferingOptions): string;

package/dist/index.d.ts

@@ -37,7 +37,6 @@ export type { Protocol, ProtocolConfig, ProtocolAttachment, ProtocolMessage, Pro
 export { ChatOrchestrator, createOrchestrator } from './orchestrator';
 export type { AgentConfig, ChatOptions, ChatMode, ThinkingMode, AutoRunMode, AutoRunConfig, ToolExecutor, ToolDefinition, ChatMessage, ResponsesApiTool, Tool, ToolContext, DataEngineContext, ToolUI, RenderType, ActionType, ExecResult, ExecOptions, ToolResult, ToolSuccess, ToolExecuteResult, ToolError, ToolErrorCode, ToolErrorCategory, ToolPlugin, ToolConfigItem, ToolExecutionAuditHooks, UserToolDefinition, JsonSchemaObject, } from './types';
 export { resolveTools, tool, tools, ToolException, normalizeToolResult, serializeToolResult, isToolResult, toolOk, createResolvedOutputSchema, STANDARD_TOOL_ERROR_SCHEMA, resolveToolResultUi, mergeToolGovernance, resolveToolGovernanceSnapshot, throwToolError, isToolError, } from './types';
-export { DEFAULT_MODEL } from './constants';
 export type { ToolCallStatus, ToolCallInfo, TokenUsage, ErrorCategory, ErrorDetails, FinishReason, ToolFailureReason, } from './events';
 export type { ThinkingStartEvent, ThinkingDeltaEvent, ThinkingEndEvent, ThinkingEvent } from './events';
 export type { ToolCallStartEvent, ToolCallResultEvent, ToolCallOutputEvent, ToolApprovalRequestEvent, ToolCallRequestEvent, ToolEvent } from './events';
@@ -58,10 +57,22 @@ export type { SkillMeta, SkillSearchQuery, ManagedSkillSummary, ManagedSkillDeta
 export { skillManagementPlugin } from './skills';
 export { createManagedSkillSummary, createManagedSkillDetail } from './skills';
 export type { SkillManagementOptions, OnSkillCreate, OnSkillUpdate, OnSkillDelete, OnSkillSetEnabled, OnSkillLoadContent, OnSkillLoadReference, } from './skills';
-export { getRouteChain, resolveRouteUrl, findRouteByProtocol, } from './llm-config';
-export type { LLMConfig, ModelRoute, ModelConfig, CompressionConfig, } from './llm-config';
-export { MODEL_CATALOG_ADAPTERS, MODEL_CATALOG_PROVIDERS, MODEL_CATALOG_SERVICE_ENTRIES, MODEL_CATALOG_SERVICE_PLANS, getModelAdapter, getModelServiceEntry, getModelServicePlan, getModelTemplate, listModelTemplatesByServicePlan, compileModelTemplate, } from './model-catalog';
-export type { ModelAdapterDefinition, ModelProviderDefinition, ModelServiceCatalogEntry, ModelServicePlanDefinition, ModelServicePlanKind, ProviderModelTemplate, CompileModelTemplateOptions, } from './model-catalog';
+export { getModelEndpoint, resolveEndpointUrl, resolveChatModel, findEndpointByProtocol, } from './llm-config';
+export type { LLMConfig, ModelEndpoint, ModelConfig, CompressionConfig, } from './llm-config';
+export type { ChatModelIntegrationExport } from './build-chat-integration-export';
+export { buildChatModelIntegrationExport } from './build-chat-integration-export';
+export { BUILTIN_PROTOCOL_IDS, BUILTIN_PROTOCOL_FACTORIES, getBuiltinProtocolFactories, isRegisteredProtocolId, } from './protocols/registry';
+export { isChatRuntimeProtocolId, resolveChatRuntimeProtocol, resolveOfficialProxyBaseUrl, resolveServerSupplierPolicy, SERVER_LLM_PROXY_PATH_BY_PROTOCOL, } from './chat-catalog-constants';
+export type { ChatServerSupplierPolicy, ChatServerUpstream, } from './chat-catalog-constants';
+export type { CatalogSupplierKind } from './chat-supplier-constants';
+export { PROXY_SUPPLIER_IDS, isProxySupplierId, normalizeCatalogSupplierKind, resolveCatalogSupplierKind, } from './chat-supplier-constants';
+export { CHAT_RUNTIME_PROTOCOL_OPTIONS, formatChatRuntimeProtocolLabel, } from './chat-runtime-protocol-options';
+export type { ChatModelCatalogItem, ChatSupplierOption, } from './chat-catalog-types';
+export { DEFAULT_CHAT_PROFILE_ID } from './chat-catalog-types';
+export type { ChatModelCompileAccess, ResolveDefaultChatOfferingOptions, } from './compile-chat-model-config';
+export { compileChatModelConfig, resolveDefaultChatOfferingModelId, } from './compile-chat-model-config';
+export type { ServerChatEnv } from './server-chat-endpoint';
+export { getServerChatUpstream, resolveServerChatEndpoint, } from './server-chat-endpoint';
 export { partRegistry } from './parts';
 export type { PartMeta, PartSearchQuery, PartRegistry, ManagedPartSummary, ManagedPartDetail, } from './parts';
 export { createManagedPartSummary, createManagedPartDetail } from './parts';