@jsonstudio/rcc 0.85.9

package/dist/server/utils/non-blocking-error-logger.js

@@ -0,0 +1,80 @@
+import fs from 'fs/promises';
+import fsSync from 'fs';
+import os from 'os';
+import path from 'path';
+const DEFAULT_LOG_DIR = path.join(os.homedir(), '.routecodex', 'logs');
+const DEFAULT_LOG_PATH = path.join(DEFAULT_LOG_DIR, 'non-blocking-errors.log');
+function resolveLogPath() {
+    const envPath = process.env.ROUTECODEX_INTERNAL_ERROR_LOG || process.env.RCC_INTERNAL_ERROR_LOG;
+    if (envPath && typeof envPath === 'string') {
+        return envPath;
+    }
+    return DEFAULT_LOG_PATH;
+}
+function serializeError(error) {
+    if (!error) {
+        return { message: 'unknown' };
+    }
+    if (error instanceof Error) {
+        const out = {
+            name: error.name,
+            message: error.message
+        };
+        if (error.code) {
+            out.code = error.code;
+        }
+        if (error.stack) {
+            out.stack = error.stack;
+        }
+        return out;
+    }
+    if (typeof error === 'object') {
+        try {
+            return {
+                message: JSON.stringify(error)
+            };
+        }
+        catch {
+            return { message: String(error) };
+        }
+    }
+    return { message: String(error) };
+}
+/**
+ * 记录非阻塞错误到独立 JSONL 文件中，绝不向调用方抛出异常
+ */
+export async function logNonBlockingError(meta, error) {
+    try {
+        const logPath = resolveLogPath();
+        const dir = path.dirname(logPath);
+        if (!fsSync.existsSync(dir)) {
+            await fs.mkdir(dir, { recursive: true });
+        }
+        const record = {
+            ts: new Date().toISOString(),
+            level: meta.level || 'warn',
+            component: meta.component,
+            operation: meta.operation,
+            requestId: meta.requestId,
+            entryEndpoint: meta.entryEndpoint,
+            meta,
+            error: serializeError(error)
+        };
+        await fs.appendFile(logPath, JSON.stringify(record) + '\n', 'utf-8');
+    }
+    catch {
+        // 最后兜底：不打断主流程，必要时可以考虑加一次性 console.error，但避免刷屏
+    }
+}
+/**
+ * 运行一个“非阻塞”操作，失败时记录错误但不抛出
+ */
+export async function runNonBlocking(meta, fn) {
+    try {
+        await fn();
+    }
+    catch (error) {
+        await logNonBlockingError(meta, error);
+    }
+}
+//# sourceMappingURL=non-blocking-error-logger.js.map

package/dist/server/utils/non-blocking-error-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-blocking-error-logger.js","sourceRoot":"","sources":["../../../src/server/utils/non-blocking-error-logger.ts"],"names":[],"mappings":"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"}

package/dist/server/utils/port-resolver.d.ts

@@ -0,0 +1,5 @@
+export declare function resolvePortForMode(params: {
+    mode: 'dev' | 'release';
+    cliPort?: number | null;
+    configPort?: number | null;
+}): number;

package/dist/server/utils/port-resolver.js

@@ -0,0 +1,14 @@
+export function resolvePortForMode(params) {
+    const { mode, cliPort, configPort } = params;
+    // CLI override always wins if provided and valid
+    if (typeof cliPort === 'number' && Number.isFinite(cliPort) && cliPort > 0)
+        return cliPort;
+    if (mode === 'dev') {
+        return 5555; // dev 固定默认端口
+    }
+    // release 模式必须从配置读取，缺失则 Fail Fast
+    if (typeof configPort === 'number' && Number.isFinite(configPort) && configPort > 0)
+        return configPort;
+    throw new Error('httpserver.port is required in release mode');
+}
+//# sourceMappingURL=port-resolver.js.map

package/dist/server/utils/port-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-resolver.js","sourceRoot":"","sources":["../../../src/server/utils/port-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,MAIlC;IACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC7C,iDAAiD;IACjD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3F,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,CAAC,aAAa;IAC5B,CAAC;IACD,kCAAkC;IAClC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACvG,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACjE,CAAC"}

package/dist/server/utils/stage-logger.d.ts

@@ -0,0 +1,2 @@
+export declare function isStageLoggingEnabled(): boolean;
+export declare function logPipelineStage(stage: string, requestId: string, details?: Record<string, unknown>): void;

package/dist/server/utils/stage-logger.js

@@ -0,0 +1,71 @@
+const truthy = new Set(['1', 'true', 'yes']);
+const falsy = new Set(['0', 'false', 'no']);
+let cachedStageLoggingFlag = null;
+const COLOR_RESET = '\x1b[0m';
+const COLOR_INFO = '\x1b[90m';
+const COLOR_START = '\x1b[36m';
+const COLOR_SUCCESS = '\x1b[32m';
+const COLOR_ERROR = '\x1b[31m';
+function computeStageLoggingEnabled() {
+    const raw = String(process.env.ROUTECODEX_STAGE_LOG || '').trim().toLowerCase();
+    if (truthy.has(raw)) {
+        return true;
+    }
+    if (falsy.has(raw)) {
+        return false;
+    }
+    const nodeEnv = String(process.env.NODE_ENV || '').trim().toLowerCase();
+    return nodeEnv === 'development';
+}
+export function isStageLoggingEnabled() {
+    if (cachedStageLoggingFlag === null) {
+        cachedStageLoggingFlag = computeStageLoggingEnabled();
+    }
+    return cachedStageLoggingFlag;
+}
+export function logPipelineStage(stage, requestId, details) {
+    if (!isStageLoggingEnabled()) {
+        return;
+    }
+    const suffix = details && Object.keys(details).length ? ` ${JSON.stringify(details)}` : '';
+    const { scope, action } = parseStage(stage);
+    const level = detectStageLevel(stage);
+    const label = `[${scope}][${requestId}] ${action}`;
+    console.log(`${colorize(level, label)}${suffix}`);
+}
+function parseStage(stage) {
+    const segments = stage.split('.').filter(Boolean);
+    if (segments.length <= 1) {
+        return { scope: 'pipeline', action: segments[0] || stage };
+    }
+    return {
+        scope: segments.slice(0, -1).join('.'),
+        action: segments[segments.length - 1]
+    };
+}
+function detectStageLevel(stage) {
+    const normalized = stage.toLowerCase();
+    if (normalized.includes('error') || normalized.includes('fail')) {
+        return 'error';
+    }
+    if (normalized.includes('completed') || normalized.includes('end')) {
+        return 'success';
+    }
+    if (normalized.includes('start') || normalized.includes('prepare')) {
+        return 'start';
+    }
+    return 'info';
+}
+function colorize(level, text) {
+    switch (level) {
+        case 'start':
+            return `${COLOR_START}${text}${COLOR_RESET}`;
+        case 'success':
+            return `${COLOR_SUCCESS}${text}${COLOR_RESET}`;
+        case 'error':
+            return `${COLOR_ERROR}${text}${COLOR_RESET}`;
+        default:
+            return `${COLOR_INFO}${text}${COLOR_RESET}`;
+    }
+}
+//# sourceMappingURL=stage-logger.js.map

package/dist/server/utils/stage-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-logger.js","sourceRoot":"","sources":["../../../src/server/utils/stage-logger.ts"],"names":[],"mappings":"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"}

package/dist/server-factory.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Server Factory - 服务器工厂
+ *
+ * 提供V1和V2服务器的统一创建接口
+ * 支持渐进式切换，零风险部署
+ */
+import type { ServerConfig } from './server/RouteCodexServer.js';
+type ServerConfigV2 = any;
+/**
+ * 服务器创建选项
+ */
+export interface ServerCreateOptions {
+    useV2?: boolean;
+    fallbackToV1?: boolean;
+    config?: {
+        v2HooksEnabled?: boolean;
+        v2MiddlewareEnabled?: boolean;
+    };
+}
+/**
+ * 服务器实例接口
+ */
+export interface ServerInstance {
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): any;
+    isInitialized(): boolean;
+    isRunning(): boolean;
+}
+/**
+ * 服务器工厂类
+ */
+export declare class ServerFactory {
+    private static v1Instance?;
+    private static v2Instance?;
+    /**
+     * 创建服务器实例
+     * 根据配置自动选择V1或V2，默认V1
+     */
+    static createServer(config: ServerConfig | ServerConfigV2, options?: ServerCreateOptions): Promise<ServerInstance>;
+    /**
+     * 创建V1服务器实例
+     */
+    static createV1Server(config: ServerConfig, options?: ServerCreateOptions): Promise<ServerInstance>;
+    /**
+     * 创建V2服务器实例
+     */
+    static createV2Server(config: ServerConfigV2, options?: ServerCreateOptions): Promise<ServerInstance>;
+    /**
+     * 测试专用：创建V2服务器实例
+     */
+    static createV2ServerForTest(config?: Partial<ServerConfigV2>): Promise<ServerInstance>;
+    /**
+     * 生产专用：创建V1服务器实例
+     */
+    static createV1ServerForProduction(config: ServerConfig): Promise<ServerInstance>;
+    /**
+     * 获取当前实例状态
+     */
+    static getInstanceStatus(): {
+        v1Created: boolean;
+        v2Created: boolean;
+        v1Initialized: boolean;
+        v2Initialized: boolean;
+    };
+    /**
+     * 清理实例缓存
+     */
+    static clearInstances(): void;
+    /**
+     * 强制重新创建实例
+     */
+    static recreateServer(config: ServerConfig | ServerConfigV2, options?: ServerCreateOptions): Promise<ServerInstance>;
+    /**
+     * 获取V1实例 (单例)
+     */
+    static getV1Instance(): ServerInstance | undefined;
+    /**
+     * 获取V2实例 (单例)
+     */
+    static getV2Instance(): ServerInstance | undefined;
+}
+/**
+ * 便捷函数：创建服务器
+ */
+export declare function createRouteCodexServer(config: ServerConfig | ServerConfigV2, options?: ServerCreateOptions): Promise<ServerInstance>;
+/**
+ * 便捷函数：创建V1服务器
+ */
+export declare function createV1Server(config: ServerConfig): Promise<ServerInstance>;
+/**
+ * 便捷函数：创建V2服务器
+ */
+export declare function createV2Server(config: ServerConfigV2): Promise<ServerInstance>;
+export { ServerFactory as default };

package/dist/server-factory.js

@@ -0,0 +1,201 @@
+/**
+ * Server Factory - 服务器工厂
+ *
+ * 提供V1和V2服务器的统一创建接口
+ * 支持渐进式切换，零风险部署
+ */
+import { LOCAL_HOSTS } from './constants/index.js';
+/**
+ * 服务器工厂类
+ */
+export class ServerFactory {
+    static v1Instance;
+    static v2Instance;
+    /**
+     * 创建服务器实例
+     * 根据配置自动选择V1或V2，默认V1
+     */
+    static async createServer(config, options = {}) {
+        // 新开关：ROUTECODEX_PIPELINE_MODE=dynamic|static（默认dynamic）
+        const modeEnv = String(process.env.ROUTECODEX_PIPELINE_MODE || process.env.RCC_PIPELINE_MODE || '').trim().toLowerCase();
+        const resolveUseV2 = () => {
+            if (modeEnv === 'dynamic' || modeEnv === 'v2')
+                return true;
+            if (modeEnv === 'static' || modeEnv === 'v1')
+                return false;
+            const legacy = String(process.env.ROUTECODEX_USE_V2 || '').trim().toLowerCase();
+            if (legacy === 'true' || legacy === '1') {
+                console.warn('[ServerFactory] ROUTECODEX_USE_V2 已弃用，请使用 ROUTECODEX_PIPELINE_MODE=dynamic|static');
+                return true;
+            }
+            if (legacy === 'false' || legacy === '0') {
+                console.warn('[ServerFactory] ROUTECODEX_USE_V2 已弃用，请使用 ROUTECODEX_PIPELINE_MODE=dynamic|static');
+                return false;
+            }
+            return true; // 默认动态（V2）
+        };
+        const useV2 = options.useV2 ?? resolveUseV2();
+        // 全局禁用降级（Fail Fast）：如果V2启用但创建失败，直接抛错，不再回退到V1
+        const fallbackToV1 = false;
+        console.log(`[ServerFactory] Creating server instance (V2: ${useV2}, Fallback: ${fallbackToV1})`);
+        if (useV2) {
+            try {
+                const v2Server = await this.createV2Server(config, options);
+                console.log('[ServerFactory] V2 server created successfully');
+                return v2Server;
+            }
+            catch (error) {
+                console.error('[ServerFactory] Failed to create V2 server:', error);
+                // 不再降级
+                throw error;
+            }
+        }
+        else {
+            return await this.createV1Server(config, options);
+        }
+    }
+    /**
+     * 创建V1服务器实例
+     */
+    static async createV1Server(config, options = {}) {
+        if (!ServerFactory.v1Instance) {
+            console.log('[ServerFactory] Creating V1 server instance');
+            try {
+                // 动态导入V1实现
+                const { RouteCodexServer } = await import('./server/RouteCodexServer.js');
+                ServerFactory.v1Instance = new RouteCodexServer(config);
+                console.log('[ServerFactory] V1 server instance created');
+            }
+            catch (error) {
+                console.error('[ServerFactory] Failed to create V1 server:', error);
+                throw new Error(`Failed to create V1 server: ${error.message}`);
+            }
+        }
+        return ServerFactory.v1Instance;
+    }
+    /**
+     * 创建V2服务器实例
+     */
+    static async createV2Server(config, options = {}) {
+        if (!ServerFactory.v2Instance) {
+            console.log('[ServerFactory] Creating V2 server instance');
+            try {
+                // 动态导入V2实现
+                const { RouteCodexHttpServer } = await import('./server/runtime/http-server.js');
+                // 合并V2配置
+                const v2Config = {
+                    ...config,
+                    v2Config: {
+                        enableHooks: options.config?.v2HooksEnabled ?? true,
+                        enableMiddleware: options.config?.v2MiddlewareEnabled ?? true,
+                        ...config.v2Config
+                    }
+                };
+                ServerFactory.v2Instance = new RouteCodexHttpServer(v2Config);
+                console.log('[ServerFactory] V2 server instance created');
+            }
+            catch (error) {
+                console.error('[ServerFactory] Failed to create V2 server:', error);
+                throw new Error(`Failed to create V2 server: ${error.message}`);
+            }
+        }
+        return ServerFactory.v2Instance;
+    }
+    /**
+     * 测试专用：创建V2服务器实例
+     */
+    static async createV2ServerForTest(config) {
+        const defaultConfig = {
+            server: {
+                port: 5507, // 使用不同端口避免冲突
+                host: LOCAL_HOSTS.IPV4,
+                useV2: true
+            },
+            logging: {
+                level: 'debug',
+                enableConsole: true
+            },
+            providers: {},
+            v2Config: {
+                enableHooks: true,
+                enableMiddleware: true
+            }
+        };
+        const finalConfig = { ...defaultConfig, ...config };
+        return await this.createV2Server(finalConfig, { useV2: true, fallbackToV1: false });
+    }
+    /**
+     * 生产专用：创建V1服务器实例
+     */
+    static async createV1ServerForProduction(config) {
+        return await this.createV1Server(config, { useV2: false, fallbackToV1: false });
+    }
+    /**
+     * 获取当前实例状态
+     */
+    static getInstanceStatus() {
+        return {
+            v1Created: !!ServerFactory.v1Instance,
+            v2Created: !!ServerFactory.v2Instance,
+            v1Initialized: ServerFactory.v1Instance?.isInitialized() ?? false,
+            v2Initialized: ServerFactory.v2Instance?.isInitialized() ?? false
+        };
+    }
+    /**
+     * 清理实例缓存
+     */
+    static clearInstances() {
+        console.log('[ServerFactory] Clearing server instances cache');
+        if (ServerFactory.v1Instance) {
+            console.log('[ServerFactory] Clearing V1 instance');
+            ServerFactory.v1Instance = undefined;
+        }
+        if (ServerFactory.v2Instance) {
+            console.log('[ServerFactory] Clearing V2 instance');
+            ServerFactory.v2Instance = undefined;
+        }
+    }
+    /**
+     * 强制重新创建实例
+     */
+    static async recreateServer(config, options = {}) {
+        console.log('[ServerFactory] Recreating server instances');
+        // 清理现有实例
+        ServerFactory.clearInstances();
+        // 创建新实例
+        return await ServerFactory.createServer(config, options);
+    }
+    /**
+     * 获取V1实例 (单例)
+     */
+    static getV1Instance() {
+        return ServerFactory.v1Instance;
+    }
+    /**
+     * 获取V2实例 (单例)
+     */
+    static getV2Instance() {
+        return ServerFactory.v2Instance;
+    }
+}
+/**
+ * 便捷函数：创建服务器
+ */
+export function createRouteCodexServer(config, options = {}) {
+    return ServerFactory.createServer(config, options);
+}
+/**
+ * 便捷函数：创建V1服务器
+ */
+export function createV1Server(config) {
+    return ServerFactory.createV1Server(config);
+}
+/**
+ * 便捷函数：创建V2服务器
+ */
+export function createV2Server(config) {
+    return ServerFactory.createV2Server(config);
+}
+// 导出工厂类和便捷函数
+export { ServerFactory as default };
+//# sourceMappingURL=server-factory.js.map

package/dist/server-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-factory.js","sourceRoot":"","sources":["../src/server-factory.ts"],"names":[],"mappings":"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"}

package/dist/tools/provider-update/auth-headers.d.ts

@@ -0,0 +1,2 @@
+import type { AuthConfig } from './types.js';
+export declare function buildAuthHeaders(auth?: AuthConfig): Record<string, string>;

package/dist/tools/provider-update/auth-headers.js

@@ -0,0 +1,11 @@
+export function buildAuthHeaders(auth) {
+    if (!auth || auth.type !== 'apikey')
+        return {};
+    const key = (auth.apiKey || '').trim();
+    if (!key)
+        return {};
+    const headerName = (auth.headerName || 'Authorization').trim();
+    const prefix = (auth.prefix || 'Bearer').trim();
+    return { [headerName]: `${prefix} ${key}` };
+}
+//# sourceMappingURL=auth-headers.js.map

package/dist/tools/provider-update/auth-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-headers.js","sourceRoot":"","sources":["../../../src/tools/provider-update/auth-headers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,EAAE,EAAE,CAAC;AAC9C,CAAC"}

package/dist/tools/provider-update/blacklist.d.ts

@@ -0,0 +1,3 @@
+import type { BlacklistFile } from './types.js';
+export declare function readBlacklist(file: string): BlacklistFile;
+export declare function writeBlacklist(file: string, data: BlacklistFile): void;

package/dist/tools/provider-update/blacklist.js

@@ -0,0 +1,23 @@
+import fs from 'fs';
+import path from 'path';
+export function readBlacklist(file) {
+    try {
+        if (fs.existsSync(file)) {
+            const txt = fs.readFileSync(file, 'utf-8');
+            const j = JSON.parse(txt);
+            const models = Array.isArray(j?.models) ? j.models.map((x) => String(x)) : [];
+            return { models, updatedAt: Number(j?.updatedAt || Date.now()) };
+        }
+    }
+    catch { /* ignore */ }
+    return { models: [], updatedAt: Date.now() };
+}
+export function writeBlacklist(file, data) {
+    try {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+    }
+    catch { /* ignore */ }
+    const out = { models: Array.from(new Set(data.models)).sort(), updatedAt: Date.now() };
+    fs.writeFileSync(file, JSON.stringify(out, null, 2), 'utf-8');
+}
+//# sourceMappingURL=blacklist.js.map

package/dist/tools/provider-update/blacklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blacklist.js","sourceRoot":"","sources":["../../../src/tools/provider-update/blacklist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAmB;IAC9D,IAAI,CAAC;QAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACrF,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACtG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/tools/provider-update/config-builder.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderInputConfig } from './types.js';
+type JsonObject = Record<string, any>;
+export type BuildConfigArgs = {
+    providerId: string;
+    provider: ProviderInputConfig;
+    modelsFiltered: string[];
+    outputPath: string;
+};
+export declare function buildOrUpdateProviderConfig(args: BuildConfigArgs): {
+    config: JsonObject;
+    summary: {
+        added: string[];
+        removed: string[];
+        kept: string[];
+        completedWithTemplates: string[];
+    };
+};
+export {};