Function createToolCatalog

src/runtime/tool-catalog.ts:16–88

(tools: ToolDefinition[])

import { log } from '../utils/logging/index.ts';

export function createToolCatalog(tools: ToolDefinition[]): ToolCatalog {
  // Build lookup maps for fast resolution, deduplicating by mcpName so that
  // tools shared across multiple workflows don't cause ambiguous resolution.
  const byCliName = new Map<string, ToolDefinition>();
  const byMcpName = new Map<string, ToolDefinition>();
  const byToolId = new Map<string, ToolDefinition>();
  const byMcpKebab = new Map<string, ToolDefinition[]>();
  const seenMcpNames = new Set<string>();

  for (const tool of tools) {
    const mcpKey = tool.mcpName.toLowerCase();
    if (seenMcpNames.has(mcpKey)) continue;
    seenMcpNames.add(mcpKey);

    byCliName.set(tool.cliName, tool);
    byMcpName.set(mcpKey, tool);
    if (tool.id) {
      byToolId.set(tool.id, tool);
    }

    const mcpKebab = toKebabCase(tool.mcpName);
    let kebabGroup = byMcpKebab.get(mcpKebab);
    if (!kebabGroup) {
      kebabGroup = [];
      byMcpKebab.set(mcpKebab, kebabGroup);
    }
    kebabGroup.push(tool);
  }

  return {
    tools,

    getByCliName(name: string): ToolDefinition | null {
      return byCliName.get(name) ?? null;
    },

    getByMcpName(name: string): ToolDefinition | null {
      return byMcpName.get(name.toLowerCase().trim()) ?? null;
    },

    getByToolId(toolId: string): ToolDefinition | null {
      return byToolId.get(toolId) ?? null;
    },

    resolve(input: string): ToolResolution {
      const normalized = input.toLowerCase().trim();

      // Try exact CLI name match first
      const exact = byCliName.get(normalized);
      if (exact) {
        return { tool: exact };
      }

      // Try kebab-case of MCP name (alias)
      const mcpKebab = toKebabCase(normalized);
      const aliasMatches = byMcpKebab.get(mcpKebab);
      if (aliasMatches && aliasMatches.length === 1) {
        return { tool: aliasMatches[0] };