Method executeSpecificTool

packages/core/src/core/run-handler.ts:600–653

* Execute a specific tool

(
    tool: FrontendTool<any>,
    toolCall: ToolCall,
    message: Message,
    agent: AbstractAgent,
    agentId: string,
  )

   * Execute a specific tool
   */
  private async executeSpecificTool(
    tool: FrontendTool<any>,
    toolCall: ToolCall,
    message: Message,
    agent: AbstractAgent,
    agentId: string,
  ): Promise<boolean> {
    // Check if tool is constrained to a specific agent
    if (tool?.agentId && tool.agentId !== agent.agentId) {
      // Tool is not available for this agent, skip it
      return false;
    }

    let handlerResult: ExecuteToolHandlerResult = {
      result: "",
      error: undefined,
      isArgumentError: false,
    };

    if (tool?.handler) {
      handlerResult = await this.executeToolHandler({
        tool,
        toolCall,
        agent,
        agentId,
        handlerArgs: toolCall.function.arguments,
        toolType: "specific",
        messageId: message.id,
      });
    }

    {
      const messageIndex = agent.messages.findIndex((m) => m.id === message.id);
      if (messageIndex === -1) {
        // Parent message no longer in agent's messages (e.g. thread was switched
        // while the tool handler was still executing). Skip result insertion and
        // do not request a follow-up to avoid mutating the wrong thread.
        return false;
      }
      const toolMessage = {
        id: randomUUID(),
        role: "tool" as const,
        toolCallId: toolCall.id,
        content: handlerResult.result,
      };
      agent.messages.splice(messageIndex + 1, 0, toolMessage);

      if (!handlerResult.error && tool?.followUp !== false) {
        return true; // Needs follow-up
      }
    }

    return false;
  }

  /**
   * Execute a wildcard tool.