Method invoke

src/runtime/tool-invoker.ts:287–319

(
    toolName: string,
    args: Record<string, unknown>,
    opts: InvokeOptions,
  )

  constructor(private catalog: ToolCatalog) {}

  async invoke(
    toolName: string,
    args: Record<string, unknown>,
    opts: InvokeOptions,
  ): Promise<void> {
    const resolved = this.catalog.resolve(toolName);
    const session = opts.renderSession ?? createRenderSession('text');
    const resolvedOpts = { ...opts, renderSession: session };

    if (resolved.ambiguous) {
      emitExplicitRuntimeError({
        session,
        handlerContext: opts.handlerContext,
        onStructuredOutput: opts.onStructuredOutput,
        code: 'AMBIGUOUS_TOOL',
        message: `Ambiguous tool name: Multiple tools match '${toolName}'. Use one of:\n- ${resolved.ambiguous.join('\n- ')}`,
      });
      return;
    }

    if (resolved.notFound || !resolved.tool) {
      emitExplicitRuntimeError({
        session,
        handlerContext: opts.handlerContext,
        onStructuredOutput: opts.onStructuredOutput,
        code: 'TOOL_NOT_FOUND',
        message: `Tool not found: Unknown tool '${toolName}'. Run 'xcodebuildmcp tools' to see available tools.`,
      });
      return;
    }

    return this.executeTool(resolved.tool, args, resolvedOpts);
  }

  async invokeDirect(
    tool: ToolDefinition,