@cgalaviz/easysell-mcp 0.4.0

package/dist/client.js

@@ -0,0 +1,372 @@
+/**
+ * Cliente HTTP hacia commerce-api. Autenticación por API key
+ * (`Authorization: Bearer npk_...`), la misma que expone el panel en
+ * Empresa → API keys — nunca sesión de usuario. `COMMERCE_API_KEY` es la
+ * única credencial que este proceso necesita; determina qué tenant y qué
+ * scopes puede usar (ver apps/commerce-api/src/auth/principal.guard.ts).
+ *
+ * `COMMERCE_TENANT_ID` es opcional y solo tiene efecto con una key GLOBAL
+ * (sin tenant propio, T-IAM-09b): manda `X-Tenant-Id` en cada request para
+ * decirle a commerce-api sobre qué empresa operar. Con una key de tenant
+ * normal no hace falta — el tenant ya viene fijo en la key — y el header,
+ * si se manda de todos modos, se ignora (PrincipalGuard solo lo lee cuando
+ * la key resolvió como global).
+ */
+import { SUPER_ADMIN_OVERVIEW_PATH } from "./registry/super-admin.js";
+const DEFAULT_BASE_URL = "https://api-easysell.tupla.dev/api/v1";
+/**
+ * Tope duro por request: sin esto, una conexión colgada a commerce-api deja
+ * la tool esperando indefinidamente y con ella el cliente MCP entero (stdio
+ * es un solo canal secuencial). 30s es generoso para cualquier endpoint real
+ * de este API; configurable por si un despliegue propio lo necesita más largo.
+ */
+function timeoutMs() {
+    const raw = process.env.COMMERCE_TIMEOUT_MS;
+    const parsed = raw ? Number(raw) : NaN;
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 30_000;
+}
+function baseUrl() {
+    const raw = process.env.COMMERCE_API_BASE_URL ?? DEFAULT_BASE_URL;
+    // CRÍTICO: validar scheme. Sin esto, un `.mcp.json` o config compartida
+    // puede apuntar el MCP a `http://evil.com` y exfiltrar la API key en cada
+    // request vía el header `Authorization: Bearer npk_...`. Permitimos
+    // `http://` SOLO para hosts locales (loopback) — útil para dev contra
+    // un commerce-api local sin TLS — y exigimos `https://` para todo lo
+    // demás, sin excepciones.
+    let parsed;
+    try {
+        parsed = new URL(raw.replace(/\/+$/, ""));
+    }
+    catch {
+        throw new Error(`COMMERCE_API_BASE_URL inválida: ${JSON.stringify(raw)}. Debe ser una URL absoluta (ej. https://api.example.com/api/v1).`);
+    }
+    const isLoopback = parsed.hostname === "localhost" ||
+        parsed.hostname === "127.0.0.1" ||
+        parsed.hostname === "[::1]" ||
+        parsed.hostname === "::1";
+    if (parsed.protocol === "http:" && !isLoopback) {
+        throw new Error(`COMMERCE_API_BASE_URL insegura: ${parsed.protocol}//${parsed.host} no es loopback. ` +
+            "Solo se permite http:// hacia localhost/127.0.0.1/[::1] (dev). En cualquier otro caso usa https://.");
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`COMMERCE_API_BASE_URL insegura: scheme ${JSON.stringify(parsed.protocol)} no soportado. Usa https:// (o http://localhost en dev).`);
+    }
+    return parsed.toString().replace(/\/+$/, "");
+}
+function apiKey() {
+    const key = process.env.COMMERCE_API_KEY;
+    if (!key) {
+        throw new Error("COMMERCE_API_KEY no configurada. Crea una API key en el panel (Empresa → API keys) " +
+            "y pásala como variable de entorno al arrancar este servidor MCP.");
+    }
+    return key;
+}
+function authHeaders() {
+    const headers = { authorization: `Bearer ${apiKey()}` };
+    const tenantId = process.env.COMMERCE_TENANT_ID;
+    if (tenantId)
+        headers["x-tenant-id"] = tenantId;
+    return headers;
+}
+/**
+ * Lee el body de una Response con tope de tamaño. Intenta parsear JSON; si
+ * falla, devuelve el texto crudo (cubre text/html de proxies, mensajes 502
+ * vacíos, etc.). Devuelve `null` si el body está vacío. Si excede
+ * `RESPONSE_MAX_BYTES`, devuelve `{ error: "RESPONSE_TOO_LARGE" }` sin
+ * retener el contenido (cliente MCP recibe error accionable, no se Buffea
+ * un payload de GBs en RAM).
+ */
+const RESPONSE_MAX_BYTES = 16 * 1024 * 1024; // 16 MiB
+async function readBody(res) {
+    // Early check vía Content-Length (cuando el backend lo manda). Si declara
+    // más del tope, ni siquiera intentamos leer.
+    const cl = res.headers.get("content-length");
+    if (cl !== null) {
+        const declared = Number(cl);
+        if (Number.isFinite(declared) && declared > RESPONSE_MAX_BYTES) {
+            return {
+                error: "RESPONSE_TOO_LARGE",
+                message: `El backend anunció ${declared} bytes; el tope local es ${RESPONSE_MAX_BYTES}.`,
+                maxBytes: RESPONSE_MAX_BYTES,
+            };
+        }
+    }
+    // Lectura streaming con cap real (cubre chunked sin Content-Length).
+    const reader = res.body?.getReader();
+    if (!reader)
+        return null;
+    const chunks = [];
+    let total = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > RESPONSE_MAX_BYTES) {
+            await reader.cancel().catch(() => { });
+            return {
+                error: "RESPONSE_TOO_LARGE",
+                message: `La respuesta excedió ${RESPONSE_MAX_BYTES} bytes durante la lectura.`,
+                maxBytes: RESPONSE_MAX_BYTES,
+            };
+        }
+        chunks.push(value);
+    }
+    if (chunks.length === 0)
+        return null;
+    // Concatenación robusta (no depende de Buffer.concat con Uint8Array[]):
+    // un solo Uint8Array del tamaño exacto + TextDecoder.
+    const merged = new Uint8Array(total);
+    let pos = 0;
+    for (const c of chunks) {
+        merged.set(c, pos);
+        pos += c.byteLength;
+    }
+    const text = new TextDecoder().decode(merged);
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Ejecuta la petición. Nunca lanza por un error HTTP del backend (4xx/5xx):
+ * ese error es información útil para el agente (falta un scope, un recurso
+ * no existe, una validación falló), así que se devuelve como dato normal
+ * con `ok:false`, no como excepción — el handler de la tool lo traduce a
+ * `isError` de MCP sin perder el detalle del body. Tampoco lanza por
+ * configuración inválida (URL malformada, scheme no permitido) — eso sería
+ * una falla de arranque, no de tool, y debe llegar al cliente como un
+ * mensaje accionable, no como un stack trace.
+ */
+export async function apiRequest(method, path, opts = {}) {
+    let url;
+    try {
+        url = new URL(baseUrl() + path);
+        for (const [k, v] of Object.entries(opts.query ?? {})) {
+            if (v !== undefined)
+                url.searchParams.set(k, v);
+        }
+    }
+    catch (err) {
+        return { ok: false, status: 0, data: { error: "CONFIG_ERROR", message: err.message } };
+    }
+    const hasBody = opts.body !== undefined;
+    let res;
+    try {
+        res = await fetch(url, {
+            method,
+            headers: {
+                ...authHeaders(),
+                ...(hasBody ? { "content-type": "application/json" } : {}),
+            },
+            body: hasBody ? JSON.stringify(opts.body) : undefined,
+            signal: AbortSignal.timeout(timeoutMs()),
+        });
+    }
+    catch (err) {
+        return { ok: false, status: 0, data: { error: "NETWORK_ERROR", message: err.message, url: url.toString() } };
+    }
+    return { ok: res.ok, status: res.status, data: await readBody(res) };
+}
+/**
+ * Tope para descargas binarias. PDFs de cotización reales son < 5 MB;
+ * CSVs de notificaciones con cientos de miles de filas pueden ser más
+ * grandes pero rara vez > 32 MB. 32 MB decoded = ~43 MB de base64 — un
+ * cliente MCP que guarda el base64 en su transcript se queda sin disco
+ * rápido si pasamos de ahí. El backend controla el origen del archivo;
+ * este cap es defensa en profundidad contra respuestas corruptas/gigantes.
+ */
+const DOWNLOAD_MAX_BYTES = 32 * 1024 * 1024;
+/** Descarga binaria (PDF de cotización, CSV de notificaciones): la respuesta no es JSON, se devuelve en base64 con tope. */
+export async function apiDownload(path) {
+    let url;
+    try {
+        url = new URL(baseUrl() + path);
+    }
+    catch (err) {
+        return { ok: false, status: 0, error: { error: "CONFIG_ERROR", message: err.message } };
+    }
+    let res;
+    try {
+        res = await fetch(url, { method: "GET", headers: authHeaders(), signal: AbortSignal.timeout(timeoutMs()) });
+    }
+    catch (err) {
+        return { ok: false, status: 0, error: { message: err.message, url: url.toString() } };
+    }
+    if (!res.ok) {
+        // Errores del backend: pasar por readBody para tener JSON parseado (o
+        // texto crudo) sin riesgo de OOM por respuestas de error gigantes.
+        const data = await readBody(res);
+        return { ok: false, status: res.status, error: data ?? null };
+    }
+    // Early check vía Content-Length: si declara > tope, no leemos.
+    const cl = res.headers.get("content-length");
+    if (cl !== null) {
+        const declared = Number(cl);
+        if (Number.isFinite(declared) && declared > DOWNLOAD_MAX_BYTES) {
+            return {
+                ok: false,
+                status: res.status,
+                error: {
+                    error: "DOWNLOAD_TOO_LARGE",
+                    message: `El backend anunció ${declared} bytes; el tope local es ${DOWNLOAD_MAX_BYTES}.`,
+                    maxBytes: DOWNLOAD_MAX_BYTES,
+                },
+            };
+        }
+    }
+    // Streaming con cap (cubre chunked sin Content-Length).
+    const reader = res.body?.getReader();
+    if (!reader) {
+        return { ok: false, status: res.status, error: { message: "response body vacío" } };
+    }
+    const chunks = [];
+    let total = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > DOWNLOAD_MAX_BYTES) {
+            await reader.cancel().catch(() => { });
+            return {
+                ok: false,
+                status: res.status,
+                error: {
+                    error: "DOWNLOAD_TOO_LARGE",
+                    message: `El binario excedió ${DOWNLOAD_MAX_BYTES} bytes durante la lectura.`,
+                    maxBytes: DOWNLOAD_MAX_BYTES,
+                },
+            };
+        }
+        chunks.push(value);
+    }
+    if (chunks.length === 0) {
+        return {
+            ok: true,
+            status: res.status,
+            base64: "",
+            mimeType: res.headers.get("content-type") ?? "application/octet-stream",
+        };
+    }
+    const merged = new Uint8Array(total);
+    let pos = 0;
+    for (const c of chunks) {
+        merged.set(c, pos);
+        pos += c.byteLength;
+    }
+    return {
+        ok: true,
+        status: res.status,
+        base64: Buffer.from(merged).toString("base64"),
+        mimeType: res.headers.get("content-type") ?? "application/octet-stream",
+    };
+}
+/**
+ * Tope local ANTES de salir a la red. El backend (`ProductImageUploadInterceptor`)
+ * ya tope a 5 MB, pero este es un segundo piso de defensa: rechaza payloads
+ * obviamente sobredimensionados (5 MB decoded + overhead de multipart) sin
+ * pagar el costo de decodificar el base64 gigante, armar FormData y mandar la
+ * request. 8 MiB decoded = ~10.7 MiB de base64 = aprox el peor caso real
+ * (imagen PNG 6000x6000 + cabecera + FormData boundary).
+ */
+const UPLOAD_MAX_BYTES = 8 * 1024 * 1024;
+/**
+ * Caracteres máximos del string base64 ANTES del decode. Base64 son 4
+ * chars por cada 3 bytes; redondeamos hacia arriba con un margen para
+ * padding/espacios. Sin este check, un payload malicioso de 1 GB de base64
+ * se decodifica a ~750 MB en RAM (`Buffer.from(b64, 'base64')` no es
+ * lazy) y mata el proceso antes de poder validar el tamaño post-decode.
+ */
+const UPLOAD_MAX_B64_CHARS = Math.ceil((UPLOAD_MAX_BYTES * 4) / 3) + 64;
+/**
+ * Subida multipart (fotos de catálogo): las dos únicas rutas del registro
+ * que no son JSON puro, así que no encajan en `apiRequest` / el DSL
+ * declarativo de `registry/types.ts`. El agente manda la imagen en base64;
+ * aquí se valida el tamaño ANTES del decode y se arma el
+ * `multipart/form-data` que espera `ProductImageUploadInterceptor` (campo
+ * `file`).
+ */
+export async function apiUpload(path, file) {
+    let url;
+    try {
+        url = new URL(baseUrl() + path);
+    }
+    catch (err) {
+        return { ok: false, status: 0, data: { error: "CONFIG_ERROR", message: err.message } };
+    }
+    // Primer piso: cap por longitud del string base64 antes del decode.
+    // Más barato que decodificar y validar después, y evita memory-bomb.
+    if (file.base64.length > UPLOAD_MAX_B64_CHARS) {
+        return {
+            ok: false,
+            status: 0,
+            data: {
+                error: "PAYLOAD_TOO_LARGE",
+                message: `El base64 mide ${file.base64.length} caracteres; el tope es ~${UPLOAD_MAX_B64_CHARS} (~${UPLOAD_MAX_BYTES} bytes decoded).`,
+                maxBytes: UPLOAD_MAX_BYTES,
+            },
+        };
+    }
+    const bytes = Buffer.from(file.base64, "base64");
+    // Segundo piso (defensa en profundidad): por si el base64 traía padding
+    // excesivo que infló la longitud sin representar tantos bytes.
+    if (bytes.byteLength > UPLOAD_MAX_BYTES) {
+        return {
+            ok: false,
+            status: 0,
+            data: {
+                error: "PAYLOAD_TOO_LARGE",
+                message: `El archivo decodificado pesa ${bytes.byteLength} bytes; el tope es ${UPLOAD_MAX_BYTES}.`,
+                maxBytes: UPLOAD_MAX_BYTES,
+            },
+        };
+    }
+    const form = new FormData();
+    form.append("file", new Blob([bytes], { type: file.mimeType }), file.filename);
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "POST",
+            headers: authHeaders(),
+            body: form,
+            signal: AbortSignal.timeout(timeoutMs()),
+        });
+    }
+    catch (err) {
+        return { ok: false, status: 0, data: { error: "NETWORK_ERROR", message: err.message, url: url.toString() } };
+    }
+    return { ok: res.ok, status: res.status, data: await readBody(res) };
+}
+/**
+ * Detecta, al arrancar, si la key configurada es GLOBAL (T-IAM-09b) —
+ * probando un endpoint que solo `SuperAdminGuard` deja pasar. Nunca lanza:
+ * "unknown" si no se pudo determinar (red caída, key inválida — eso ya lo
+ * va a reportar la primera tool que se use). Solo informativo, para el aviso
+ * de arranque en `main.ts`; ninguna tool depende de este resultado.
+ *
+ * El path del probe viene del registry (`SUPER_ADMIN_OVERVIEW_PATH`) para
+ * que un rename de la ruta no rompa silenciosamente el aviso de "key global".
+ */
+export async function probeKeyKind() {
+    try {
+        const res = await fetch(new URL(baseUrl() + SUPER_ADMIN_OVERVIEW_PATH), {
+            method: "GET",
+            headers: authHeaders(),
+            signal: AbortSignal.timeout(timeoutMs()),
+        });
+        if (res.status === 200)
+            return "global";
+        if (res.status === 403 || res.status === 401)
+            return "tenant";
+        return "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerRoutes } from "./tools.js";
+import { registerCatalogImageTools } from "./registry/catalog-images.js";
+import { registerBinaryDownloadTools } from "./registry/binary-downloads.js";
+import { registerTenantUploads } from "./registry/uploads.js";
+import { allRoutes } from "./registry/index.js";
+import { probeKeyKind } from "./client.js";
+// Falla rápido y claro en vez de que la primera tool llamada reviente con un
+// error genérico de fetch — quien arranca esto por primera vez ve el motivo
+// exacto antes de intentar conectarse desde un cliente MCP.
+if (!process.env.COMMERCE_API_KEY) {
+    console.error("easysell MCP no arrancó: falta COMMERCE_API_KEY. Crea una API key en el panel " +
+        "(Empresa → API keys, o Plataforma → API keys globales si eres super-admin) y pásala " +
+        "como variable de entorno.");
+    process.exit(1);
+}
+const server = new McpServer({ name: "easysell", version: "0.1.0" });
+registerRoutes(server, allRoutes);
+registerCatalogImageTools(server);
+registerBinaryDownloadTools(server);
+registerTenantUploads(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`easysell MCP: ${allRoutes.length + 4} tools registradas, esperando por stdio.`);
+    // Best-effort, no bloquea el arranque: solo avisa por stderr si la key
+    // resultó ser GLOBAL (T-IAM-09b), para que quede claro que TODAS las tools
+    // de negocio ahora pueden operar sobre CUALQUIER empresa (con X-Tenant-Id)
+    // y que las ~18 tools `super_admin_*` ya están activas. Con una key normal
+    // de tenant, o si la key es inválida, o si no hay red, no dice nada.
+    probeKeyKind()
+        .then((kind) => {
+        if (kind === "global") {
+            console.error("⚠️  easysell MCP: esta API key es GLOBAL — opera sobre CUALQUIER empresa " +
+                "(usa COMMERCE_TENANT_ID para acotarla a una) e incluye las tools super_admin_*. " +
+                "Si no era la intención, revoca esta key y usa una de tenant (Empresa → API keys).");
+        }
+    })
+        .catch(() => {
+        // El probe ya no lanza (ver client.ts); este catch es solo defensivo.
+    });
+}
+main().catch((err) => {
+    console.error("easysell MCP no pudo arrancar:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,6EAA6E;AAC7E,4EAA4E;AAC5E,4DAA4D;AAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CACX,gFAAgF;QAC9E,sFAAsF;QACtF,2BAA2B,CAC9B,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAErE,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAE9B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,iBAAiB,SAAS,CAAC,MAAM,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAE/F,uEAAuE;IACvE,2EAA2E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,qEAAqE;IACrE,YAAY,EAAE;SACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CACX,2EAA2E;gBACzE,kFAAkF;gBAClF,mFAAmF,CACtF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,sEAAsE;IACxE,CAAC,CAAC,CAAC;AACP,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/registry/audit.d.ts

@@ -0,0 +1,3 @@
+import type { RouteDef } from "./types.js";
+export declare const auditRoutes: RouteDef[];
+//# sourceMappingURL=audit.d.ts.map

package/dist/registry/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/registry/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,QAAQ,EAqBjC,CAAC"}

package/dist/registry/audit.js

@@ -0,0 +1,23 @@
+export const auditRoutes = [
+    {
+        name: "audit_list_events",
+        method: "GET",
+        path: "/audit/events",
+        description: "Lista eventos de auditoría del tenant (cambios sensibles), más recientes primero.",
+        scopes: ["audit.read"],
+        query: {
+            action: { type: "string", description: "p. ej. \"delivery_zone.created\"." },
+            targetType: { type: "string", description: "p. ej. \"DeliveryZone\"." },
+            limit: { type: "number", description: "Default 50, tope 200." },
+        },
+    },
+    {
+        name: "audit_get_event",
+        method: "GET",
+        path: "/audit/events/:id",
+        description: "Detalle de un evento de auditoría por id.",
+        scopes: ["audit.read"],
+        pathParams: { id: { type: "string" } },
+    },
+];
+//# sourceMappingURL=audit.js.map

package/dist/registry/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/registry/audit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,mFAAmF;QAChG,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,KAAK,EAAE;YACL,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;YAC5E,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;SAChE;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,2CAA2C;QACxD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACvC;CACF,CAAC"}

package/dist/registry/binary-downloads.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerBinaryDownloadTools(server: McpServer): void;
+//# sourceMappingURL=binary-downloads.d.ts.map

package/dist/registry/binary-downloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-downloads.d.ts","sourceRoot":"","sources":["../../src/registry/binary-downloads.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0CzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+CnE"}

package/dist/registry/binary-downloads.js

@@ -0,0 +1,80 @@
+/**
+ * Endpoints que devuelven un binario (no JSON): PDF de cotización, CSV de
+ * notificaciones, CSV de clientes. Se registran a mano igual que las
+ * subidas de imagen (`catalog-images.ts` / `uploads.ts`): no encajan en
+ * el DSL declarativo pensado para JSON.
+ */
+import { z } from "zod";
+import { apiDownload } from "../client.js";
+/**
+ * Helper compartido: dado el resultado de apiDownload, devuelve el
+ * CallToolResult con text + resource. Centraliza el shape para que las
+ * tres tools se comporten igual y un cambio futuro (p. ej. logging de
+ * tamaño, mime type extra) sea en un solo lugar.
+ *
+ * Tipado con los tipos literales del SDK (`type: "text"` / `"resource"`)
+ * para satisfacer `CallToolResult` sin necesidad de castear.
+ */
+function downloadToResult(result) {
+    if (!result.ok) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: JSON.stringify({ status: result.status, error: result.error }, null, 2) }],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    status: result.status,
+                    mimeType: result.mimeType,
+                    base64Length: result.base64.length,
+                }),
+            },
+            {
+                type: "resource",
+                resource: {
+                    uri: `data:${result.mimeType};base64,${result.base64}`,
+                    mimeType: result.mimeType,
+                    blob: result.base64,
+                },
+            },
+        ],
+    };
+}
+export function registerBinaryDownloadTools(server) {
+    server.registerTool("quotes_download_pdf", {
+        description: "Descarga el PDF de una cotización. Devuelve el archivo en base64 (mimeType application/pdf) " +
+            "para que quien llama lo guarde o lo reenvíe. Requiere scope: quotes.read.",
+        inputSchema: { id: z.string().describe("id de la cotización") },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ id }) => downloadToResult(await apiDownload(`/quotes/${encodeURIComponent(id)}/pdf`)));
+    server.registerTool("notifications_export_csv", {
+        description: "Descarga el CSV de notificaciones del tenant. Devuelve el archivo en base64 (mimeType text/csv). " +
+            "Requiere scope: notifications.read.",
+        inputSchema: {},
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async () => downloadToResult(await apiDownload("/notifications/export.csv")));
+    server.registerTool("customers_export_csv", {
+        description: "Descarga el CSV de clientes del tenant con los mismos filtros que `customers_list` (sin paginación). " +
+            "Devuelve el archivo en base64 (mimeType text/csv). Requiere scope: customers.read.",
+        inputSchema: {
+            q: z.string().optional().describe("Búsqueda por nombre/teléfono/correo."),
+            tag: z.string().optional().describe("Etiqueta exacta."),
+            hasPendingPayment: z.enum(["true", "false"]).optional(),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async (args) => {
+        const params = new URLSearchParams();
+        if (args.q)
+            params.set("q", args.q);
+        if (args.tag)
+            params.set("tag", args.tag);
+        if (args.hasPendingPayment)
+            params.set("hasPendingPayment", args.hasPendingPayment);
+        const qs = params.toString();
+        return downloadToResult(await apiDownload(`/customers/export.csv${qs ? `?${qs}` : ""}`));
+    });
+}
+//# sourceMappingURL=binary-downloads.js.map

package/dist/registry/binary-downloads.js.map

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

package/dist/registry/canned-responses.d.ts

@@ -0,0 +1,11 @@
+import type { RouteDef } from "./types.js";
+/**
+ * Respuestas predeterminadas (`/tenants/me/canned-responses`): atajos de
+ * texto que los agentes humanos pueden insertar con un shortcut. Es la
+ * configuración operativa principal de cualquier equipo de WhatsApp.
+ *
+ * El backend declara `chat.read` para listar y `chat.write` para el resto
+ * (mismo criterio que conversaciones: leer no requiere scope de escritura).
+ */
+export declare const cannedResponseRoutes: RouteDef[];
+//# sourceMappingURL=canned-responses.d.ts.map

package/dist/registry/canned-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canned-responses.d.ts","sourceRoot":"","sources":["../../src/registry/canned-responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,EA6C1C,CAAC"}