qlogicagent 2.10.3 → 2.10.4

package/dist/types/provider-core/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides: ProviderDef + LLMTransport + ProviderRegistry + LLMClient factory
  */
-export type { ProviderDef, ModelInfo, TransportType, AuthType, MediaCapability, MediaCapabilities, VideoCapabilities, ImageCapabilities, MusicCapabilities, TtsCapabilities, ThreeDCapabilities, SttCapabilities, EmbeddingCapabilities, VideoUnderstandingCapabilities, ImageUnderstandingCapabilities, VoiceCloneCapabilities, RerankCapabilities, DocumentParsingCapabilities, RealtimeAudioCapabilities, VideoOperation, ImageOperation, MusicOperation, TtsOperation, ThreeDOperation } from "./provider-def.js";
+export type { ProviderDef, ModelInfo, TransportType, AuthType, MediaCapability, MediaCapabilities, VideoCapabilities, ImageCapabilities, MusicCapabilities, TtsCapabilities, ThreeDCapabilities, SttCapabilities, EmbeddingCapabilities, VideoUnderstandingCapabilities, ImageUnderstandingCapabilities, VoiceCloneCapabilities, RerankCapabilities, DocumentParsingCapabilities, RealtimeAudioCapabilities, VideoOperation, ImageOperation, MusicOperation, TtsOperation, ThreeDOperation, ProviderVariantKind, ProviderBillingChannelKind, ProviderVariantCapability } from "./provider-def.js";
 export type { LLMTransport, LLMRequest, LLMChunk, AccumulatedToolCall, } from "./transport.js";
 export { accumulateToolCalls } from "./transport.js";
 export type { ChatMessage, ChatMessageRole, ThinkingBlock, ToolCallMessage, ToolDefinition } from "./wire-types.js";
@@ -17,6 +17,7 @@ export type { ProviderToolAPI, WebSearchResult, ReaderResult, TokenizerResult, M
 export { ProviderRegistry } from "./provider-registry.js";
 export { BUILTIN_PROVIDERS } from "./builtin-providers.js";
 export { ModelCatalog } from "./model-catalog.js";
+export { ProviderVariantResolver, type ProviderVariantResolverInput, type ProviderVariantResolution, type RequestedProviderProtocol } from "./provider-variant-resolver.js";
 export type { LLMClientConfig, LLMClient } from "./llm-client.js";
 export { createLLMClient } from "./llm-client.js";
 export { OpenAIChatTransport } from "./transports/openai-chat.js";

package/dist/types/provider-core/provider-def.d.ts

@@ -12,6 +12,9 @@
 export type TransportType = "openai-chat" | "openai-responses" | "anthropic-messages" | "volcengine-responses" | "gemini-generatecontent";
 export type AuthType = "bearer" | "x-api-key" | "none";
 export type MediaCapability = "image" | "video" | "music" | "music_realtime" | "tts" | "3d" | "stt" | "embedding" | "video_understanding" | "image_understanding" | "voice_clone" | "rerank" | "document_parsing" | "realtime_audio" | "realtime_video";
+export type ProviderVariantKind = "standard" | "openai-compatible" | "anthropic-compatible" | "coding-plan" | "media-plan" | "realtime";
+export type ProviderBillingChannelKind = "paygo" | "plan" | "discount" | "official";
+export type ProviderVariantCapability = "thinking" | "reasoning_split" | "tool_stream" | "builtin_tools" | "vision" | "media" | "coding" | "realtime";
 export type VideoOperation = "text2video" | "img2video" | "video2video" | "edit" | "merge" | "upscale";
 export type ImageOperation = "text2image" | "img2img" | "inpainting" | "outpainting";
 export type MusicOperation = "text2music" | "cover" | "realtime";
@@ -159,6 +162,12 @@ export interface ProviderDef {
      * Defaults to provider id if unset.
      */
     group?: string;
+    /** Technical protocol variant kind for resolver ranking. */
+    variantKind?: ProviderVariantKind;
+    /** Channel type hint only; commercial cost selection is owned by llmrouter. */
+    billingChannelKind?: ProviderBillingChannelKind;
+    /** Provider-level capability hints used by ProviderVariantResolver. */
+    capabilities?: ProviderVariantCapability[];
     /** Env var names for API key (priority order) */
     apiKeyEnvVars: string[];
     /** Auth header style */

package/dist/types/provider-core/provider-variant-resolver.d.ts

@@ -0,0 +1,35 @@
+import type { ModelInfo, ProviderBillingChannelKind, ProviderDef, ProviderVariantCapability, ProviderVariantKind, TransportType } from "./provider-def.js";
+import type { ProviderRegistry } from "./provider-registry.js";
+export type RequestedProviderProtocol = TransportType | "openai" | "anthropic";
+export interface ProviderVariantResolverInput {
+    publicModel: string;
+    requestedProtocol?: RequestedProviderProtocol;
+    capabilities?: ProviderVariantCapability[];
+    purpose?: string;
+    userPreference?: {
+        providerIds?: string[];
+        preferProviderId?: string;
+        preferVariantKind?: ProviderVariantKind;
+    };
+}
+export interface ProviderVariantResolution {
+    provider: string;
+    group: string;
+    publicModel: string;
+    nativeModelId: string;
+    displayName: string;
+    transport: TransportType;
+    variantKind: ProviderVariantKind;
+    billingChannelKind: ProviderBillingChannelKind;
+    capabilities: ProviderVariantCapability[];
+    score: number;
+    reasons: string[];
+    providerDef: ProviderDef;
+    modelInfo: ModelInfo;
+}
+export declare class ProviderVariantResolver {
+    private readonly registry;
+    constructor(registry: Pick<ProviderRegistry, "listProviders" | "listModels">);
+    resolve(input: ProviderVariantResolverInput): ProviderVariantResolution[];
+    resolveBest(input: ProviderVariantResolverInput): ProviderVariantResolution | undefined;
+}

package/dist/types/provider-core/transports/minimax-media.d.ts

@@ -1,5 +1,5 @@
 /**
- * MiniMax Media Transport 鈥?Music + Video Generation.
+ * MiniMax Media Transport 鈥?Music + Video + TTS Generation.
  *
  * Music: POST /v1/music_generation (sync or async poll)
  * Video: POST /v1/video_generation (4 modes: text, image, first-last-frame, subject-ref)
@@ -21,6 +21,7 @@ export declare class MiniMaxMediaTransport implements AsyncMediaTransport {
     private timeoutMs;
     constructor(config: MiniMaxMediaConfig);
     generate(request: MediaRequest, apiKey: string, signal?: AbortSignal): Promise<MediaResult>;
+    private generateTTS;
     private generateMusic;
     private pollTask;
     /**

package/dist/types/provider-core/transports/qwen-media.d.ts

@@ -1,5 +1,5 @@
 /**
- * Qwen (DashScope) Media Transport 鈥?TTS + Video Generation.
+ * Qwen (DashScope) Media Transport.
  *
  * DashScope async task API pattern:
  *   Submit: POST /api/v1/services/aigc/<service>/generation  (X-DashScope-Async: enable)
@@ -9,7 +9,11 @@
  * Docs: https://help.aliyun.com/zh/model-studio/developer-reference/
  *
  * Video models: wan2.7-t2v (text-to-video), wan2.7-i2v (image-to-video)
- * TTS models: qwen3-tts-voicedesign, cosyvoice-v2
+ * TTS endpoints:
+ *   Qwen3-TTS:  /api/v1/services/aigc/multimodal-generation/generation
+ *   CosyVoice:  /api/v1/services/audio/tts/SpeechSynthesizer
+ * Rerank:       /api/v1/services/rerank/text-rerank/text-rerank
+ * Embedding:    /compatible-mode/v1/embeddings
  */
 import type { AsyncMediaTransport, MediaRequest, MediaResult, MediaType } from "../media-transport.js";
 export interface QwenMediaConfig {
@@ -23,6 +27,11 @@ export declare class QwenMediaTransport implements AsyncMediaTransport {
     private timeoutMs;
     constructor(config: QwenMediaConfig);
     generate(request: MediaRequest, apiKey: string, signal?: AbortSignal): Promise<MediaResult>;
+    private generateTTS;
+    private generateQwenTTS;
+    private generateCosyVoiceTTS;
+    private generateEmbedding;
+    private generateRerank;
     private pollTask;
     private generateVideo;
     /**

package/dist/types/provider-core/transports/volcengine-media.d.ts

@@ -22,6 +22,7 @@ export declare class VolcengineMediaTransport implements AsyncMediaTransport {
     private timeoutMs;
     constructor(config: VolcengineMediaConfig);
     generate(request: MediaRequest, apiKey: string, signal?: AbortSignal): Promise<MediaResult>;
+    private generateEmbedding;
     /**
      * Check if this transport can handle a given operation.
      * Video edit/merge/upscale are routed through the same video endpoint.

package/dist/types/provider-core/transports/zhipu-media.d.ts

@@ -76,7 +76,7 @@ export declare class ZhipuMediaTransport implements AsyncMediaTransport {
         status: string;
     }>>;
     /**
-     * Delete a cloned voice 鈥?DELETE /voice/{voice_id}
+     * Delete a cloned voice 鈥?POST /voice/delete
      */
     deleteVoice(voiceId: string, apiKey: string, signal?: AbortSignal): Promise<void>;
 }

package/dist/types/runtime/infra/model-registry.d.ts

@@ -54,6 +54,8 @@ export interface ResolvedModel {
 export declare const ALL_PURPOSES: ModelPurpose[];
 export declare class ModelRegistry {
     private keyPool;
+    private coreProviderRegistry;
+    private providerVariantResolver;
     private models;
     private modelEnabledOverrides;
     private bindings;
@@ -107,12 +109,17 @@ export declare class ModelRegistry {
     getTunable<T = unknown>(key: string): T | undefined;
     getModelInfo(providerId: string, modelId: string): ModelInfo | undefined;
     getProviderDefaultModel(providerId: string): string | undefined;
+    hasConfiguredKeyForProviderVariant(providerId: string): boolean;
+    hasAvailableKeyForProviderVariant(providerId: string): boolean;
     listProviderDefs(): ProviderDef[];
     resolveProviderApiKey(providerId: string): string | undefined;
     onChange(callback: RegistryChangeCallback): () => void;
     getKeyForProvider(providerId: string): string | null;
     snapshotProviderKeys(): Record<string, string>;
     private getProviderBaseUrl;
+    private acquireKeyForProviderVariant;
+    private resolveTechnicalVariant;
+    private providerVariantKeyCandidates;
     private loadModelState;
     private exportModelState;
     private emitChange;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.10.3",
+  "version": "2.10.4",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",