@botozap/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bytecraft Consultoria em Tecnologia LTDA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# @botozap/mcp
+
+Servidor **MCP (Model Context Protocol)** para a API pública do **BotoZap** — a
+plataforma dev-first sobre a WhatsApp Cloud API oficial (multi-tenant, a "Kapso
+brasileira").
+
+Ele expõe as operações da plataforma (`/api/v1`) como **ferramentas MCP**, para
+que assistentes como **Claude Code**, **Cursor** e **Codex** consigam enviar
+mensagens, gerenciar contatos/clientes/números, criar templates e webhooks etc.
+
+Cada ferramenta MCP mapeia para uma operação do SDK oficial **`@botozap/sdk`**
+(que autentica com a sua chave `bz_...`, monta a requisição e trata o envelope de
+erro). É uma ponte fina: valida os argumentos (zod), delega ao SDK e devolve o
+JSON da API.
+
+> **Status: em preparação — ainda NÃO publicado no npm.** Use a partir do
+> monorepo (build local), como abaixo.
+
+## Requisitos
+
+- **Node.js ≥ 20** (ESM).
+- Uma chave de API do BotoZap (gere em **/chaves** no painel).
+- **pnpm** (este monorepo usa pnpm exclusivamente).
+
+## Build
+
+Este pacote vive no monorepo `botozap-js` e depende de `@botozap/sdk`
+(`workspace:*`). Instale as dependências na **raiz** do monorepo e então compile:
+
+```bash
+# na raiz do monorepo botozap-js
+pnpm install
+pnpm --filter @botozap/mcp build
+```
+
+> Não use `--ignore-workspace`: o pacote precisa resolver `@botozap/sdk` pelo
+> workspace.
+
+Smoke test (monta o servidor e lista as ferramentas, **sem** chamar a API real):
+
+```bash
+pnpm --filter @botozap/mcp smoke
+```
+
+Testes (vitest, sem rede):
+
+```bash
+pnpm --filter @botozap/mcp test
+```
+
+## Configuração (variáveis de ambiente)
+
+| Variável            | Obrigatória | Default                              | Descrição                                  |
+| ------------------- | ----------- | ------------------------------------ | ------------------------------------------ |
+| `BOTOZAP_API_KEY`   | **Sim**     | —                                    | Sua chave `bz_...` (header `Authorization: Bearer`). |
+| `BOTOZAP_API_URL`   | Não         | `https://botozap.com.br/api/v1`      | Base da API (útil para staging/local).      |
+
+Sem `BOTOZAP_API_KEY` o servidor falha imediatamente com uma mensagem clara.
+
+## Usar com Claude Code
+
+Via CLI (caminho **absoluto** para o `dist/index.js` compilado):
+
+```bash
+claude mcp add botozap \
+  --env BOTOZAP_API_KEY=bz_live_suachaveaqui \
+  -- node /caminho/absoluto/para/botozap-js/packages/mcp/dist/index.js
+```
+
+Ou no JSON do MCP (`.mcp.json` do projeto ou config do usuário):
+
+```json
+{
+  "mcpServers": {
+    "botozap": {
+      "command": "node",
+      "args": ["/caminho/absoluto/para/botozap-js/packages/mcp/dist/index.js"],
+      "env": {
+        "BOTOZAP_API_KEY": "bz_live_suachaveaqui"
+      }
+    }
+  }
+}
+```
+
+## Usar com Cursor
+
+Edite `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (no projeto):
+
+```json
+{
+  "mcpServers": {
+    "botozap": {
+      "command": "node",
+      "args": ["/caminho/absoluto/para/botozap-js/packages/mcp/dist/index.js"],
+      "env": {
+        "BOTOZAP_API_KEY": "bz_live_suachaveaqui"
+      }
+    }
+  }
+}
+```
+
+## Ferramentas disponíveis
+
+Transporte: **stdio**. Nomes em inglês (snake_case, melhor para tool-calling);
+descrições em PT-BR.
+
+**Mensagens** — `send_message`, `list_messages`, `get_message`
+**Conversas** — `list_conversations`, `get_conversation`, `update_conversation`
+**Contatos** — `list_contacts`, `get_contact`, `create_contact`, `update_contact`, `delete_contact`
+**Mídia** — `ingest_media`
+**Clientes** — `list_customers`, `get_customer`, `create_customer`, `update_customer`, `delete_customer`
+**Links de setup** — `list_setup_links`, `create_setup_link`, `update_setup_link`
+**Números** — `list_phone_numbers`, `get_phone_number`, `phone_number_health`
+**Templates** — `list_templates`, `get_template`, `create_template`
+**Webhooks** — `list_webhooks`, `get_webhook`, `create_webhook`, `update_webhook`, `delete_webhook`, `test_webhook`
+**Entregas de webhook** — `list_webhook_deliveries`
+**Logs** — `list_api_logs`
+**Usuários** — `list_users`
+
+Em caso de erro da API, a ferramenta devolve um resultado de erro (`isError`) com
+a mensagem PT-BR do envelope `{ error: { code, message } }` no formato
+`Erro [code]: message`.
+
+## Chaves de sandbox
+
+Uma chave de **sandbox** (prefixo `bz_sandbox_`) só habilita as ferramentas de
+mensagem: `send_message`, `list_messages` e `get_message`. Qualquer outra
+ferramenta responde `403 sandbox_forbidden` (vindo da API) — útil para testar a
+integração de envio sem tocar dados reais.
+
+**Números mágicos** (destinatários simulados, sem custo, sem número real):
+
+| `to`             | Comportamento simulado                                  |
+| ---------------- | ------------------------------------------------------- |
+| `+5500000000001` | happy path: `sent → delivered → read`, janela sempre aberta |
+| `+5500000000002` | falha: `sent → failed` (erro Meta `131026`)             |
+| `+5500000000003` | `sent → delivered` + resposta inbound simulada (abre a janela de 24h) |
+
+### Smokes de sandbox
+
+Há dois smokes, com propósitos distintos:
+
+- **Hermético (roda no `test`, CI):** `tests/sandbox-smoke.test.ts` usa um
+  `fetch` stub fiel ao contrato do sandbox — não precisa de credencial nem rede.
+  Verifica que o texto (acento + emoji) sobrevive intacto, que a chave vira
+  `Authorization: Bearer`, que a resposta (`sandbox: true` + `wamid.sandbox.<...>`)
+  chega ao agente, e que **a chave nunca aparece** no resultado.
+
+- **Externo (manual, exige credencial):** `pnpm --filter @botozap/mcp smoke:sandbox`
+  bate na API real. Exige `dist/` compilado (`pnpm --filter @botozap/mcp build`
+  antes) e as variáveis `BOTOZAP_API_KEY` (uma chave **`bz_sandbox_`**) e
+  `BOTOZAP_API_URL`. Recusa qualquer chave que não seja sandbox e **nunca imprime
+  a chave** (redação defensiva em toda saída, inclusive erros). **Nunca** entra no
+  `test` — não roda em PR/fork, que não têm credencial.
+
+  ```bash
+  pnpm --filter @botozap/mcp build
+  BOTOZAP_API_KEY=bz_sandbox_suachave BOTOZAP_API_URL=https://.../api/v1 \
+    pnpm --filter @botozap/mcp smoke:sandbox
+  ```
+
+## Segurança
+
+A conta é sempre derivada da chave de API no servidor do BotoZap (multi-tenant,
+IDOR-safe). A chave é um segredo — não a comite nem a logue. O servidor MCP só
+escreve logs em **stderr** (stdout é reservado para o protocolo MCP); a chave
+nunca aparece em resultado de ferramenta nem em mensagem de erro.

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ponte fina para o SDK oficial `@botozap/sdk`.
+ *
+ * O servidor MCP NÃO fala HTTP diretamente: cada ferramenta chama um método do
+ * `BotoZap` (o cliente do SDK), que cuida de auth (`Authorization: Bearer`),
+ * query string, envelope de erro e desempacote de itens. Este módulo só expõe:
+ *  - `createClient` — instancia o `BotoZap` a partir de `{ apiKey, baseUrl }`;
+ *  - `Client` — o tipo do cliente, usado por `register`/tools;
+ *  - `BotoZapError` — re-exportado para o `register` adaptar o `isError`.
+ */
+import { BotoZap, BotoZapError } from "@botozap/sdk";
+export { BotoZapError };
+/** Tipo do cliente do SDK usado pelas ferramentas. */
+export type Client = BotoZap;
+/**
+ * Base padrão da API pública. O SDK já usa o mesmo default; mantemos a constante
+ * aqui só para a config por ambiente (`BOTOZAP_API_URL`) ser explícita.
+ */
+export declare const DEFAULT_API_URL = "https://botozap.com.br/api/v1";
+export interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    /** Injeta um fetch (usado pelos testes de integração). Prod → global do SDK. */
+    fetch?: typeof fetch;
+}
+/** Instancia o cliente do SDK. `baseUrl` indefinido → default do SDK. */
+export declare function createClient(options: ClientOptions): Client;

package/dist/client.js

@@ -0,0 +1,26 @@
+/**
+ * Ponte fina para o SDK oficial `@botozap/sdk`.
+ *
+ * O servidor MCP NÃO fala HTTP diretamente: cada ferramenta chama um método do
+ * `BotoZap` (o cliente do SDK), que cuida de auth (`Authorization: Bearer`),
+ * query string, envelope de erro e desempacote de itens. Este módulo só expõe:
+ *  - `createClient` — instancia o `BotoZap` a partir de `{ apiKey, baseUrl }`;
+ *  - `Client` — o tipo do cliente, usado por `register`/tools;
+ *  - `BotoZapError` — re-exportado para o `register` adaptar o `isError`.
+ */
+import { BotoZap, BotoZapError } from "@botozap/sdk";
+export { BotoZapError };
+/**
+ * Base padrão da API pública. O SDK já usa o mesmo default; mantemos a constante
+ * aqui só para a config por ambiente (`BOTOZAP_API_URL`) ser explícita.
+ */
+export const DEFAULT_API_URL = "https://botozap.com.br/api/v1";
+/** Instancia o cliente do SDK. `baseUrl` indefinido → default do SDK. */
+export function createClient(options) {
+    return new BotoZap({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,CAAC;AAKxB;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAS/D,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO,IAAI,OAAO,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Bootstrap do servidor MCP do BotoZap (transporte stdio).
+ *
+ * Uso: defina `BOTOZAP_API_KEY` (e opcionalmente `BOTOZAP_API_URL`) e rode o
+ * binário `botozap-mcp`. O servidor fala MCP por stdin/stdout — não imprima
+ * nada em stdout fora do protocolo; logs vão para stderr.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { buildServer, configFromEnv } from "./server.js";
+async function main() {
+    const config = configFromEnv();
+    const server = buildServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[botozap-mcp] servidor MCP iniciado (stdio).");
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`[botozap-mcp] erro fatal: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;AAChE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Helper de registro de ferramentas: encapsula o padrão comum de
+ *  1. validar args (zod, feito pelo SDK a partir do `inputSchema`),
+ *  2. chamar a API via cliente do `@botozap/sdk`,
+ *  3. devolver o JSON cru como conteúdo de texto (JSON pretty),
+ *  4. converter `BotoZapError`/exceções em resultado `isError` com mensagem PT-BR.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ZodRawShape } from "zod";
+import { type Client } from "./client.js";
+/** Assinatura do handler de uma ferramenta: recebe o client + args validados. */
+export type ToolHandler<Args> = (client: Client, args: Args) => Promise<unknown>;
+/**
+ * Fábrica que devolve um `register(...)` ligado a um server + client.
+ * `inputSchema` é um *raw shape* zod (objeto de schemas), como o
+ * `registerTool` do SDK espera.
+ */
+export declare function createRegister(server: McpServer, client: Client): (name: string, description: string, inputSchema: ZodRawShape, handler: ToolHandler<Record<string, unknown>>) => void;
+export type Register = ReturnType<typeof createRegister>;

package/dist/register.js

@@ -0,0 +1,42 @@
+/**
+ * Helper de registro de ferramentas: encapsula o padrão comum de
+ *  1. validar args (zod, feito pelo SDK a partir do `inputSchema`),
+ *  2. chamar a API via cliente do `@botozap/sdk`,
+ *  3. devolver o JSON cru como conteúdo de texto (JSON pretty),
+ *  4. converter `BotoZapError`/exceções em resultado `isError` com mensagem PT-BR.
+ */
+import { BotoZapError } from "./client.js";
+/**
+ * Fábrica que devolve um `register(...)` ligado a um server + client.
+ * `inputSchema` é um *raw shape* zod (objeto de schemas), como o
+ * `registerTool` do SDK espera.
+ */
+export function createRegister(server, client) {
+    return function register(name, description, inputSchema, handler) {
+        server.registerTool(name, { description, inputSchema }, async (args) => {
+            try {
+                const data = await handler(client, (args ?? {}));
+                return {
+                    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+                };
+            }
+            catch (err) {
+                let message;
+                if (err instanceof BotoZapError) {
+                    message = `Erro [${err.code}]: ${err.message}`;
+                }
+                else if (err instanceof Error) {
+                    message = `Erro: ${err.message}`;
+                }
+                else {
+                    message = `Erro: ${String(err)}`;
+                }
+                return {
+                    content: [{ type: "text", text: message }],
+                    isError: true,
+                };
+            }
+        });
+    };
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAQxD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAc;IAC9D,OAAO,SAAS,QAAQ,CACtB,IAAY,EACZ,WAAmB,EACnB,WAAwB,EACxB,OAA6C;QAE7C,MAAM,CAAC,YAAY,CACjB,IAAI,EACJ,EAAE,WAAW,EAAE,WAAW,EAAE,EAC5B,KAAK,EAAE,IAAI,EAA2B,EAAE;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;gBAC5E,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBACjE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,OAAe,CAAC;gBACpB,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;oBAChC,OAAO,GAAG,SAAS,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjD,CAAC;qBAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;oBAChC,OAAO,GAAG,SAAS,GAAG,CAAC,OAAO,EAAE,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,SAAS,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;oBAC1C,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface BuildServerOptions {
+    apiKey: string;
+    baseUrl?: string;
+    /** Injeta um fetch (testes de integração). Prod → global do SDK. */
+    fetch?: typeof fetch;
+}
+/** Monta um `McpServer` com todas as ferramentas registradas. */
+export declare function buildServer(options: BuildServerOptions): McpServer;
+/**
+ * Lê a config do ambiente e valida a presença da chave (falha rápida com
+ * mensagem PT-BR clara). Usado pelo bootstrap stdio.
+ */
+export declare function configFromEnv(): BuildServerOptions;

package/dist/server.js

@@ -0,0 +1,59 @@
+/**
+ * Construção do servidor MCP: cria o `McpServer`, instancia o cliente do SDK
+ * e registra todos os grupos de ferramentas. Extraído de `index.ts` para que o
+ * smoke test possa montar o servidor sem abrir o transporte stdio.
+ */
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { createClient, DEFAULT_API_URL } from "./client.js";
+import { createRegister } from "./register.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerConversationTools } from "./tools/conversations.js";
+import { registerContactTools } from "./tools/contacts.js";
+import { registerMediaTools } from "./tools/media.js";
+import { registerCustomerTools } from "./tools/customers.js";
+import { registerPhoneNumberTools } from "./tools/phone-numbers.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+import { registerMiscTools } from "./tools/misc.js";
+const { version: VERSION } = createRequire(import.meta.url)("../package.json");
+/** Monta um `McpServer` com todas as ferramentas registradas. */
+export function buildServer(options) {
+    const server = new McpServer({
+        name: "botozap-mcp",
+        version: VERSION,
+    });
+    const client = createClient({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    const register = createRegister(server, client);
+    registerMessageTools(register);
+    registerConversationTools(register);
+    registerContactTools(register);
+    registerMediaTools(register);
+    registerCustomerTools(register);
+    registerPhoneNumberTools(register);
+    registerTemplateTools(register);
+    registerWebhookTools(register);
+    registerMiscTools(register);
+    return server;
+}
+/**
+ * Lê a config do ambiente e valida a presença da chave (falha rápida com
+ * mensagem PT-BR clara). Usado pelo bootstrap stdio.
+ */
+export function configFromEnv() {
+    const apiKey = process.env.BOTOZAP_API_KEY?.trim();
+    if (!apiKey) {
+        throw new Error("BOTOZAP_API_KEY não definida. Gere uma chave (bz_live_...) no painel " +
+            "do BotoZap em /chaves e exporte-a como variável de ambiente " +
+            "BOTOZAP_API_KEY antes de iniciar o servidor MCP.");
+    }
+    return {
+        apiKey,
+        baseUrl: process.env.BOTOZAP_API_URL?.trim() || DEFAULT_API_URL,
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAE5E,CAAC;AASF,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACpC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACnC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,8DAA8D;YAC9D,kDAAkD,CACrD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,eAAe;KAChE,CAAC;AACJ,CAAC"}

package/dist/tools/contacts.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerContactTools(register: Register): void;

package/dist/tools/contacts.js

@@ -0,0 +1,46 @@
+/** Ferramentas de contatos (end users do WhatsApp): CRUD. */
+import { z } from "zod";
+export function registerContactTools(register) {
+    register("list_contacts", "Lista contatos da conta (paginação por cursor: { data, paging }). Filtros opcionais por cliente, presença de cliente, busca parcial em nome/wa_id e janela de criação.", {
+        customer_id: z.string().optional().describe("Filtra pelos números do cliente (derivado)."),
+        has_customer: z
+            .boolean()
+            .optional()
+            .describe("Nesta base todo contato tem cliente: false → vazio, true → no-op."),
+        profile_name_contains: z.string().optional().describe("Busca parcial (ilike) no nome de perfil."),
+        wa_id_contains: z.string().optional().describe("Busca parcial (ilike) no wa_id."),
+        created_after: z.string().optional().describe("Criados em ou após esta data (ISO 8601)."),
+        created_before: z.string().optional().describe("Criados em ou antes desta data (ISO 8601)."),
+        limit: z.number().int().positive().optional(),
+        after: z.string().optional(),
+        before: z.string().optional(),
+    }, (client, args) => client.contacts.list(args));
+    register("get_contact", "Busca um contato pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID do contato (uuid interno).") }, async (client, args) => ({ data: await client.contacts.get(String(args.id)) }));
+    register("create_contact", "Cria um contato. O contato é sempre atado a um phone_number e único por (phone_number_id, wa_id). `wa_id` (BSUID ou E.164) é a chave canônica. Informe phone_number_id (Meta) OU customer_id para resolver o número.", {
+        wa_id: z.string().describe("Identidade canônica: BSUID (BR.1A2B...) ou dígitos E.164."),
+        phone_number_id: z.string().optional().describe("phone_number_id (Meta) ao qual atar."),
+        customer_id: z.string().optional().describe("Cliente cujo número será usado."),
+        profile_name: z.string().optional(),
+        phone: z.string().optional(),
+        user_id: z.string().optional().describe("BSUID do usuário."),
+        username: z.string().optional(),
+        parent_user_id: z.string().optional(),
+    }, async (client, args) => ({
+        data: await client.contacts.create(args),
+    }));
+    register("update_contact", "Atualiza um contato (campos editáveis: profile_name, username). Retorna { data }.", {
+        id: z.string().describe("ID do contato (uuid interno)."),
+        profile_name: z.string().optional(),
+        username: z.string().optional(),
+    }, async (client, args) => {
+        const { id, ...body } = args;
+        return { data: await client.contacts.update(String(id), body) };
+    });
+    register("delete_contact", "Exclui um contato pelo id (uuid interno).", { id: z.string().describe("ID do contato (uuid interno).") }, async (client, args) => {
+        // A rota responde 204 (sem corpo); preservamos o retorno `null` do MCP
+        // legado (JSON.stringify(null) === "null").
+        await client.contacts.delete(String(args.id));
+        return null;
+    });
+}
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"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"}

package/dist/tools/conversations.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerConversationTools(register: Register): void;

package/dist/tools/conversations.js

@@ -0,0 +1,24 @@
+/** Ferramentas de conversas: listar, ler e atualizar status. */
+import { z } from "zod";
+export function registerConversationTools(register) {
+    register("list_conversations", "Lista conversas da conta (paginação por cursor: { data, paging }). Filtros opcionais por número e por busca textual de contato.", {
+        phone_number_id: z.string().optional().describe("Filtra pelo phone_number_id (Meta)."),
+        status: z.string().optional().describe("Filtra por status (active|ended)."),
+        // A rota (/v1/conversations) casa por `contact`/`phone_number` (busca parcial
+        // em nome/username/telefone/wa_id, INNER join em contacts). Não existe filtro
+        // `contact_id` — por isso ele não é exposto aqui.
+        contact: z.string().optional().describe("Busca parcial: nome, @username, telefone ou wa_id do contato."),
+        phone_number: z.string().optional().describe("Alias de busca por contato (usado quando 'contact' não é informado)."),
+        limit: z.number().int().positive().optional(),
+        after: z.string().optional(),
+        before: z.string().optional(),
+    }, (client, args) => client.conversations.list(args));
+    register("get_conversation", "Busca uma conversa pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID da conversa (uuid interno).") }, async (client, args) => ({ data: await client.conversations.get(String(args.id)) }));
+    register("update_conversation", "Atualiza o status de uma conversa. status='ended' fecha a janela de 24h; status='active' é no-op idempotente (a janela só reabre com novo inbound do contato).", {
+        id: z.string().describe("ID da conversa (uuid interno)."),
+        status: z.enum(["active", "ended"]).describe("Novo status da conversa."),
+    }, async (client, args) => ({
+        data: await client.conversations.update(String(args.id), { status: args.status }),
+    }));
+}
+//# sourceMappingURL=conversations.js.map

package/dist/tools/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/tools/conversations.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,yBAAyB,CAAC,QAAkB;IAC1D,QAAQ,CACN,oBAAoB,EACpB,iIAAiI,EACjI;QACE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACtF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC3E,8EAA8E;QAC9E,8EAA8E;QAC9E,kDAAkD;QAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;QACxG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;QACpH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAA+B,CAAC,CAC7E,CAAC;IAEF,QAAQ,CACN,kBAAkB,EAClB,8DAA8D,EAC9D,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,EAC7D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CACpF,CAAC;IAEF,QAAQ,CACN,qBAAqB,EACrB,gKAAgK,EAChK;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACzD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACzE,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;KAClF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/customers.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerCustomerTools(register: Register): void;

package/dist/tools/customers.js

@@ -0,0 +1,65 @@
+/** Ferramentas de clientes (customers do dev) e seus links de setup. */
+import { z } from "zod";
+export function registerCustomerTools(register) {
+    register("list_customers", "Lista os clientes (customers) da conta (paginação offset: { data, meta }).", {
+        // A rota (/v1/customers) só lê `page`/`per_page` (parseOffsetParams).
+        page: z.number().int().positive().optional().describe("Página (1-based)."),
+        per_page: z.number().int().positive().optional().describe("Itens por página (máx. 100)."),
+    }, (client, args) => client.customers.list(args));
+    register("get_customer", "Busca um cliente pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID do cliente (uuid interno).") }, async (client, args) => ({ data: await client.customers.get(String(args.id)) }));
+    register("create_customer", "Cria um cliente. Informe ao menos `name`. `external_customer_id` é opcional (sua referência externa). Retorna { data }.", {
+        name: z.string().describe("Nome do cliente."),
+        external_customer_id: z.string().optional().describe("Referência externa opcional."),
+    }, async (client, args) => ({
+        data: await client.customers.create(args),
+    }));
+    register("update_customer", "Atualiza um cliente (name, external_customer_id). Retorna { data }.", {
+        id: z.string().describe("ID do cliente (uuid interno)."),
+        name: z.string().optional(),
+        external_customer_id: z.string().optional(),
+    }, async (client, args) => {
+        const { id, ...body } = args;
+        return { data: await client.customers.update(String(id), body) };
+    });
+    register("delete_customer", "Exclui um cliente pelo id (uuid interno).", { id: z.string().describe("ID do cliente (uuid interno).") }, async (client, args) => {
+        await client.customers.delete(String(args.id));
+        return null;
+    });
+    // ---- Links de setup (Embedded Signup) ----
+    register("list_setup_links", "Lista os links de setup de um cliente (paginação offset: { data, meta }).", {
+        customer_id: z.string().describe("ID do cliente (uuid interno)."),
+        page: z.number().int().positive().optional().describe("Página (1-based)."),
+        per_page: z.number().int().positive().optional().describe("Itens por página (máx. 100)."),
+    }, (client, args) => {
+        const { customer_id, ...query } = args;
+        return client.customers.listSetupLinks(String(customer_id), query);
+    });
+    register("create_setup_link", "Cria um link de setup para um cliente. Opções: allowed_connection_types ('dedicated'|'coexistence'), provision_phone_number, language e redirects. Retorna { data }.", {
+        customer_id: z.string().describe("ID do cliente (uuid interno)."),
+        allowed_connection_types: z
+            .array(z.enum(["dedicated", "coexistence"]))
+            .optional()
+            .describe("Modos de conexão permitidos."),
+        provision_phone_number: z.boolean().optional(),
+        language: z.string().optional().describe("Idioma (ou 'auto')."),
+        success_redirect_url: z.string().optional(),
+        failure_redirect_url: z.string().optional(),
+    }, async (client, args) => {
+        const { customer_id, ...body } = args;
+        return {
+            data: await client.customers.createSetupLink(String(customer_id), body),
+        };
+    });
+    register("update_setup_link", "Atualiza um link de setup (status, expires_at). Retorna { data }.", {
+        customer_id: z.string().describe("ID do cliente (uuid interno)."),
+        link_id: z.string().describe("ID do link de setup."),
+        status: z.string().optional().describe("Novo status do link."),
+        expires_at: z.string().optional().describe("Nova expiração (ISO 8601)."),
+    }, async (client, args) => {
+        const { customer_id, link_id, ...body } = args;
+        return {
+            data: await client.customers.updateSetupLink(String(customer_id), String(link_id), body),
+        };
+    });
+}
+//# sourceMappingURL=customers.js.map

package/dist/tools/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../src/tools/customers.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,QAAQ,CACN,gBAAgB,EAChB,4EAA4E,EAC5E;QACE,sEAAsE;QACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1F,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAoB,CAAC,CAC9D,CAAC;IAEF,QAAQ,CACN,cAAc,EACd,4DAA4D,EAC5D,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,EAC5D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAChF,CAAC;IAEF,QAAQ,CACN,iBAAiB,EACjB,yHAAyH,EACzH;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC7C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KACrF,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAA4B,CAAC;KAClE,CAAC,CACH,CAAC;IAEF,QAAQ,CACN,iBAAiB,EACjB,qEAAqE,EACrE;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5C,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAA4B,CAAC,EAAE,CAAC;IAC3F,CAAC,CACF,CAAC;IAEF,QAAQ,CACN,iBAAiB,EACjB,2CAA2C,EAC3C,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,EAC5D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC,CACF,CAAC;IAEF,6CAA6C;IAE7C,QAAQ,CACN,kBAAkB,EAClB,2EAA2E,EAC3E;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1F,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QACf,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,KAAqB,CAAC,CAAC;IACrF,CAAC,CACF,CAAC;IAEF,QAAQ,CACN,mBAAmB,EACnB,sKAAsK,EACtK;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACjE,wBAAwB,EAAE,CAAC;aACxB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;aAC3C,QAAQ,EAAE;aACV,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC/D,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5C,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAC1C,MAAM,CAAC,WAAW,CAAC,EACnB,IAA6B,CAC9B;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,QAAQ,CACN,mBAAmB,EACnB,mEAAmE,EACnE;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACjE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KACzE,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAC1C,MAAM,CAAC,WAAW,CAAC,EACnB,MAAM,CAAC,OAAO,CAAC,EACf,IAA6B,CAC9B;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/media.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerMediaTools(register: Register): void;

package/dist/tools/media.js

@@ -0,0 +1,17 @@
+/** Ferramenta de ingest de mídia a partir de uma URL. */
+import { z } from "zod";
+export function registerMediaTools(register) {
+    register("ingest_media", "Faz o ingest de uma mídia a partir de uma URL para a Meta. delivery='meta_media' (default) retorna um media_id usável em mensagens; delivery='meta_resumable_asset' retorna um handle reutilizável (ex.: header de template). Retorna { data }.", {
+        phone_number_id: z.string().describe("phone_number_id (Meta) dono da mídia."),
+        source: z.string().describe("URL de origem da mídia (https)."),
+        filename: z.string().optional(),
+        mime_type: z.string().optional().describe("Force o mime (ex.: image/png); senão é inferido."),
+        delivery: z
+            .enum(["meta_media", "meta_resumable_asset"])
+            .optional()
+            .describe("Forma de entrega à Meta (default meta_media)."),
+    }, async (client, args) => ({
+        data: await client.media.upload(args),
+    }));
+}
+//# sourceMappingURL=media.js.map

package/dist/tools/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,QAAQ,CACN,cAAc,EACd,iPAAiP,EACjP;QACE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC7F,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;aAC5C,QAAQ,EAAE;aACV,QAAQ,CAAC,+CAA+C,CAAC;KAC7D,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAoC,CAAC;KACtE,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/messages.d.ts

@@ -0,0 +1,110 @@
+/** Ferramentas de mensagens: envio, listagem e leitura. */
+import { z } from "zod";
+import type { Register } from "../register.js";
+/**
+ * Schema refinado que amarra `type` ao payload (o shape base sozinho aceitaria
+ * type='text' sem `text`, type='template' sem `template`, ou os dois juntos).
+ * Exportado pros testes e usado no handler pra validar ANTES de chamar a API —
+ * a validação do próprio SDK roda contra o shape base (sem esta regra cruzada).
+ */
+export declare const sendMessageSchema: z.ZodEffects<z.ZodObject<{
+    readonly to: z.ZodString;
+    readonly type: z.ZodEnum<["text", "template"]>;
+    readonly text: z.ZodOptional<z.ZodObject<{
+        body: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        body: string;
+    }, {
+        body: string;
+    }>>;
+    readonly template: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        language: z.ZodObject<{
+            code: z.ZodString;
+            policy: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            policy?: string | undefined;
+        }, {
+            code: string;
+            policy?: string | undefined;
+        }>;
+        components: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    }, {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    }>>;
+    readonly from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "text" | "template";
+    to: string;
+    text?: {
+        body: string;
+    } | undefined;
+    template?: {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    } | undefined;
+    from?: string | undefined;
+}, {
+    type: "text" | "template";
+    to: string;
+    text?: {
+        body: string;
+    } | undefined;
+    template?: {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    } | undefined;
+    from?: string | undefined;
+}>, {
+    type: "text" | "template";
+    to: string;
+    text?: {
+        body: string;
+    } | undefined;
+    template?: {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    } | undefined;
+    from?: string | undefined;
+}, {
+    type: "text" | "template";
+    to: string;
+    text?: {
+        body: string;
+    } | undefined;
+    template?: {
+        name: string;
+        language: {
+            code: string;
+            policy?: string | undefined;
+        };
+        components?: Record<string, unknown>[] | undefined;
+    } | undefined;
+    from?: string | undefined;
+}>;
+export declare function registerMessageTools(register: Register): void;

package/dist/tools/messages.js

@@ -0,0 +1,125 @@
+/** Ferramentas de mensagens: envio, listagem e leitura. */
+import { z } from "zod";
+/**
+ * Shape (raw) de `send_message`. Fica como *raw shape* de propósito: é ele que
+ * vai pro `registerTool` do MCP SDK, que só gera JSON Schema (com as descrições
+ * dos campos, que o AGENTE lê) a partir de um ZodObject/raw shape. Um schema
+ * refinado (`superRefine`) ou uma discriminated union viram ZodEffects/ZodUnion
+ * SEM `.shape` — o `normalizeObjectSchema` do SDK não os reconhece e cai no
+ * `EMPTY_OBJECT_JSON_SCHEMA`, apagando todas as descrições. Por isso: shape base
+ * pro JSON Schema; a regra cruzada (type ↔ payload) mora no `sendMessageSchema`.
+ */
+const sendMessageShape = {
+    to: z.string().describe("Destinatário: telefone E.164 (ex.: 5511999999999) ou wa_id."),
+    type: z.enum(["text", "template"]).describe("Tipo da mensagem."),
+    text: z
+        .object({ body: z.string() })
+        .optional()
+        .describe("Conteúdo de texto quando type='text'."),
+    // Schema restritivo de propósito: o MCP é consumido por AGENTES, então o
+    // objeto do template precisa espelhar o contrato da rota (e do SDK:
+    // TemplatePayload) — não aceitar "qualquer objeto". A rota exige `name` e o
+    // objeto `language: { code }` (string solta é rejeitada). `components` fica
+    // como array de objetos livres porque é genuinamente o formato aberto da
+    // Cloud API (parâmetros de header/body/button). Contraste com create_template
+    // em tools/templates.ts, onde `components` também é livre pelo mesmo motivo.
+    template: z
+        .object({
+        name: z.string().describe("Nome do template APROVADO na Meta."),
+        language: z
+            .object({
+            code: z.string().describe("Código de idioma, ex.: pt_BR."),
+            // Zod sem .strict() faz STRIP de chaves extras — sem `policy`
+            // declarado, um `language.policy` legítimo da Cloud API seria
+            // descartado em silêncio. Declarado pra preservar.
+            policy: z
+                .string()
+                .optional()
+                .describe("Política de idioma da Cloud API (ex.: deterministic)."),
+        })
+            .describe("Idioma no formato da Cloud API: { code, policy? }."),
+        components: z
+            .array(z.record(z.string(), z.unknown()))
+            .optional()
+            .describe("Componentes com parâmetros (header/body/button) no formato da Cloud API."),
+    })
+        .optional()
+        .describe("Objeto do template quando type='template'. Exige name e language.code."),
+    from: z
+        .string()
+        .optional()
+        .describe("phone_number_id de origem (obrigatório se a conta tem >1 número)."),
+};
+/**
+ * Schema refinado que amarra `type` ao payload (o shape base sozinho aceitaria
+ * type='text' sem `text`, type='template' sem `template`, ou os dois juntos).
+ * Exportado pros testes e usado no handler pra validar ANTES de chamar a API —
+ * a validação do próprio SDK roda contra o shape base (sem esta regra cruzada).
+ */
+export const sendMessageSchema = z
+    .object(sendMessageShape)
+    .superRefine((val, ctx) => {
+    if (val.type === "text") {
+        if (!val.text) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["text"],
+                message: "type='text' exige o campo 'text' com { body }.",
+            });
+        }
+        if (val.template) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["template"],
+                message: "type='text' não aceita 'template' junto — envie só 'text' (ou use type='template').",
+            });
+        }
+    }
+    else if (val.type === "template") {
+        if (!val.template) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["template"],
+                message: "type='template' exige o campo 'template' com { name, language.code }.",
+            });
+        }
+        if (val.text) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["text"],
+                message: "type='template' não aceita 'text' junto — envie só 'template' (ou use type='text').",
+            });
+        }
+    }
+});
+export function registerMessageTools(register) {
+    register("send_message", "Envia uma mensagem de WhatsApp (texto ou template) via API do BotoZap. `to` é o número E.164 ou wa_id do destinatário. Para texto: type='text' e text={ body }. Para template: type='template' e template={ name, language, components? }. `from` (phone_number_id) é obrigatório se a conta tem mais de um número. Retorna { id, wamid, to, status }.", sendMessageShape, (client, args) => {
+        // O SDK do MCP já validou `args` contra o shape base; aqui aplicamos a
+        // regra cruzada type ↔ payload (que o shape base não expressa) com mensagem
+        // PT-BR clara pro agente, ANTES de gastar um round-trip com a API.
+        const parsed = sendMessageSchema.safeParse(args);
+        if (!parsed.success) {
+            throw new Error(parsed.error.issues.map((i) => i.message).join(" "));
+        }
+        const { to, type, text, template, from } = parsed.data;
+        // Despacha pelo `type` — o superRefine já garantiu o payload correspondente.
+        // Resposta direta (sem envelope), igual ao POST /messages.
+        if (type === "text") {
+            return client.messages.send({ to, text: text.body, from });
+        }
+        return client.messages.sendTemplate({ to, template: template, from });
+    });
+    register("list_messages", "Lista mensagens da conta (paginação por cursor: { data, paging }). Filtros opcionais por número, conversa, direção, status, tipo e presença de mídia.", {
+        phone_number_id: z.string().optional().describe("Filtra pelo phone_number_id (Meta)."),
+        conversation_id: z.string().optional().describe("Filtra pela conversa (uuid interno)."),
+        direction: z.enum(["inbound", "outbound"]).optional(),
+        status: z.string().optional().describe("Status da mensagem (enum message_status)."),
+        message_type: z.string().optional().describe("Tipo da mensagem (kind: text, image, ...)."),
+        has_media: z.boolean().optional().describe("true para apenas mensagens com mídia."),
+        limit: z.number().int().positive().optional().describe("Tamanho da página."),
+        after: z.string().optional().describe("Cursor: itens após este created_at."),
+        before: z.string().optional().describe("Cursor: itens antes deste created_at."),
+    }, (client, args) => client.messages.list(args));
+    register("get_message", "Busca uma mensagem específica pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID da mensagem (uuid interno).") }, async (client, args) => ({ data: await client.messages.get(String(args.id)) }));
+}
+//# sourceMappingURL=messages.js.map

package/dist/tools/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"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"}

package/dist/tools/misc.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerMiscTools(register: Register): void;

package/dist/tools/misc.js

@@ -0,0 +1,18 @@
+/** Ferramentas diversas: logs de API e usuários da conta. */
+import { z } from "zod";
+export function registerMiscTools(register) {
+    register("list_api_logs", "Lista os logs de requisições à API pública da conta (auditoria). Paginação por cursor: { data, paging }.", {
+        // Filtros reais da rota (/v1/api_logs): source, method e status_code.
+        source: z.string().optional().describe("Origem do log (ex.: api)."),
+        method: z.string().optional().describe("Método HTTP (normalizado p/ maiúsculas)."),
+        status_code: z.number().int().optional().describe("Código HTTP exato (inteiro)."),
+        limit: z.number().int().positive().optional(),
+        after: z.string().optional(),
+        before: z.string().optional(),
+    }, (client, args) => client.apiLogs.list(args));
+    register("list_users", "Lista os usuários (membros) da conta. Paginação offset: { data, meta }.", {
+        page: z.number().int().positive().optional().describe("Página (1-based)."),
+        per_page: z.number().int().positive().optional().describe("Itens por página (máx. 100)."),
+    }, (client, args) => client.users.list(args));
+}
+//# sourceMappingURL=misc.js.map

package/dist/tools/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/tools/misc.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,QAAQ,CACN,eAAe,EACf,0GAA0G,EAC1G;QACE,sEAAsE;QACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAyB,CAAC,CACjE,CAAC;IAEF,QAAQ,CACN,YAAY,EACZ,yEAAyE,EACzE;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1F,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAoB,CAAC,CAC1D,CAAC;AACJ,CAAC"}

package/dist/tools/phone-numbers.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerPhoneNumberTools(register: Register): void;

package/dist/tools/phone-numbers.js

@@ -0,0 +1,12 @@
+/** Ferramentas de números de telefone (WABA): listar, ler e saúde. */
+import { z } from "zod";
+export function registerPhoneNumberTools(register) {
+    register("list_phone_numbers", "Lista os números de telefone conectados da conta (paginação offset: { data, meta }). Filtro opcional por cliente.", {
+        customer_id: z.string().optional().describe("Filtra pelos números de um cliente."),
+        page: z.number().int().positive().optional().describe("Página (1-based)."),
+        per_page: z.number().int().positive().optional().describe("Itens por página (máx. 100)."),
+    }, (client, args) => client.phoneNumbers.list(args));
+    register("get_phone_number", "Busca um número pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID do número (uuid interno).") }, async (client, args) => ({ data: await client.phoneNumbers.get(String(args.id)) }));
+    register("phone_number_health", "Retorna a saúde/qualidade de um número (quality rating, status de verificação, limites). Retorna { data }.", { id: z.string().describe("ID do número (uuid interno).") }, async (client, args) => ({ data: await client.phoneNumbers.health(String(args.id)) }));
+}
+//# sourceMappingURL=phone-numbers.js.map

package/dist/tools/phone-numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.js","sourceRoot":"","sources":["../../src/tools/phone-numbers.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,wBAAwB,CAAC,QAAkB;IACzD,QAAQ,CACN,oBAAoB,EACpB,mHAAmH,EACnH;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAClF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1F,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAA8B,CAAC,CAC3E,CAAC;IAEF,QAAQ,CACN,kBAAkB,EAClB,2DAA2D,EAC3D,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,EAC3D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CACnF,CAAC;IAEF,QAAQ,CACN,qBAAqB,EACrB,4GAA4G,EAC5G,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,EAC3D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CACtF,CAAC;AACJ,CAAC"}

package/dist/tools/templates.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerTemplateTools(register: Register): void;

package/dist/tools/templates.js

@@ -0,0 +1,26 @@
+/** Ferramentas de templates de mensagem. */
+import { z } from "zod";
+export function registerTemplateTools(register) {
+    register("list_templates", "Lista templates da conta (paginação offset: { data, meta }). Filtros opcionais por status, categoria e conexão WABA.", {
+        status: z.string().optional().describe("Filtra por status (ex.: APPROVED, PENDING)."),
+        category: z.string().optional().describe("Filtra por categoria (case-insensitive)."),
+        waba_connection_id: z.string().optional(),
+        phone_number_id: z.string().optional().describe("Resolve a conexão do número (Meta)."),
+        page: z.number().int().positive().optional().describe("Página (1-based)."),
+        per_page: z.number().int().positive().optional().describe("Itens por página (máx. 100)."),
+    }, (client, args) => client.templates.list(args));
+    register("get_template", "Busca um template pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID do template (uuid interno).") }, async (client, args) => ({ data: await client.templates.get(String(args.id)) }));
+    register("create_template", "Cria um template e o submete à Meta. Informe name, language, category e components (array no formato da Cloud API). Aponte a conexão via waba_connection_id OU phone_number_id. Retorna { data }.", {
+        name: z.string().describe("Nome do template (snake_case)."),
+        language: z.string().describe("Código de idioma (ex.: pt_BR)."),
+        category: z.string().describe("Categoria (MARKETING|UTILITY|AUTHENTICATION)."),
+        components: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe("Componentes do template (header/body/footer/buttons)."),
+        waba_connection_id: z.string().optional(),
+        phone_number_id: z.string().optional().describe("Resolve a conexão do número (Meta)."),
+    }, async (client, args) => ({
+        data: await client.templates.create(args),
+    }));
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,QAAQ,CACN,gBAAgB,EAChB,sHAAsH,EACtH;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACpF,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACtF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1F,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAA2B,CAAC,CACrE,CAAC;IAEF,QAAQ,CACN,cAAc,EACd,6DAA6D,EAC7D,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,EAC7D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAChF,CAAC;IAEF,QAAQ,CACN,iBAAiB,EACjB,mMAAmM,EACnM;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC9E,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aACxC,QAAQ,CAAC,uDAAuD,CAAC;QACpE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACvF,EACD,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAuC,CAAC;KAC7E,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,2 @@
+import type { Register } from "../register.js";
+export declare function registerWebhookTools(register: Register): void;

package/dist/tools/webhooks.js

@@ -0,0 +1,40 @@
+/** Ferramentas de webhooks (assinaturas de eventos de saída) e entregas. */
+import { z } from "zod";
+export function registerWebhookTools(register) {
+    register("list_webhooks", "Lista os endpoints de webhook da conta (paginação por cursor: { data, paging }).", {
+        limit: z.number().int().positive().optional(),
+        after: z.string().optional(),
+        before: z.string().optional(),
+    }, (client, args) => client.webhooks.list(args));
+    register("get_webhook", "Busca um webhook pelo id (uuid interno). Retorna { data }.", { id: z.string().describe("ID do webhook (uuid interno).") }, async (client, args) => ({ data: await client.webhooks.get(String(args.id)) }));
+    register("create_webhook", "Cria um endpoint de webhook. `url` precisa ser https. `events` é a lista de tipos de evento assinados (ao menos um). Retorna { data }.", {
+        url: z.string().describe("URL https do endpoint."),
+        events: z.array(z.string()).describe("Tipos de evento assinados."),
+        active: z.boolean().optional().describe("Ativo (default true)."),
+    }, async (client, args) => ({
+        data: await client.webhooks.create(args),
+    }));
+    register("update_webhook", "Atualiza um webhook (url, events, active). Retorna { data }.", {
+        id: z.string().describe("ID do webhook (uuid interno)."),
+        url: z.string().optional(),
+        events: z.array(z.string()).optional(),
+        active: z.boolean().optional(),
+    }, async (client, args) => {
+        const { id, ...body } = args;
+        return { data: await client.webhooks.update(String(id), body) };
+    });
+    register("delete_webhook", "Exclui um webhook pelo id (uuid interno).", { id: z.string().describe("ID do webhook (uuid interno).") }, async (client, args) => {
+        await client.webhooks.delete(String(args.id));
+        return null;
+    });
+    register("test_webhook", "Dispara um evento de teste assinado para o endpoint de webhook informado. Retorna { data }.", { id: z.string().describe("ID do webhook (uuid interno).") }, async (client, args) => ({ data: await client.webhooks.test(String(args.id)) }));
+    register("list_webhook_deliveries", "Lista as entregas de webhook (tentativas de POST aos endpoints), com status e resposta. Paginação por cursor: { data, paging }.", {
+        webhook_id: z.string().optional().describe("Filtra por endpoint (alias de endpoint_id na rota)."),
+        status: z.string().optional().describe("Filtra por status da entrega (pending|success|failed|exhausted)."),
+        event_type: z.string().optional().describe("Filtra pelo tipo de evento da entrega."),
+        limit: z.number().int().positive().optional(),
+        after: z.string().optional(),
+        before: z.string().optional(),
+    }, (client, args) => client.webhookDeliveries.list(args));
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@botozap/mcp",
+  "version": "0.1.0",
+  "description": "Servidor MCP (Model Context Protocol) para a API pública do BotoZap — expõe as operações da plataforma WhatsApp Cloud API como ferramentas MCP para Claude Code, Cursor e Codex.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://botozap.com.br",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bytecraft-fernando/botozap-js.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/bytecraft-fernando/botozap-js/issues"
+  },
+  "bin": {
+    "botozap-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76",
+    "@botozap/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "smoke": "node scripts/smoke.ts",
+    "smoke:sandbox": "node scripts/smoke-sandbox.ts"
+  }
+}