Function registerMcpTool

packages/web/src/features/tools/adapters.ts:37–74

(
    server: McpServer,
    def: ToolDefinition<TName, TShape, TMetadata>,
    context: ToolContext,
)

}

export function registerMcpTool<TName extends string, TShape extends z.ZodRawShape, TMetadata>(
    server: McpServer,
    def: ToolDefinition<TName, TShape, TMetadata>,
    context: ToolContext,
) {
    // Widening .shape to z.ZodRawShape (its base constraint) gives TypeScript a
    // concrete InputArgs so it can fully resolve BaseToolCallback's conditional
    // type. def.inputSchema.parse() recovers the correctly typed value inside.
    server.registerTool(
        def.name,
        {
            description: def.description,
            inputSchema: def.inputSchema.shape as z.ZodRawShape,
            annotations: {
                readOnlyHint: def.isReadOnly,
                idempotentHint: def.isIdempotent,
            },
        },
        async (input) => {
            let success = true;
            try {
                const parsed = def.inputSchema.parse(input);
                const result = await def.execute(parsed, context);
                return { content: [{ type: "text" as const, text: result.output }] };
            } catch (error) {
                success = false;
                const message = error instanceof Error ? error.message : String(error);
                return { content: [{ type: "text" as const, text: `Tool "${def.name}" failed: ${message}` }], isError: true };
            } finally {
                captureEvent('tool_used', {
                    toolName: def.name,
                    source: context.source ?? 'unknown',
                    success,
                });
            }
        },
    );
}