Function executeTool

apps/sim/lib/copilot/tool-executor/executor.ts:42–84

(
  toolId: string,
  params: Record<string, unknown>,
  context: ToolExecutionContext
)

}

export async function executeTool(
  toolId: string,
  params: Record<string, unknown>,
  context: ToolExecutionContext
): Promise<ToolExecutionResult> {
  // Client-routed tools (e.g. run_workflow) are normally executed in the browser and never
  // reach this point in interactive mode. In headless mode (Mothership block, no browser) there
  // is no client to delegate to, so fall back to the registered server-side handler when one
  // exists — otherwise the call would route to executeAppTool and throw "Tool not found".
  const canUseRegisteredHandler =
    isKnownTool(toolId) &&
    (isSimExecuted(toolId) || (isClientExecuted(toolId) && hasHandler(toolId)))
  if (!canUseRegisteredHandler) {
    const appParams = buildAppToolParams(toolId, params, context)
    return executeAppTool(toolId, appParams)
  }

  if (context.abortSignal?.aborted) {
    logger.warn('Tool execution skipped: abort signal already set', {
      toolId,
      abortReason: context.abortSignal.reason ?? 'unknown',
    })
    return { success: false, error: 'Execution aborted: abort signal was set before tool started' }
  }

  const handler = handlerRegistry.get(toolId)
  if (!handler) {
    logger.warn('No handler registered for tool', { toolId })
    return { success: false, error: `No handler for tool: ${toolId}` }
  }

  try {
    return await handler(params, context)
  } catch (error) {
    const message = toError(error).message
    logger.error('Tool execution failed', {
      toolId,
      error: message,
      abortSignalAborted: context.abortSignal?.aborted ?? false,
    })
    return { success: false, error: message }
  }
}

async function executeToolBatch(
  toolCalls: ToolCallDescriptor[],