import type { ActorsMcpServerOptions, HelperTool, ToolBase, ToolEntry } from '../types.js';
type ToolPublicFieldOptions = {
uiMode?: ActorsMcpServerOptions['uiMode'];
filterOpenAiMeta?: boolean;
};
/**
* Strips OpenAI specific metadata from the tool metadata. U
* @param meta - The tool metadata.
* @returns The tool metadata with OpenAI specific metadata stripped.
*/
function stripOpenAiMeta(meta?: ToolBase['_meta']) {
if (!meta) return meta;
const filteredEntries = Object.entries(meta)
.filter(([key]) => !key.startsWith('openai/'));
if (filteredEntries.length === 0) return undefined;
return Object.fromEntries(filteredEntries);
}
/**
* Returns a public version of the tool containing only fields that should be exposed publicly.
* Used for the tools list request.
*/
export function getToolPublicFieldOnly(tool: ToolBase, options: ToolPublicFieldOptions = {}) {
const { uiMode, filterOpenAiMeta = false } = options;
const meta = filterOpenAiMeta && uiMode !== 'openai'
? stripOpenAiMeta(tool._meta)
: tool._meta;
return {
name: tool.name,
title: tool.title,
description: tool.description,
inputSchema: tool.inputSchema,
outputSchema: tool.outputSchema,
annotations: tool.annotations,
icons: tool.icons,
execution: tool.execution,
_meta: meta,
};
}
/**
* Creates a deep copy of a tool entry, preserving functions like ajvValidate and call
* while cloning all other properties to avoid shared state mutations.
*/
export function cloneToolEntry(toolEntry: ToolEntry): ToolEntry {
// Store the original functions
const originalAjvValidate = toolEntry.ajvValidate;
const originalCall = toolEntry.type === 'internal' ? toolEntry.call : undefined;
// Create a deep copy using JSON serialization (excluding functions)
const cloned = JSON.parse(JSON.stringify(toolEntry, (key, value) => {
if (key === 'ajvValidate' || key === 'call') return undefined;
return value;
})) as ToolEntry;
// Restore the original functions
cloned.ajvValidate = originalAjvValidate;
if (toolEntry.type === 'internal' && originalCall) {
(cloned as HelperTool).call = originalCall;
}
return cloned;
}
