openclaw/dist/model-fallback-candidates-DNfpNFJt.mjs

Multi-channel AI gateway with extensible messaging integrations

import { l as normalizeOptionalString } from "./string-coerce-1VuiLaaR.mjs";
import { n as sanitizeForLog } from "./ansi-BeFJ0Uu7.mjs";
import { t as pruneMapToMaxSize } from "./map-size-BlrH_CnE.mjs";
import { t as createSubsystemLogger } from "./subsystem-I-uqdx4f.mjs";
import { r as normalizeProviderId } from "./provider-id-D1VImdKk.mjs";
import { r as resolveAgentConfig, s as resolveAgentModelConfigForRuntime } from "./agent-scope-config-CDYpzA0r.mjs";
import { t as resolvePluginControlPlaneFingerprint } from "./plugin-control-plane-context-k1PmbRpn.mjs";
import { i as getCurrentPluginMetadataSnapshot } from "./current-plugin-metadata-snapshot-BF6RZfMc.mjs";
import { o as resolveAgentModelFallbackValues, s as resolveAgentModelPrimaryValue } from "./model-input-C9K4a_6k.mjs";
import { t as hasUtilityModelSeparationMigrationMarker } from "./utility-model-separation-migration-BVcPkqsj.mjs";
import { n as DEFAULT_MODEL, r as DEFAULT_PROVIDER } from "./defaults-Jag53zwP.mjs";
import { f as getActivePluginRegistryWorkspaceDirFromStateCore, l as normalizeProviderModelIdWithRuntime, o as normalizeModelRef } from "./model-ref-shared-KBg0y299.mjs";
import { n as getPluginRegistryState } from "./runtime-state-Cd-Ga9cg.mjs";
import { r as getPluginRegistryForContext } from "./gateway-request-scope-BSmCVVpP.mjs";
import { t as getPluginRuntimeGenerationRegistry } from "./generation-state-C1yPL1Zl.mjs";
import { t as modelKey } from "./model-key-5zORvMDY.mjs";
import { S as hasExactConfiguredProviderModel, h as resolveConfiguredModelRef, i as buildModelAliasIndex, v as resolveModelRefFromString, x as allowsPluginModelNormalization, y as readUtilityModelSetting } from "./model-selection-shared-DcM6hdAC.mjs";
import { n as resolveConfiguredModelFallbacks, r as resolveModelAliasFromPair } from "./model-selection-resolve-PdD2eskm.mjs";
import { t as isPluginProvidersLoadInFlight } from "./providers.runtime-De7Zs9_Y.mjs";
//#region src/agents/model-fallback-candidates.ts
/** Resolves ordered model and image fallback candidate chains. */
const MAX_FALLBACK_CANDIDATE_CACHE_ENTRIES = 256;
const fallbackCandidateCache = /* @__PURE__ */ new Map();
const fallbackContextIds = /* @__PURE__ */ new WeakMap();
let nextFallbackContextId = 0;
const log = createSubsystemLogger("model-selection");
function createModelCandidateCollector() {
	const seen = /* @__PURE__ */ new Set();
	const candidates = [];
	const addCandidate = (candidate, routeOrigin, routeResolution) => {
		if (!candidate.provider || !candidate.model) return;
		const key = JSON.stringify([candidate.provider, candidate.model]);
		if (seen.has(key)) return;
		seen.add(key);
		candidates.push({
			...candidate,
			routeOrigin,
			routeResolution
		});
	};
	return {
		candidates,
		addCandidate
	};
}
function resolveImageFallbackCandidates(params) {
	const primary = resolveAgentModelPrimaryValue(params.cfg?.agents?.defaults?.imageModel);
	let defaultProvider = DEFAULT_PROVIDER;
	if (primary?.trim()) {
		const primaryAliasIndex = buildModelAliasIndex({
			cfg: params.cfg ?? {},
			defaultProvider: DEFAULT_PROVIDER,
			manifestPlugins: params.manifestPlugins
		});
		defaultProvider = resolveModelRefFromString({
			cfg: params.cfg,
			raw: primary,
			defaultProvider: "openai",
			aliasIndex: primaryAliasIndex,
			manifestPlugins: params.manifestPlugins
		})?.ref.provider || "openai";
	}
	const aliasIndex = buildModelAliasIndex({
		cfg: params.cfg ?? {},
		defaultProvider,
		manifestPlugins: params.manifestPlugins
	});
	const { candidates, addCandidate } = createModelCandidateCollector();
	const addRaw = (raw, routeOrigin) => {
		const resolved = resolveModelRefFromString({
			cfg: params.cfg,
			raw,
			defaultProvider,
			aliasIndex,
			manifestPlugins: params.manifestPlugins
		});
		if (!resolved) {
			log.warn(`Unresolved image model "${sanitizeForLog(raw)}"; skipped ${routeOrigin} candidate.`);
			return;
		}
		addCandidate(resolved.ref, routeOrigin, "resolved");
	};
	if (params.modelOverride?.trim()) addRaw(params.modelOverride, "requested");
	else if (primary?.trim()) addRaw(primary, "configured-primary");
	const imageFallbacks = resolveAgentModelFallbackValues(params.cfg?.agents?.defaults?.imageModel);
	for (const raw of imageFallbacks) addRaw(raw, "configured-fallback");
	return candidates;
}
function resolveModelCandidateChain(params) {
	const { cacheKey, manifestPlugins } = resolveFallbackCandidateContext(params);
	const cached = cacheKey ? fallbackCandidateCache.get(cacheKey) : void 0;
	if (cached) return cached.map((candidate) => Object.assign({}, candidate));
	const candidates = resolveFallbackCandidatesUncached({
		...params,
		manifestPlugins
	});
	if (cacheKey) {
		fallbackCandidateCache.set(cacheKey, candidates.map((candidate) => Object.assign({}, candidate)));
		pruneMapToMaxSize(fallbackCandidateCache, MAX_FALLBACK_CANDIDATE_CACHE_ENTRIES);
	}
	return candidates;
}
function getFallbackContextId(value) {
	const existing = fallbackContextIds.get(value);
	if (existing !== void 0) return existing;
	const id = nextFallbackContextId++;
	fallbackContextIds.set(value, id);
	return id;
}
function resolveFallbackCandidateContext(params) {
	if (params.manifestPlugins !== void 0) return {
		cacheKey: null,
		manifestPlugins: params.manifestPlugins
	};
	const workspaceDir = getActivePluginRegistryWorkspaceDirFromStateCore();
	const env = process.env;
	const pluginMetadata = getCurrentPluginMetadataSnapshot({
		env,
		workspaceDir,
		allowWorkspaceScopedSnapshot: true
	});
	const providerLoadMetadata = getCurrentPluginMetadataSnapshot({
		config: params.cfg,
		env,
		workspaceDir,
		allowWorkspaceScopedSnapshot: true,
		requireDefaultDiscoveryContext: params.cfg === void 0
	});
	if (isPluginProvidersLoadInFlight({
		config: params.cfg,
		workspaceDir,
		env,
		...providerLoadMetadata ? { pluginMetadataSnapshot: providerLoadMetadata } : {},
		activate: false
	})) return {
		cacheKey: null,
		manifestPlugins: providerLoadMetadata
	};
	const registryState = getPluginRegistryState();
	const registry = getPluginRuntimeGenerationRegistry() ?? getPluginRegistryForContext();
	const agentConfig = params.cfg && params.agentId ? resolveAgentConfig(params.cfg, params.agentId) : void 0;
	return {
		cacheKey: JSON.stringify({
			agentId: params.agentId,
			agentModel: resolveAgentModelConfigForRuntime(agentConfig),
			agentModels: agentConfig?.models,
			provider: params.provider,
			model: params.model,
			requestedRouteResolution: params.requestedRouteResolution,
			allowPluginNormalization: params.allowPluginNormalization,
			fallbacksOverride: params.fallbacksOverride,
			agentsDefaultsModel: params.cfg?.agents?.defaults?.model,
			agentsDefaultsModels: params.cfg?.agents?.defaults?.models,
			utilityModel: params.cfg ? readUtilityModelSetting(params.cfg, params.agentId) : void 0,
			utilityModelSeparation: hasUtilityModelSeparationMigrationMarker(params.cfg),
			modelProviders: resolveFallbackCandidateModelProviderCacheParts(params.cfg),
			pluginControlPlane: resolvePluginControlPlaneFingerprint({
				config: params.cfg,
				env,
				workspaceDir
			}),
			pluginMetadataFingerprint: pluginMetadata?.configFingerprint ?? null,
			pluginMetadataIdentity: pluginMetadata ? getFallbackContextId(pluginMetadata) : null,
			normalizationMetadataIdentity: providerLoadMetadata ? getFallbackContextId(providerLoadMetadata) : null,
			pluginRegistryIdentity: registry ? getFallbackContextId(registry) : null,
			pluginRegistryKey: registryState?.key ?? null,
			pluginRegistryVersion: registryState?.activeVersion ?? null,
			pluginWorkspaceDir: workspaceDir ?? null
		}),
		manifestPlugins: providerLoadMetadata
	};
}
function resolveFallbackCandidateModelProviderCacheParts(cfg) {
	const providers = cfg?.models?.providers;
	if (!providers) return;
	return Object.entries(providers).map(([providerId, providerConfig]) => ({
		providerId,
		api: typeof providerConfig?.api === "string" ? providerConfig.api : void 0,
		models: Array.isArray(providerConfig?.models) ? providerConfig.models.map((entry) => typeof entry?.id === "string" ? entry.id : void 0).filter((id) => id !== void 0) : []
	}));
}
function resolveFallbackCandidatesUncached(params) {
	const primary = params.cfg ? resolveConfiguredModelRef({
		cfg: params.cfg,
		agentId: params.agentId,
		defaultProvider: DEFAULT_PROVIDER,
		defaultModel: DEFAULT_MODEL,
		allowPluginNormalization: false,
		manifestPlugins: params.manifestPlugins
	}) : null;
	const defaultProvider = primary?.provider ?? "openai";
	const defaultModel = primary?.model ?? "gpt-6-astra";
	const providerRaw = normalizeOptionalString(params.provider) || defaultProvider;
	const modelRaw = normalizeOptionalString(params.model) || defaultModel;
	const allowPluginModelAliases = params.allowPluginNormalization !== false && params.cfg?.plugins?.enabled !== false;
	const requestedRouteResolution = params.requestedRouteResolution ?? "raw";
	const normalizedPrimary = requestedRouteResolution === "resolved" ? {
		provider: normalizeProviderId(providerRaw),
		model: modelRaw
	} : normalizeModelRef(providerRaw, modelRaw, {
		allowPluginNormalization: params.allowPluginNormalization !== false && allowsPluginModelNormalization({
			cfg: params.cfg,
			provider: providerRaw,
			model: modelRaw
		}),
		manifestPlugins: params.manifestPlugins
	});
	const aliasIndex = buildModelAliasIndex({
		cfg: params.cfg ?? {},
		agentId: params.agentId,
		defaultProvider,
		allowPluginNormalization: allowPluginModelAliases,
		manifestPlugins: params.manifestPlugins
	});
	const { candidates, addCandidate } = createModelCandidateCollector();
	let requestedCandidate = normalizedPrimary;
	const exactRequestedRouteConfigured = hasExactConfiguredProviderModel({
		cfg: params.cfg,
		provider: normalizedPrimary.provider,
		model: normalizedPrimary.model
	}) || aliasIndex.byKey.has(modelKey(normalizedPrimary.provider, normalizedPrimary.model));
	if (requestedRouteResolution === "raw" && !exactRequestedRouteConfigured) requestedCandidate = resolveModelAliasFromPair({
		cfg: params.cfg,
		agentId: params.agentId,
		provider: providerRaw,
		model: modelRaw,
		defaultProvider,
		aliasIndex,
		allowPluginNormalization: params.allowPluginNormalization !== false && allowsPluginModelNormalization({
			cfg: params.cfg,
			provider: providerRaw,
			model: modelRaw
		}),
		manifestPlugins: params.manifestPlugins
	}) ?? normalizedPrimary;
	addCandidate(requestedCandidate, "requested", params.manifestPlugins !== void 0 ? "resolved" : requestedRouteResolution);
	const modelFallbacks = params.fallbacksOverride !== void 0 ? params.fallbacksOverride : params.cfg ? resolveConfiguredModelFallbacks({
		cfg: params.cfg,
		agentId: params.agentId
	}) : [];
	for (const raw of modelFallbacks) {
		const resolved = resolveModelRefFromString({
			cfg: params.cfg,
			agentId: params.agentId,
			raw,
			defaultProvider,
			aliasIndex,
			allowPluginNormalization: allowPluginModelAliases,
			manifestPlugins: params.manifestPlugins
		});
		if (!resolved) continue;
		addCandidate(resolved.ref, "configured-fallback", "resolved");
	}
	if (params.fallbacksOverride === void 0 && primary?.provider && primary.model) {
		let model = primary.model;
		if (allowPluginModelAliases && allowsPluginModelNormalization({
			cfg: params.cfg,
			...primary
		})) model = normalizeProviderModelIdWithRuntime({
			provider: primary.provider,
			context: {
				provider: primary.provider,
				modelId: model
			}
		}) ?? model;
		addCandidate({
			...primary,
			model
		}, "configured-primary", "resolved");
	}
	return candidates;
}
//#endregion
export { resolveModelCandidateChain as n, resolveImageFallbackCandidates as t };