import { withActivatedPluginIds } from "./activation-context.js"; import { resolveBundledPluginCompatibleActivationInputs } from "./activation-context.js"; import { resolveManifestActivationPluginIds } from "./activation-planner.js"; import { isPluginRegistryLoadInFlight, loadOpenClawPlugins, resolveRuntimePluginRegistry, type PluginLoadOptions, } from "./loader.js"; import { hasExplicitPluginIdScope } from "./plugin-scope.js"; import { resolveProviderConfigApiOwnerHint } from "./provider-config-owner.js"; import { resolveActivatableProviderOwnerPluginIds, resolveDiscoverableProviderOwnerPluginIds, resolveDiscoveredProviderPluginIds, resolveEnabledProviderPluginIds, resolveBundledProviderCompatPluginIds, resolveOwningPluginIdsForProvider, resolveOwningPluginIdsForModelRefs, withBundledProviderVitestCompat, } from "./providers.js"; import { getActivePluginRegistryWorkspaceDir } from "./runtime.js"; import { buildPluginRuntimeLoadOptionsFromValues, createPluginRuntimeLoaderLogger, } from "./runtime/load-context.js"; import type { ProviderPlugin } from "./types.js"; function dedupeSortedPluginIds(values: Iterable): string[] { return [...new Set(values)].toSorted((left, right) => left.localeCompare(right)); } function resolveExplicitProviderOwnerPluginIds(params: { providerRefs: readonly string[]; config?: PluginLoadOptions["config"]; workspaceDir?: string; env?: PluginLoadOptions["env"]; }): string[] { return dedupeSortedPluginIds( params.providerRefs.flatMap((provider) => { const plannedPluginIds = resolveManifestActivationPluginIds({ trigger: { kind: "provider", provider, }, config: params.config, workspaceDir: params.workspaceDir, env: params.env, }); if (plannedPluginIds.length > 0) { return plannedPluginIds; } const apiOwnerHint = resolveProviderConfigApiOwnerHint({ provider, config: params.config, }); if (apiOwnerHint) { const apiOwnerPluginIds = resolveManifestActivationPluginIds({ trigger: { kind: "provider", provider: apiOwnerHint, }, config: params.config, workspaceDir: params.workspaceDir, env: params.env, }); if (apiOwnerPluginIds.length > 0) { return apiOwnerPluginIds; } const legacyApiOwnerPluginIds = resolveOwningPluginIdsForProvider({ provider: apiOwnerHint, config: params.config, workspaceDir: params.workspaceDir, env: params.env, }); if (legacyApiOwnerPluginIds?.length) { return legacyApiOwnerPluginIds; } } // Keep legacy provider/CLI-backend ownership working until every owner is // expressible through activation descriptors. return ( resolveOwningPluginIdsForProvider({ provider, config: params.config, workspaceDir: params.workspaceDir, env: params.env, }) ?? [] ); }), ); } function mergeExplicitOwnerPluginIds( providerPluginIds: readonly string[], explicitOwnerPluginIds: readonly string[], ): string[] { if (explicitOwnerPluginIds.length === 0) { return [...providerPluginIds]; } return dedupeSortedPluginIds([...providerPluginIds, ...explicitOwnerPluginIds]); } function resolvePluginProviderLoadBase(params: { config?: PluginLoadOptions["config"]; workspaceDir?: string; env?: PluginLoadOptions["env"]; onlyPluginIds?: string[]; providerRefs?: readonly string[]; modelRefs?: readonly string[]; }) { const env = params.env ?? process.env; const workspaceDir = params.workspaceDir ?? getActivePluginRegistryWorkspaceDir(); const providerOwnedPluginIds = params.providerRefs?.length ? resolveExplicitProviderOwnerPluginIds({ providerRefs: params.providerRefs, config: params.config, workspaceDir, env, }) : []; const modelOwnedPluginIds = params.modelRefs?.length ? resolveOwningPluginIdsForModelRefs({ models: params.modelRefs, config: params.config, workspaceDir, env, }) : []; const requestedPluginIds = hasExplicitPluginIdScope(params.onlyPluginIds) || params.providerRefs?.length || params.modelRefs?.length || providerOwnedPluginIds.length > 0 || modelOwnedPluginIds.length > 0 ? [ ...new Set([ ...(params.onlyPluginIds ?? []), ...providerOwnedPluginIds, ...modelOwnedPluginIds, ]), ].toSorted((left, right) => left.localeCompare(right)) : undefined; const explicitOwnerPluginIds = dedupeSortedPluginIds([ ...providerOwnedPluginIds, ...modelOwnedPluginIds, ]); return { env, workspaceDir, requestedPluginIds, explicitOwnerPluginIds, rawConfig: params.config, }; } function resolveSetupProviderPluginLoadState( params: Parameters[0], base: ReturnType, ) { const providerPluginIds = resolveDiscoveredProviderPluginIds({ config: params.config, workspaceDir: base.workspaceDir, env: base.env, onlyPluginIds: base.requestedPluginIds, includeUntrustedWorkspacePlugins: params.includeUntrustedWorkspacePlugins, }); const explicitOwnerPluginIds = resolveDiscoverableProviderOwnerPluginIds({ pluginIds: base.explicitOwnerPluginIds, config: params.config, workspaceDir: base.workspaceDir, env: base.env, includeUntrustedWorkspacePlugins: params.includeUntrustedWorkspacePlugins, }); const setupPluginIds = mergeExplicitOwnerPluginIds(providerPluginIds, explicitOwnerPluginIds); if (setupPluginIds.length === 0) { return undefined; } const setupConfig = withActivatedPluginIds({ config: base.rawConfig, pluginIds: setupPluginIds, }); const loadOptions = buildPluginRuntimeLoadOptionsFromValues( { config: setupConfig, activationSourceConfig: setupConfig, autoEnabledReasons: {}, workspaceDir: base.workspaceDir, env: base.env, logger: createPluginRuntimeLoaderLogger(), }, { onlyPluginIds: setupPluginIds, pluginSdkResolution: params.pluginSdkResolution, cache: params.cache ?? false, activate: params.activate ?? false, }, ); return { loadOptions }; } function resolveRuntimeProviderPluginLoadState( params: Parameters[0], base: ReturnType, ) { const explicitOwnerPluginIds = resolveActivatableProviderOwnerPluginIds({ pluginIds: base.explicitOwnerPluginIds, config: base.rawConfig, workspaceDir: base.workspaceDir, env: base.env, includeUntrustedWorkspacePlugins: params.includeUntrustedWorkspacePlugins, }); const runtimeRequestedPluginIds = base.requestedPluginIds !== undefined ? dedupeSortedPluginIds([...(params.onlyPluginIds ?? []), ...explicitOwnerPluginIds]) : undefined; const requestConfig = withActivatedPluginIds({ config: base.rawConfig, pluginIds: explicitOwnerPluginIds, }); const activation = resolveBundledPluginCompatibleActivationInputs({ rawConfig: requestConfig, env: base.env, workspaceDir: base.workspaceDir, onlyPluginIds: runtimeRequestedPluginIds, applyAutoEnable: params.applyAutoEnable ?? true, compatMode: { allowlist: params.bundledProviderAllowlistCompat, enablement: "allowlist", vitest: params.bundledProviderVitestCompat, }, resolveCompatPluginIds: resolveBundledProviderCompatPluginIds, }); const config = params.bundledProviderVitestCompat ? withBundledProviderVitestCompat({ config: activation.config, pluginIds: activation.compatPluginIds, env: base.env, }) : activation.config; const providerPluginIds = mergeExplicitOwnerPluginIds( resolveEnabledProviderPluginIds({ config, workspaceDir: base.workspaceDir, env: base.env, onlyPluginIds: runtimeRequestedPluginIds, }), explicitOwnerPluginIds, ); const loadOptions = buildPluginRuntimeLoadOptionsFromValues( { config, activationSourceConfig: activation.activationSourceConfig, autoEnabledReasons: activation.autoEnabledReasons, workspaceDir: base.workspaceDir, env: base.env, logger: createPluginRuntimeLoaderLogger(), }, { onlyPluginIds: providerPluginIds, pluginSdkResolution: params.pluginSdkResolution, cache: params.cache ?? true, activate: params.activate ?? false, }, ); return { loadOptions }; } export function isPluginProvidersLoadInFlight( params: Parameters[0], ): boolean { const base = resolvePluginProviderLoadBase(params); const loadState = params.mode === "setup" ? resolveSetupProviderPluginLoadState(params, base) : resolveRuntimeProviderPluginLoadState(params, base); if (!loadState) { return false; } return isPluginRegistryLoadInFlight(loadState.loadOptions); } export function resolvePluginProviders(params: { config?: PluginLoadOptions["config"]; workspaceDir?: string; /** Use an explicit env when plugin roots should resolve independently from process.env. */ env?: PluginLoadOptions["env"]; bundledProviderAllowlistCompat?: boolean; bundledProviderVitestCompat?: boolean; onlyPluginIds?: string[]; providerRefs?: readonly string[]; modelRefs?: readonly string[]; activate?: boolean; cache?: boolean; applyAutoEnable?: boolean; pluginSdkResolution?: PluginLoadOptions["pluginSdkResolution"]; mode?: "runtime" | "setup"; includeUntrustedWorkspacePlugins?: boolean; }): ProviderPlugin[] { const base = resolvePluginProviderLoadBase(params); if (params.mode === "setup") { const loadState = resolveSetupProviderPluginLoadState(params, base); if (!loadState) { return []; } const registry = loadOpenClawPlugins(loadState.loadOptions); return registry.providers.map((entry) => Object.assign({}, entry.provider, { pluginId: entry.pluginId }), ); } const loadState = resolveRuntimeProviderPluginLoadState(params, base); const registry = resolveRuntimePluginRegistry(loadState.loadOptions); if (!registry) { return []; } return registry.providers.map((entry) => Object.assign({}, entry.provider, { pluginId: entry.pluginId }), ); }