@xiaozhiclaw/provider-core 0.1.0

package/dist/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/adapters/aliyun-oss-file-upload-adapter.js

@@ -0,0 +1,96 @@
+/**
+ * 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 { createHmac, randomUUID } from "node:crypto";
+/**
+ * Create an AliyunOSSFileUploadAdapter from environment variables.
+ * Returns undefined if required env vars (OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET) are missing.
+ */
+export function createAliyunOSSAdapterFromEnv() {
+    const accessKeyId = (process.env.OSS_ACCESS_KEY_ID ?? process.env.ALIYUN_OSS_ACCESS_KEY_ID ?? "").trim();
+    const accessKeySecret = (process.env.OSS_ACCESS_KEY_SECRET ?? process.env.ALIYUN_OSS_ACCESS_KEY_SECRET ?? "").trim();
+    if (!accessKeyId || !accessKeySecret)
+        return undefined;
+    return new AliyunOSSFileUploadAdapter({
+        accessKeyId,
+        accessKeySecret,
+        bucket: (process.env.OSS_BUCKET ?? process.env.ALIYUN_OSS_BUCKET ?? "qlogicagent").trim(),
+        region: (process.env.OSS_REGION ?? process.env.ALIYUN_OSS_REGION ?? "cn-beijing").trim(),
+        endpoint: (process.env.OSS_ENDPOINT ?? "").trim() || undefined,
+    });
+}
+export class AliyunOSSFileUploadAdapter {
+    config;
+    constructor(config) {
+        const bucket = config.bucket || "qlogicagent";
+        const region = config.region || "cn-beijing";
+        this.config = {
+            accessKeyId: config.accessKeyId,
+            accessKeySecret: config.accessKeySecret,
+            bucket,
+            region,
+            endpoint: config.endpoint || `${bucket}.oss-${region}.aliyuncs.com`,
+            pathPrefix: config.pathPrefix || "media",
+            timeoutMs: config.timeoutMs ?? 120_000,
+        };
+    }
+    async uploadFile(buffer, filename, mimeType, _apiKey, signal) {
+        // Generate unique object key: media/2026-05-20/a1b2c3d4_filename.png
+        const date = new Date().toISOString().slice(0, 10); // 2026-05-20
+        const uid = randomUUID().slice(0, 8);
+        const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_");
+        const objectKey = `${this.config.pathPrefix}/${date}/${uid}_${safeName}`;
+        // Build request
+        const url = `https://${this.config.endpoint}/${objectKey}`;
+        const dateStr = new Date().toUTCString();
+        // OSS V1 Signature
+        const stringToSign = [
+            "PUT",
+            "", // Content-MD5 (optional)
+            mimeType,
+            dateStr,
+            `/${this.config.bucket}/${objectKey}`,
+        ].join("\n");
+        const signature = createHmac("sha1", this.config.accessKeySecret)
+            .update(stringToSign)
+            .digest("base64");
+        const headers = {
+            "Date": dateStr,
+            "Content-Type": mimeType,
+            "Content-Length": String(buffer.byteLength),
+            "Authorization": `OSS ${this.config.accessKeyId}:${signature}`,
+        };
+        const res = await fetch(url, {
+            method: "PUT",
+            headers,
+            body: buffer,
+            signal: signal ?? AbortSignal.timeout(this.config.timeoutMs),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Aliyun OSS upload failed ${res.status}: ${body.slice(0, 300)}`);
+        }
+        return {
+            url,
+            fileId: objectKey,
+            filename: safeName,
+            bytes: buffer.byteLength,
+            mimeType,
+            provider: "aliyun-oss",
+        };
+    }
+}

package/dist/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/adapters/gemini-file-upload-adapter.js

@@ -0,0 +1,92 @@
+/**
+ * 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.
+ */
+export class GeminiFileUploadAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async uploadFile(buffer, filename, mimeType, apiKey, signal) {
+        const timeout = this.config.timeoutMs ?? 180_000;
+        const effectiveSignal = signal ?? AbortSignal.timeout(timeout);
+        // Step 1: Initiate resumable upload
+        const uploadInitUrl = this.config.baseUrl.replace(/(\/v1beta)$/, "/upload$1/files");
+        const initRes = await fetch(uploadInitUrl, {
+            method: "POST",
+            headers: {
+                "x-goog-api-key": apiKey,
+                "X-Goog-Upload-Protocol": "resumable",
+                "X-Goog-Upload-Command": "start",
+                "X-Goog-Upload-Header-Content-Length": String(buffer.length),
+                "X-Goog-Upload-Header-Content-Type": mimeType,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ file: { display_name: filename } }),
+            signal: effectiveSignal,
+        });
+        if (!initRes.ok) {
+            const text = await initRes.text().catch(() => "");
+            throw new Error(`Gemini file upload init failed (${initRes.status}): ${text.slice(0, 500)}`);
+        }
+        const uploadUrl = initRes.headers.get("x-goog-upload-url");
+        if (!uploadUrl) {
+            throw new Error("Gemini file upload: missing x-goog-upload-url in response");
+        }
+        // Step 2: Upload bytes
+        const uploadRes = await fetch(uploadUrl, {
+            method: "PUT",
+            headers: {
+                "Content-Length": String(buffer.length),
+                "X-Goog-Upload-Offset": "0",
+                "X-Goog-Upload-Command": "upload, finalize",
+            },
+            body: buffer,
+            signal: effectiveSignal,
+        });
+        if (!uploadRes.ok) {
+            const text = await uploadRes.text().catch(() => "");
+            throw new Error(`Gemini file upload failed (${uploadRes.status}): ${text.slice(0, 500)}`);
+        }
+        const data = await uploadRes.json();
+        const fileInfo = data.file;
+        // Wait for processing if video/audio (they start in PROCESSING state)
+        if (fileInfo.state === "PROCESSING") {
+            await this.waitForProcessing(fileInfo.name, apiKey, effectiveSignal);
+        }
+        return {
+            url: fileInfo.uri, // e.g. "https://generativelanguage.googleapis.com/v1beta/files/abc123"
+            fileId: fileInfo.name,
+            filename,
+            bytes: parseInt(fileInfo.sizeBytes ?? "0", 10) || buffer.length,
+            mimeType,
+            provider: "gemini",
+        };
+    }
+    async waitForProcessing(fileName, apiKey, signal, maxRetries = 30) {
+        const getUrl = `${this.config.baseUrl}/files/${fileName.replace("files/", "")}`;
+        for (let i = 0; i < maxRetries; i++) {
+            await new Promise((r) => setTimeout(r, 2000));
+            if (signal.aborted)
+                throw new Error("Upload aborted during processing wait");
+            const res = await fetch(`${getUrl}?key=${apiKey}`, { signal });
+            if (!res.ok)
+                continue;
+            const data = await res.json();
+            if (data.state === "ACTIVE")
+                return;
+            if (data.state === "FAILED")
+                throw new Error("Gemini file processing failed");
+        }
+        // If we exhaust retries, proceed anyway 鈥?LLM might still accept it
+    }
+}

package/dist/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/adapters/hub-oss-file-upload-adapter.js

@@ -0,0 +1,53 @@
+/**
+ * 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/..." }
+ */
+export class HubOSSFileUploadAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async uploadFile(buffer, filename, mimeType, _apiKey, signal) {
+        const hubBaseUrl = this.config.hubBaseUrl.replace(/\/+$/, "");
+        const url = `${hubBaseUrl}/api/v1/files/upload`;
+        const formData = new FormData();
+        const blob = new Blob([buffer], { type: mimeType });
+        formData.append("file", blob, filename);
+        formData.append("purpose", "llm_input");
+        const headers = {};
+        if (this.config.hubApiKey) {
+            headers["Authorization"] = `Bearer ${this.config.hubApiKey}`;
+        }
+        const res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: formData,
+            signal: signal ?? AbortSignal.timeout(this.config.timeoutMs ?? 120_000),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Hub OSS upload failed ${res.status}: ${body.slice(0, 200)}`);
+        }
+        const json = await res.json();
+        if (!json.url) {
+            throw new Error("Hub OSS upload response missing 'url' field");
+        }
+        return {
+            url: json.url,
+            fileId: json.fileId ?? filename,
+            filename,
+            bytes: json.bytes ?? buffer.byteLength,
+            mimeType,
+            provider: this.config.provider ?? "hub-oss",
+        };
+    }
+}

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

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

package/dist/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/adapters/openai-file-upload-adapter.js

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+export class OpenAIFileUploadAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async uploadFile(buffer, filename, mimeType, apiKey, signal) {
+        const baseUrl = this.config.baseUrl.replace(/\/+$/, "");
+        // Handle both "/v1" and non-versioned base URLs
+        const hasVersion = /\/v\d+$/.test(baseUrl);
+        const url = hasVersion ? `${baseUrl}/files` : `${baseUrl}/v1/files`;
+        const formData = new FormData();
+        const blob = new Blob([buffer], { type: mimeType });
+        formData.append("file", blob, filename);
+        formData.append("purpose", this.config.defaultPurpose ?? "file-extract");
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                ...this.config.extraHeaders,
+            },
+            body: formData,
+            signal: signal ?? AbortSignal.timeout(this.config.timeoutMs ?? 120_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => "");
+            throw new Error(`File upload to ${this.config.provider} failed (${res.status}): ${errText}`);
+        }
+        const data = await res.json();
+        const fileId = String(data.id ?? "");
+        // Some providers return download_url or url directly
+        const directUrl = String(data.download_url ?? data.url ?? data.file_url ?? "");
+        return {
+            url: directUrl || fileId, // If no URL, file_id is used as reference
+            fileId,
+            filename: String(data.filename ?? filename),
+            bytes: Number(data.bytes ?? buffer.byteLength),
+            mimeType,
+            provider: this.config.provider,
+        };
+    }
+}

package/dist/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/adapters/volcengine-file-upload-adapter.js

@@ -0,0 +1,45 @@
+/**
+ * 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.
+ */
+export class VolcengineFileUploadAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async uploadFile(buffer, filename, mimeType, apiKey, signal) {
+        const baseUrl = this.config.baseUrl.replace(/\/+$/, "");
+        const url = `${baseUrl}/v3/files`;
+        const formData = new FormData();
+        const blob = new Blob([buffer], { type: mimeType });
+        formData.append("file", blob, filename);
+        formData.append("purpose", this.config.defaultPurpose ?? "user_data");
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}` },
+            body: formData,
+            signal: signal ?? AbortSignal.timeout(this.config.timeoutMs ?? 120_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => "");
+            throw new Error(`Volcengine file upload failed (${res.status}): ${errText}`);
+        }
+        const data = await res.json();
+        const fileId = String(data.id ?? "");
+        return {
+            // Volcengine uses file_id reference in messages, not a direct URL
+            url: fileId,
+            fileId,
+            filename,
+            bytes: buffer.byteLength,
+            mimeType,
+            provider: "volcengine",
+        };
+    }
+}

package/dist/builtin-providers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Curated Provider Core model catalog.
+ *
+ * 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[];