/**
 * Capacidades do BANCO DE DADOS EXTERNO (Fase 5).
 *
 * O agente enxerga o outro sistema do dono — o segundo CRM, o ERP, a base que
 * outro produto escreve. Sem isto, o conector seria só uma tela de configuração.
 *
 * `modulo: "banco_externo"`: com o módulo desligado em `/admin/sistema`, estas
 * duas entradas somem da tela de capacidades, do agente publicado e do cliente MCP
 * externo — ninguém liga o que não existe, e o agente não chama o que vai recusar.
 * Ver `deModuloDesligado` em `./index.ts` (mesmo padrão de `./honorarios.ts`).
 *
 * Os nomes vivem no `crm_*` porque são contrato de wire: renomear quebraria
 * agentes publicação em VPS de cliente. A camada de apresentação fala a língua
 * de quem configura, não a de quem programa (ver `tests/unit/catalogo-tools-leigo-friendly.test.ts`).
 */
import { declararTools } from "./tipos";

export const TOOLS_DADOS_EXTERNOS = declararTools([
  {
    name: "crm_describe_external_data",
    category: "read",
    rotulo: "Ver as tabelas do banco conectado",
    explicacao:
      "Mostra quais tabelas e campos existem no banco de dados que você conectou, para o assistente saber onde procurar o dado antes de responder.",
    oQueToca: "Banco de dados conectado",
    risco: "seguro",
    // Em "Organizar a operação", e não em "Atender"/"Vender": estas são
    // capacidades de FONTE DE DADOS, configuradas junto das demais integrações
    // da empresa. Os pacotes de conversa já operam no teto de vagas por agente
    // (ver `selecao-por-pacote.ts`), e empurrá-las para lá recusaria a jornada
    // inteira de atender. Quem quer as duas capacidades no dia a dia liga
    // "Organizar" — que é onde se cadastra a origem dos dados.
    pacotes: ["organizar"],
    modulo: "banco_externo",
  },
  {
    name: "crm_query_external_data",
    category: "read",
    rotulo: "Buscar dados no banco conectado",
    explicacao:
      "Lê o conteúdo de uma tabela do banco que você conectou, com filtros, para o assistente responder ao cliente com o dado real em vez de estimar.",
    oQueToca: "Banco de dados conectado",
    risco: "seguro",
    pacotes: ["organizar"],
    modulo: "banco_externo",
  },
]);