@xiaozhiclaw/provider-core 0.1.0

package/dist/constants.d.ts

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

package/dist/constants.js

@@ -0,0 +1 @@
+export const MEDIA_MAX_UPLOAD_SIZE = 50 * 1024 * 1024;

package/dist/credentials.d.ts

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

package/dist/credentials.js

@@ -0,0 +1,8 @@
+export function resolveApiKey(envVarNames, env = process.env) {
+    for (const name of envVarNames) {
+        const value = env[name];
+        if (value)
+            return value;
+    }
+    return undefined;
+}

package/dist/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/debug-transport.js

@@ -0,0 +1,99 @@
+// ============================================================
+// DebugTransport 鈥?Diagnostic decorator for LLMTransport
+//
+// CC parity: dumpPrompts.ts (request JSONL logging)
+// Wraps any LLMTransport, logging request metadata + timing + usage
+// to a JSONL file at ~/.qlogicagent/debug-logs/{sessionId}.jsonl
+//
+// Enable via: QLOGICAGENT_DEBUG=1 (env var)
+// ============================================================
+import { join } from "node:path";
+import { mkdirSync, appendFileSync } from "node:fs";
+import { getUserDebugLogsDir } from "./paths.js";
+// 鈹€鈹€ Configuration 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+const DEBUG_LOG_DIR = getUserDebugLogsDir();
+/**
+ * Check whether debug transport should be enabled.
+ */
+export function isDebugTransportEnabled() {
+    return process.env.QLOGICAGENT_DEBUG === "1";
+}
+/**
+ * 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 function createDebugTransport(base, sessionId) {
+    const logPath = join(DEBUG_LOG_DIR, `${sessionId}.jsonl`);
+    let dirEnsured = false;
+    function ensureDir() {
+        if (!dirEnsured) {
+            mkdirSync(DEBUG_LOG_DIR, { recursive: true });
+            dirEnsured = true;
+        }
+    }
+    function writeEntry(entry) {
+        try {
+            ensureDir();
+            appendFileSync(logPath, JSON.stringify(entry) + "\n", "utf8");
+        }
+        catch {
+            // Diagnostic logging is best-effort 鈥?never crash the agent
+        }
+    }
+    return {
+        async *stream(request, apiKey, signal) {
+            const startMs = Date.now();
+            // Log request metadata (strip apiKey for safety)
+            writeEntry({
+                type: "request",
+                timestamp: new Date(startMs).toISOString(),
+                model: request.model,
+                messageCount: request.messages.length,
+                toolCount: request.tools?.length ?? 0,
+                toolChoice: request.toolChoice,
+                temperature: request.temperature,
+                maxTokens: request.maxTokens,
+                reasoning: request.reasoning,
+            });
+            let promptTokens = 0;
+            let completionTokens = 0;
+            let reasoningTokens = 0;
+            let finishReason = "";
+            let error;
+            try {
+                for await (const chunk of base.stream(request, apiKey, signal)) {
+                    // Capture usage/done metadata
+                    if (chunk.type === "usage") {
+                        promptTokens = chunk.promptTokens;
+                        completionTokens = chunk.completionTokens;
+                        reasoningTokens = chunk.reasoningTokens ?? 0;
+                    }
+                    else if (chunk.type === "done") {
+                        finishReason = chunk.finishReason;
+                    }
+                    yield chunk;
+                }
+            }
+            catch (err) {
+                error = err instanceof Error ? err.message : String(err);
+                throw err;
+            }
+            finally {
+                const elapsedMs = Date.now() - startMs;
+                writeEntry({
+                    type: "response",
+                    timestamp: new Date().toISOString(),
+                    model: request.model,
+                    elapsedMs,
+                    promptTokens,
+                    completionTokens,
+                    reasoningTokens,
+                    finishReason,
+                    ...(error ? { error } : {}),
+                });
+            }
+        },
+    };
+}

package/dist/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/errors.js

@@ -0,0 +1,12 @@
+export class ProviderCoreError extends Error {
+    status;
+    code;
+    provider;
+    constructor(message, opts) {
+        super(message, { cause: opts?.cause });
+        this.name = "ProviderCoreError";
+        this.status = opts?.status;
+        this.code = opts?.code;
+        this.provider = opts?.provider;
+    }
+}

package/dist/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/events.js

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

package/dist/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/file-upload-service.js

@@ -0,0 +1,110 @@
+/**
+ * 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.
+ */
+// 鈹€鈹€ MIME Detection 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+const EXTENSION_MIME_MAP = {
+    ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+    ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml",
+    ".bmp": "image/bmp", ".avif": "image/avif", ".heic": "image/heic",
+    ".mp4": "video/mp4", ".webm": "video/webm", ".mov": "video/quicktime",
+    ".avi": "video/x-msvideo", ".mkv": "video/x-matroska",
+    ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg",
+    ".aac": "audio/aac", ".flac": "audio/flac", ".m4a": "audio/mp4",
+    ".opus": "audio/opus",
+    ".pdf": "application/pdf",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".txt": "text/plain", ".csv": "text/csv", ".json": "application/json",
+};
+/** Guess MIME type from filename extension. */
+export function guessMimeType(filename) {
+    const ext = filename.slice(filename.lastIndexOf(".")).toLowerCase();
+    return EXTENSION_MIME_MAP[ext] || "application/octet-stream";
+}
+// 鈹€鈹€ Local URL Detection 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+const LOCAL_URL_RE = /^https?:\/\/(127\.0\.0\.1|localhost|0\.0\.0\.0|\[::1\])(:\d+)?/i;
+/** Check if a URL points to a local/private address that cloud APIs cannot reach. */
+export function isLocalUrl(url) {
+    return LOCAL_URL_RE.test(url);
+}
+// 鈹€鈹€ Core Resolution 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+/**
+ * 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 async function resolveLocalMedia(url, adapter, apiKey, signal) {
+    // Already a data URL 鈥?should not happen in new architecture, but handle gracefully
+    if (url.startsWith("data:"))
+        return url;
+    // Public URL 鈥?LLM API can fetch directly, no upload needed
+    if (!isLocalUrl(url))
+        return url;
+    // Local URL 鈥?fetch content and upload to provider
+    const res = await fetch(url, { signal });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch local media ${url}: ${res.status}`);
+    }
+    const buffer = Buffer.from(await res.arrayBuffer());
+    const filename = extractFilename(url);
+    const contentType = res.headers.get("content-type") || guessMimeType(filename);
+    const result = await adapter.uploadFile(buffer, filename, contentType, apiKey, signal);
+    return result.url;
+}
+/**
+ * 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 async function resolveLocalMediaBatch(urls, adapter, apiKey, signal, concurrency = 3) {
+    if (urls.length <= concurrency) {
+        // All fit within concurrency limit 鈥?resolve all at once
+        return Promise.all(urls.map((url) => resolveLocalMedia(url, adapter, apiKey, signal)));
+    }
+    // Concurrency-limited parallel uploads
+    const results = new Array(urls.length);
+    let nextIndex = 0;
+    const worker = async () => {
+        while (nextIndex < urls.length) {
+            const i = nextIndex++;
+            results[i] = await resolveLocalMedia(urls[i], adapter, apiKey, signal);
+        }
+    };
+    await Promise.all(Array.from({ length: concurrency }, () => worker()));
+    return results;
+}
+// 鈹€鈹€ Helpers 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+function extractFilename(url) {
+    try {
+        const pathname = new URL(url).pathname;
+        const last = pathname.split("/").pop();
+        return last && last.includes(".") ? last : "upload";
+    }
+    catch {
+        return "upload";
+    }
+}

package/dist/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/gemini-schema-utils.js

@@ -0,0 +1,76 @@
+/**
+ * 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 const GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS = new Set([
+    "patternProperties",
+    "additionalProperties",
+    "$schema",
+    "$id",
+    "$ref",
+    "$defs",
+    "definitions",
+    "examples",
+    "minLength",
+    "maxLength",
+    "minimum",
+    "maximum",
+    "multipleOf",
+    "pattern",
+    "format",
+    "minItems",
+    "maxItems",
+    "uniqueItems",
+    "minProperties",
+    "maxProperties",
+    "const",
+]);
+/**
+ * Recursively strip unsupported JSON Schema keywords from a schema object.
+ * Safe to call multiple times (idempotent).
+ */
+export function cleanSchemaForGemini(schema) {
+    if (!schema || typeof schema !== "object") {
+        return schema;
+    }
+    if (Array.isArray(schema)) {
+        return schema.map((item) => cleanSchemaForGemini(item));
+    }
+    const record = schema;
+    const cleaned = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS.has(key))
+            continue;
+        if (key === "properties" && value && typeof value === "object" && !Array.isArray(value)) {
+            cleaned[key] = Object.fromEntries(Object.entries(value).map(([nestedKey, nestedValue]) => [nestedKey, cleanSchemaForGemini(nestedValue)]));
+            continue;
+        }
+        if (key === "items" && value && typeof value === "object") {
+            cleaned[key] = Array.isArray(value)
+                ? value.map((item) => cleanSchemaForGemini(item))
+                : cleanSchemaForGemini(value);
+            continue;
+        }
+        if ((key === "anyOf" || key === "oneOf" || key === "allOf") && Array.isArray(value)) {
+            cleaned[key] = value.map((item) => cleanSchemaForGemini(item));
+            continue;
+        }
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            cleaned[key] = cleanSchemaForGemini(value);
+            continue;
+        }
+        if (Array.isArray(value)) {
+            cleaned[key] = value.map((item) => cleanSchemaForGemini(item));
+            continue;
+        }
+        cleaned[key] = value;
+    }
+    return cleaned;
+}

package/dist/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, 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";
+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 { 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";
+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/index.js

@@ -0,0 +1,33 @@
+/**
+ * LLM Provider layer 鈥?public API surface.
+ *
+ * Provides: ProviderDef + LLMTransport + ProviderRegistry + LLMClient factory
+ */
+export { accumulateToolCalls } from "./transport.js";
+export { ProviderCoreError } from "./errors.js";
+export { resolveApiKey } from "./credentials.js";
+export { isAsyncMediaTransport } from "./media-transport.js";
+export { MediaClient } from "./media-client.js";
+// Registry
+export { ProviderRegistry } from "./provider-registry.js";
+export { BUILTIN_PROVIDERS } from "./builtin-providers.js";
+export { ProviderVariantResolver } from "./provider-variant-resolver.js";
+export { createLLMClient } from "./llm-client.js";
+// Transports (chat)
+export { OpenAIChatTransport } from "./transports/openai-chat.js";
+export { AnthropicMessagesTransport } from "./transports/anthropic-messages.js";
+export { GeminiGenerateContentTransport } from "./transports/gemini-generatecontent.js";
+// Transports (media generation)
+export { VolcengineMediaTransport } from "./transports/volcengine-media.js";
+export { OpenAIMediaTransport } from "./transports/openai-media.js";
+export { MiniMaxMediaTransport } from "./transports/minimax-media.js";
+export { GeminiMediaTransport } from "./transports/gemini-media.js";
+// Gemini Lyria RealTime (WebSocket streaming music)
+export { GeminiLyriaRealtimeSession, generateRealtimeMusic } from "./transports/gemini-lyria-realtime.js";
+// OpenAI Realtime (WebSocket bidirectional audio/voice)
+export { RealtimeTransport } from "./transports/realtime-transport.js";
+// Gemini utility APIs (Context Caching + File API)
+export { GeminiCacheAPI } from "./transports/gemini-cache-api.js";
+export { GeminiFileAPI } from "./transports/gemini-file-api.js";
+// Debug
+export { isDebugTransportEnabled, createDebugTransport } from "./debug-transport.js";

package/dist/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;