/**
 * O ID de uma ferramenta remota dentro de `ai_agent_versions.tool_ids` (#2147,
 * item 6) — cada agente escolhe as próprias.
 *
 * ── Por que um prefixo e não o nome cru ─────────────────────────────────────
 *
 * O catálogo compilado é a fonte dos ids sem prefixo e `tool_ids` já é
 * validado contra ele (`VALID_TOOL_IDS`, em quatro pontos: zod da versão, rota
 * de publicação e os dois espelhos de `_actions.ts`). Um id novo sem marca
 * própria seria recusado lá; com prefixo, o mesmo validador o aceita sem
 * perder a régua de "id que não existe não entra".
 *
 * ── Por que a marca de LEITURA/ESCRITA vem no id ────────────────────────────
 *
 * `annotations.readOnlyHint` é DECLARAÇÃO do servidor remoto, não garantia: um
 * servidor que se diga "readOnly" num `cancelar_pedido` passaria como leitura.
 * Quem administra o cadastro também administra esta escolha, e ela precisa
 * ficar gravada em algum lugar da VERSÃO — o id é esse lugar. Um servidor
 * anuncia `readOnlyHint: true` E o administrador marca `leitura` para a
 * ferramenta contar como leitura durante uma conversa (item 8); qualquer outra
 * combinação é escrita, que a regra de escopo do turno recusa.
 *
 * ── O formato ──────────────────────────────────────────────────────────────
 *
 * `mcp_externo:<leitura|escrita>:<nome>` — prefixo estável que o editor do
 * agente lista, marca explícita e o nome como o servidor o anuncia. O nome
 * segue a mesma régua do protocolo MCP (`[A-Za-z0-9_-]{1,64}`): um id fora
 * dela nunca monta ferramenta, então recusá-lo aqui é recusar cedo o que de
 * qualquer jeito não funcionaria.
 */

/** Prefixo estável: é por ele que o editor e a validação reconhecem a remota. */
export const PREFIXO_TOOL_ID_MCP_EXTERNO = "mcp_externo:";

/** O que a escolha do agente declara sobre a ferramenta remota. */
export type MarcaRemota = "leitura" | "escrita";

/** Uma escolha lida de volta de `tool_ids`. */
export interface EscolhaRemota {
  /** Nome como o servidor remoto o anuncia (`tools/list`). */
  nome: string;
  /** `true` só quando o administrador marcou a ferramenta como leitura. */
  leitura: boolean;
  /**
   * O servidor DO AGENTE a que a escolha pertence (`ai_agent_mcp_servers.id`).
   * Ausente = o servidor compartilhado da organização (o formato de antes,
   * `mcp_externo:<marca>:<nome>`), que segue valendo sem migração de dados.
   */
  servidorId?: string;
}

const NOME_DE_PROTOCOLO = /^[A-Za-z0-9_-]{1,64}$/;
const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;

function ehNomeDeProtocolo(nome: unknown): nome is string {
  return typeof nome === "string" && NOME_DE_PROTOCOLO.test(nome);
}

/**
 * Monta o id que vai para `tool_ids` — o inverso exato de `lerToolIdRemoto`.
 *
 * Com `servidorId`, o formato dos servidores POR AGENTE:
 * `mcp_externo:<servidor_id>:<leitura|escrita>:<nome>`. O id do servidor no
 * prefixo é o que impede o `buscar_pedido` de um servidor de ser confundido
 * com o `buscar_pedido` de outro — nomes iguais em servidores diferentes são
 * escolhas diferentes.
 */
export function toolIdRemoto(nome: string, marca: MarcaRemota, servidorId?: string): string {
  return servidorId
    ? `${PREFIXO_TOOL_ID_MCP_EXTERNO}${servidorId}:${marca}:${nome}`
    : `${PREFIXO_TOOL_ID_MCP_EXTERNO}${marca}:${nome}`;
}

/**
 * A escolha contida num id, ou `null` quando o id não é de ferramenta remota
 * (prefixo ausente, marca desconhecida ou nome fora do protocolo).
 *
 * `null` para id SEM prefixo é obrigatório: quem chama costuma testar os dois
 * domínios no mesmo laço, e tratar `crm_search_products` como id remoto
 * inválido mudaria o significado de "recusar".
 */
export function lerToolIdRemoto(id: string): EscolhaRemota | null {
  if (!id.startsWith(PREFIXO_TOOL_ID_MCP_EXTERNO)) return null;
  const partes = id.slice(PREFIXO_TOOL_ID_MCP_EXTERNO.length).split(":");
  // Três partes = servidor do agente (com o id do servidor na frente); duas =
  // o servidor compartilhado da organização. Qualquer outra forma não é escolha.
  const [servidorId, marca, nome] =
    partes.length === 3 ? partes : partes.length === 2 ? [undefined, ...partes] : [];
  if (servidorId !== undefined && !UUID.test(servidorId)) return null;
  if (!ehNomeDeProtocolo(nome)) return null;
  if (marca !== "leitura" && marca !== "escrita") return null;
  return servidorId
    ? { nome: nome!, leitura: marca === "leitura", servidorId }
    : { nome: nome!, leitura: marca === "leitura" };
}

/** É um id de ferramenta remota bem formado? (`false` para ids compilados.) */
export function ehToolIdRemoto(id: string): boolean {
  return lerToolIdRemoto(id) !== null;
}

/**
 * O predicado ÚNICO de "este id pode entrar em `tool_ids`": catálogo compilado
 * OU ferramenta remota bem formada.
 *
 * Quatro pontos da codebase conferem isso (o zod da versão, a rota de
 * publicação e os dois espelhos de `_actions.ts`) e cada um tem cópia própria
 * do `Set` de catálogo — aceitar remota em um só deles faria a versão salvar e
 * a publicação recusar, com o mesmo dado na mesma tela.
 */
export function toolIdAceito(id: string, catalogo: ReadonlySet<string>): boolean {
  return catalogo.has(id) || ehToolIdRemoto(id);
}

/**
 * As escolhas remotas do servidor COMPARTILHADO da organização, na ordem do
 * array e sem duplicatas de nome — a mesma ferramenta marcada leitura E escrita
 * seria duas verdades sobre o mesmo tool no turno, e a primeira que vence.
 *
 * Só o formato sem servidor: as escolhas de servidor do agente têm dono próprio
 * (`escolhasDoServidor`) e não podem montar contra o servidor da organização.
 */
export function escolhasRemotas(toolIds: readonly string[]): EscolhaRemota[] {
  const porNome = new Map<string, EscolhaRemota>();
  for (const id of toolIds) {
    const escolha = lerToolIdRemoto(id);
    if (escolha && !escolha.servidorId && !porNome.has(escolha.nome)) {
      porNome.set(escolha.nome, escolha);
    }
  }
  return [...porNome.values()];
}

/** As escolhas de UM servidor do agente, com a mesma régua de duplicata. */
export function escolhasDoServidor(toolIds: readonly string[], servidorId: string): EscolhaRemota[] {
  const porNome = new Map<string, EscolhaRemota>();
  for (const id of toolIds) {
    const escolha = lerToolIdRemoto(id);
    if (escolha?.servidorId === servidorId && !porNome.has(escolha.nome)) {
      porNome.set(escolha.nome, escolha);
    }
  }
  return [...porNome.values()];
}

/** Os ids de servidor do agente que aparecem em algum `tool_ids`. */
export function servidoresEscolhidos(toolIds: readonly string[]): Set<string> {
  const ids = new Set<string>();
  for (const id of toolIds) {
    const escolha = lerToolIdRemoto(id);
    if (escolha?.servidorId) ids.add(escolha.servidorId);
  }
  return ids;
}