@jsonstudio/rcc 0.89.1960 → 0.89.2195

package/dist/providers/core/runtime/runtime-endpoint-resolver.js

@@ -0,0 +1,64 @@
+import { DynamicProfileLoader } from '../config/service-profiles.js';
+export class RuntimeEndpointResolver {
+    static resolveEffectiveBaseUrl(input) {
+        const runtimeEndpoint = RuntimeEndpointResolver.pickRuntimeBaseUrl(input.runtime);
+        const candidates = [
+            runtimeEndpoint,
+            input.runtime?.baseUrl,
+            input.overrideBaseUrl,
+            input.configBaseUrl,
+            input.serviceDefaultBaseUrl
+        ]
+            .map((value) => (typeof value === 'string' ? value.trim() : ''))
+            .filter((value) => value.length > 0);
+        const firstAbsolute = candidates.find((value) => RuntimeEndpointResolver.looksLikeAbsoluteUrl(value));
+        if (firstAbsolute) {
+            return firstAbsolute;
+        }
+        const serviceDefault = String(input.serviceDefaultBaseUrl || '').trim();
+        if (serviceDefault && RuntimeEndpointResolver.looksLikeAbsoluteUrl(serviceDefault)) {
+            return serviceDefault;
+        }
+        const staticServiceDefault = RuntimeEndpointResolver.resolveStaticServiceDefaultBaseUrl(input.profileKey, input.providerType);
+        if (staticServiceDefault && RuntimeEndpointResolver.looksLikeAbsoluteUrl(staticServiceDefault)) {
+            return staticServiceDefault;
+        }
+        return candidates[0] || String(input.serviceDefaultBaseUrl || '');
+    }
+    static resolveEffectiveEndpoint(input) {
+        const runtimeEndpoint = input.runtime?.endpoint && !RuntimeEndpointResolver.looksLikeAbsoluteUrl(input.runtime.endpoint)
+            ? input.runtime.endpoint
+            : undefined;
+        return (runtimeEndpoint ||
+            input.overrideEndpoint ||
+            input.serviceDefaultEndpoint);
+    }
+    static looksLikeAbsoluteUrl(value) {
+        if (!value) {
+            return false;
+        }
+        const trimmed = value.trim();
+        return /^https?:\/\//i.test(trimmed) || trimmed.startsWith('//');
+    }
+    static pickRuntimeBaseUrl(runtime) {
+        if (!runtime) {
+            return undefined;
+        }
+        if (typeof runtime.baseUrl === 'string' && runtime.baseUrl.trim()) {
+            return runtime.baseUrl.trim();
+        }
+        if (typeof runtime.endpoint === 'string' && RuntimeEndpointResolver.looksLikeAbsoluteUrl(runtime.endpoint)) {
+            return runtime.endpoint.trim();
+        }
+        return undefined;
+    }
+    static resolveStaticServiceDefaultBaseUrl(profileKey, providerType) {
+        const baseProfile = DynamicProfileLoader.buildServiceProfile(profileKey) ||
+            DynamicProfileLoader.buildServiceProfile(providerType);
+        const candidate = typeof baseProfile?.defaultBaseUrl === 'string'
+            ? baseProfile.defaultBaseUrl.trim()
+            : '';
+        return candidate || undefined;
+    }
+}
+//# sourceMappingURL=runtime-endpoint-resolver.js.map

package/dist/providers/core/runtime/runtime-endpoint-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-endpoint-resolver.js","sourceRoot":"","sources":["../../../../src/providers/core/runtime/runtime-endpoint-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAkBrE,MAAM,OAAO,uBAAuB;IAClC,MAAM,CAAC,uBAAuB,CAAC,KAA4B;QACzD,MAAM,eAAe,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,UAAU,GAAG;YACjB,eAAe;YACf,KAAK,CAAC,OAAO,EAAE,OAAO;YACtB,KAAK,CAAC,eAAe;YACrB,KAAK,CAAC,aAAa;YACnB,KAAK,CAAC,qBAAqB;SAC5B;aACE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAC/D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEvC,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;QACtG,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxE,IAAI,cAAc,IAAI,uBAAuB,CAAC,oBAAoB,CAAC,cAAc,CAAC,EAAE,CAAC;YACnF,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,kCAAkC,CACrF,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,YAAY,CACnB,CAAC;QACF,IAAI,oBAAoB,IAAI,uBAAuB,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC/F,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,wBAAwB,CAAC,KAA6B;QAC3D,MAAM,eAAe,GACnB,KAAK,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC9F,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ;YACxB,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,CACL,eAAe;YACf,KAAK,CAAC,gBAAgB;YACtB,KAAK,CAAC,sBAAsB,CAC7B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,KAAc;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,OAAgC;QAChE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,uBAAuB,CAAC,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3G,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,kCAAkC,CAAC,UAAkB,EAAE,YAAoB;QACxF,MAAM,WAAW,GACf,oBAAoB,CAAC,mBAAmB,CAAC,UAAU,CAAC;YACpD,oBAAoB,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,WAAW,EAAE,cAAc,KAAK,QAAQ;YAC/D,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,SAAS,IAAI,SAAS,CAAC;IAChC,CAAC;CACF"}

package/dist/providers/core/runtime/service-profile-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { ServiceProfile } from '../api/provider-types.js';
+export interface ServiceProfileResolverInput {
+    cfg: {
+        baseUrl?: string;
+        endpoint?: string;
+        defaultModel?: string;
+        timeout?: number;
+        maxRetries?: number;
+        headers?: Record<string, string>;
+        authCapabilities?: {
+            required?: string[];
+            optional?: string[];
+        };
+        overrides?: {
+            baseUrl?: string;
+            endpoint?: string;
+            defaultModel?: string;
+            timeout?: number;
+            maxRetries?: number;
+            headers?: Record<string, string>;
+        };
+        protocol?: string;
+    };
+    profileKey: string;
+    providerType: string;
+}
+export declare class ServiceProfileResolver {
+    static resolve(input: ServiceProfileResolverInput): ServiceProfile;
+}

package/dist/providers/core/runtime/service-profile-resolver.js

@@ -0,0 +1,88 @@
+import { DynamicProfileLoader } from '../config/service-profiles.js';
+import { DEFAULT_PROVIDER } from '../../../constants/index.js';
+export class ServiceProfileResolver {
+    static resolve(input) {
+        const { cfg, profileKey, providerType } = input;
+        const useConfigCoreEnv = String(process.env.ROUTECODEX_USE_CONFIG_CORE_PROVIDER_DEFAULTS ||
+            process.env.RCC_USE_CONFIG_CORE_PROVIDER_DEFAULTS ||
+            '').trim().toLowerCase();
+        const forceConfigCoreDefaults = useConfigCoreEnv === '1' ||
+            useConfigCoreEnv === 'true' ||
+            useConfigCoreEnv === 'yes' ||
+            useConfigCoreEnv === 'on';
+        const baseFromCfg = (cfg.baseUrl || cfg.overrides?.baseUrl || '').trim();
+        const endpointFromCfg = (cfg.overrides?.endpoint || cfg.endpoint || '').trim();
+        const defaultModelFromCfg = (cfg.overrides?.defaultModel || cfg.defaultModel || '').trim();
+        const timeoutFromCfg = cfg.overrides?.timeout ?? cfg.timeout;
+        const maxRetriesFromCfg = cfg.overrides?.maxRetries ?? cfg.maxRetries;
+        const headersFromCfg = (cfg.overrides?.headers || cfg.headers);
+        const authCapsFromCfg = cfg.authCapabilities;
+        const hasConfigCoreProfile = !!baseFromCfg ||
+            !!endpointFromCfg ||
+            !!defaultModelFromCfg ||
+            typeof timeoutFromCfg === 'number' ||
+            typeof maxRetriesFromCfg === 'number' ||
+            !!authCapsFromCfg ||
+            !!headersFromCfg;
+        const baseProfile = DynamicProfileLoader.buildServiceProfile(profileKey) ||
+            DynamicProfileLoader.buildServiceProfile(providerType);
+        if (hasConfigCoreProfile || forceConfigCoreDefaults) {
+            if (forceConfigCoreDefaults) {
+                if (!baseFromCfg) {
+                    throw new Error(`Provider config-core defaults missing baseUrl for providerId=${profileKey}`);
+                }
+                if (!endpointFromCfg && !baseProfile?.defaultEndpoint) {
+                    throw new Error(`Provider config-core defaults missing endpoint for providerId=${profileKey}`);
+                }
+            }
+            const defaultBaseUrl = baseFromCfg ||
+                baseProfile?.defaultBaseUrl ||
+                'https://api.openai.com/v1';
+            const defaultEndpoint = endpointFromCfg ||
+                baseProfile?.defaultEndpoint ||
+                '/chat/completions';
+            const defaultModel = (defaultModelFromCfg && defaultModelFromCfg.length > 0)
+                ? defaultModelFromCfg
+                : (baseProfile?.defaultModel ?? '');
+            const genericRequiredAuth = [];
+            const genericOptionalAuth = ['apikey', 'oauth'];
+            const requiredAuth = authCapsFromCfg?.required && authCapsFromCfg.required.length
+                ? authCapsFromCfg.required
+                : (baseProfile?.requiredAuth ?? genericRequiredAuth);
+            const optionalAuth = authCapsFromCfg?.optional && authCapsFromCfg.optional.length
+                ? authCapsFromCfg.optional
+                : (baseProfile?.optionalAuth ?? genericOptionalAuth);
+            const mergedHeaders = {
+                ...(baseProfile?.headers || {}),
+                ...(headersFromCfg || {})
+            };
+            const timeout = typeof timeoutFromCfg === 'number'
+                ? timeoutFromCfg
+                : (baseProfile?.timeout ?? DEFAULT_PROVIDER.TIMEOUT_MS);
+            const maxRetries = typeof maxRetriesFromCfg === 'number'
+                ? maxRetriesFromCfg
+                : (baseProfile?.maxRetries ?? DEFAULT_PROVIDER.MAX_RETRIES);
+            return {
+                defaultBaseUrl,
+                defaultEndpoint,
+                defaultModel,
+                requiredAuth,
+                optionalAuth,
+                headers: mergedHeaders,
+                timeout,
+                maxRetries,
+                hooks: baseProfile?.hooks,
+                features: baseProfile?.features,
+                extensions: {
+                    ...(baseProfile?.extensions || {}),
+                    protocol: cfg.protocol || baseProfile?.extensions?.protocol
+                }
+            };
+        }
+        if (baseProfile) {
+            return baseProfile;
+        }
+        throw new Error(`Unknown providerType='${providerType}' (no service profile registered)`);
+    }
+}
+//# sourceMappingURL=service-profile-resolver.js.map

package/dist/providers/core/runtime/service-profile-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-profile-resolver.js","sourceRoot":"","sources":["../../../../src/providers/core/runtime/service-profile-resolver.ts"],"names":[],"mappings":"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"}

package/dist/providers/core/runtime/transport/auth-mode-utils.d.ts

@@ -0,0 +1,13 @@
+import type { OAuthAuth } from '../../api/provider-config.js';
+type OAuthAuthExtended = OAuthAuth & {
+    rawType?: string;
+    oauthProviderId?: string;
+    tokenFile?: string;
+};
+export declare class AuthModeUtils {
+    static normalizeAuthMode(type: unknown): 'apikey' | 'oauth';
+    static resolveOAuthProviderId(type: unknown): string | undefined;
+    static ensureOAuthProviderId(auth: OAuthAuthExtended, extensions?: Record<string, unknown>): string;
+    static ensureOAuthProviderIdLegacy(type: unknown): string;
+}
+export {};

package/dist/providers/core/runtime/transport/auth-mode-utils.js

@@ -0,0 +1,43 @@
+export class AuthModeUtils {
+    static normalizeAuthMode(type) {
+        return typeof type === 'string' && type.toLowerCase().includes('oauth') ? 'oauth' : 'apikey';
+    }
+    static resolveOAuthProviderId(type) {
+        if (typeof type !== 'string') {
+            return undefined;
+        }
+        const match = type.toLowerCase().match(/^([a-z0-9._-]+)-oauth$/);
+        return match ? match[1] : undefined;
+    }
+    static ensureOAuthProviderId(auth, extensions) {
+        const fromExtension = typeof extensions?.oauthProviderId === 'string' && extensions.oauthProviderId.trim()
+            ? extensions.oauthProviderId.trim()
+            : undefined;
+        if (fromExtension) {
+            return fromExtension;
+        }
+        const fromAuthField = typeof auth?.oauthProviderId === 'string' && auth.oauthProviderId.trim()
+            ? auth.oauthProviderId.trim()
+            : undefined;
+        if (fromAuthField) {
+            return fromAuthField;
+        }
+        const providerId = AuthModeUtils.resolveOAuthProviderId(auth?.rawType ?? auth?.type);
+        if (providerId) {
+            return providerId;
+        }
+        const fallback = AuthModeUtils.resolveOAuthProviderId(auth?.type);
+        if (fallback) {
+            return fallback;
+        }
+        throw new Error(`OAuth auth.type must be declared as "<provider>-oauth" (received ${typeof auth?.rawType === 'string' ? auth.rawType : auth?.type ?? 'unknown'})`);
+    }
+    static ensureOAuthProviderIdLegacy(type) {
+        const providerId = AuthModeUtils.resolveOAuthProviderId(type);
+        if (!providerId) {
+            throw new Error(`OAuth auth.type must be declared as "<provider>-oauth" (received ${typeof type === 'string' ? type : 'unknown'})`);
+        }
+        return providerId;
+    }
+}
+//# sourceMappingURL=auth-mode-utils.js.map

package/dist/providers/core/runtime/transport/auth-mode-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-mode-utils.js","sourceRoot":"","sources":["../../../../../src/providers/core/runtime/transport/auth-mode-utils.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,iBAAiB,CAAC,IAAa;QACpC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/F,CAAC;IAED,MAAM,CAAC,sBAAsB,CAAC,IAAa;QACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,qBAAqB,CAAC,IAAuB,EAAE,UAAoC;QACxF,MAAM,aAAa,GACjB,OAAO,UAAU,EAAE,eAAe,KAAK,QAAQ,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE;YAClF,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE;YACnC,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,aAAa,GACjB,OAAO,IAAI,EAAE,eAAe,KAAK,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE;YACtE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;QACrF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oEAAoE,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,GAAG,CAClJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,2BAA2B,CAAC,IAAa;QAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,oEAAoE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,CACnH,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/providers/core/runtime/transport/auth-provider-factory.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Auth Provider Factory
+ *
+ * 负责创建各种认证提供者实例：
+ * - ApiKeyAuthProvider
+ * - OAuthAuthProvider
+ * - TokenFileAuthProvider
+ * - IflowCookieAuthProvider
+ */
+import type { IAuthProvider } from '../../../auth/auth-interface.js';
+import type { ApiKeyAuth, OAuthAuth } from '../../api/provider-config.js';
+import type { ServiceProfile } from '../../api/provider-types.js';
+export interface AuthProviderFactoryContext {
+    providerType: string;
+    moduleType: string;
+    config: {
+        config: {
+            providerId?: string;
+            baseUrl?: string;
+            overrides?: {
+                baseUrl?: string;
+            };
+            auth: ApiKeyAuth | OAuthAuth;
+        };
+    };
+    serviceProfile: ServiceProfile;
+}
+export declare class AuthProviderFactory {
+    private context;
+    constructor(context: AuthProviderFactoryContext);
+    createAuthProvider(): IAuthProvider;
+    private createApiKeyAuthProvider;
+    private createOAuthAuthProvider;
+    private normalizeAuthMode;
+    private resolveOAuthProviderId;
+    private ensureOAuthProviderId;
+}

package/dist/providers/core/runtime/transport/auth-provider-factory.js

@@ -0,0 +1,131 @@
+/**
+ * Auth Provider Factory
+ *
+ * 负责创建各种认证提供者实例：
+ * - ApiKeyAuthProvider
+ * - OAuthAuthProvider
+ * - TokenFileAuthProvider
+ * - IflowCookieAuthProvider
+ */
+import { ApiKeyAuthProvider } from '../../../auth/apikey-auth.js';
+import { OAuthAuthProvider } from '../../../auth/oauth-auth.js';
+import { TokenFileAuthProvider } from '../../../auth/tokenfile-auth.js';
+import { IflowCookieAuthProvider } from '../../../auth/iflow-cookie-auth.js';
+import { ApiKeyRotator } from '../../../auth/apikey-auth.js';
+import { getProviderFamilyProfile } from '../../../profile/profile-registry.js';
+export class AuthProviderFactory {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    createAuthProvider() {
+        const auth = this.context.config.config.auth;
+        const authMode = this.normalizeAuthMode(auth.type);
+        // 根据认证类型创建对应的认证提供者
+        if (authMode === 'apikey') {
+            return this.createApiKeyAuthProvider(auth);
+        }
+        else if (authMode === 'oauth') {
+            return this.createOAuthAuthProvider(auth);
+        }
+        else {
+            throw new Error(`Unsupported auth type: ${auth.type}`);
+        }
+    }
+    createApiKeyAuthProvider(auth) {
+        const rawTypeValue = typeof auth.rawType === 'string'
+            ? String(auth.rawType)
+            : typeof auth.type === 'string'
+                ? String(auth.type)
+                : '';
+        const rawType = rawTypeValue.toLowerCase();
+        const providerId = typeof (this.context.config.config.providerId) === 'string'
+            ? this.context.config.config.providerId.toLowerCase()
+            : '';
+        const baseUrl = typeof this.context.config.config.baseUrl === 'string'
+            ? this.context.config.config.baseUrl.toLowerCase()
+            : '';
+        const isIflowFamily = providerId === 'iflow' ||
+            baseUrl.includes('apis.iflow.cn') ||
+            baseUrl.includes('iflow.cn');
+        // iFlow Cookie 模式：使用浏览器导出的 Cookie 交换 API Key，避免频繁走 OAuth。
+        if (isIflowFamily &&
+            (rawType === 'iflow-cookie' ||
+                (!(auth.apiKey) &&
+                    (typeof auth.cookie === 'string' ||
+                        typeof auth.cookieFile === 'string')))) {
+            return new IflowCookieAuthProvider(auth);
+        }
+        // 检查是否有多 key entries，有则使用轮询模式
+        const authWithEntries = auth;
+        if (authWithEntries.entries && authWithEntries.entries.length > 0) {
+            const rotator = new ApiKeyRotator(authWithEntries.entries);
+            return new ApiKeyAuthProvider(auth, rotator);
+        }
+        return new ApiKeyAuthProvider(auth);
+    }
+    createOAuthAuthProvider(auth) {
+        const resolvedOAuthProviderId = this.ensureOAuthProviderId(auth);
+        const serviceProfileKey = this.context.moduleType === 'gemini-cli-http-provider'
+            ? 'gemini-cli'
+            : (resolvedOAuthProviderId ?? this.context.providerType);
+        const familyProfile = getProviderFamilyProfile({
+            providerId: this.context.config.config.providerId,
+            providerType: this.context.providerType,
+            oauthProviderId: resolvedOAuthProviderId
+        });
+        const profileTokenFileMode = familyProfile?.resolveOAuthTokenFileMode?.({
+            oauthProviderId: resolvedOAuthProviderId,
+            auth: {
+                clientId: auth.clientId,
+                tokenUrl: auth.tokenUrl,
+                deviceCodeUrl: auth.deviceCodeUrl
+            },
+            moduleType: this.context.moduleType
+        });
+        // For providers like Qwen/iflow/Gemini CLI where public OAuth client may not be available,
+        // allow reading tokens produced by external login tools (CLIProxyAPI) via token file.
+        const useTokenFile = (typeof profileTokenFileMode === 'boolean'
+            ? profileTokenFileMode
+            : (resolvedOAuthProviderId === 'qwen' ||
+                resolvedOAuthProviderId === 'iflow' ||
+                this.context.moduleType === 'gemini-cli-http-provider')) &&
+            !auth.clientId &&
+            !auth.tokenUrl &&
+            !auth.deviceCodeUrl;
+        if (useTokenFile) {
+            // Keep TokenFileAuthProvider pure: do not infer providerId from type/rawType.
+            // The creator already knows oauthProviderId and must pass it explicitly.
+            return new TokenFileAuthProvider({ ...auth, oauthProviderId: resolvedOAuthProviderId });
+        }
+        return new OAuthAuthProvider(auth, resolvedOAuthProviderId);
+    }
+    normalizeAuthMode(type) {
+        return typeof type === 'string' && type.toLowerCase().includes('oauth') ? 'oauth' : 'apikey';
+    }
+    resolveOAuthProviderId(type) {
+        if (typeof type !== 'string') {
+            return undefined;
+        }
+        const match = type.toLowerCase().match(/^([a-z0-9._-]+)-oauth$/);
+        return match ? match[1] : undefined;
+    }
+    ensureOAuthProviderId(auth) {
+        const fromAuthField = typeof auth?.oauthProviderId === 'string' && auth.oauthProviderId.trim()
+            ? auth.oauthProviderId.trim()
+            : undefined;
+        if (fromAuthField) {
+            return fromAuthField;
+        }
+        const providerId = this.resolveOAuthProviderId(auth?.rawType ?? auth?.type);
+        if (providerId) {
+            return providerId;
+        }
+        const fallback = this.resolveOAuthProviderId(auth?.type);
+        if (fallback) {
+            return fallback;
+        }
+        throw new Error(`OAuth auth.type must be declared as "<provider>-oauth" (received ${typeof auth?.rawType === 'string' ? auth.rawType : auth?.type ?? 'unknown'})`);
+    }
+}
+//# sourceMappingURL=auth-provider-factory.js.map

package/dist/providers/core/runtime/transport/auth-provider-factory.js.map

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

package/dist/providers/core/runtime/transport/header-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Header Utilities
+ *
+ * 提供头部操作的工具函数：
+ * - 查找、赋值、删除头部字段
+ * - 头部 key 标准化
+ */
+export declare class HeaderUtils {
+    static findHeaderValue(headers: Record<string, string>, target: string): string | undefined;
+    static normalizeHeaderKey(value: string): string;
+    static assignHeader(headers: Record<string, string>, target: string, value: string): void;
+    static deleteHeader(headers: Record<string, string>, target: string): void;
+    static setHeaderIfMissing(headers: Record<string, string>, target: string, value: string): void;
+    static copyHeaderValue(target: Record<string, string>, source: Record<string, string>, from: string, to: string): void;
+}

package/dist/providers/core/runtime/transport/header-utils.js

@@ -0,0 +1,85 @@
+/**
+ * Header Utilities
+ *
+ * 提供头部操作的工具函数：
+ * - 查找、赋值、删除头部字段
+ * - 头部 key 标准化
+ */
+export class HeaderUtils {
+    static findHeaderValue(headers, target) {
+        const lowered = typeof target === 'string' ? target.toLowerCase() : '';
+        if (!lowered) {
+            return undefined;
+        }
+        const normalizedTarget = HeaderUtils.normalizeHeaderKey(lowered);
+        for (const [key, value] of Object.entries(headers)) {
+            if (typeof value !== 'string') {
+                continue;
+            }
+            const trimmed = value.trim();
+            if (!trimmed) {
+                continue;
+            }
+            const loweredKey = key.toLowerCase();
+            if (loweredKey === lowered) {
+                return trimmed;
+            }
+            if (HeaderUtils.normalizeHeaderKey(loweredKey) === normalizedTarget) {
+                return trimmed;
+            }
+        }
+        return undefined;
+    }
+    static normalizeHeaderKey(value) {
+        if (!value) {
+            return '';
+        }
+        return value.replace(/[\s_-]+/g, '');
+    }
+    static assignHeader(headers, target, value) {
+        if (!value || !value.trim()) {
+            return;
+        }
+        const lowered = target.toLowerCase();
+        for (const key of Object.keys(headers)) {
+            if (key.toLowerCase() === lowered) {
+                headers[key] = value;
+                return;
+            }
+        }
+        headers[target] = value;
+    }
+    static deleteHeader(headers, target) {
+        const lowered = typeof target === 'string' ? target.toLowerCase() : '';
+        if (!lowered) {
+            return;
+        }
+        const normalizedTarget = HeaderUtils.normalizeHeaderKey(lowered);
+        for (const key of Object.keys(headers)) {
+            const loweredKey = key.toLowerCase();
+            if (loweredKey === lowered) {
+                delete headers[key];
+                continue;
+            }
+            if (HeaderUtils.normalizeHeaderKey(loweredKey) === normalizedTarget) {
+                delete headers[key];
+            }
+        }
+    }
+    static setHeaderIfMissing(headers, target, value) {
+        if (HeaderUtils.findHeaderValue(headers, target)) {
+            return;
+        }
+        HeaderUtils.assignHeader(headers, target, value);
+    }
+    static copyHeaderValue(target, source, from, to) {
+        if (HeaderUtils.findHeaderValue(target, to)) {
+            return;
+        }
+        const value = HeaderUtils.findHeaderValue(source, from);
+        if (value) {
+            target[to] = value;
+        }
+    }
+}
+//# sourceMappingURL=header-utils.js.map

package/dist/providers/core/runtime/transport/header-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-utils.js","sourceRoot":"","sources":["../../../../../src/providers/core/runtime/transport/header-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,eAAe,CAAC,OAA+B,EAAE,MAAc;QACpE,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,gBAAgB,GAAG,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,IAAI,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,gBAAgB,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,KAAa;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAA+B,EAAE,MAAc,EAAE,KAAa;QAChF,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACrB,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAA+B,EAAE,MAAc;QACjE,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,gBAAgB,GAAG,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACjE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,IAAI,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,gBAAgB,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,kBAAkB,CACvB,OAA+B,EAC/B,MAAc,EACd,KAAa;QAEb,IAAI,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,MAA8B,EAC9B,MAA8B,EAC9B,IAAY,EACZ,EAAU;QAEV,IAAI,WAAW,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/providers/core/runtime/transport/iflow-signer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * iFlow Signature Builder
+ *
+ * 构建 iFlow 特有的签名头部：
+ * - x-iflow-timestamp
+ * - x-iflow-signature
+ */
+export declare class IflowSigner {
+    static enforceIflowCliHeaders(headers: Record<string, string>): void;
+    private static extractBearerApiKey;
+    private static buildIflowSignature;
+}

package/dist/providers/core/runtime/transport/iflow-signer.js

@@ -0,0 +1,63 @@
+/**
+ * iFlow Signature Builder
+ *
+ * 构建 iFlow 特有的签名头部：
+ * - x-iflow-timestamp
+ * - x-iflow-signature
+ */
+import { createHmac } from 'node:crypto';
+import { DEFAULT_PROVIDER } from '../../../../constants/index.js';
+import { HeaderUtils } from './header-utils.js';
+export class IflowSigner {
+    static enforceIflowCliHeaders(headers) {
+        const resolvedSessionId = HeaderUtils.findHeaderValue(headers, 'session-id') ??
+            HeaderUtils.findHeaderValue(headers, 'session_id') ??
+            '';
+        const resolvedConversationId = HeaderUtils.findHeaderValue(headers, 'conversation-id') ??
+            HeaderUtils.findHeaderValue(headers, 'conversation_id') ??
+            resolvedSessionId;
+        if (resolvedSessionId) {
+            HeaderUtils.assignHeader(headers, 'session-id', resolvedSessionId);
+        }
+        if (resolvedConversationId) {
+            HeaderUtils.assignHeader(headers, 'conversation-id', resolvedConversationId);
+        }
+        const bearerApiKey = IflowSigner.extractBearerApiKey(headers);
+        if (!bearerApiKey) {
+            return;
+        }
+        const userAgent = HeaderUtils.findHeaderValue(headers, 'User-Agent') ?? 'iFlow-Cli';
+        const timestamp = Date.now().toString();
+        const signature = IflowSigner.buildIflowSignature(userAgent, resolvedSessionId, timestamp, bearerApiKey);
+        if (!signature) {
+            return;
+        }
+        HeaderUtils.assignHeader(headers, 'x-iflow-timestamp', timestamp);
+        HeaderUtils.assignHeader(headers, 'x-iflow-signature', signature);
+    }
+    static extractBearerApiKey(headers) {
+        const authorization = HeaderUtils.findHeaderValue(headers, 'Authorization');
+        if (!authorization) {
+            return undefined;
+        }
+        const matched = authorization.match(/^Bearer\s+(.+)$/i);
+        if (!matched || !matched[1]) {
+            return undefined;
+        }
+        const apiKey = matched[1].trim();
+        return apiKey || undefined;
+    }
+    static buildIflowSignature(userAgent, sessionId, timestamp, apiKey) {
+        if (!apiKey) {
+            return undefined;
+        }
+        const payload = `${userAgent}:${sessionId}:${timestamp}`;
+        try {
+            return createHmac(DEFAULT_PROVIDER.IFLOW_SIGNATURE_ALGORITHM, apiKey).update(payload, 'utf8').digest('hex');
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=iflow-signer.js.map

package/dist/providers/core/runtime/transport/iflow-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iflow-signer.js","sourceRoot":"","sources":["../../../../../src/providers/core/runtime/transport/iflow-signer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,sBAAsB,CAAC,OAA+B;QAC3D,MAAM,iBAAiB,GACrB,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC;YAClD,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC;YAClD,EAAE,CAAC;QACL,MAAM,sBAAsB,GAC1B,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC;YACvD,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC;YACvD,iBAAiB,CAAC;QAEpB,IAAI,iBAAiB,EAAE,CAAC;YACtB,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,sBAAsB,EAAE,CAAC;YAC3B,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,WAAW,CAAC;QACpF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,WAAW,CAAC,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QACzG,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;QAClE,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAAC,OAA+B;QAChE,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC5E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,IAAI,SAAS,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAChC,SAAiB,EACjB,SAAiB,EACjB,SAAiB,EACjB,MAAc;QAEd,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,gBAAgB,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9G,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/providers/core/runtime/transport/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transport Module Exports
+ *
+ * 统一导出所有 transport 子模块
+ */
+export { AuthProviderFactory, type AuthProviderFactoryContext } from './auth-provider-factory.js';
+export { AuthModeUtils } from './auth-mode-utils.js';
+export { HeaderUtils } from './header-utils.js';
+export { RuntimeDetector } from './runtime-detector.js';
+export { IflowSigner } from './iflow-signer.js';
+export { OAuthRecoveryHandler, type OAuthRecoveryContext } from './oauth-recovery-handler.js';
+export { OAuthHeaderPreflight, type OAuthHeaderPreflightContext } from './oauth-header-preflight.js';
+export { ProviderPayloadUtils } from './provider-payload-utils.js';
+export { RequestHeaderBuilder, type RequestHeaderBuildContext } from './request-header-builder.js';
+export { SessionHeaderUtils } from './session-header-utils.js';