import {

buildPluginToolDescriptorCacheKey,

capturePluginToolDescriptor,

createPluginToolDescriptorConfigCacheKeyMemo,

readCachedPluginToolDescriptors,

type CachedPluginToolDescriptor,

type PluginToolDescriptorConfigCacheKeyMemo,

writeCachedPluginToolDescriptors,

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

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

plugin: PluginManifestRecord;

ctx: OpenClawPluginToolContext;

currentRuntimeConfig?: PluginLoadOptions["config"] | null;

configCacheKeyMemo?: PluginToolDescriptorConfigCacheKeyMemo;

}): string {

return buildPluginToolDescriptorCacheKey({

pluginId: params.plugin.id,

contractToolNames: params.plugin.contracts?.tools ?? [],

ctx: params.ctx,

currentRuntimeConfig: params.currentRuntimeConfig,

configCacheKeyMemo: params.configCacheKeyMemo,

});

}

loadContext: ReturnType<typeof resolvePluginRuntimeLoadContext>;

runtimeOptions: PluginLoadOptions["runtimeOptions"];

currentRuntimeConfig?: PluginLoadOptions["config"] | null;

configCacheKeyMemo: PluginToolDescriptorConfigCacheKeyMemo;

}): { tools: AnyAgentTool[]; handledPluginIds: Set<string> } {

const tools: AnyAgentTool[] = [];

const handledPluginIds = new Set<string>();

plugin,

ctx: params.ctx,

currentRuntimeConfig: params.currentRuntimeConfig,

configCacheKeyMemo: params.configCacheKeyMemo,

}),

);

if (

const existing = params.existingToolNames ?? new Set<string>();

const existingNormalized = new Set(Array.from(existing, (tool) => normalizeToolName(tool)));

const allowlist = normalizeAllowlist(params.toolAllowlist);

const configCacheKeyMemo = createPluginToolDescriptorConfigCacheKeyMemo();

let currentRuntimeConfigForDescriptorCache: PluginLoadOptions["config"] | null | undefined =

params.context.runtimeConfig;

if (currentRuntimeConfigForDescriptorCache === undefined && params.context.getRuntimeConfig) {

loadContext: context,

runtimeOptions,

currentRuntimeConfig: currentRuntimeConfigForDescriptorCache,

configCacheKeyMemo,

});

tools.push(...cached.tools);

const runtimePluginIds = onlyPluginIds.filter(

plugin: manifestPlugin,

ctx: params.context,

currentRuntimeConfig: currentRuntimeConfigForDescriptorCache,

configCacheKeyMemo,

}),

descriptors,

});