qlogicagent 2.10.0 → 2.10.1

package/dist/types/cli/handlers/settings-handler.d.ts

@@ -1,24 +1,12 @@
-/**
- * Settings RPC handlers — model management system.
- *
- * All model pool operations go through ModelRegistry (single source of truth).
- * Handles: settings.listSupportedProviders, settings.addKey, settings.removeKey,
- *          settings.toggleKey, settings.listModels, settings.setActiveModel,
- *          settings.getActiveModel, settings.getOverview, settings.refreshModels
- */
 import type { AgentRpcRequest } from "../../protocol/wire/agent-rpc.js";
-export declare function handleSettingsListProviders(this: any, msg: AgentRpcRequest): void;
+export declare function handleSettingsListProviders(this: any, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsAddKey(this: any, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsRemoveKey(this: any, msg: AgentRpcRequest): void;
 export declare function handleSettingsToggleKey(this: any, msg: AgentRpcRequest): void;
 export declare function handleSettingsToggleModel(this: any, msg: AgentRpcRequest): void;
-export declare function handleSettingsListModels(this: any, msg: AgentRpcRequest): void;
+export declare function handleSettingsListModels(this: any, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsSetActiveModel(this: any, msg: AgentRpcRequest): void;
 export declare function handleSettingsGetActiveModel(this: any, msg: AgentRpcRequest): void;
-export declare function handleSettingsGetOverview(this: any, msg: AgentRpcRequest): void;
+export declare function handleSettingsGetOverview(this: any, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsRefreshModels(this: any, msg: AgentRpcRequest): Promise<void>;
-/**
- * Validate a provider API key by making a minimal /models list request.
- * Does not store the key; just verifies connectivity + auth.
- */
 export declare function handleSettingsValidateKey(this: any, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/handlers/settings-handler.remote-catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/runtime/infra/llmrouter-catalog.d.ts

@@ -0,0 +1,49 @@
+import type { ModelEntry, ModelRegistry } from "./model-registry.js";
+export declare const LLMROUTER_CATALOG_UNAVAILABLE_MESSAGE = "\u65E0\u6CD5\u8FDE\u63A5 llmrouter \u6A21\u578B\u76EE\u5F55";
+export declare class LlmrouterCatalogUnavailableError extends Error {
+    constructor(message?: string);
+}
+export interface LlmrouterCatalogProvider {
+    id: string;
+    name?: string;
+    displayName?: string;
+    baseUrl?: string;
+    base_url?: string;
+    transport?: string;
+    models?: Array<{
+        id?: string;
+    }>;
+}
+export interface LlmrouterCatalogModel {
+    id: string;
+    public_model?: string;
+    publicModel?: string;
+    provider?: string;
+    owned_by?: string;
+    native_model_id?: string;
+    nativeModelId?: string;
+    display_name?: string;
+    displayName?: string;
+    name?: string;
+    category?: string;
+    purposes?: string[];
+    baseUrl?: string;
+    base_url?: string;
+    provider_transport?: string;
+    providerTransport?: string;
+    context_window?: number;
+    contextWindow?: number;
+    max_output?: number;
+    maxOutput?: number;
+    stream_required?: boolean;
+    streamRequired?: boolean;
+    capabilities?: string[];
+    pricing?: Record<string, unknown>;
+}
+export declare function listLlmrouterCatalogProviders(): Promise<LlmrouterCatalogProvider[]>;
+export declare function listLlmrouterCatalogModels(): Promise<LlmrouterCatalogModel[]>;
+export declare function providerDisplayName(provider: LlmrouterCatalogProvider): string;
+export declare function providerBaseUrl(provider: LlmrouterCatalogProvider): string | undefined;
+export declare function getLlmrouterCatalogProvider(providerId: string): Promise<LlmrouterCatalogProvider | null>;
+export declare function refreshRegistryFromLlmrouterCatalog(registry: ModelRegistry): Promise<ModelEntry[]>;
+export declare function toModelEntry(model: LlmrouterCatalogModel): ModelEntry | null;

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

@@ -1,19 +1,24 @@
-/**
- * Model Registry — centralized model pool + per-purpose binding.
- *
- * Architecture: User adds Provider keys → enables models → binds each purpose to a model.
- * Any code needing a model calls `registry.getActiveModel(purpose)`.
- * Turn handler, media handler, STT, TTS — all go through this single source of truth.
- *
- * Persistence: ~/.qlogicagent/settings.json
- * Runtime state (key health, inFlight): in-memory via KeyPool
- */
-import { type ProviderPoolConfig, type KeyConfig, type LoadBalanceStrategy, type KeyHandle, type PoolStatus } from "./key-pool.js";
-import { type ModelInfo, type ProviderDef } from "@qlogic/provider-core";
+import { type KeyConfig, type KeyHandle, type LoadBalanceStrategy, type PoolStatus, type ProviderPoolConfig } from "./key-pool.js";
 export type RegistryChangeCallback = () => void;
-/** Purpose categories for model routing. */
 export type ModelPurpose = "textGeneration" | "smallModel" | "stt" | "tts" | "imageGeneration" | "imageUnderstanding" | "videoGeneration" | "videoUnderstanding" | "threeDGeneration" | "embedding" | "voiceClone" | "musicGeneration" | "realtimeAudio" | "realtimeVideo";
-/** A model entry in the available model pool. */
+export interface ModelInfo {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxOutput?: number;
+    streamRequired?: boolean;
+    vision?: boolean;
+    mediaType?: string;
+}
+export interface ProviderDef {
+    id: string;
+    name: string;
+    transport: string;
+    baseUrl: string;
+    defaultModel?: string;
+    group?: string;
+    models?: ModelInfo[];
+}
 export interface ModelEntry {
     id: string;
     provider: string;
@@ -22,17 +27,23 @@ export interface ModelEntry {
     purposes: ModelPurpose[];
     baseUrl?: string;
     enabled: boolean;
+    transport?: string;
+    contextWindow?: number;
+    maxOutput?: number;
+    streamRequired?: boolean;
+    capabilities?: string[];
+    pricing?: Record<string, unknown>;
 }
-/** Per-purpose binding: maps purpose → model ID. */
 export type PurposeBindings = Partial<Record<ModelPurpose, string>>;
-/** Persistent settings.json schema (new architecture). */
 export interface ModelRegistryConfig {
     providers: ProviderPoolConfig[];
-    models: ModelEntry[];
+    models: Array<{
+        id: string;
+        enabled?: boolean;
+    }>;
     bindings: PurposeBindings;
     tunables?: Record<string, unknown>;
 }
-/** Resolved model ready for API call. */
 export interface ResolvedModel {
     provider: string;
     model: string;
@@ -40,34 +51,18 @@ export interface ResolvedModel {
     baseUrl?: string;
     keyHandle: KeyHandle;
 }
+export declare const ALL_PURPOSES: ModelPurpose[];
 export declare class ModelRegistry {
     private keyPool;
     private models;
+    private modelEnabledOverrides;
     private bindings;
     private settingsPath;
     private changeListeners;
     constructor(config?: ModelRegistryConfig);
-    /**
-     * Get the currently bound model for a purpose, with a live API key from the pool.
-     * Returns null if purpose is not bound or no key is available.
-     *
-     * IMPORTANT: Caller MUST call result.keyHandle.release({ success, tokens? }) when done.
-     */
     getActiveModel(purpose: ModelPurpose): ResolvedModel | null;
-    /**
-     * Peek at the bound model for a purpose WITHOUT acquiring a key.
-     * Useful for UI display, description generation, etc.
-     */
     peekActiveModel(purpose: ModelPurpose): ModelEntry | null;
-    /**
-     * Check if a purpose has an available model + key (without acquiring).
-     */
     isAvailable(purpose: ModelPurpose): boolean;
-    /**
-     * Resolve a model name for a purpose, falling back to textGeneration if not bound.
-     * Returns the raw model string (e.g. "deepseek-v4-flash") or null if nothing configured.
-     * Does NOT acquire a key — use for cases where the caller already has transport/key.
-     */
     resolveModelForPurpose(purpose: ModelPurpose): string | null;
     addProvider(providerId: string, opts?: {
         baseUrl?: string;
@@ -89,6 +84,8 @@ export declare class ModelRegistry {
     addModel(entry: Omit<ModelEntry, "id"> & {
         id?: string;
     }): string;
+    replaceCatalogModels(entries: ModelEntry[]): void;
+    migrateModelIds(aliasToNative: Map<string, string>): void;
     removeModel(id: string): void;
     enableModel(id: string): void;
     disableModel(id: string): void;
@@ -104,84 +101,22 @@ export declare class ModelRegistry {
     getAllBindings(): Record<string, ModelEntry | null>;
     getProviderStatus(providerId: string): PoolStatus | null;
     getAllProviderStatus(): PoolStatus[];
-    /** Save current config to settings.json. Preserves non-model fields (tunables, theme, etc.). */
     save(): void;
-    /** Load config from settings.json. Returns false if file not found or parse error. */
     load(): boolean;
-    /** Export full config (for serialization/transfer). */
     exportConfig(): ModelRegistryConfig;
-    /**
-     * Read a tunable value from settings.json tunables section.
-     * Returns undefined if not set. Does NOT write — read-only accessor.
-     */
     getTunable<T = unknown>(key: string): T | undefined;
-    private _providerRegistry;
-    private getProviderRegistry;
-    /**
-     * Get model metadata (streamRequired, contextWindow, etc.) from the merged
-     * provider-core registry. Replaces direct `this.registry.getModelInfo(...)`.
-     */
     getModelInfo(providerId: string, modelId: string): ModelInfo | undefined;
-    /**
-     * Get the default model id for a provider (from builtin-providers).
-     * Replaces `this.registry.getProvider(provider)?.defaultModel`.
-     */
     getProviderDefaultModel(providerId: string): string | undefined;
-    /**
-     * List all known provider definitions (builtin + catalog).
-     * Replaces `this.registry.listProviders()`.
-     */
     listProviderDefs(): ProviderDef[];
-    /**
-     * Resolve an API key for a provider via env vars (fallback when KeyPool has no key).
-     * Replaces `this.registry.resolveApiKey(providerId)`.
-     */
     resolveProviderApiKey(providerId: string): string | undefined;
-    /**
-     * Register a callback to be notified when registry state changes
-     * (binding change, model add/remove, key change, save/load).
-     * Returns an unsubscribe function.
-     */
     onChange(callback: RegistryChangeCallback): () => void;
-    private emitChange;
-    /**
-     * Snapshot one available key for a provider WITHOUT holding it (for legacy flat-map consumers).
-     * Returns null if no healthy key exists.
-     */
     getKeyForProvider(providerId: string): string | null;
-    /**
-     * Snapshot one key per provider (for media tools flat apiKeys map).
-     */
     snapshotProviderKeys(): Record<string, string>;
     private getProviderBaseUrl;
+    private loadModelState;
+    private exportModelState;
+    private emitChange;
 }
-export declare const ALL_PURPOSES: ModelPurpose[];
-/**
- * Get the global ModelRegistry singleton.
- * Lazily loads from settings.json on first access.
- */
 export declare function getModelRegistry(): ModelRegistry;
-/**
- * Reset the global singleton (for testing or hot-reload).
- */
 export declare function resetModelRegistry(): void;
-/**
- * Derive which purposes a model supports from its ModelInfo metadata.
- * Layer 1: ModelCatalog (models.dev) modalities → purpose mapping.
- *
- * Priority: mediaType field → vision field → fallback to textGeneration.
- */
 export declare function deriveModelPurposes(model: ModelInfo): ModelPurpose[];
-/**
- * Layer 3: Name-based heuristic for models not in ModelCatalog or builtin-providers.
- */
-export declare function heuristicModelPurposes(modelId: string): ModelPurpose[];
-/**
- * Refresh models from ModelCatalog (remote models.dev + disk cache) for given providers.
- * Merges discovered models into the registry without overwriting user-modified entries.
- */
-export declare function refreshModelsFromCatalog(registry: ModelRegistry, providerIds: string[]): void;
-/**
- * Force refresh the ModelCatalog from remote, then merge into registry.
- */
-export declare function forceRefreshCatalog(registry: ModelRegistry, providerIds: string[]): Promise<boolean>;

package/package.json

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

package/dist/types/runtime/infra/builtin-providers.d.ts

@@ -1,36 +0,0 @@
-/**
- * Supported provider metadata for settings RPC.
- *
- * Bridges provider-core's BUILTIN_PROVIDERS into the ModelPurpose system.
- * This is the authoritative list of providers shown in "Add Key" UI.
- *
- * IMPORTANT: Model lists here are the Layer 2 (offline fallback) data source.
- * Layer 1 is ModelCatalog (models.dev remote). These two are the ONLY sources.
- */
-import type { ModelPurpose } from "./model-registry.js";
-export interface KnownModelMeta {
-    model: string;
-    displayName: string;
-    purposes: ModelPurpose[];
-    baseUrl?: string;
-}
-export interface SupportedProviderMeta {
-    id: string;
-    displayName: string;
-    baseUrl: string;
-    defaultRateLimit?: {
-        rpm?: number;
-        tpm?: number;
-    };
-    knownModels: KnownModelMeta[];
-}
-/**
- * Minimal offline fallback providers.
- * Remote catalog (Layer 1) has text generation models; this Layer 2 keeps ONLY
- * specialized models that remote may not cover: embedding, TTS, STT, image gen,
- * video gen, music gen, 3D gen, realtime voice/video, voice clone.
- *
- * All providers are kept (for Add Key UI dropdown + baseUrl lookup).
- * Text generation / image understanding models are NOT listed here — remote always has them.
- */
-export declare const SUPPORTED_PROVIDERS: SupportedProviderMeta[];