capturePluginToolDescriptor,

createPluginToolDescriptorConfigCacheKeyMemo,

readCachedPluginToolDescriptors,

resetPluginToolDescriptorCache as resetCachedPluginToolDescriptors,

type CachedPluginToolDescriptor,

type PluginToolDescriptorConfigCacheKeyMemo,

writeCachedPluginToolDescriptors,

} from "./tool-descriptor-cache.js";

import type { OpenClawPluginToolContext } from "./types.js";

export {

resetPluginToolDescriptorCache,

resetPluginToolDescriptorCache as resetPluginToolFactoryCache,

} from "./tool-descriptor-cache.js";

let cachedDescriptorRuntimeRegistries = new WeakMap<CachedPluginToolDescriptor, PluginRegistry>();

export function resetPluginToolDescriptorCache(): void {

resetCachedPluginToolDescriptors();

cachedDescriptorRuntimeRegistries = new WeakMap();

}

export { resetPluginToolDescriptorCache as resetPluginToolFactoryCache };

/** MCP bridge metadata attached to plugin tools surfaced through agent tool lists. */

export type PluginToolMcpMeta = {

const registry = resolvePluginToolRegistry({

loadOptions,

onlyPluginIds: [pluginId],

retainedRegistry: cachedDescriptorRuntimeRegistries.get(params.descriptor),

onRetainRegistry: (retainedRegistry) => {

cachedDescriptorRuntimeRegistries.set(params.descriptor, retainedRegistry);

},

});

const candidates = registry?.tools.filter((candidate) => candidate.pluginId === pluginId);

if (!candidates || candidates.length === 0) {

function resolvePluginToolRegistry(params: {

loadOptions: PluginLoadOptions;

onlyPluginIds?: readonly string[];

retainedRegistry?: PluginRegistry;

onRetainRegistry?: (registry: PluginRegistry) => void;

}) {

const lookup = {

env: params.loadOptions.env,

return activeRegistry;

}

if (registryHasScopedPluginTools(params.retainedRegistry, params.onlyPluginIds)) {

return params.retainedRegistry;

}

const forceStandaloneLoad = Boolean(channelRegistry || activeRegistry);

const shouldRetainColdLoadedToolRegistry =

forceStandaloneLoad &&

params.loadOptions.activate === false &&

params.loadOptions.toolDiscovery === true &&

params.onRetainRegistry !== undefined;

const standaloneRegistry = ensureStandaloneRuntimePluginRegistryLoaded({

surface: "active",

forceLoad: forceStandaloneLoad,

loadOptions: params.loadOptions,

});

if (registryHasScopedPluginTools(standaloneRegistry, params.onlyPluginIds)) {

if (shouldRetainColdLoadedToolRegistry) {

params.onRetainRegistry?.(standaloneRegistry);

}

return standaloneRegistry;

}

return standaloneRegistry ?? channelRegistry ?? activeRegistry;