simstudioai--sim/apps/sim/lib/copilot/tools/handlers/integration-tools.ts

import { getBlockVisibilityForCopilot } from '@/lib/copilot/block-visibility'
import {
  filterExposedIntegrationTools,
  getExposedIntegrationTools,
} from '@/lib/copilot/integration-tools'
import type { ExecutionContext, ToolCallResult } from '@/lib/copilot/request/types'
import { stripVersionSuffix } from '@/tools/utils'

export async function executeListIntegrationTools(
  params: Record<string, unknown>,
  context: ExecutionContext
): Promise<ToolCallResult> {
  const raw = typeof params.integration === 'string' ? params.integration.trim() : ''
  if (!raw) {
    return { success: false, error: "Missing required parameter 'integration'" }
  }

  // The exposed set is the ungated universe — project it for this viewer so
  // gated (preview / kill-switched) integrations stay undiscoverable.
  const vis = await getBlockVisibilityForCopilot(context.userId, context.workspaceId)
  const all = filterExposedIntegrationTools(getExposedIntegrationTools(), vis)
  const service = stripVersionSuffix(raw.toLowerCase())
  const matches = all.filter((tool) => tool.service === service)

  if (matches.length === 0) {
    const services = Array.from(new Set(all.map((tool) => tool.service))).sort()
    return {
      success: false,
      error: `Unknown integration "${raw}". Available integrations: ${services.join(', ')}`,
    }
  }

  return {
    success: true,
    output: {
      integration: service,
      note: 'Call load_integration_tool({tool_ids: ["<id>"]}) with the exact id before invoking an operation.',
      tools: matches.map((tool) => ({
        id: tool.toolId,
        operation: tool.operation,
        name: tool.config.name,
        description: tool.config.description,
      })),
    },
  }
}