qlogicagent 2.10.1 → 2.10.2

package/dist/types/agent/agent.d.ts

@@ -13,7 +13,7 @@
  * Zero imports from express/pg/ioredis/ws.
  */
 import type { AgentLogger, ToolInvoker, TurnEvent, TurnRequest, HookRegistry } from "./types.js";
-import type { LLMTransport } from "@qlogic/provider-core";
+import type { LLMTransport } from "../provider-core/index.js";
 export interface AgentConfig {
     llmTransport: LLMTransport;
     apiKey: string;

package/dist/types/agent/tool-loop.d.ts

@@ -19,7 +19,7 @@
  * Zero imports from express/pg/ioredis/ws.
  */
 import type { AgentLogger, ChatMessage, ToolDefinition, ToolInvoker, TurnEvent, HookRegistry } from "./types.js";
-import type { LLMTransport } from "@qlogic/provider-core";
+import type { LLMTransport } from "../provider-core/index.js";
 export interface ToolLoopParams {
     turnId: string;
     sessionId: string;

package/dist/types/agent/types.d.ts

@@ -7,7 +7,7 @@
  */
 import type { SkillInstruction } from "../orchestration/index.js";
 import type { HookRegistry } from "../contracts/hooks.js";
-import type { MediaCapability } from "@qlogic/provider-core";
+import type { MediaCapability } from "../provider-core/index.js";
 import type { ChatMessage as WireChatMessage, ChatMessageRole as WireChatMessageRole, ThinkingBlock as WireThinkingBlock, ToolCallMessage as WireToolCallMessage, ToolDefinition as WireToolDefinition, WireTokenUsage } from "../protocol/wire/index.js";
 export type ChatMessageRole = WireChatMessageRole;
 export type ThinkingBlock = WireThinkingBlock;

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

@@ -4,7 +4,7 @@
  */
 import type { ChatMessage } from "../../agent/types.js";
 import type { AgentRpcRequest } from "../../protocol/wire/agent-rpc.js";
-import type { LLMTransport } from "@qlogic/provider-core";
+import type { LLMTransport } from "../../provider-core/index.js";
 export declare function handleAbort(this: any, msg: AgentRpcRequest): void;
 export declare function handleApprovalResponse(this: any, msg: AgentRpcRequest): void;
 export declare function handleUserResponse(this: any, msg: AgentRpcRequest): void;

package/dist/types/cli/tool-bootstrap.d.ts

@@ -3,9 +3,9 @@ import { type TaskToolHooks } from "../skills/tools/task-tool.js";
 import { type ExecProgress } from "../skills/tools/exec-tool.js";
 import type { AgentLogger } from "../agent/types.js";
 import { type AskUserQuestion } from "../skills/tools/ask-user-tool.js";
-import type { MediaClient } from "@qlogic/provider-core";
-import type { MediaCapability } from "@qlogic/provider-core";
-import type { ProviderToolAPI } from "@qlogic/provider-core";
+import type { MediaClient } from "../provider-core/index.js";
+import type { MediaCapability } from "../provider-core/index.js";
+import type { ProviderToolAPI } from "../provider-core/index.js";
 /** Enable or disable group security mode (blocks sensitive file access). */
 export declare function setGroupSecurityMode(enabled: boolean): void;
 /**

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export type { AgentConfig } from "./config/config.js";
 export type { Transport } from "./cli/transport.js";
 export { StdioTransport } from "./cli/transport.js";
 export { StdioServer, type StdioServerConfig } from "./cli/stdio-server.js";
-export { ProviderRegistry, createLLMClient, } from "@qlogic/provider-core";
-export type { LLMTransport, LLMRequest, LLMChunk } from "@qlogic/provider-core";
+export { ProviderRegistry, createLLMClient, } from "./provider-core/index.js";
+export type { LLMTransport, LLMRequest, LLMChunk } from "./provider-core/index.js";
 export { createHookRegistry } from "./runtime/hooks/hook-registry.js";
 export { buildSkillInstruction, } from "./orchestration/index.js";

package/dist/types/llm/index.d.ts

@@ -1 +1 @@
-export * from "@qlogic/provider-core";
+export * from "../provider-core/index.js";

package/dist/types/orchestration/tool-cascade.d.ts

@@ -23,14 +23,14 @@
  *
  * ```ts
  * import { cascadeWebSearch } from "./tool-cascade.js";
- * import { ZhipuToolAPI } from "@qlogic/provider-core/transports/zhipu-tool-api";
+ * import { ZhipuToolAPI } from "../provider-core/transports/zhipu-tool-api.js";
  *
  * const providerApi = new ZhipuToolAPI({ baseUrl, apiKey });
  * const cascadedSearch = cascadeWebSearch(providerApi, fallbackSearchFn);
  * const tool = createWebSearchTool({ search: cascadedSearch });
  * ```
  */
-import type { ProviderToolAPI } from "@qlogic/provider-core";
+import type { ProviderToolAPI } from "../provider-core/index.js";
 import type { WebSearchToolDeps } from "../skills/tools/web-search-tool.js";
 /**
  * Cascade web search: provider-native search → host fallback.

package/dist/types/provider-core/adapters/aliyun-oss-file-upload-adapter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Aliyun OSS File Upload Adapter 鈥?direct upload to Alibaba Cloud OSS.
+ *
+ * Uploads files directly to OSS bucket using V1 signature (HMAC-SHA1).
+ * No external dependencies 鈥?uses Node.js crypto + fetch.
+ *
+ * This is the **universal fallback adapter** for providers without a native
+ * File Upload API (e.g. Anthropic). Ensures ALL file handling goes through
+ * upload 鈥?never base64 inline.
+ *
+ * Environment variables:
+ *   OSS_ACCESS_KEY_ID       鈥?Aliyun AccessKey ID
+ *   OSS_ACCESS_KEY_SECRET   鈥?Aliyun AccessKey Secret
+ *   OSS_BUCKET              鈥?Bucket name (default: "qlogicagent")
+ *   OSS_REGION              鈥?Region (default: "cn-beijing")
+ *   OSS_ENDPOINT            鈥?Custom endpoint (default: derived from region)
+ */
+import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
+export interface AliyunOSSFileUploadConfig {
+    /** Aliyun AccessKey ID. Required. */
+    accessKeyId: string;
+    /** Aliyun AccessKey Secret. Required. */
+    accessKeySecret: string;
+    /** OSS Bucket name. Default: "qlogicagent". */
+    bucket?: string;
+    /** OSS Region. Default: "cn-beijing". */
+    region?: string;
+    /** Custom OSS endpoint. Default: "{bucket}.oss-{region}.aliyuncs.com". */
+    endpoint?: string;
+    /** Upload path prefix. Default: "media". */
+    pathPrefix?: string;
+    /** Timeout ms. Default: 120_000. */
+    timeoutMs?: number;
+}
+/**
+ * Create an AliyunOSSFileUploadAdapter from environment variables.
+ * Returns undefined if required env vars (OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET) are missing.
+ */
+export declare function createAliyunOSSAdapterFromEnv(): AliyunOSSFileUploadAdapter | undefined;
+export declare class AliyunOSSFileUploadAdapter implements FileUploadAdapter {
+    private readonly config;
+    constructor(config: AliyunOSSFileUploadConfig);
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+}

package/dist/types/provider-core/adapters/gemini-file-upload-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gemini File Upload Adapter.
+ *
+ * Implements the Google Gemini 2-step resumable upload protocol
+ * into the unified FileUploadAdapter interface.
+ *
+ * Protocol:
+ *   1. POST /upload/v1beta/files 鈥?initiate, get upload URL
+ *   2. PUT {uploadUrl} 鈥?send bytes, finalize
+ *
+ * Returns a file URI (e.g. "files/abc123") that can be used in
+ * generateContent requests as a file reference.
+ */
+import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
+export interface GeminiFileUploadConfig {
+    /** Base URL (e.g. "https://generativelanguage.googleapis.com/v1beta") */
+    baseUrl: string;
+    /** Timeout ms. Default: 180_000. */
+    timeoutMs?: number;
+}
+export declare class GeminiFileUploadAdapter implements FileUploadAdapter {
+    private readonly config;
+    constructor(config: GeminiFileUploadConfig);
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+    private waitForProcessing;
+}

package/dist/types/provider-core/adapters/hub-oss-file-upload-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hub OSS File Upload Adapter 鈥?for providers without native File API (e.g. Anthropic).
+ *
+ * Uploads local files to the Hub's OSS relay endpoint, which stores them in
+ * cloud object storage (Aliyun OSS / Tencent COS) and returns a public URL.
+ * The LLM provider can then access the file via this public URL.
+ *
+ * This enables Anthropic (which only supports base64 inline or public URL)
+ * to handle large files that exceed the base64 size limit (20MB).
+ *
+ * Endpoint: POST {hubBaseUrl}/api/v1/files/upload
+ * Returns: { url: "https://oss-bucket.oss-cn-xxx.aliyuncs.com/..." }
+ */
+import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
+export interface HubOSSFileUploadConfig {
+    /** Hub API base URL (e.g. "https://hub.xiaozhiclaw.com" or from env). */
+    hubBaseUrl: string;
+    /** Hub API key for authentication. */
+    hubApiKey?: string;
+    /** Timeout ms. Default: 120_000. */
+    timeoutMs?: number;
+    /** Provider name for result metadata. Default: "hub-oss". */
+    provider?: string;
+}
+export declare class HubOSSFileUploadAdapter implements FileUploadAdapter {
+    private readonly config;
+    constructor(config: HubOSSFileUploadConfig);
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * File Upload Adapters 鈥?barrel export.
+ *
+ * Provider-specific implementations of the FileUploadAdapter interface.
+ */
+export { OpenAIFileUploadAdapter, type OpenAIFileUploadConfig } from "./openai-file-upload-adapter.js";
+export { VolcengineFileUploadAdapter, type VolcengineFileUploadConfig } from "./volcengine-file-upload-adapter.js";
+export { GeminiFileUploadAdapter, type GeminiFileUploadConfig } from "./gemini-file-upload-adapter.js";
+export { HubOSSFileUploadAdapter, type HubOSSFileUploadConfig } from "./hub-oss-file-upload-adapter.js";
+export { AliyunOSSFileUploadAdapter, type AliyunOSSFileUploadConfig, createAliyunOSSAdapterFromEnv } from "./aliyun-oss-file-upload-adapter.js";

package/dist/types/provider-core/adapters/openai-file-upload-adapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OpenAI-compatible File Upload Adapter.
+ *
+ * Implements FileUploadAdapter for providers using the standard
+ * POST /v1/files multipart upload endpoint:
+ *   - OpenAI
+ *   - Kimi (Moonshot)
+ *   - Minimax
+ *   - Qwen (via DashScope compatible endpoint)
+ *   - GLM (Zhipu)
+ *   - Any OpenAI-API-compatible provider
+ *
+ * The uploaded file gets a file_id which can be referenced in messages.
+ * Some providers also return a direct download URL.
+ */
+import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
+export interface OpenAIFileUploadConfig {
+    /** Base URL (e.g. "https://api.openai.com/v1" or "https://api.moonshot.cn/v1") */
+    baseUrl: string;
+    /** Provider name for result metadata. */
+    provider: string;
+    /** Extra headers to include (e.g. for Minimax group_id). */
+    extraHeaders?: Record<string, string>;
+    /** Upload purpose (default: "file-extract" for document understanding). */
+    defaultPurpose?: string;
+    /**
+     * Whether the provider returns a download URL in the upload response.
+     * If false, constructs URL from file_id (provider-specific).
+     */
+    returnsUrl?: boolean;
+    /** Timeout for upload request (ms). Default: 120_000. */
+    timeoutMs?: number;
+}
+export declare class OpenAIFileUploadAdapter implements FileUploadAdapter {
+    private readonly config;
+    constructor(config: OpenAIFileUploadConfig);
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+}

package/dist/types/provider-core/adapters/volcengine-file-upload-adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Volcengine File Upload Adapter.
+ *
+ * Wraps the Volcengine /v3/files endpoint into the unified
+ * FileUploadAdapter interface.
+ *
+ * Volcengine returns a file_id that can be used in API messages
+ * as a file reference. Files uploaded this way can be referenced in
+ * multimodal inputs via the file_id field.
+ */
+import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
+export interface VolcengineFileUploadConfig {
+    /** Base URL (e.g. "https://ark.cn-beijing.volces.com/api") */
+    baseUrl: string;
+    /** Upload purpose. Default: "user_data". */
+    defaultPurpose?: string;
+    /** Timeout ms. Default: 120_000. */
+    timeoutMs?: number;
+}
+export declare class VolcengineFileUploadAdapter implements FileUploadAdapter {
+    private readonly config;
+    constructor(config: VolcengineFileUploadConfig);
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Builtin provider definitions 鈥?hardcoded fallback list (~30 providers).
+ *
+ * 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.
+ */
+import type { ProviderDef } from "./provider-def.js";
+export declare const BUILTIN_PROVIDERS: ProviderDef[];

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

@@ -0,0 +1 @@
+export declare const MEDIA_MAX_UPLOAD_SIZE: number;

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

@@ -0,0 +1 @@
+export declare function resolveApiKey(envVarNames: string[], env?: NodeJS.ProcessEnv): string | undefined;

package/dist/types/provider-core/debug-transport.d.ts

@@ -0,0 +1,12 @@
+import type { LLMTransport } from "./transport.js";
+/**
+ * Check whether debug transport should be enabled.
+ */
+export declare function isDebugTransportEnabled(): boolean;
+/**
+ * Create a DebugTransport decorator that wraps a base LLMTransport,
+ * logging request metadata + timing + usage to JSONL.
+ *
+ * CC parity: createDumpPromptsFetch 鈥?but vendor-agnostic via transport abstraction.
+ */
+export declare function createDebugTransport(base: LLMTransport, sessionId: string): LLMTransport;

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

@@ -0,0 +1,11 @@
+export declare class ProviderCoreError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly provider?: string;
+    constructor(message: string, opts?: {
+        status?: number;
+        code?: string;
+        provider?: string;
+        cause?: unknown;
+    });
+}

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

@@ -0,0 +1,48 @@
+export interface ProviderUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+}
+export interface ProviderErrorPayload {
+    message: string;
+    code?: string;
+    status?: number;
+    provider?: string;
+}
+export type ProviderEvent = {
+    type: "response.created";
+    id: string;
+    model: string;
+    provider: string;
+    credentialId?: string;
+    credentialSource?: string;
+    credentialEgressMode?: string;
+    credentialEgressRegion?: string;
+} | {
+    type: "content.delta";
+    index: number;
+    text: string;
+} | {
+    type: "reasoning.delta";
+    text: string;
+} | {
+    type: "tool.call.delta";
+    id: string;
+    name?: string;
+    argumentsDelta?: string;
+} | {
+    type: "usage.delta";
+    usage: ProviderUsage;
+} | {
+    type: "annotation";
+    annotation: Record<string, unknown>;
+} | {
+    type: "response.completed";
+    usage?: ProviderUsage;
+    finishReason?: string;
+} | {
+    type: "error";
+    error: ProviderErrorPayload;
+};

package/dist/types/provider-core/file-upload-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * FileUploadService 鈥?Unified file upload abstraction for all LLM providers.
+ *
+ * Replaces the base64 approach in media-resolve.ts. When a local URL is
+ * encountered, this service uploads the file to the current provider's
+ * File API and returns a public URL or file_id.
+ *
+ * Supported providers:
+ *   - OpenAI-compatible (OpenAI, Kimi, Minimax, Qwen, GLM) 鈥?POST /v1/files
+ *   - Volcengine 鈥?POST /v3/files
+ *   - Google Gemini 鈥?Resumable upload protocol
+ *
+ * Architecture:
+ *   Transport layer calls resolveLocalMedia() before sending messages.
+ *   resolveLocalMedia() fetches local content and uploads to provider,
+ *   returning a public URL the LLM can access.
+ */
+export interface FileUploadResult {
+    /** Public URL accessible by the LLM provider. */
+    url: string;
+    /** Provider-specific file identifier (for reference/deletion). */
+    fileId: string;
+    /** Original filename. */
+    filename: string;
+    /** File size in bytes. */
+    bytes: number;
+    /** MIME type of the uploaded file. */
+    mimeType: string;
+    /** Provider that stored the file. */
+    provider: string;
+}
+/**
+ * Provider-specific upload adapter.
+ * Each transport implements this to upload files to its own File API.
+ */
+export interface FileUploadAdapter {
+    /**
+     * Upload a file buffer and return a publicly accessible URL.
+     * @param buffer - File content
+     * @param filename - Original filename (used for MIME detection)
+     * @param mimeType - MIME type of the file
+     * @param apiKey - Provider API key
+     * @param signal - Abort signal
+     */
+    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
+}
+/** Guess MIME type from filename extension. */
+export declare function guessMimeType(filename: string): string;
+/** Check if a URL points to a local/private address that cloud APIs cannot reach. */
+export declare function isLocalUrl(url: string): boolean;
+/**
+ * Resolve a local URL by uploading its content to the provider's File API.
+ * Public URLs are returned as-is (the LLM API can fetch them directly).
+ *
+ * @param url - The URL to resolve (may be local or public)
+ * @param adapter - Provider-specific upload adapter
+ * @param apiKey - API key for the upload
+ * @param signal - Optional abort signal
+ * @returns Public URL accessible by the LLM
+ */
+export declare function resolveLocalMedia(url: string, adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal): Promise<string>;
+/**
+ * Batch-resolve multiple URLs concurrently. Returns array in same order.
+ * Local URLs are uploaded; public URLs pass through unchanged.
+ * Supports concurrent uploads (up to `concurrency` limit, default 3).
+ * Failures throw (caller should handle).
+ */
+export declare function resolveLocalMediaBatch(urls: string[], adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal, concurrency?: number): Promise<string[]>;

package/dist/types/provider-core/gemini-schema-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gemini JSON Schema cleaning utilities.
+ *
+ * Gemini's generateContent API rejects several standard JSON Schema keywords.
+ * This module provides a shared recursive cleaner used by:
+ *   - GeminiGenerateContentTransport (tool declarations in request body)
+ *   - tool-schema.ts (provider-aware schema normalization at orchestration level)
+ *
+ * Keeping a single source of truth avoids drift between the two consumers.
+ */
+/** Keywords that Gemini's generateContent API does not accept in tool schemas. */
+export declare const GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS: Set<string>;
+/**
+ * Recursively strip unsupported JSON Schema keywords from a schema object.
+ * Safe to call multiple times (idempotent).
+ */
+export declare function cleanSchemaForGemini(schema: unknown): unknown;

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

@@ -0,0 +1,37 @@
+/**
+ * LLM Provider layer 鈥?public API surface.
+ *
+ * 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 { LLMTransport, LLMRequest, LLMChunk, AccumulatedToolCall, } from "./transport.js";
+export { accumulateToolCalls } from "./transport.js";
+export type { ChatMessage, ChatMessageRole, ThinkingBlock, ToolCallMessage, ToolDefinition } from "./wire-types.js";
+export type { ProviderEvent, ProviderErrorPayload, ProviderUsage } from "./events.js";
+export { ProviderCoreError } from "./errors.js";
+export { resolveApiKey } from "./credentials.js";
+export type { MediaTransport, MediaRequest, MediaResult, MediaType } from "./media-transport.js";
+export { isAsyncMediaTransport } from "./media-transport.js";
+export { MediaClient, type MediaClientConfig, type ResolvedMediaModel } from "./media-client.js";
+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 type { LLMClientConfig, LLMClient } from "./llm-client.js";
+export { createLLMClient } from "./llm-client.js";
+export { OpenAIChatTransport } from "./transports/openai-chat.js";
+export { AnthropicMessagesTransport } from "./transports/anthropic-messages.js";
+export { GeminiGenerateContentTransport } from "./transports/gemini-generatecontent.js";
+export { VolcengineMediaTransport } from "./transports/volcengine-media.js";
+export { OpenAIMediaTransport } from "./transports/openai-media.js";
+export { MiniMaxMediaTransport } from "./transports/minimax-media.js";
+export { GeminiMediaTransport, type GeminiMediaConfig } from "./transports/gemini-media.js";
+export { GeminiLyriaRealtimeSession, generateRealtimeMusic } from "./transports/gemini-lyria-realtime.js";
+export type { WeightedPrompt, MusicGenerationConfig, MusicScale, MusicGenerationMode, LyriaRealtimeConfig, LyriaRealtimeSessionOptions, AudioChunk } from "./transports/gemini-lyria-realtime.js";
+export { RealtimeTransport } from "./transports/realtime-transport.js";
+export type { RealtimeConfig, RealtimeTool, RealtimeEvent, RealtimeUsage } from "./transports/realtime-transport.js";
+export { GeminiCacheAPI } from "./transports/gemini-cache-api.js";
+export type { GeminiCachedContent, GeminiCacheCreateOptions } from "./transports/gemini-cache-api.js";
+export { GeminiFileAPI } from "./transports/gemini-file-api.js";
+export type { GeminiFileInfo } from "./transports/gemini-file-api.js";
+export { isDebugTransportEnabled, createDebugTransport } from "./debug-transport.js";

package/dist/types/provider-core/llm-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LLM Client factory 鈥?resolves ProviderDef 鈫?creates LLMTransport instance.
+ *
+ * Replaces the old createAdminInferProxyClient() call chain.
+ * User API key + ProviderDef 鈫?direct provider connection.
+ */
+import type { ProviderDef } from "./provider-def.js";
+import type { LLMTransport } from "./transport.js";
+import { ProviderRegistry } from "./provider-registry.js";
+export interface LLMClientConfig {
+    /** Provider id, e.g. "deepseek" */
+    provider: string;
+    /** Model id, e.g. "deepseek-v4-flash" */
+    model: string;
+    /** User API key */
+    apiKey: string;
+    /** Optional base URL override */
+    baseUrl?: string;
+}
+export interface LLMClient {
+    transport: LLMTransport;
+    apiKey: string;
+    resolvedModel: string;
+    providerDef: ProviderDef;
+}
+/**
+ * Create an LLM client from config + registry.
+ *
+ * 1. Look up provider in registry
+ * 2. Apply baseUrl override if provided
+ * 3. Instantiate the correct transport
+ */
+export declare function createLLMClient(config: LLMClientConfig, registry: ProviderRegistry): LLMClient;
+/**
+ * Auto-detect provider from API key environment variables.
+ * Scans registry for providers whose env vars are set.
+ * Returns the first match.
+ */
+export declare function autoDetectProvider(registry: ProviderRegistry): {
+    providerId: string;
+    apiKey: string;
+    defaultModel: string;
+} | undefined;

package/dist/types/provider-core/media-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Media Client factory 鈥?resolves ProviderDef 鈫?creates MediaTransport instances.
+ *
+ * Parallel to createLLMClient() but for generation models (image/video/music/3D).
+ * Uses the same ProviderRegistry to look up provider config, then instantiates
+ * the correct media transport adapter.
+ *
+ * The MediaClient holds a provider-keyed transport cache so that repeated
+ * generation calls reuse the same adapter instance.
+ */
+import type { MediaTransport } from "./media-transport.js";
+import type { ProviderDef, MediaCapability, ModelInfo } from "./provider-def.js";
+import type { ProviderRegistry } from "./provider-registry.js";
+export interface MediaClientConfig {
+    registry: ProviderRegistry;
+}
+export interface ResolvedMediaModel {
+    providerId: string;
+    providerDef: ProviderDef;
+    modelInfo: ModelInfo;
+    mediaType: MediaCapability;
+}
+export declare class MediaClient {
+    private registry;
+    private transports;
+    constructor(config: MediaClientConfig);
+    /**
+     * Find a specific model by provider + model id for a given media type.
+     * Used by the user-designated model routing (no failover).
+     */
+    resolveModelById(providerId: string, modelId: string, mediaType: MediaCapability): ResolvedMediaModel | undefined;
+    /**
+     * Get a MediaTransport for a specific provider.
+     * Creates and caches the adapter on first access.
+     */
+    getTransport(providerId: string): MediaTransport | undefined;
+    /**
+     * List all available generation models across all providers.
+     */
+    listMediaModels(mediaType?: MediaCapability): ResolvedMediaModel[];
+    private findModelInProvider;
+}