@jsonstudio/llms 0.6.2979 → 0.6.3238

package/dist/router/virtual-router/bootstrap/streaming-helpers.js

@@ -83,6 +83,29 @@ export function normalizeModelContextTokens(provider) {
         defaultContextTokens: defaultCandidate
     };
 }
+/**
+ * Normalize model-level output token limits (maxTokens / max_output_tokens).
+ */
+export function normalizeModelOutputTokens(provider) {
+    const modelsNode = asRecord(provider.models);
+    const normalized = {};
+    for (const [modelId, modelRaw] of Object.entries(modelsNode)) {
+        if (!modelRaw || typeof modelRaw !== 'object') {
+            continue;
+        }
+        const candidate = readOutputTokens(modelRaw);
+        if (candidate) {
+            normalized[modelId] = candidate;
+        }
+    }
+    const configNode = asRecord(provider.config);
+    const defaultsNode = asRecord(configNode?.userConfigDefaults);
+    const defaultCandidate = readOutputTokens(provider) ?? readOutputTokens(configNode) ?? readOutputTokens(defaultsNode);
+    return {
+        modelOutputTokens: Object.keys(normalized).length ? normalized : undefined,
+        defaultOutputTokens: defaultCandidate
+    };
+}
 /**
  * Read context tokens from various field names.
  */
@@ -107,6 +130,27 @@ function readContextTokens(record) {
     }
     return undefined;
 }
+function readOutputTokens(record) {
+    if (!record) {
+        return undefined;
+    }
+    const keys = [
+        'maxOutputTokens',
+        'max_output_tokens',
+        'maxTokens',
+        'max_tokens',
+        'outputTokens',
+        'output_tokens'
+    ];
+    for (const key of keys) {
+        const value = record[key];
+        const parsed = normalizePositiveInteger(value);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
 /**
  * Normalize positive integer value.
  */

package/dist/router/virtual-router/bootstrap.js

@@ -129,6 +129,8 @@ function buildProviderRuntimeEntries(providers) {
                 responsesConfig: normalizedProvider.responsesConfig,
                 streaming: normalizedProvider.streaming,
                 modelStreaming: normalizedProvider.modelStreaming,
+                modelOutputTokens: normalizedProvider.modelOutputTokens,
+                defaultOutputTokens: normalizedProvider.defaultOutputTokens,
                 modelContextTokens: normalizedProvider.modelContextTokens,
                 defaultContextTokens: normalizedProvider.defaultContextTokens,
                 ...(normalizedProvider.deepseek ? { deepseek: normalizedProvider.deepseek } : {}),

package/dist/router/virtual-router/engine/routing-state/store.d.ts

@@ -1,6 +1,6 @@
 import type { RouterMetadataInput } from '../../types.js';
 import type { RoutingInstructionState } from '../../routing-instructions.js';
-type RoutingInstructionStateStoreLike = {
+export type RoutingInstructionStateStoreLike = {
     loadSync: (key: string) => RoutingInstructionState | null;
     saveAsync: (key: string, state: RoutingInstructionState | null) => void;
     saveSync?: (key: string, state: RoutingInstructionState | null) => void;
@@ -8,4 +8,3 @@ type RoutingInstructionStateStoreLike = {
 export declare function resolveStopMessageScope(metadata: RouterMetadataInput): string | undefined;
 export declare function getRoutingInstructionState(stickyKey: string | undefined, routingInstructionState: Map<string, RoutingInstructionState>, routingStateStore: RoutingInstructionStateStoreLike): RoutingInstructionState;
 export declare function persistRoutingInstructionState(key: string, state: RoutingInstructionState, routingStateStore: RoutingInstructionStateStoreLike): void;
-export {};

package/dist/router/virtual-router/engine/routing-state/store.js

@@ -32,7 +32,7 @@ export function resolveStopMessageScope(metadata) {
 export function getRoutingInstructionState(stickyKey, routingInstructionState, routingStateStore) {
     const key = stickyKey || 'default';
     const existing = routingInstructionState.get(key);
-    // 对 session:/conversation: 作用域，在每次读取时尝试从磁盘刷新 stopMessage 相关字段，
+    // 对 session:/conversation:/tmux: 作用域，在每次读取时尝试从磁盘刷新 stopMessage 相关字段，
     // 确保 servertool（如 stop_message_auto）通过 sticky-session-store 更新的使用次数
     // 能在 VirtualRouter 日志中实时反映出来。
     if (existing && isPersistentScopeKey(key)) {
@@ -61,7 +61,7 @@ export function getRoutingInstructionState(stickyKey, routingInstructionState, r
         return existing;
     }
     let initial = null;
-    // 仅对 session:/conversation: 作用域的 key 尝试从磁盘恢复持久化状态
+    // 仅对 session:/conversation:/tmux: 作用域的 key 尝试从磁盘恢复持久化状态
     if (isPersistentScopeKey(key)) {
         initial = routingStateStore.loadSync(key);
     }

package/dist/router/virtual-router/engine-legacy/config.d.ts

@@ -0,0 +1,11 @@
+import type { ProviderQuotaView } from '../types.js';
+import type { VirtualRouterConfig, VirtualRouterHealthStore } from '../types.js';
+import type { RoutingInstructionStateStoreLike } from '../engine/routing-state/store.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function updateDeps(engine: VirtualRouterEngine, deps: {
+    healthStore?: VirtualRouterHealthStore | null;
+    routingStateStore?: RoutingInstructionStateStoreLike | null;
+    quotaView?: ProviderQuotaView | null;
+}): void;
+export declare function initialize(engine: VirtualRouterEngine, config: VirtualRouterConfig): void;
+export declare function validateConfig(engine: VirtualRouterEngine, config: VirtualRouterConfig): void;

package/dist/router/virtual-router/engine-legacy/config.js

@@ -0,0 +1,108 @@
+import { RouteLoadBalancer } from '../load-balancer.js';
+import { StickySessionManager } from '../engine/sticky-session-manager.js';
+import { RoutingClassifier } from '../classifier.js';
+import { loadRoutingInstructionStateSync, saveRoutingInstructionStateAsync, saveRoutingInstructionStateSync } from '../sticky-session-store.js';
+import { resolveAntigravityAliasReuseCooldownMs, hydrateAntigravityAliasLeaseStoreIfNeeded } from '../engine/antigravity/alias-lease.js';
+import { routeHasTargets, hasPrimaryPool } from './route-utils.js';
+import { DEFAULT_ROUTE, VirtualRouterError, VirtualRouterErrorCode } from '../types.js';
+export function updateDeps(engine, deps) {
+    if (!deps || typeof deps !== 'object') {
+        return;
+    }
+    if ('healthStore' in deps) {
+        engine.healthStore = deps.healthStore ?? undefined;
+        engine.cooldownManager.updateDeps({ healthStore: engine.healthStore });
+    }
+    if ('routingStateStore' in deps) {
+        engine.routingStateStore =
+            deps.routingStateStore ??
+                {
+                    loadSync: loadRoutingInstructionStateSync,
+                    saveAsync: saveRoutingInstructionStateAsync,
+                    saveSync: saveRoutingInstructionStateSync
+                };
+        // Routing state store changes require clearing in-memory cache to avoid stale reads.
+        engine.routingInstructionState.clear();
+    }
+    if ('quotaView' in deps) {
+        const prevQuotaEnabled = Boolean(engine.quotaView);
+        engine.quotaView = deps.quotaView ?? undefined;
+        engine.cooldownManager.updateDeps({ quotaView: engine.quotaView });
+        const nextQuotaEnabled = Boolean(engine.quotaView);
+        // When quotaView is enabled, health/cooldown decisions must be driven by quotaView only.
+        // - Enabling quotaView: clear any legacy router-local cooldown TTLs immediately.
+        // - Disabling quotaView: reload legacy cooldown state from health snapshots.
+        if (!prevQuotaEnabled && nextQuotaEnabled) {
+            engine.cooldownManager.clearAllCooldowns();
+        }
+        else if (prevQuotaEnabled && !nextQuotaEnabled) {
+            engine.cooldownManager.clearAllCooldowns();
+            engine.restoreHealthFromStore();
+        }
+    }
+}
+export function initialize(engine, config) {
+    validateConfig(engine, config);
+    engine.routing = config.routing;
+    engine.providerRegistry.load(config.providers);
+    engine.healthManager.configure(config.health);
+    engine.healthConfig = config.health ?? null;
+    engine.healthManager.registerProviders(Object.keys(config.providers));
+    engine.cooldownManager.clearAllCooldowns();
+    engine.restoreHealthFromStore();
+    engine.loadBalancer = new RouteLoadBalancer(config.loadBalancing);
+    const aliasReuseCooldownMs = resolveAntigravityAliasReuseCooldownMs(config);
+    engine.stickySessionManager = new StickySessionManager(aliasReuseCooldownMs);
+    hydrateAntigravityAliasLeaseStoreIfNeeded({
+        force: true,
+        leaseStore: engine.stickySessionManager.getAllStores().aliasLeaseStore,
+        persistence: engine.antigravityLeasePersistence,
+        aliasReuseCooldownMs: engine.stickySessionManager.getAliasReuseCooldownMs()
+    });
+    engine.classifier = new RoutingClassifier(config.classifier);
+    engine.contextRouting = config.contextRouting ?? { warnRatio: 0.9, hardLimit: false };
+    engine.contextAdvisor.configure(engine.contextRouting);
+    engine.webSearchForce = config.webSearch?.force === true;
+    engine.routeAnalytics.getAllRouteStats().clear();
+    for (const routeName of Object.keys(engine.routing)) {
+        engine.routeAnalytics.getRouteStats(routeName) ||
+            engine.routeAnalytics.incrementRouteStat(routeName, '', {
+                timestampMs: Date.now(),
+                stopMessage: { active: false }
+            });
+    }
+}
+export function validateConfig(engine, config) {
+    if (!config.routing || typeof config.routing !== 'object') {
+        throw new VirtualRouterError('routing configuration is required', VirtualRouterErrorCode.CONFIG_ERROR);
+    }
+    if (!config.providers || Object.keys(config.providers).length === 0) {
+        throw new VirtualRouterError('providers configuration is required', VirtualRouterErrorCode.CONFIG_ERROR);
+    }
+    const defaultPools = config.routing[DEFAULT_ROUTE];
+    if (!routeHasTargets(engine, defaultPools)) {
+        throw new VirtualRouterError('default route must be configured with at least one provider', VirtualRouterErrorCode.CONFIG_ERROR);
+    }
+    if (!hasPrimaryPool(engine, defaultPools)) {
+        throw new VirtualRouterError('default route must define at least one non-backup pool', VirtualRouterErrorCode.CONFIG_ERROR);
+    }
+    const providerKeys = new Set(Object.keys(config.providers));
+    for (const [routeName, pools] of Object.entries(config.routing)) {
+        if (!routeHasTargets(engine, pools)) {
+            if (routeName === DEFAULT_ROUTE) {
+                throw new VirtualRouterError('default route cannot be empty', VirtualRouterErrorCode.CONFIG_ERROR);
+            }
+            continue;
+        }
+        for (const pool of pools) {
+            if (!Array.isArray(pool.targets) || !pool.targets.length) {
+                continue;
+            }
+            for (const providerKey of pool.targets) {
+                if (!providerKeys.has(providerKey)) {
+                    throw new VirtualRouterError(`Route ${routeName} references unknown provider ${providerKey}`, VirtualRouterErrorCode.CONFIG_ERROR);
+                }
+            }
+        }
+    }
+}

package/dist/router/virtual-router/engine-legacy/direct-model.d.ts

@@ -0,0 +1,10 @@
+import type { RoutingFeatures } from '../types.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function parseDirectProviderModel(engine: VirtualRouterEngine, model: string | undefined): {
+    providerId: string;
+    modelId: string;
+} | null;
+export declare function shouldFallbackDirectModelForMedia(engine: VirtualRouterEngine, direct: {
+    providerId: string;
+    modelId: string;
+}, features: RoutingFeatures): boolean;

package/dist/router/virtual-router/engine-legacy/direct-model.js

@@ -0,0 +1,38 @@
+import { routeHasTargets } from './route-utils.js';
+export function parseDirectProviderModel(engine, model) {
+    const raw = typeof model === 'string' ? model.trim() : '';
+    if (!raw) {
+        return null;
+    }
+    const firstDot = raw.indexOf('.');
+    if (firstDot <= 0 || firstDot === raw.length - 1) {
+        return null;
+    }
+    const providerId = raw.slice(0, firstDot).trim();
+    const modelId = raw.slice(firstDot + 1).trim();
+    if (!providerId || !modelId) {
+        return null;
+    }
+    if (engine.providerRegistry.listProviderKeys(providerId).length === 0) {
+        return null;
+    }
+    return { providerId, modelId };
+}
+export function shouldFallbackDirectModelForMedia(engine, direct, features) {
+    if (!features.hasImageAttachment) {
+        return false;
+    }
+    const providerId = direct.providerId.trim().toLowerCase();
+    const modelId = direct.modelId.trim().toLowerCase();
+    if (providerId !== 'qwen') {
+        return false;
+    }
+    const isQwen35Plus = modelId === 'qwen3.5-plus' || modelId === 'qwen3-5-plus' || modelId === 'qwen3_5-plus';
+    if (!isQwen35Plus) {
+        return false;
+    }
+    if (!(features.hasVideoAttachment === true && features.hasLocalVideoAttachment === true)) {
+        return false;
+    }
+    return routeHasTargets(engine, engine.routing.vision);
+}

package/dist/router/virtual-router/engine-legacy/health.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderErrorEvent, ProviderFailureEvent, ProviderHealthConfig, ProviderSuccessEvent, VirtualRouterHealthSnapshot } from '../types.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+export declare function providerHealthConfig(engine: VirtualRouterEngine): Required<ProviderHealthConfig>;
+export declare function markProviderCooldown(engine: VirtualRouterEngine, providerKey: string, cooldownMs: number | undefined): void;
+export declare function clearProviderCooldown(engine: VirtualRouterEngine, providerKey: string): void;
+export declare function isProviderCoolingDown(engine: VirtualRouterEngine, providerKey: string): boolean;
+export declare function getProviderCooldownRemainingMs(engine: VirtualRouterEngine, providerKey: string): number;
+export declare function restoreHealthFromStore(engine: VirtualRouterEngine): void;
+export declare function buildHealthSnapshot(engine: VirtualRouterEngine): VirtualRouterHealthSnapshot;
+export declare function persistHealthSnapshot(engine: VirtualRouterEngine): void;
+export declare function handleProviderFailure(engine: VirtualRouterEngine, event: ProviderFailureEvent): void;
+export declare function handleProviderError(engine: VirtualRouterEngine, event: ProviderErrorEvent): void;
+export declare function handleProviderSuccess(engine: VirtualRouterEngine, event: ProviderSuccessEvent): void;

package/dist/router/virtual-router/engine-legacy/health.js

@@ -0,0 +1,104 @@
+import { applyAntigravityRiskPolicyImpl, applyQuotaDepletedImpl, applyQuotaRecoveryImpl, applySeriesCooldownImpl, handleProviderFailureImpl, mapProviderErrorImpl } from '../engine/health/index.js';
+import { recordAntigravitySessionLease } from '../engine/antigravity/alias-lease.js';
+export function providerHealthConfig(engine) {
+    return engine.healthManager.getConfig();
+}
+export function markProviderCooldown(engine, providerKey, cooldownMs) {
+    engine.cooldownManager.markProviderCooldown(providerKey, cooldownMs);
+}
+export function clearProviderCooldown(engine, providerKey) {
+    engine.cooldownManager.clearProviderCooldown(providerKey);
+}
+export function isProviderCoolingDown(engine, providerKey) {
+    return engine.cooldownManager.isProviderCoolingDown(providerKey);
+}
+export function getProviderCooldownRemainingMs(engine, providerKey) {
+    if (!providerKey) {
+        return 0;
+    }
+    const expiry = engine.cooldownManager.getCooldownMap().get(providerKey);
+    if (!expiry || !Number.isFinite(expiry)) {
+        return 0;
+    }
+    const remaining = Math.floor(expiry - Date.now());
+    return remaining > 0 ? remaining : 0;
+}
+export function restoreHealthFromStore(engine) {
+    engine.cooldownManager.restoreHealthFromStore();
+}
+export function buildHealthSnapshot(engine) {
+    const providers = engine.healthManager.getSnapshot();
+    const cooldownSnapshot = engine.cooldownManager.buildHealthSnapshot();
+    return { providers, cooldowns: cooldownSnapshot.cooldowns };
+}
+export function persistHealthSnapshot(engine) {
+    engine.cooldownManager.persistHealthSnapshot();
+}
+export function handleProviderFailure(engine, event) {
+    handleProviderFailureImpl(event, engine.healthManager, providerHealthConfig(engine), (key, ttl) => markProviderCooldown(engine, key, ttl));
+}
+export function handleProviderError(engine, event) {
+    if (engine.healthStore && typeof engine.healthStore.recordProviderError === 'function') {
+        try {
+            engine.healthStore.recordProviderError(event);
+        }
+        catch {
+            // ignore persistence errors
+        }
+    }
+    // Quota routing mode: health/cooldown must be driven by quotaView only (host/core quota center).
+    // VirtualRouter must not produce or persist its own cooldown state in this mode.
+    // 当 Host 注入 quotaView 时，VirtualRouter 的入池/优先级决策应以 quota 为准；
+    // 此时不再在 engine-health 内部进行 429/backoff/series cooldown 等健康决策，
+    // 以避免与 daemon/quota-center 的长期熔断策略重复维护并导致日志噪声。
+    if (engine.quotaView) {
+        return;
+    }
+    // Antigravity account safety policy uses router-local cooldown TTLs; only applies when quota routing is disabled.
+    applyAntigravityRiskPolicyImpl(event, engine.providerRegistry, engine.healthManager, (key, ttl) => markProviderCooldown(engine, key, ttl), engine.debug);
+    // 配额恢复事件优先处理：一旦识别到 virtualRouterQuotaRecovery，
+    // 直接清理健康状态/冷却 TTL，避免继续走常规错误映射逻辑。
+    const handledByQuota = applyQuotaRecoveryImpl(event, engine.healthManager, (key) => clearProviderCooldown(engine, key), engine.debug);
+    if (handledByQuota) {
+        return;
+    }
+    const handledByQuotaDepleted = applyQuotaDepletedImpl(event, engine.healthManager, (key, ttl) => markProviderCooldown(engine, key, ttl), engine.debug);
+    if (handledByQuotaDepleted) {
+        return;
+    }
+    applySeriesCooldownImpl(event, engine.providerRegistry, engine.healthManager, (key, ttl) => markProviderCooldown(engine, key, ttl), engine.debug);
+    const derived = mapProviderErrorImpl(event, providerHealthConfig(engine));
+    if (!derived) {
+        return;
+    }
+    handleProviderFailure(engine, derived);
+}
+export function handleProviderSuccess(engine, event) {
+    if (!event || typeof event !== 'object') {
+        return;
+    }
+    const providerKey = event.runtime && typeof event.runtime.providerKey === 'string' ? event.runtime.providerKey.trim() : '';
+    if (!providerKey) {
+        return;
+    }
+    const metadata = event.metadata && typeof event.metadata === 'object' && !Array.isArray(event.metadata)
+        ? event.metadata
+        : null;
+    if (!metadata) {
+        return;
+    }
+    if (providerKey.toLowerCase().startsWith('antigravity.')) {
+        recordAntigravitySessionLease({
+            metadata: metadata,
+            providerKey,
+            sessionKey: engine.resolveSessionScope(metadata),
+            providerRegistry: engine.providerRegistry,
+            leaseStore: engine.stickySessionManager.getAllStores().aliasLeaseStore,
+            sessionAliasStore: engine.stickySessionManager.getAllStores().sessionAliasStore,
+            persistence: engine.antigravityLeasePersistence,
+            aliasReuseCooldownMs: engine.stickySessionManager.getAliasReuseCooldownMs(),
+            commitSessionBinding: true,
+            debug: engine.debug
+        });
+    }
+}

package/dist/router/virtual-router/engine-legacy/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { StandardizedMessage } from '../../../conversion/hub/types/standardized.js';
+import type { RouterMetadataInput } from '../types.js';
+import type { RoutingInstructionState } from '../routing-instructions.js';
+export declare const DEFAULT_STOP_MESSAGE_MAX_REPEATS = 10;
+export declare function isStopScopeTraceEnabled(): boolean;
+export declare function normalizeStopMessageStageMode(value: unknown): 'on' | 'off' | 'auto' | undefined;
+export declare function normalizeStopMessageAiMode(value: unknown): 'on' | 'off' | undefined;
+export declare function stripStopMessageFields(state: RoutingInstructionState): RoutingInstructionState;
+export declare function stripClientInjectScopedFields(state: RoutingInstructionState): RoutingInstructionState;
+export declare function hasClientInjectScopedFields(state: RoutingInstructionState | null | undefined): boolean;
+export declare function hasRoutingInstructionMarker(messages: StandardizedMessage[]): boolean;
+export declare function hasLatestUserRoutingInstructionMarker(messages: StandardizedMessage[]): boolean;
+export declare function getLatestUserTextFromResponsesContext(context: unknown): string;
+export declare function hasRoutingInstructionMarkerInResponsesContext(context: unknown): boolean;
+export declare function cleanResponsesContextFromRoutingInstructions(context: unknown): void;
+export declare function isServerToolFollowupRequest(metadata: RouterMetadataInput): boolean;

package/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') {
+            return false;
+        }
+        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/dist/router/virtual-router/engine-legacy/route-finalize.d.ts

@@ -0,0 +1,9 @@
+import type { RoutingInstruction, RoutingInstructionState } from '../routing-instructions.js';
+import type { RouterMetadataInput, TargetMetadata, RoutingDecision, RoutingDiagnostics } from '../types.js';
+import type { VirtualRouterEngine } from '../engine-legacy.js';
+import type { RoutingSelectionResult } from './route-selection.js';
+export declare function finalizeRoutingDecision(engine: VirtualRouterEngine, metadata: RouterMetadataInput, routingState: RoutingInstructionState, metadataInstructions: RoutingInstruction[], instructions: RoutingInstruction[], selectionResult: RoutingSelectionResult): {
+    target: TargetMetadata;
+    decision: RoutingDecision;
+    diagnostics: RoutingDiagnostics;
+};