@jsonstudio/rcc 0.89.1960 → 0.89.2195

package/dist/modules/llmswitch/bridge.js

@@ -1,837 +1,17 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { createRequire } from 'module';
-import { importCoreModule, resolveCoreModulePath } from './core-loader.js';
-import { writeErrorsampleJson } from '../../utils/errorsamples.js';
-import { isLlmsEngineShadowEnabledForSubpath, recordLlmsEngineShadowDiff, resolveLlmsEngineShadowConfig, shouldRunLlmsEngineShadowForSubpath } from '../../utils/llms-engine-shadow.js';
-import { buildInfo } from '../../build-info.js';
-import { resolveLlmswitchCoreVersion } from '../../utils/runtime-versions.js';
-const require = createRequire(import.meta.url);
-function parsePrefixList(raw) {
-    return String(raw || '')
-        .split(',')
-        .map((s) => s.trim())
-        .filter(Boolean)
-        .map((s) => s.replace(/^\/*/, '').replace(/\/+$/, ''));
-}
-function matchesPrefix(subpath, prefixes) {
-    if (!prefixes.length) {
-        return false;
-    }
-    const normalized = subpath.replace(/^\/*/, '').replace(/\.js$/i, '');
-    return prefixes.some((prefix) => normalized === prefix || normalized.startsWith(`${prefix}/`));
-}
-function isEngineEnabled() {
-    const raw = String(process.env.ROUTECODEX_LLMS_ENGINE_ENABLE || '').trim().toLowerCase();
-    return raw === '1' || raw === 'true' || raw === 'yes';
-}
-function getEnginePrefixes() {
-    return parsePrefixList(process.env.ROUTECODEX_LLMS_ENGINE_PREFIXES);
-}
-function resolveImplForSubpath(subpath) {
-    if (!isEngineEnabled()) {
-        return 'ts';
-    }
-    const enginePrefixes = getEnginePrefixes();
-    if (matchesPrefix(subpath, enginePrefixes)) {
-        return 'engine';
-    }
-    return 'ts';
-}
-async function importCoreDist(subpath, impl = resolveImplForSubpath(subpath)) {
-    try {
-        return await importCoreModule(subpath, impl);
-    }
-    catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        const pkg = impl === 'engine' ? '@jsonstudio/llms-engine' : '@jsonstudio/llms';
-        throw new Error(`[llmswitch-bridge] Unable to load core module "${subpath}" (${impl}). 请确认 ${pkg} 依赖已安装（npm install）。${detail ? ` (${detail})` : ''}`);
-    }
-}
-function requireCoreDist(subpath, impl = resolveImplForSubpath(subpath)) {
-    if (impl === 'engine' && !isEngineEnabled()) {
-        throw new Error('[llmswitch-bridge] ROUTECODEX_LLMS_ENGINE_ENABLE must be enabled to load engine core');
-    }
-    const modulePath = resolveCoreModulePath(subpath, impl);
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    return require(modulePath);
-}
-let cachedAntigravitySignatureModule = null;
-let antigravitySignatureModuleWarmupPromise = null;
-function loadAntigravitySignatureModule() {
-    if (cachedAntigravitySignatureModule) {
-        return cachedAntigravitySignatureModule;
-    }
-    try {
-        cachedAntigravitySignatureModule = requireCoreDist('conversion/compat/antigravity-session-signature');
-    }
-    catch {
-        cachedAntigravitySignatureModule = null;
-    }
-    return cachedAntigravitySignatureModule;
-}
-export async function warmupAntigravitySessionSignatureModule() {
-    if (cachedAntigravitySignatureModule) {
-        return;
-    }
-    if (!antigravitySignatureModuleWarmupPromise) {
-        antigravitySignatureModuleWarmupPromise = (async () => {
-            try {
-                return await importCoreDist('conversion/compat/antigravity-session-signature');
-            }
-            catch {
-                return null;
-            }
-        })();
-    }
-    try {
-        cachedAntigravitySignatureModule = await antigravitySignatureModuleWarmupPromise;
-    }
-    finally {
-        antigravitySignatureModuleWarmupPromise = null;
-    }
-}
-export function extractAntigravityGeminiSessionId(payload) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.extractAntigravityGeminiSessionId;
-    if (typeof fn !== 'function') {
-        return undefined;
-    }
-    try {
-        return fn(payload);
-    }
-    catch {
-        return undefined;
-    }
-}
-export function cacheAntigravitySessionSignature(a, b, c, d = 1) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.cacheAntigravitySessionSignature;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    const supportsAliasKey = typeof mod?.getAntigravitySessionSignature === 'function' &&
-        mod.getAntigravitySessionSignature.length >= 2;
-    const isNewSignature = typeof c === 'string';
-    const aliasKey = isNewSignature ? a : 'antigravity.unknown';
-    const sessionId = isNewSignature ? b : a;
-    const signature = isNewSignature ? c : b;
-    const messageCount = typeof c === 'number' ? c : typeof d === 'number' ? d : 1;
-    try {
-        if (isNewSignature && supportsAliasKey) {
-            fn(aliasKey, sessionId, signature, messageCount);
-        }
-        else {
-            fn(sessionId, signature, messageCount);
-        }
-    }
-    catch {
-        // best-effort only
-    }
-}
-export function getAntigravityLatestSignatureSessionIdForAlias(aliasKey, options) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.getAntigravityLatestSignatureSessionIdForAlias;
-    if (typeof fn !== 'function') {
-        return undefined;
-    }
-    try {
-        const out = fn(aliasKey, options);
-        return typeof out === 'string' && out.trim().length ? out.trim() : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function lookupAntigravitySessionSignatureEntry(aliasKey, sessionId, options) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.lookupAntigravitySessionSignatureEntry;
-    if (typeof fn !== 'function') {
-        return undefined;
-    }
-    try {
-        const out = fn(aliasKey, sessionId, options);
-        return out && typeof out === 'object' ? out : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function invalidateAntigravitySessionSignature(aliasKey, sessionId) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.invalidateAntigravitySessionSignature;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    try {
-        fn(aliasKey, sessionId);
-    }
-    catch {
-        // best-effort only
-    }
-}
-export function resetAntigravitySessionSignatureCachesForTests() {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.resetAntigravitySessionSignatureCachesForTests;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    try {
-        fn();
-    }
-    catch {
-        // best-effort only
-    }
-}
-let quotaModulePromise = null;
-let cachedQuotaModuleError = null;
-async function importQuotaModule() {
-    if (!quotaModulePromise) {
-        quotaModulePromise = (async () => {
-            try {
-                const mod = await importCoreDist('quota/index');
-                cachedQuotaModuleError = null;
-                return mod;
-            }
-            catch {
-                cachedQuotaModuleError = 'failed to import core module quota/index (resolveCoreModulePath or import failed)';
-                return null;
-            }
-        })();
-    }
-    return await quotaModulePromise;
-}
-export async function createCoreQuotaManager(options) {
-    const mod = await importQuotaModule();
-    const Ctor = mod?.QuotaManager;
-    if (typeof Ctor !== 'function') {
-        throw new Error(`[llmswitch-bridge] core QuotaManager not available; please update @jsonstudio/llms${cachedQuotaModuleError ? ` (${cachedQuotaModuleError})` : ''}`);
-    }
-    return new Ctor({ ...(options ?? {}) });
-}
-export function configureAntigravitySessionSignaturePersistence(input) {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.configureAntigravitySessionSignaturePersistence;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    try {
-        fn(input);
-    }
-    catch {
-        // best-effort only
-    }
-}
-export function flushAntigravitySessionSignaturePersistenceSync() {
-    const mod = loadAntigravitySignatureModule();
-    const fn = mod?.flushAntigravitySessionSignaturePersistenceSync;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    try {
-        fn();
-    }
-    catch {
-        // best-effort only
-    }
-}
-export async function writeSnapshotViaHooks(channelOrOptions, payload) {
-    let hooksModule = null;
-    try {
-        hooksModule = await importCoreDist('conversion/shared/snapshot-hooks');
-    }
-    catch {
-        hooksModule = null;
-    }
-    const writer = hooksModule?.writeSnapshotViaHooks;
-    if (typeof writer !== 'function') {
-        return;
-    }
-    let options;
-    if (payload && typeof channelOrOptions === 'string') {
-        const channelValue = typeof payload.channel === 'string' && payload.channel ? payload.channel : channelOrOptions;
-        options = {
-            ...payload,
-            channel: channelValue
-        };
-    }
-    else if (channelOrOptions && typeof channelOrOptions === 'object') {
-        options = channelOrOptions;
-    }
-    if (!options) {
-        return;
-    }
-    await writer(options);
-}
-export async function resumeResponsesConversation(responseId, submitPayload, options) {
-    const mod = await importCoreDist('conversion/shared/responses-conversation-store');
-    const fn = mod.resumeResponsesConversation;
-    if (typeof fn !== 'function') {
-        throw new Error('[llmswitch-bridge] resumeResponsesConversation not available');
-    }
-    return await fn(responseId, submitPayload, options);
-}
-export async function rebindResponsesConversationRequestId(oldId, newId) {
-    if (!oldId || !newId || oldId === newId) {
-        return;
-    }
-    const mod = await importCoreDist('conversion/shared/responses-conversation-store');
-    const fn = mod.rebindResponsesConversationRequestId;
-    if (typeof fn === 'function') {
-        fn(oldId, newId);
-    }
-}
-const cachedConvertProviderResponseByImpl = {
-    ts: null,
-    engine: null
-};
-const llmsEngineShadowConfig = resolveLlmsEngineShadowConfig();
 /**
- * Host/HTTP 侧统一使用的 provider 响应转换入口。
- * 封装 llmswitch-core 的 convertProviderResponse，避免在 Host 内部直接 import core 模块。
+ * RouteCodex LLM Switch Bridge
+ *
+ * Single boundary module for llmswitch-core integration.
  */
-export async function convertProviderResponse(options) {
-    const subpath = 'conversion/hub/response/provider-response';
-    const ensureFn = async (impl) => {
-        if (!cachedConvertProviderResponseByImpl[impl]) {
-            const mod = await importCoreDist(subpath, impl);
-            const fn = mod.convertProviderResponse;
-            if (typeof fn !== 'function') {
-                throw new Error('[llmswitch-bridge] convertProviderResponse not available');
-            }
-            cachedConvertProviderResponseByImpl[impl] = async (opts) => {
-                const result = fn(opts);
-                return result instanceof Promise ? await result : result;
-            };
-        }
-        return cachedConvertProviderResponseByImpl[impl];
-    };
-    const shadowEnabled = isLlmsEngineShadowEnabledForSubpath(llmsEngineShadowConfig, 'conversion/hub/response');
-    if (shadowEnabled) {
-        // Fail fast: if shadow is enabled for this module, engine core must be available.
-        await ensureFn('engine');
-    }
-    const wantsShadow = shadowEnabled && shouldRunLlmsEngineShadowForSubpath(llmsEngineShadowConfig, 'conversion/hub/response');
-    if (wantsShadow) {
-        const baseline = await (await ensureFn('ts'))(options);
-        const requestId = typeof options.requestId === 'string'
-            ? String(options.requestId)
-            : (typeof options.id === 'string' ? String(options.id) : `shadow_${Date.now()}`);
-        void (async () => {
-            try {
-                const candidate = await (await ensureFn('engine'))(options);
-                await recordLlmsEngineShadowDiff({
-                    group: 'provider-response',
-                    requestId,
-                    subpath: 'conversion/hub/response',
-                    baselineImpl: 'ts',
-                    candidateImpl: 'engine',
-                    baselineOut: baseline,
-                    candidateOut: candidate,
-                    excludedComparePaths: []
-                });
-            }
-            catch (error) {
-                // eslint-disable-next-line no-console
-                console.error('[llms-engine-shadow] provider response shadow failed:', error);
-            }
-        })();
-        return baseline;
-    }
-    const impl = resolveImplForSubpath(subpath);
-    return await (await ensureFn(impl))(options);
-}
-let cachedSnapshotRecorderFactory = null;
-/**
- * 为 HubPipeline / provider 响应路径创建阶段快照记录器。
- * 内部通过 llmswitch-core 的 snapshot-recorder 模块实现。
- */
-export async function createSnapshotRecorder(context, endpoint) {
-    if (!cachedSnapshotRecorderFactory) {
-        const mod = await importCoreDist('conversion/hub/snapshot-recorder');
-        const factory = mod.createSnapshotRecorder;
-        if (typeof factory !== 'function') {
-            throw new Error('[llmswitch-bridge] createSnapshotRecorder not available');
-        }
-        cachedSnapshotRecorderFactory = factory;
-    }
-    const recorder = cachedSnapshotRecorderFactory(context, endpoint);
-    const baseRecord = typeof recorder?.record === 'function' ? recorder.record.bind(recorder) : null;
-    if (!baseRecord) {
-        return recorder;
-    }
-    return {
-        ...recorder,
-        record(stage, payload) {
-            baseRecord(stage, payload);
-            try {
-                if (!stage || typeof stage !== 'string')
-                    return;
-                const p = payload;
-                if (!p || typeof p !== 'object')
-                    return;
-                if (stage.startsWith('hub_policy.')) {
-                    const violations = p.violations;
-                    if (!Array.isArray(violations) || violations.length <= 0)
-                        return;
-                    void writeErrorsampleJson({
-                        group: 'policy',
-                        kind: stage,
-                        payload: {
-                            kind: 'hub_policy_violation',
-                            timestamp: new Date().toISOString(),
-                            endpoint,
-                            stage,
-                            versions: {
-                                routecodex: buildInfo.version,
-                                llms: resolveLlmswitchCoreVersion(),
-                                node: process.version
-                            },
-                            ...(context && typeof context === 'object'
-                                ? {
-                                    requestId: context.requestId,
-                                    providerProtocol: context.providerProtocol,
-                                    runtime: context.runtime
-                                }
-                                : {}),
-                            observation: payload
-                        }
-                    }).catch(() => { });
-                    return;
-                }
-                if (stage.startsWith('hub_toolsurface.')) {
-                    const diffCount = typeof p.diffCount === 'number' ? p.diffCount : 0;
-                    if (!(diffCount > 0))
-                        return;
-                    void writeErrorsampleJson({
-                        group: 'tool-surface',
-                        kind: stage,
-                        payload: {
-                            kind: 'hub_toolsurface_diff',
-                            timestamp: new Date().toISOString(),
-                            endpoint,
-                            stage,
-                            versions: {
-                                routecodex: buildInfo.version,
-                                llms: resolveLlmswitchCoreVersion(),
-                                node: process.version
-                            },
-                            ...(context && typeof context === 'object'
-                                ? {
-                                    requestId: context.requestId,
-                                    providerProtocol: context.providerProtocol,
-                                    runtime: context.runtime
-                                }
-                                : {}),
-                            observation: payload
-                        }
-                    }).catch(() => { });
-                    return;
-                }
-                if (stage.startsWith('hub_followup.')) {
-                    const diffCount = typeof p.diffCount === 'number' ? p.diffCount : 0;
-                    if (!(diffCount > 0))
-                        return;
-                    void writeErrorsampleJson({
-                        group: 'followup',
-                        kind: stage,
-                        payload: {
-                            kind: 'hub_followup_diff',
-                            timestamp: new Date().toISOString(),
-                            endpoint,
-                            stage,
-                            versions: {
-                                routecodex: buildInfo.version,
-                                llms: resolveLlmswitchCoreVersion(),
-                                node: process.version
-                            },
-                            ...(context && typeof context === 'object'
-                                ? {
-                                    requestId: context.requestId,
-                                    providerProtocol: context.providerProtocol,
-                                    runtime: context.runtime
-                                }
-                                : {}),
-                            observation: payload
-                        }
-                    }).catch(() => { });
-                    return;
-                }
-            }
-            catch {
-                // best-effort only; must never break request path
-            }
-        }
-    };
-}
-let cachedResponsesSseConverterFactory = null;
-/**
- * 创建 Responses SSE→JSON 转换器实例，供 ResponsesProvider 使用。
- */
-export async function createResponsesSseToJsonConverter() {
-    if (!cachedResponsesSseConverterFactory) {
-        const mod = await importCoreDist('sse/sse-to-json/index');
-        const Ctor = mod.ResponsesSseToJsonConverter;
-        if (typeof Ctor !== 'function') {
-            throw new Error('[llmswitch-bridge] ResponsesSseToJsonConverter not available');
-        }
-        cachedResponsesSseConverterFactory = () => new Ctor();
-    }
-    return cachedResponsesSseConverterFactory();
-}
-let cachedProviderErrorCenter = null;
-/**
- * ProviderErrorCenter 统一桥接入口。
- * Provider/Host 通过本函数获取 error center，避免直接 import core 模块。
- */
-export async function getProviderErrorCenter() {
-    if (!cachedProviderErrorCenter) {
-        const mod = await importCoreDist('router/virtual-router/error-center');
-        const center = mod.providerErrorCenter;
-        if (!center) {
-            throw new Error('[llmswitch-bridge] providerErrorCenter not available');
-        }
-        cachedProviderErrorCenter = center;
-    }
-    return cachedProviderErrorCenter;
-}
-let cachedProviderSuccessCenter = null;
-/**
- * ProviderSuccessCenter 统一桥接入口。
- * Host 通过本函数获取 success center，避免直接 import core 模块。
- */
-export async function getProviderSuccessCenter() {
-    if (!cachedProviderSuccessCenter) {
-        const mod = await importCoreDist('router/virtual-router/success-center');
-        const center = mod.providerSuccessCenter;
-        if (!center) {
-            throw new Error('[llmswitch-bridge] providerSuccessCenter not available');
-        }
-        cachedProviderSuccessCenter = center;
-    }
-    return cachedProviderSuccessCenter;
-}
-let cachedStickySessionStore = undefined;
-function getStickySessionStoreExports() {
-    if (cachedStickySessionStore !== undefined) {
-        return cachedStickySessionStore;
-    }
-    try {
-        // NOTE: must be sync because VirtualRouter routingStateStore expects loadSync.
-        // Centralized here to keep a single core import surface.
-        cachedStickySessionStore = requireCoreDist('router/virtual-router/sticky-session-store');
-    }
-    catch {
-        cachedStickySessionStore = null;
-    }
-    return cachedStickySessionStore;
-}
-export function loadRoutingInstructionStateSync(key) {
-    const mod = getStickySessionStoreExports();
-    const fn = mod?.loadRoutingInstructionStateSync;
-    if (typeof fn !== 'function') {
-        return null;
-    }
-    return fn(key);
-}
-export function saveRoutingInstructionStateAsync(key, state) {
-    const mod = getStickySessionStoreExports();
-    const fn = mod?.saveRoutingInstructionStateAsync;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    fn(key, state);
-}
-export function saveRoutingInstructionStateSync(key, state) {
-    const mod = getStickySessionStoreExports();
-    const fn = mod?.saveRoutingInstructionStateSync;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    fn(key, state);
-}
-let cachedSessionIdentifiersModule = undefined;
-function getSessionIdentifiersModule() {
-    if (cachedSessionIdentifiersModule !== undefined) {
-        return cachedSessionIdentifiersModule;
-    }
-    try {
-        cachedSessionIdentifiersModule = requireCoreDist('conversion/hub/pipeline/session-identifiers');
-    }
-    catch {
-        cachedSessionIdentifiersModule = null;
-    }
-    return cachedSessionIdentifiersModule;
-}
-export function extractSessionIdentifiersFromMetadata(meta) {
-    const mod = getSessionIdentifiersModule();
-    const fn = mod?.extractSessionIdentifiersFromMetadata;
-    if (typeof fn !== 'function') {
-        return {};
-    }
-    try {
-        return fn(meta);
-    }
-    catch {
-        return {};
-    }
-}
-let cachedStatsCenter = undefined;
-export function getStatsCenterSafe() {
-    if (cachedStatsCenter) {
-        return cachedStatsCenter;
-    }
-    if (cachedStatsCenter === null) {
-        return { recordProviderUsage: () => { } };
-    }
-    try {
-        const mod = requireCoreDist('telemetry/stats-center');
-        const fn = mod?.getStatsCenter;
-        const center = typeof fn === 'function' ? fn() : null;
-        if (center && typeof center.recordProviderUsage === 'function') {
-            cachedStatsCenter = center;
-            return center;
-        }
-    }
-    catch {
-        // fall through
-    }
-    cachedStatsCenter = null;
-    return { recordProviderUsage: () => { } };
-}
-export function getLlmsStatsSnapshot() {
-    try {
-        const mod = requireCoreDist('telemetry/stats-center');
-        const get = mod?.getStatsCenter;
-        const center = typeof get === 'function' ? get() : null;
-        const snap = center && typeof center === 'object' ? center.getSnapshot : null;
-        return typeof snap === 'function' ? snap.call(center) : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 通过 llmswitch-core 的 bootstrapVirtualRouterConfig 预处理 Virtual Router 配置。
- */
-export async function bootstrapVirtualRouterConfig(input) {
-    const mod = await importCoreDist('router/virtual-router/bootstrap');
-    const fn = mod.bootstrapVirtualRouterConfig;
-    if (typeof fn !== 'function') {
-        throw new Error('[llmswitch-bridge] bootstrapVirtualRouterConfig not available');
-    }
-    return fn(input);
-}
-let cachedClockTaskStoreModule = undefined;
-let clockTaskStoreLastLoadAttemptAtMs = 0;
-let hasLoggedClockTaskStoreLoadFailure = false;
-const CLOCK_TASK_STORE_RETRY_INTERVAL_MS = 30_000;
-async function tryLoadClockTaskStoreModule() {
-    try {
-        return await importCoreDist('servertool/clock/task-store');
-    }
-    catch {
-        // fallback to legacy split exports
-    }
-    try {
-        const [tasksModule, configModule] = await Promise.all([
-            importCoreDist('servertool/clock/tasks'),
-            importCoreDist('servertool/clock/config')
-        ]);
-        return {
-            ...tasksModule,
-            resolveClockConfig: configModule.resolveClockConfig
-        };
-    }
-    catch {
-        return null;
-    }
-}
-async function getClockTaskStoreModuleSafe() {
-    if (cachedClockTaskStoreModule) {
-        return cachedClockTaskStoreModule;
-    }
-    const now = Date.now();
-    if (cachedClockTaskStoreModule === null &&
-        now - clockTaskStoreLastLoadAttemptAtMs < CLOCK_TASK_STORE_RETRY_INTERVAL_MS) {
-        return null;
-    }
-    clockTaskStoreLastLoadAttemptAtMs = now;
-    const loaded = await tryLoadClockTaskStoreModule();
-    if (loaded) {
-        cachedClockTaskStoreModule = loaded;
-        hasLoggedClockTaskStoreLoadFailure = false;
-        return loaded;
-    }
-    cachedClockTaskStoreModule = null;
-    if (!hasLoggedClockTaskStoreLoadFailure) {
-        hasLoggedClockTaskStoreLoadFailure = true;
-        console.warn('[llmswitch-bridge] clock task-store module unavailable; clock daemon inject/tasks are temporarily disabled. Please ensure @jsonstudio/llms dist is built and installed.');
-    }
-    return null;
-}
-export async function resolveClockConfigSnapshot(input) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.resolveClockConfig;
-    if (typeof fn !== 'function') {
-        return null;
-    }
-    try {
-        return fn(input) ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-export async function reserveClockDueTasks(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.reserveDueTasksForRequest;
-    if (typeof fn !== 'function') {
-        return { reservation: null };
-    }
-    try {
-        return await fn(args);
-    }
-    catch {
-        return { reservation: null };
-    }
-}
-export async function commitClockDueReservation(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.commitClockReservation;
-    if (typeof fn !== 'function') {
-        return;
-    }
-    try {
-        await fn(args.reservation, args.config);
-    }
-    catch {
-        // best-effort only
-    }
-}
-export async function listClockSessionIdsSnapshot() {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.listClockSessionIds;
-    if (typeof fn !== 'function') {
-        return [];
-    }
-    try {
-        const out = await fn();
-        return Array.isArray(out) ? out.filter((item) => typeof item === 'string' && item.trim()).map((item) => item.trim()) : [];
-    }
-    catch {
-        return [];
-    }
-}
-export async function listClockTasksSnapshot(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.listClockTasks;
-    if (typeof fn !== 'function') {
-        return [];
-    }
-    try {
-        const out = await fn(args.sessionId, args.config);
-        return Array.isArray(out) ? out : [];
-    }
-    catch {
-        return [];
-    }
-}
-export async function scheduleClockTasksSnapshot(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.scheduleClockTasks;
-    if (typeof fn !== 'function') {
-        return [];
-    }
-    try {
-        const out = await fn(args.sessionId, Array.isArray(args.items) ? args.items : [], args.config);
-        return Array.isArray(out) ? out : [];
-    }
-    catch {
-        return [];
-    }
-}
-export async function updateClockTaskSnapshot(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.updateClockTask;
-    if (typeof fn !== 'function') {
-        return null;
-    }
-    try {
-        return await fn(args.sessionId, args.taskId, args.patch, args.config);
-    }
-    catch {
-        return null;
-    }
-}
-export async function cancelClockTaskSnapshot(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.cancelClockTask;
-    if (typeof fn !== 'function') {
-        return false;
-    }
-    try {
-        return Boolean(await fn(args.sessionId, args.taskId, args.config));
-    }
-    catch {
-        return false;
-    }
-}
-export async function clearClockTasksSnapshot(args) {
-    const mod = await getClockTaskStoreModuleSafe();
-    const fn = mod?.clearClockTasks;
-    if (typeof fn !== 'function') {
-        return 0;
-    }
-    try {
-        const removed = await fn(args.sessionId, args.config);
-        return Number.isFinite(Number(removed)) ? Math.max(0, Math.floor(Number(removed))) : 0;
-    }
-    catch {
-        return 0;
-    }
-}
-const cachedHubPipelineCtorByImpl = {
-    ts: null,
-    engine: null
-};
-/**
- * 获取 HubPipeline 构造函数，供 Host 创建 HubPipeline 实例。
- */
-export async function getHubPipelineCtor() {
-    const impl = resolveImplForSubpath('conversion/hub/pipeline/hub-pipeline');
-    if (!cachedHubPipelineCtorByImpl[impl]) {
-        const mod = await importCoreDist('conversion/hub/pipeline/hub-pipeline', impl);
-        const Ctor = mod.HubPipeline;
-        if (typeof Ctor !== 'function') {
-            throw new Error('[llmswitch-bridge] HubPipeline constructor not available');
-        }
-        cachedHubPipelineCtorByImpl[impl] = Ctor;
-    }
-    return cachedHubPipelineCtorByImpl[impl];
-}
-export async function getHubPipelineCtorForImpl(impl) {
-    if (!cachedHubPipelineCtorByImpl[impl]) {
-        const mod = await importCoreDist('conversion/hub/pipeline/hub-pipeline', impl);
-        const Ctor = mod.HubPipeline;
-        if (typeof Ctor !== 'function') {
-            throw new Error('[llmswitch-bridge] HubPipeline constructor not available');
-        }
-        cachedHubPipelineCtorByImpl[impl] = Ctor;
-    }
-    return cachedHubPipelineCtorByImpl[impl];
-}
-function resolveBaseDir() {
-    const env = String(process.env.ROUTECODEX_BASEDIR || process.env.RCC_BASEDIR || '').trim();
-    if (env) {
-        return env;
-    }
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        return path.resolve(path.dirname(__filename), '../../..');
-    }
-    catch {
-        return process.cwd();
-    }
-}
+// Core module loading utilities.
+export { importCoreDist, requireCoreDist, resolveImplForSubpath } from './bridge/module-loader.js';
+// Existing bridge exports.
+export { createSnapshotRecorder } from './bridge/snapshot-recorder.js';
+export { convertProviderResponse } from './bridge/response-converter.js';
+export { warmupAntigravitySessionSignatureModule, extractAntigravityGeminiSessionId, cacheAntigravitySessionSignature, getAntigravityLatestSignatureSessionIdForAlias, lookupAntigravitySessionSignatureEntry, invalidateAntigravitySessionSignature, clearAntigravitySessionAliasPins, resetAntigravitySessionSignatureCachesForTests, configureAntigravitySessionSignaturePersistence, flushAntigravitySessionSignaturePersistenceSync } from './bridge/antigravity-signature.js';
+// Newly factored bridge modules.
+export { createCoreQuotaManager } from './bridge/quota-manager.js';
+export { writeSnapshotViaHooks, resumeResponsesConversation, rebindResponsesConversationRequestId, createResponsesSseToJsonConverter, getProviderErrorCenter, getProviderSuccessCenter } from './bridge/runtime-integrations.js';
+export { loadRoutingInstructionStateSync, saveRoutingInstructionStateAsync, saveRoutingInstructionStateSync, extractSessionIdentifiersFromMetadata, getStatsCenterSafe, getLlmsStatsSnapshot, resolveClockConfigSnapshot, reserveClockDueTasks, commitClockDueReservation, listClockSessionIdsSnapshot, listClockTasksSnapshot, scheduleClockTasksSnapshot, updateClockTaskSnapshot, cancelClockTaskSnapshot, clearClockTasksSnapshot } from './bridge/state-integrations.js';
+export { bootstrapVirtualRouterConfig, getHubPipelineCtor, getHubPipelineCtorForImpl, resolveBaseDir } from './bridge/routing-integrations.js';
 //# sourceMappingURL=bridge.js.map