qlogicagent 2.10.3 → 2.10.5

package/dist/types/provider-core/builtin-providers.d.ts

@@ -1,10 +1,8 @@
 /**
- * Builtin provider definitions 鈥?hardcoded fallback list (~30 providers).
+ * Curated Provider Core model catalog.
  *
- * This is Layer 1 (lowest priority) of the three-layer merge strategy.
- * Used when remote model catalog is unavailable.
- *
- * Aligned with Hermes hermes_cli/models.py hardcoded fallback.
+ * This is the single source used by qlogicagent direct mode and llmrouter's
+ * model catalog API. External broad catalogs are intentionally not merged in.
  */
 import type { ProviderDef } from "./provider-def.js";
 export declare const BUILTIN_PROVIDERS: ProviderDef[];

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";
@@ -16,7 +16,7 @@ export { MediaClient, type MediaClientConfig, type ResolvedMediaModel } from "./
 export type { ProviderToolAPI, WebSearchResult, ReaderResult, TokenizerResult, ModerationResult, ProviderToolCapability } from "./provider-tool-api.js";
 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

@@ -4,14 +4,14 @@
  * Aligned with Hermes `ProviderDef` dataclass pattern:
  *   id + name + transport type + baseUrl + auth config + model list
  *
- * Three-layer merge strategy (Layer 3 > Layer 2 > Layer 1):
- *   Layer 1: builtin-providers.ts hardcoded (fallback)
- *   Layer 2: model-catalog.ts remote (models.dev)
- *   Layer 3: user config (from agent.turn.config)
+ * Single curated model catalog plus optional user provider overrides.
  */
 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 +159,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-registry.d.ts

@@ -1,26 +1,22 @@
 /**
- * ProviderRegistry 鈥?two-layer merge registry for LLM providers.
+ * ProviderRegistry 鈥?single-source curated registry for LLM providers.
  *
- * Layer 1: builtin-providers.ts hardcoded (lowest priority, ~20 providers)
- * Layer 2: model-catalog.ts remote (models.dev 鈥?enriches model metadata)
- * Layer 3: user config override (from agent.turn.config 鈥?highest priority)
+ * Layer 1: builtin-providers.ts curated providers and models
+ * Layer 2: user config override (from agent.turn.config)
  *
- * Merge strategy: Layer 3 > Layer 2 > Layer 1 (later layers override same-id fields)
+ * Model IDs are intentionally not enriched from external catalogs. llmrouter and
+ * OpenClaw consume the same curated Provider Core catalog, and upstream request
+ * IDs are resolved through model aliases/native IDs.
  *
  * Aligned with Hermes provider_registry.py.
  */
 import type { ModelInfo, ProviderDef } from "./provider-def.js";
-import { ModelCatalog } from "./model-catalog.js";
 export declare class ProviderRegistry {
-    /** Layer 1: builtin hardcoded providers */
+    /** Curated providers and models */
     private builtins;
-    /** Layer 2: remote model catalog (models.dev) */
-    private catalog;
-    /** Layer 3: user overrides (from agent.turn.config) */
+    /** User overrides (from agent.turn.config) */
     private overrides;
-    constructor(opts?: {
-        catalog?: ModelCatalog;
-    });
+    constructor();
     /**
      * Apply user config override for a provider.
      * Typically called when agent.turn.config has baseUrl/apiKey overrides.
@@ -38,7 +34,6 @@ export declare class ProviderRegistry {
     listProviders(): ProviderDef[];
     /**
      * List models for a specific provider.
-     * Merges: Layer 3 override > Layer 1 builtin > Layer 2 catalog enrichment.
      */
     listModels(providerId: string): ModelInfo[];
     /**
@@ -46,10 +41,6 @@ export declare class ProviderRegistry {
      * Returns undefined if the model is not found.
      */
     getModelInfo(providerId: string, modelId: string): ModelInfo | undefined;
-    /**
-     * Trigger background refresh of the remote model catalog.
-     */
-    refreshCatalog(): Promise<boolean>;
     /**
      * Resolve API key for a provider:
      *   1. Explicit key (from agent.turn.config)

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

@@ -27,6 +27,7 @@ export interface ModelEntry {
     purposes: ModelPurpose[];
     baseUrl?: string;
     enabled: boolean;
+    nativeModelId?: string;
     transport?: string;
     contextWindow?: number;
     maxOutput?: number;
@@ -54,6 +55,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 +110,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.5",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",

package/dist/types/provider-core/model-catalog.d.ts

@@ -1,82 +0,0 @@
-/**
- * ModelCatalog 鈥?remote model directory with disk cache + fallback.
- *
- * Fetches model metadata from models.dev/api.json (community-maintained,
- * comprehensive single-source catalog with 100+ providers).
- *
- * Two-layer fallback:
- *   1. In-memory cache (process-level, TTL check against disk mtime)
- *   2. Disk cache (~/.qlogicagent/cache/model_catalog.json)
- *   3. Remote fetch (models.dev single endpoint)
- *   4. Stale disk cache (if remote fails)
- *   5. Empty (caller falls back to builtin-providers.ts hardcoded)
- *
- * Non-blocking: first startup without cache returns empty immediately,
- * triggers background async fetch. Agent uses builtin providers until
- * catalog arrives.
- */
-import type { ModelInfo } from "./provider-def.js";
-/** Embedding model metadata from models.dev catalog. */
-export interface EmbeddingModelInfo {
-    id: string;
-    name: string;
-    /** Provider-internal ID (e.g. "openai", "qwen") */
-    providerId: string;
-    /** Output vector dimensions (from limit.output) */
-    dimensions: number;
-    /** Max input context tokens */
-    maxInputTokens: number;
-    /** Cost per million input tokens (USD) */
-    costInput?: number;
-    /** Model family string from models.dev */
-    family: string;
-}
-export declare class ModelCatalog {
-    private cache;
-    private cacheDir;
-    private cacheFile;
-    private ttlMs;
-    private fetching;
-    private lastFetchAttempt;
-    constructor(opts?: {
-        cacheDir?: string;
-        ttlMs?: number;
-    });
-    /**
-     * Get models for a provider. Non-blocking: returns whatever is cached.
-     * Triggers background refresh if stale.
-     */
-    getModels(providerId: string): ModelInfo[];
-    /**
-     * Get a single model by provider + model id.
-     */
-    getModel(providerId: string, modelId: string): ModelInfo | undefined;
-    /**
-     * List all known provider ids from the catalog.
-     */
-    listProviderIds(): string[];
-    /**
-     * Get embedding models for a provider.
-     * Returns models sorted by cost (cheapest first, then largest dims).
-     */
-    getEmbeddingModels(providerId: string): EmbeddingModelInfo[];
-    /**
-     * Get the default embedding model for a provider.
-     * Picks the cheapest model with >=512 dimensions.
-     */
-    getDefaultEmbeddingModel(providerId: string): EmbeddingModelInfo | undefined;
-    /**
-     * Get all embedding models across all providers.
-     */
-    getAllEmbeddingModels(): Map<string, EmbeddingModelInfo[]>;
-    /**
-     * Force refresh from remote. Returns true if successful.
-     */
-    refreshCatalog(): Promise<boolean>;
-    private ensureLoaded;
-    private isStale;
-    private loadFromDisk;
-    private saveToDisk;
-    private backgroundFetch;
-    private fetchRemote;
-}