@jsonstudio/rcc 0.90.352 → 0.90.367

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/helpers.js

@@ -0,0 +1,226 @@
+import { extractMessageText } from '../message-utils.js';
+export const DEFAULT_STOP_MESSAGE_MAX_REPEATS = 10;
+export function isStopScopeTraceEnabled() {
+    const raw = String(process.env.ROUTECODEX_STOP_SCOPE_TRACE ?? process.env.RCC_STOP_SCOPE_TRACE ?? '')
+        .trim()
+        .toLowerCase();
+    return (raw === '1' ||
+        raw === 'true' ||
+        raw === 'on' ||
+        raw === 'yes' ||
+        raw === 'debug' ||
+        raw === 'trace' ||
+        raw === 'verbose');
+}
+export function normalizeStopMessageStageMode(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'on' || normalized === 'off' || normalized === 'auto') {
+        return normalized;
+    }
+    return undefined;
+}
+export function normalizeStopMessageAiMode(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'on' || normalized === 'off') {
+        return normalized;
+    }
+    return undefined;
+}
+export function stripStopMessageFields(state) {
+    return {
+        ...state,
+        stopMessageSource: undefined,
+        stopMessageText: undefined,
+        stopMessageMaxRepeats: undefined,
+        stopMessageUsed: undefined,
+        stopMessageUpdatedAt: undefined,
+        stopMessageLastUsedAt: undefined,
+        stopMessageStageMode: undefined,
+        stopMessageAiMode: undefined,
+        stopMessageAiSeedPrompt: undefined,
+        stopMessageAiHistory: undefined
+    };
+}
+export function stripClientInjectScopedFields(state) {
+    return {
+        ...stripStopMessageFields(state),
+        preCommandSource: undefined,
+        preCommandScriptPath: undefined,
+        preCommandUpdatedAt: undefined
+    };
+}
+export function hasClientInjectScopedFields(state) {
+    if (!state) {
+        return false;
+    }
+    return (typeof state.stopMessageText === 'string' ||
+        typeof state.stopMessageMaxRepeats === 'number' ||
+        typeof state.stopMessageUsed === 'number' ||
+        typeof state.stopMessageStageMode === 'string' ||
+        typeof state.stopMessageAiMode === 'string' ||
+        typeof state.stopMessageAiSeedPrompt === 'string' ||
+        Array.isArray(state.stopMessageAiHistory) ||
+        typeof state.preCommandScriptPath === 'string' ||
+        typeof state.preCommandUpdatedAt === 'number');
+}
+export function hasRoutingInstructionMarker(messages) {
+    for (const message of messages) {
+        if (!message || message.role !== 'user') {
+            continue;
+        }
+        const content = extractMessageText(message);
+        if (!content) {
+            continue;
+        }
+        if (/<\*\*[\s\S]*?\*\*>/.test(content)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function hasLatestUserRoutingInstructionMarker(messages) {
+    for (let idx = messages.length - 1; idx >= 0; idx -= 1) {
+        const message = messages[idx];
+        if (!message) {
+            continue;
+        }
+        if (message.role !== 'user') {
+            continue;
+        }
+        const content = extractMessageText(message);
+        if (!content) {
+            return false;
+        }
+        return /<\*\*[\s\S]*?\*\*>/.test(content);
+    }
+    return false;
+}
+function extractResponsesInputText(entry) {
+    if (typeof entry.content === 'string' && entry.content.trim()) {
+        return entry.content;
+    }
+    if (Array.isArray(entry.content)) {
+        return extractMessageText({ role: 'user', content: entry.content });
+    }
+    return '';
+}
+export function getLatestUserTextFromResponsesContext(context) {
+    if (!context || typeof context !== 'object') {
+        return '';
+    }
+    const input = context.input;
+    if (!Array.isArray(input) || input.length === 0) {
+        return '';
+    }
+    for (let idx = input.length - 1; idx >= 0; idx -= 1) {
+        const entry = input[idx];
+        if (!entry || typeof entry !== 'object') {
+            continue;
+        }
+        const record = entry;
+        const entryType = typeof record.type === 'string' ? record.type.trim().toLowerCase() : 'message';
+        if (entryType !== 'message') {
+            continue;
+        }
+        const role = typeof record.role === 'string' ? record.role.trim().toLowerCase() : 'user';
+        if (role !== 'user') {
+            continue;
+        }
+        const text = extractResponsesInputText(record).trim();
+        if (text) {
+            return text;
+        }
+    }
+    return '';
+}
+export function hasRoutingInstructionMarkerInResponsesContext(context) {
+    const latestUserText = getLatestUserTextFromResponsesContext(context);
+    if (!latestUserText) {
+        return false;
+    }
+    return /<\*\*[\s\S]*?\*\*>/.test(latestUserText);
+}
+export function cleanResponsesContextFromRoutingInstructions(context) {
+    if (!context || typeof context !== 'object') {
+        return;
+    }
+    const record = context;
+    if (!Array.isArray(record.input)) {
+        return;
+    }
+    const cleaned = record.input
+        .map((entry) => {
+        if (!entry || typeof entry !== 'object') {
+            return entry;
+        }
+        const row = entry;
+        const entryType = typeof row.type === 'string' ? row.type.trim().toLowerCase() : 'message';
+        if (entryType !== 'message') {
+            return entry;
+        }
+        const role = typeof row.role === 'string' ? row.role.trim().toLowerCase() : 'user';
+        if (role !== 'user') {
+            return entry;
+        }
+        if (typeof row.content === 'string') {
+            const cleanedText = row.content.replace(/<\*\*[\s\S]*?\*\*>/g, '').trim();
+            if (!cleanedText) {
+                return null;
+            }
+            return { ...row, content: cleanedText };
+        }
+        if (Array.isArray(row.content)) {
+            const nextContent = row.content
+                .map((part) => {
+                if (typeof part === 'string') {
+                    const cleanedText = part.replace(/<\*\*[\s\S]*?\*\*>/g, '').trim();
+                    return cleanedText ? cleanedText : null;
+                }
+                if (!part || typeof part !== 'object' || Array.isArray(part)) {
+                    return part;
+                }
+                const partRecord = part;
+                if (typeof partRecord.text === 'string') {
+                    const cleanedText = partRecord.text.replace(/<\*\*[\s\S]*?\*\*>/g, '').trim();
+                    if (!cleanedText) {
+                        return null;
+                    }
+                    return { ...partRecord, text: cleanedText };
+                }
+                if (typeof partRecord.content === 'string') {
+                    const cleanedText = partRecord.content.replace(/<\*\*[\s\S]*?\*\*>/g, '').trim();
+                    if (!cleanedText) {
+                        return null;
+                    }
+                    return { ...partRecord, content: cleanedText };
+                }
+                return part;
+            })
+                .filter((part) => part !== null);
+            if (!nextContent.length) {
+                return null;
+            }
+            return { ...row, content: nextContent };
+        }
+        return entry;
+    })
+        .filter((entry) => entry !== null);
+    record.input = cleaned;
+}
+export function isServerToolFollowupRequest(metadata) {
+    if (!metadata || typeof metadata !== 'object') {
+        return false;
+    }
+    const rt = metadata.__rt;
+    if (!rt || typeof rt !== 'object' || Array.isArray(rt)) {
+        return false;
+    }
+    const flag = rt.serverToolFollowup;
+    return flag === true || (typeof flag === 'string' && flag.trim().toLowerCase() === 'true');
+}

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/route-utils.d.ts

@@ -0,0 +1,19 @@
+import type { RoutePoolTier } from '../types.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function normalizeRouteAlias(routeName: string | undefined): string;
+export declare function buildRouteCandidates(engine: VirtualRouterEngine, requestedRoute: string, classificationCandidates: string[] | undefined, features: {
+    hasImageAttachment?: boolean;
+    hasVideoAttachment?: boolean;
+    hasLocalVideoAttachment?: boolean;
+}): string[];
+export declare function reorderForInlineVision(engine: VirtualRouterEngine, routeNames: string[]): string[];
+export declare function reorderForPreferredModel(engine: VirtualRouterEngine, routeNames: string[], modelId: string): string[];
+export declare function routeSupportsModel(engine: VirtualRouterEngine, routeName: string, modelId: string): boolean;
+export declare function routeSupportsInlineVision(engine: VirtualRouterEngine, routeName: string): boolean;
+export declare function sortByPriority(routeNames: string[]): string[];
+export declare function routeWeight(routeName: string): number;
+export declare function routeHasForceFlag(engine: VirtualRouterEngine, routeName: string): boolean;
+export declare function routeHasTargets(engine: VirtualRouterEngine, pools?: RoutePoolTier[]): boolean;
+export declare function hasPrimaryPool(engine: VirtualRouterEngine, pools?: RoutePoolTier[]): boolean;
+export declare function sortRoutePools(_engine: VirtualRouterEngine, pools?: RoutePoolTier[]): RoutePoolTier[];
+export declare function flattenPoolTargets(_engine: VirtualRouterEngine, pools?: RoutePoolTier[]): string[];

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/route-utils.js

@@ -0,0 +1,212 @@
+import { DEFAULT_ROUTE, ROUTE_PRIORITY } from '../types.js';
+export function normalizeRouteAlias(routeName) {
+    const base = routeName && routeName.trim() ? routeName.trim() : DEFAULT_ROUTE;
+    return base;
+}
+export function buildRouteCandidates(engine, requestedRoute, classificationCandidates, features) {
+    const forceVision = routeHasForceFlag(engine, 'vision');
+    const hasMultimodalTargets = routeHasTargets(engine, engine.routing.multimodal);
+    const hasVisionTargets = routeHasTargets(engine, engine.routing.vision);
+    const hasLocalVideoAttachment = features.hasVideoAttachment === true && features.hasLocalVideoAttachment === true;
+    if (features.hasImageAttachment && hasLocalVideoAttachment && hasVisionTargets) {
+        return ['vision'];
+    }
+    const normalized = normalizeRouteAlias(requestedRoute || DEFAULT_ROUTE);
+    const baseList = [];
+    if (classificationCandidates && classificationCandidates.length) {
+        for (const candidate of classificationCandidates) {
+            baseList.push(normalizeRouteAlias(candidate));
+        }
+    }
+    else if (normalized) {
+        baseList.push(normalized);
+    }
+    if (features.hasImageAttachment) {
+        if (hasMultimodalTargets) {
+            if (!baseList.includes('multimodal')) {
+                baseList.unshift('multimodal');
+            }
+        }
+        if (hasVisionTargets && (!hasMultimodalTargets || forceVision)) {
+            if (!baseList.includes('vision')) {
+                baseList.push('vision');
+            }
+        }
+        if (!forceVision && hasMultimodalTargets) {
+            const visionAwareRoutes = [DEFAULT_ROUTE, 'thinking'];
+            for (const routeName of visionAwareRoutes) {
+                if (routeHasTargets(engine, engine.routing[routeName]) && !baseList.includes(routeName)) {
+                    baseList.push(routeName);
+                }
+            }
+        }
+    }
+    let ordered = sortByPriority(baseList);
+    if (features.hasImageAttachment && !forceVision && hasMultimodalTargets) {
+        ordered = reorderForInlineVision(engine, ordered);
+    }
+    if (features.hasImageAttachment && hasMultimodalTargets) {
+        ordered = reorderForPreferredModel(engine, ordered, 'kimi-k2.5');
+    }
+    const deduped = [];
+    for (const routeName of ordered) {
+        if (routeName && !deduped.includes(routeName)) {
+            deduped.push(routeName);
+        }
+    }
+    if (!deduped.includes(DEFAULT_ROUTE)) {
+        deduped.push(DEFAULT_ROUTE);
+    }
+    const filtered = deduped.filter((routeName) => routeHasTargets(engine, engine.routing[routeName]));
+    if (!filtered.includes(DEFAULT_ROUTE) && routeHasTargets(engine, engine.routing[DEFAULT_ROUTE])) {
+        filtered.push(DEFAULT_ROUTE);
+    }
+    return filtered.length ? filtered : [DEFAULT_ROUTE];
+}
+export function reorderForInlineVision(engine, routeNames) {
+    const unique = Array.from(new Set(routeNames.filter(Boolean)));
+    if (!unique.length) {
+        return unique;
+    }
+    // 仅当 default/thinking 中存在 Responses/Gemini 提供方时，才将其提前作为「一次完成」优先级。
+    const inlinePreferred = [];
+    const inlineRoutes = [DEFAULT_ROUTE, 'thinking'];
+    for (const routeName of inlineRoutes) {
+        if (routeSupportsInlineVision(engine, routeName) && !inlinePreferred.includes(routeName)) {
+            inlinePreferred.push(routeName);
+        }
+    }
+    if (!inlinePreferred.length) {
+        return unique;
+    }
+    const remaining = [];
+    for (const routeName of unique) {
+        if (!inlinePreferred.includes(routeName)) {
+            remaining.push(routeName);
+        }
+    }
+    return [...inlinePreferred, ...remaining];
+}
+export function reorderForPreferredModel(engine, routeNames, modelId) {
+    const unique = Array.from(new Set(routeNames.filter(Boolean)));
+    if (!unique.length) {
+        return unique;
+    }
+    const preferred = unique.filter((routeName) => routeSupportsModel(engine, routeName, modelId));
+    if (!preferred.length) {
+        return unique;
+    }
+    const remaining = unique.filter((routeName) => !preferred.includes(routeName));
+    return [...preferred, ...remaining];
+}
+export function routeSupportsModel(engine, routeName, modelId) {
+    const normalizedModel = modelId.trim().toLowerCase();
+    if (!normalizedModel) {
+        return false;
+    }
+    const pools = engine.routing[routeName];
+    if (!Array.isArray(pools)) {
+        return false;
+    }
+    for (const pool of pools) {
+        if (!Array.isArray(pool.targets)) {
+            continue;
+        }
+        for (const providerKey of pool.targets) {
+            try {
+                const profile = engine.providerRegistry.get(providerKey);
+                const candidate = typeof profile.modelId === 'string' ? profile.modelId.trim().toLowerCase() : '';
+                if (candidate === normalizedModel) {
+                    return true;
+                }
+            }
+            catch {
+                // ignore unknown provider keys during capability probing
+            }
+        }
+    }
+    return false;
+}
+export function routeSupportsInlineVision(engine, routeName) {
+    const pools = engine.routing[routeName];
+    if (!Array.isArray(pools)) {
+        return false;
+    }
+    for (const pool of pools) {
+        if (!Array.isArray(pool.targets)) {
+            continue;
+        }
+        for (const providerKey of pool.targets) {
+            try {
+                const profile = engine.providerRegistry.get(providerKey);
+                if (profile.providerType === 'responses' || profile.providerType === 'gemini') {
+                    return true;
+                }
+            }
+            catch {
+                // ignore unknown provider keys during capability probing
+            }
+        }
+    }
+    return false;
+}
+export function sortByPriority(routeNames) {
+    return [...routeNames].sort((a, b) => routeWeight(a) - routeWeight(b));
+}
+export function routeWeight(routeName) {
+    const idx = ROUTE_PRIORITY.indexOf(routeName);
+    return idx >= 0 ? idx : ROUTE_PRIORITY.length;
+}
+export function routeHasForceFlag(engine, routeName) {
+    const pools = engine.routing[routeName];
+    if (!Array.isArray(pools)) {
+        return false;
+    }
+    return pools.some((pool) => pool.force);
+}
+export function routeHasTargets(engine, pools) {
+    if (!Array.isArray(pools)) {
+        return false;
+    }
+    return pools.some((pool) => Array.isArray(pool.targets) && pool.targets.length > 0);
+}
+export function hasPrimaryPool(engine, pools) {
+    if (!Array.isArray(pools)) {
+        return false;
+    }
+    return pools.some((pool) => !pool.backup && Array.isArray(pool.targets) && pool.targets.length > 0);
+}
+export function sortRoutePools(_engine, pools) {
+    if (!Array.isArray(pools)) {
+        return [];
+    }
+    return pools
+        .filter((pool) => Array.isArray(pool.targets) && pool.targets.length > 0)
+        .sort((a, b) => {
+        if (a.backup && !b.backup)
+            return 1;
+        if (!a.backup && b.backup)
+            return -1;
+        if (a.priority !== b.priority) {
+            return b.priority - a.priority;
+        }
+        return a.id.localeCompare(b.id);
+    });
+}
+export function flattenPoolTargets(_engine, pools) {
+    const flattened = [];
+    if (!Array.isArray(pools)) {
+        return flattened;
+    }
+    for (const pool of pools) {
+        if (!Array.isArray(pool.targets)) {
+            continue;
+        }
+        for (const target of pool.targets) {
+            if (typeof target === 'string' && target && !flattened.includes(target)) {
+                flattened.push(target);
+            }
+        }
+    }
+    return flattened;
+}

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/selection-core.d.ts

@@ -0,0 +1,28 @@
+import type { ClassificationResult, RouterMetadataInput, RoutingFeatures } from '../types.js';
+import type { RoutingInstructionState } from '../routing-instructions.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function selectProvider(engine: VirtualRouterEngine, requestedRoute: string, metadata: RouterMetadataInput, classification: ClassificationResult, features: RoutingFeatures, routingState?: RoutingInstructionState): {
+    providerKey: string;
+    routeUsed: string;
+    pool: string[];
+    poolId?: string;
+};
+export declare function selectFromCandidates(engine: VirtualRouterEngine, routes: string[], metadata: RouterMetadataInput, classification: ClassificationResult, features: RoutingFeatures, state: RoutingInstructionState, requiredProviderKeys?: Set<string>, allowAliasRotation?: boolean): {
+    providerKey: string;
+    routeUsed: string;
+    pool: string[];
+    poolId?: string;
+};
+/**
+ * 在 sticky 模式下，仅在 sticky 池内选择 Provider：
+ * - stickyKeySet 表示已经解析并通过健康检查的 providerKey 集合；
+ * - 不再依赖 routing[*].targets 中是否挂载这些 key，避免「未初始化路由池」导致 sticky 池为空；
+ * - 仍然尊重 allowed/disabledProviders、disabledKeys、disabledModels 以及上下文长度。
+ */
+export declare function selectFromStickyPool(engine: VirtualRouterEngine, stickyKeySet: Set<string>, metadata: RouterMetadataInput, features: RoutingFeatures, state: RoutingInstructionState, allowAliasRotation?: boolean): {
+    providerKey: string;
+    routeUsed: string;
+    pool: string[];
+    poolId?: string;
+} | null;
+export declare function extractExcludedProviderKeySet(engine: VirtualRouterEngine, metadata: RouterMetadataInput | undefined): Set<string>;

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/selection-core.js

@@ -0,0 +1,112 @@
+import { DEFAULT_ROUTE } from '../types.js';
+import { getRoutingInstructionState } from '../engine/routing-state/store.js';
+import { selectProviderImpl } from '../engine/routing-pools/index.js';
+import { extractKeyAlias, extractKeyIndex, extractProviderId, getProviderModelId } from '../engine/provider-key/parse.js';
+export function selectProvider(engine, requestedRoute, metadata, classification, features, routingState) {
+    const activeState = routingState ||
+        getRoutingInstructionState(engine.resolveStickyKey(metadata), engine.routingInstructionState, engine.routingStateStore);
+    return selectProviderImpl(requestedRoute, metadata, classification, features, activeState, {
+        routing: engine.routing,
+        providerRegistry: engine.providerRegistry,
+        healthManager: engine.healthManager,
+        contextAdvisor: engine.contextAdvisor,
+        loadBalancer: engine.loadBalancer,
+        isProviderCoolingDown: (key) => engine.isProviderCoolingDown(key),
+        getProviderCooldownRemainingMs: (key) => engine.getProviderCooldownRemainingMs(key),
+        resolveStickyKey: (m) => engine.resolveStickyKey(m),
+        quotaView: engine.quotaView,
+        aliasQueueStore: engine.stickySessionManager.getAllStores().aliasQueueStore,
+        antigravityAliasLeaseStore: engine.stickySessionManager.getAllStores().aliasLeaseStore,
+        antigravitySessionAliasStore: engine.stickySessionManager.getAllStores().sessionAliasStore,
+        antigravityAliasReuseCooldownMs: engine.stickySessionManager.getAliasReuseCooldownMs()
+    }, { routingState });
+}
+export function selectFromCandidates(engine, routes, metadata, classification, features, state, requiredProviderKeys, allowAliasRotation) {
+    // legacy helper kept for backward compatibility; selection logic moved to engine-selection.ts
+    return selectProviderImpl(engine.normalizeRouteAlias(classification.routeName || DEFAULT_ROUTE), metadata, classification, features, state, {
+        routing: engine.routing,
+        providerRegistry: engine.providerRegistry,
+        healthManager: engine.healthManager,
+        contextAdvisor: engine.contextAdvisor,
+        loadBalancer: engine.loadBalancer,
+        isProviderCoolingDown: (key) => engine.isProviderCoolingDown(key),
+        getProviderCooldownRemainingMs: (key) => engine.getProviderCooldownRemainingMs(key),
+        resolveStickyKey: (m) => engine.resolveStickyKey(m),
+        quotaView: engine.quotaView,
+        aliasQueueStore: engine.stickySessionManager.getAllStores().aliasQueueStore
+    }, { routingState: state });
+}
+/**
+ * 在 sticky 模式下，仅在 sticky 池内选择 Provider：
+ * - stickyKeySet 表示已经解析并通过健康检查的 providerKey 集合；
+ * - 不再依赖 routing[*].targets 中是否挂载这些 key，避免「未初始化路由池」导致 sticky 池为空；
+ * - 仍然尊重 allowed/disabledProviders、disabledKeys、disabledModels 以及上下文长度。
+ */
+export function selectFromStickyPool(engine, stickyKeySet, metadata, features, state, allowAliasRotation) {
+    if (!stickyKeySet || stickyKeySet.size === 0) {
+        return null;
+    }
+    const allowedProviders = new Set(state.allowedProviders);
+    const disabledProviders = new Set(state.disabledProviders);
+    const disabledKeysMap = new Map(Array.from(state.disabledKeys.entries()).map(([provider, keys]) => [
+        provider,
+        new Set(Array.from(keys).map((k) => (typeof k === 'string' ? k : k + 1)))
+    ]));
+    const disabledModels = new Map(Array.from(state.disabledModels.entries()).map(([provider, models]) => [provider, new Set(models)]));
+    // 初始候选集合：sticky 池中的所有 key
+    // In quota routing mode, cooldown is controlled by quotaView only.
+    let candidates = Array.from(stickyKeySet).filter((key) => (engine.quotaView ? true : !engine.isProviderCoolingDown(key)));
+    // 应用 provider 白名单 / 黑名单
+    if (allowedProviders.size > 0) {
+        candidates = candidates.filter((key) => {
+            const providerId = extractProviderId(key);
+            return providerId && allowedProviders.has(providerId);
+        });
+    }
+    if (disabledProviders.size > 0) {
+        candidates = candidates.filter((key) => {
+            const providerId = extractProviderId(key);
+            return providerId && !disabledProviders.has(providerId);
+        });
+    }
+    // 应用 key / model 级别黑名单
+    if (disabledKeysMap.size > 0 || disabledModels.size > 0) {
+        candidates = candidates.filter((key) => {
+            const providerId = extractProviderId(key);
+            if (!providerId) {
+                return true;
+            }
+            const disabledKeys = disabledKeysMap.get(providerId);
+            if (disabledKeys && disabledKeys.size > 0) {
+                const keyAlias = extractKeyAlias(key);
+                const keyIndex = extractKeyIndex(key);
+                if (keyAlias && disabledKeys.has(keyAlias)) {
+                    return false;
+                }
+                if (keyIndex !== undefined && disabledKeys.has(keyIndex + 1)) {
+                    return false;
+                }
+            }
+            const disabledModelSet = disabledModels.get(providerId);
+            if (disabledModelSet && disabledModelSet.size > 0) {
+                const modelId = getProviderModelId(key, engine.providerRegistry);
+                if (modelId && disabledModelSet.has(modelId)) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    if (!candidates.length) {
+        return null;
+    }
+    const stickyKey = allowAliasRotation ? undefined : engine.resolveStickyKey(metadata);
+    const estimatedTokens = typeof features.estimatedTokens === 'number' && Number.isFinite(features.estimatedTokens)
+        ? Math.max(0, features.estimatedTokens)
+        : 0;
+    // delegate to selection module
+    return null;
+}
+export function extractExcludedProviderKeySet(engine, metadata) {
+    return engine.routeAnalytics.extractExcludedProviderKeySet(metadata);
+}

package/vendor/llmswitch-core/dist/router/virtual-router/engine-legacy/selection-state.d.ts

@@ -0,0 +1,16 @@
+import type { RoutingInstructionState } from '../routing-instructions.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function resolveSelectionPenalty(engine: VirtualRouterEngine, providerKey: string): number | undefined;
+export declare function resolveInstructionProcessModeForSelection(engine: VirtualRouterEngine, providerKey: string, routingState: RoutingInstructionState): 'chat' | 'passthrough' | undefined;
+export declare function resolveInstructionTarget(engine: VirtualRouterEngine, target: NonNullable<RoutingInstructionState['forcedTarget']>): {
+    mode: 'exact' | 'filter';
+    keys: string[];
+} | null;
+export declare function filterCandidatesByRoutingState(engine: VirtualRouterEngine, routes: string[], state: RoutingInstructionState): string[];
+/**
+ * 在已有候选路由集合上，筛选出真正挂载了 sticky 池内 providerKey 的路由，
+ * 并按 ROUTE_PRIORITY 进行排序；同时显式排除 tools 路由，保证一旦进入
+ * sticky 模式，就不会再命中独立的 tools 池（例如 glm/qwen 工具模型）。
+ * 若候选集合中完全没有挂载 sticky key 的路由，则尝试在 default 路由上兜底。
+ */
+export declare function buildStickyRouteCandidatesFromFiltered(engine: VirtualRouterEngine, filteredCandidates: string[], stickyKeySet: Set<string>): string[];