@wondai/n8n-nodes-nucleo 0.2.1

package/README.md

@@ -0,0 +1,80 @@
+# @wondai/n8n-nodes-nucleo
+
+Node community do **n8n** para o **Núcleo Wondai** — a camada de atendimento de IA (WhatsApp → n8n
+→ Núcleo). Um único node com as operações que o agente precisa, assinando cada chamada com **HMAC
+v1**. O **tenant (a padaria) vem do token**, no servidor — nunca de nada que o n8n envie (a parede,
+ADR-013).
+
+> Substitui o pacote antigo `@wondai/n8n-nodes-crm`. Decisões: **ADR-015** (este package + resolução
+> inteligente de catálogo) e **ADR-016** (orquestração: router + especialistas; catálogo como tool).
+
+## Filosofia: node burro, servidor inteligente
+
+O node **só** monta a string canônica, assina e chama. Toda inteligência (busca fuzzy, apelidos,
+lote, teto de tokens, idempotência, isolamento entre padarias) vive no **servidor**, atrás da
+parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o token seguro.
+
+## Operações
+
+| Recurso | Operação | Endpoint | Escopo do token |
+|---|---|---|---|
+| Cliente | Buscar | `GET /api/v1/agent/cliente` | `cliente:ler` |
+| Catálogo | Resolver Produtos | `POST /api/v1/agent/catalogo/resolver` | `catalogo:ler` |
+| Pedido | Criar | `POST /api/v1/agent/pedido` | `pedido:escrever` |
+| Pedido | Alterar | `PATCH /api/v1/agent/pedido/:id` | `pedido:escrever` |
+| Pedido | Cancelar | `POST /api/v1/agent/pedido/:id/cancelar` | `pedido:escrever` |
+
+**Resolver Produtos** é a operação inteligente: manda várias consultas numa chamada (máx 10),
+tolera erro de digitação (`banofe`→Banoffee), falta de acento (`pao frances`→Pão Francês) e
+apelidos; devolve no máx 3 candidatos por consulta com `status` (`achou`/`ambiguo`/`nao_achou`).
+
+**Criar** é idempotente: deixe *Idempotency Key* vazio (gera uma) ou repita a mesma chave num retry
+— o Núcleo nunca duplica o pedido.
+
+## Instalação (n8n self-hosted)
+
+1. **Settings → Community Nodes → Install** → `@wondai/n8n-nodes-nucleo`.
+   (ou, em dev: `npm run build` aqui e aponte o n8n para a pasta / `npm link`.)
+2. Para usar como **ferramenta do AI Agent**, o n8n precisa permitir nodes community como tools:
+   ```
+   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
+   ```
+   (variável de ambiente do servidor n8n; sem ela o node funciona como node normal, mas não aparece
+   como tool do AI Agent.)
+
+## Credencial — "Núcleo Wondai API"
+
+| Campo | O que é |
+|---|---|
+| **Base URL** | Origem do Núcleo, sem barra final (ex: `https://app.suapadaria.com.br`). |
+| **Token ID** | Id do token (público). Header `x-wondai-key`. |
+| **Signing Secret** | Segredo de assinatura — exibido **uma vez** ao emitir o token. |
+
+O par **Token ID + Signing Secret** é emitido no painel **/agente** do Núcleo (uma credencial por
+padaria). O n8n guarda os dois **cifrados** no cofre — nunca em texto puro no workflow.
+
+## Assinatura (contrato HMAC v1)
+
+Cada requisição leva os headers `x-wondai-key`, `x-wondai-timestamp` (unix s, janela ±300s),
+`x-wondai-nonce` (único — reuso = replay → 401) e `x-wondai-signature`. A assinatura é
+`HMAC_SHA256(signingSecret, canônica)` em hex, onde a canônica é:
+
+```
+v1
+<MÉTODO>
+<path + query>
+<timestamp>
+<nonce>
+<sha256_hex(corpo)>     # corpo cru; "" no GET
+```
+
+## Build (dev)
+
+```bash
+npm install
+npm run build      # tsc → dist/ + copia ícones
+```
+
+## Licença
+
+MIT

package/dist/credentials/NucleoApi.credentials.d.ts

@@ -0,0 +1,17 @@
+import type { ICredentialType, INodeProperties } from "n8n-workflow";
+/**
+ * Credencial do Núcleo Wondai (por padaria).
+ *
+ * Guarda o par emitido pelo painel `/agente` do Núcleo: `tokenId` (público, vai no header
+ * `x-wondai-key`) + `signingSecret` (derivado da chave-mestra do servidor; equivale a uma senha).
+ * O n8n guarda ambos CIFRADOS no cofre de credenciais — nunca em texto puro no workflow (G7).
+ *
+ * NÃO há `authenticate`/`test` genérico: a assinatura é HMAC dinâmica (depende de
+ * método+caminho+corpo+timestamp+nonce), montada pelo próprio node a cada requisição.
+ */
+export declare class NucleoApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/NucleoApi.credentials.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NucleoApi = void 0;
+/**
+ * Credencial do Núcleo Wondai (por padaria).
+ *
+ * Guarda o par emitido pelo painel `/agente` do Núcleo: `tokenId` (público, vai no header
+ * `x-wondai-key`) + `signingSecret` (derivado da chave-mestra do servidor; equivale a uma senha).
+ * O n8n guarda ambos CIFRADOS no cofre de credenciais — nunca em texto puro no workflow (G7).
+ *
+ * NÃO há `authenticate`/`test` genérico: a assinatura é HMAC dinâmica (depende de
+ * método+caminho+corpo+timestamp+nonce), montada pelo próprio node a cada requisição.
+ */
+class NucleoApi {
+    constructor() {
+        this.name = "nucleoApi";
+        this.displayName = "Núcleo Wondai API";
+        this.documentationUrl = "https://github.com/wondai/n8n-nodes-nucleo";
+        this.properties = [
+            {
+                displayName: "Base URL",
+                name: "baseUrl",
+                type: "string",
+                default: "https://wondai-core-sooty.vercel.app",
+                placeholder: "https://app.suapadaria.com.br",
+                required: true,
+                description: "Origem da API do Núcleo, sem barra final. O node acrescenta /api/v1/agent/...",
+            },
+            {
+                displayName: "Token ID",
+                name: "tokenId",
+                type: "string",
+                default: "",
+                required: true,
+                description: "Id do token (público). Vai no header x-wondai-key. Emitido no painel /agente do Núcleo.",
+            },
+            {
+                displayName: "Signing Secret",
+                name: "signingSecret",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                required: true,
+                description: "Segredo de assinatura exibido UMA vez ao emitir o token. Guarde como senha — define o tenant que o n8n alcança.",
+            },
+        ];
+    }
+}
+exports.NucleoApi = NucleoApi;

package/dist/nodes/Nucleo/Nucleo.node.d.ts

@@ -0,0 +1,5 @@
+import { type IExecuteFunctions, type INodeExecutionData, type INodeType, type INodeTypeDescription } from "n8n-workflow";
+export declare class Nucleo implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Nucleo/Nucleo.node.js

@@ -0,0 +1,588 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Nucleo = void 0;
+const node_crypto_1 = require("node:crypto");
+const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * Node Núcleo Wondai — satélite de IA → Núcleo (ADR-003/013/015/016).
+ *
+ * NODE BURRO, SERVIDOR INTELIGENTE: este node só monta a string canônica v1, assina (HMAC) e
+ * chama. Toda regra (fuzzy, alias, lote, limite, idempotência, isolamento) mora no servidor,
+ * atrás da parede. O tenant é decidido pelo TOKEN no servidor — nunca por nada que o n8n envie.
+ *
+ * String canônica (CONTRATO — tem que bater byte a byte com core/agent-auth/signing.ts):
+ *   v1 \n MÉTODO \n path+query \n timestamp \n nonce \n sha256_hex(corpo)
+ * signature = HMAC_SHA256(signingSecret, canônica) em hex.
+ */
+const SIGNATURE_VERSION = "v1";
+const HEADERS = {
+    key: "x-wondai-key",
+    timestamp: "x-wondai-timestamp",
+    nonce: "x-wondai-nonce",
+    signature: "x-wondai-signature",
+};
+function sha256Hex(body) {
+    return (0, node_crypto_1.createHash)("sha256").update(body, "utf8").digest("hex");
+}
+function canonicalString(method, path, timestamp, nonce, body) {
+    return [SIGNATURE_VERSION, method.toUpperCase(), path, timestamp, nonce, sha256Hex(body)].join("\n");
+}
+function sign(signingSecret, canonical) {
+    return (0, node_crypto_1.createHmac)("sha256", signingSecret).update(canonical, "utf8").digest("hex");
+}
+/** Aceita string (linhas / vírgulas / JSON array) ou já-array. Normaliza, dedup, corta. */
+function parseConsultas(raw, max = 10) {
+    let list = [];
+    if (Array.isArray(raw)) {
+        list = raw;
+    }
+    else if (typeof raw === "string") {
+        const t = raw.trim();
+        if (t.startsWith("[")) {
+            try {
+                const j = JSON.parse(t);
+                list = Array.isArray(j) ? j : [t];
+            }
+            catch {
+                list = t.split(/[\n,;]+/);
+            }
+        }
+        else {
+            list = t.split(/[\n,;]+/);
+        }
+    }
+    const out = [];
+    const seen = new Set();
+    for (const c of list) {
+        const s = typeof c === "string" ? c.trim() : String(c ?? "").trim();
+        if (s.length < 2)
+            continue;
+        const k = s.toLowerCase();
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(s);
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
+/** Lê um parâmetro JSON (string ou objeto) como array. Vazio → []. */
+function asArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === "string") {
+        const t = value.trim();
+        if (!t)
+            return [];
+        try {
+            const j = JSON.parse(t);
+            return Array.isArray(j) ? j : [j];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+/** IDs separados por vírgula ou JSON array → string[]. */
+function parseIds(value) {
+    if (Array.isArray(value))
+        return value.map((v) => String(v)).filter(Boolean);
+    if (typeof value === "string") {
+        const t = value.trim();
+        if (!t)
+            return [];
+        if (t.startsWith("[")) {
+            try {
+                const j = JSON.parse(t);
+                return Array.isArray(j) ? j.map((v) => String(v)).filter(Boolean) : [];
+            }
+            catch {
+                return [];
+            }
+        }
+        return t
+            .split(/[\n,;]+/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+class Nucleo {
+    constructor() {
+        this.description = {
+            displayName: "Núcleo Wondai",
+            name: "nucleo",
+            icon: "file:nucleo.svg",
+            group: ["transform"],
+            version: 1,
+            subtitle: '={{ $parameter["operation"] + ": " + $parameter["resource"] }}',
+            description: "Atendimento de IA no Núcleo Wondai: buscar cliente, resolver catálogo (fuzzy) e criar/alterar/cancelar pedido. Assinatura HMAC; o tenant vem do token.",
+            defaults: { name: "Núcleo Wondai" },
+            // Permite usar o node como ferramenta do AI Agent (router/especialistas, ADR-016).
+            usableAsTool: true,
+            inputs: ["main"],
+            outputs: ["main"],
+            credentials: [{ name: "nucleoApi", required: true }],
+            properties: [
+                // ----------------------------------------------------------------- resource
+                {
+                    displayName: "Recurso",
+                    name: "resource",
+                    type: "options",
+                    noDataExpression: true,
+                    options: [
+                        { name: "Cliente", value: "cliente" },
+                        { name: "Catálogo", value: "catalogo" },
+                        { name: "Pedido", value: "pedido" },
+                        { name: "Conversa", value: "conversa" },
+                    ],
+                    default: "catalogo",
+                },
+                // ----------------------------------------------------------------- operations
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["cliente"] } },
+                    options: [
+                        {
+                            name: "Buscar",
+                            value: "buscar",
+                            action: "Buscar cliente por telefone",
+                            description: "Lookup do cliente + histórico recente de pedidos",
+                        },
+                    ],
+                    default: "buscar",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["catalogo"] } },
+                    options: [
+                        {
+                            name: "Resolver Produtos",
+                            value: "resolver",
+                            action: "Resolver produtos do catálogo",
+                            description: "Busca vários produtos numa chamada — tolera erro de digitação e apelidos",
+                        },
+                    ],
+                    default: "resolver",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["pedido"] } },
+                    options: [
+                        {
+                            name: "Detalhar",
+                            value: "detalhar",
+                            action: "Detalhar pedido",
+                            description: "Busca o pedido (com itens e IDs) por UUID ou número curto",
+                        },
+                        {
+                            name: "Criar",
+                            value: "criar",
+                            action: "Criar pedido",
+                            description: "Cria pedido (idempotente)",
+                        },
+                        {
+                            name: "Alterar",
+                            value: "alterar",
+                            action: "Alterar pedido",
+                            description: "Altera data/observações/itens (adicionar, remover, mudar quantidade)",
+                        },
+                        {
+                            name: "Cancelar",
+                            value: "cancelar",
+                            action: "Cancelar pedido",
+                            description: "Cancela o pedido inteiro (idempotente)",
+                        },
+                    ],
+                    default: "criar",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["conversa"] } },
+                    options: [
+                        {
+                            name: "Registrar",
+                            value: "registrar",
+                            action: "Registrar conversa",
+                            description: "Encerra a conversa com resumo + resultado (handoff = precisa_humano)",
+                        },
+                    ],
+                    default: "registrar",
+                },
+                // ----------------------------------------------------------------- cliente:buscar
+                {
+                    displayName: "Telefone",
+                    name: "telefone",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "+5511999999999",
+                    description: "Telefone do cliente em E.164. Pode vir do remotejid do WhatsApp — normalize antes (só dígitos + DDI).",
+                    displayOptions: { show: { resource: ["cliente"], operation: ["buscar"] } },
+                },
+                // ----------------------------------------------------------------- catalogo:resolver
+                {
+                    displayName: "Consultas",
+                    name: "consultas",
+                    type: "string",
+                    typeOptions: { rows: 3 },
+                    default: "",
+                    required: true,
+                    placeholder: "banofe, pão francês, coxinha",
+                    description: "Produtos a buscar: um por linha ou separados por vírgula (máx 10). Aceita erro de digitação, falta de acento e apelidos. Ex: 'banofe, pão francês'.",
+                    displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
+                },
+                // ----------------------------------------------------------------- pedido:detalhar
+                {
+                    displayName: "Pedido (ref)",
+                    name: "ref",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "64 ou UUID",
+                    description: "Número curto (ex: 64) ou UUID do pedido. Devolve o pedido com itens e seus IDs. Pedido de outra padaria → 404.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["detalhar"] } },
+                },
+                // ----------------------------------------------------------------- pedido:criar
+                {
+                    displayName: "Telefone",
+                    name: "telefone",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "+5511999999999",
+                    description: "Telefone do cliente (E.164). Resolve o cliente existente ou cria um novo.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Itens (JSON)",
+                    name: "itens",
+                    type: "json",
+                    default: "[]",
+                    required: true,
+                    description: 'Array de itens. Cada item: {"produto_id" OU "alias", "variacao_id"?, "quantidade", "personalizacao"?}. Ex: [{"alias":"paozinho","quantidade":6},{"produto_id":"...","quantidade":1}]',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Tipo de Entrega",
+                    name: "tipoEntrega",
+                    type: "options",
+                    options: [
+                        { name: "Retirada", value: "retirada" },
+                        { name: "Entrega", value: "entrega" },
+                    ],
+                    default: "retirada",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Observações",
+                    name: "observacoes",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Agendado Para",
+                    name: "agendadoPara",
+                    type: "string",
+                    default: "",
+                    placeholder: "2026-06-20T10:00:00Z",
+                    description: "Data/hora ISO 8601 para encomenda. Vazio = imediato.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Loja (unit_id)",
+                    name: "unitId",
+                    type: "string",
+                    default: "",
+                    description: "Opcional. Vazio = primeira loja da padaria.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Idempotency Key",
+                    name: "idempotencyKey",
+                    type: "string",
+                    default: "",
+                    description: "Opcional. Vazio = gerada automaticamente. Use a MESMA chave num retry para não duplicar o pedido.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
+                // ----------------------------------------------------------------- pedido:alterar / cancelar
+                {
+                    displayName: "Pedido ID",
+                    name: "pedidoId",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    description: "Id do pedido (do tenant). Pedido de outra padaria → 404.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar", "cancelar"] } },
+                },
+                {
+                    displayName: "Observações",
+                    name: "observacoes",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Agendado Para",
+                    name: "agendadoPara",
+                    type: "string",
+                    default: "",
+                    placeholder: "2026-06-21T09:00:00Z",
+                    description: "ISO 8601. Envie vazio para não alterar.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Adicionar Itens (JSON)",
+                    name: "adicionarItens",
+                    type: "json",
+                    default: "[]",
+                    description: "Mesma forma de Itens. Vazio = não adiciona.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Remover Itens (IDs)",
+                    name: "removerItemIds",
+                    type: "string",
+                    default: "",
+                    description: "IDs de itens a remover, separados por vírgula ou JSON array.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Alterar Quantidade de Itens (JSON)",
+                    name: "alterarItens",
+                    type: "json",
+                    default: "[]",
+                    description: 'Muda a quantidade de itens já existentes: [{"item_id":"...","quantidade":4}]. Os IDs vêm do Detalhar. Trocar item = remover + adicionar. Vazio = não altera.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Motivo",
+                    name: "motivo",
+                    type: "string",
+                    default: "",
+                    description: "Motivo do cancelamento (opcional).",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["cancelar"] } },
+                },
+                // ----------------------------------------------------------------- conversa:registrar
+                {
+                    displayName: "Resumo",
+                    name: "resumo",
+                    type: "string",
+                    typeOptions: { rows: 2 },
+                    default: "",
+                    required: true,
+                    description: "Resumo objetivo do atendimento (vai para o inbox de conversas).",
+                    displayOptions: { show: { resource: ["conversa"], operation: ["registrar"] } },
+                },
+                {
+                    displayName: "Resultado",
+                    name: "resultado",
+                    type: "options",
+                    options: [
+                        { name: "Resolvido", value: "resolvido" },
+                        { name: "Precisa de Humano (handoff)", value: "precisa_humano" },
+                        { name: "Abandonado", value: "abandonado" },
+                    ],
+                    default: "resolvido",
+                    description: "Desfecho do atendimento. 'precisa_humano' = handoff (cai no inbox como pendente).",
+                    displayOptions: { show: { resource: ["conversa"], operation: ["registrar"] } },
+                },
+                {
+                    displayName: "Telefone",
+                    name: "convTelefone",
+                    type: "string",
+                    default: "",
+                    placeholder: "+5511999999999",
+                    description: "Telefone do cliente (E.164). Vincula ao cliente se casar — não cria.",
+                    displayOptions: { show: { resource: ["conversa"], operation: ["registrar"] } },
+                },
+                {
+                    displayName: "Pedido ID",
+                    name: "convPedidoId",
+                    type: "string",
+                    default: "",
+                    description: "Opcional. UUID de pedido gerado na conversa (validado contra o tenant).",
+                    displayOptions: { show: { resource: ["conversa"], operation: ["registrar"] } },
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returned = [];
+        const creds = await this.getCredentials("nucleoApi");
+        const baseUrl = String(creds.baseUrl ?? "").replace(/\/+$/, "");
+        const tokenId = String(creds.tokenId ?? "");
+        const signingSecret = String(creds.signingSecret ?? "");
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const resource = this.getNodeParameter("resource", i);
+                const operation = this.getNodeParameter("operation", i);
+                let method = "GET";
+                let path = "";
+                let bodyObj;
+                let idempotencyKey;
+                if (resource === "cliente" && operation === "buscar") {
+                    const telefone = this.getNodeParameter("telefone", i).trim();
+                    method = "GET";
+                    path = `/api/v1/agent/cliente?telefone=${encodeURIComponent(telefone)}`;
+                }
+                else if (resource === "catalogo" && operation === "resolver") {
+                    const consultas = parseConsultas(this.getNodeParameter("consultas", i));
+                    method = "POST";
+                    path = "/api/v1/agent/catalogo/resolver";
+                    bodyObj = { consultas };
+                }
+                else if (resource === "pedido" && operation === "detalhar") {
+                    const ref = this.getNodeParameter("ref", i).trim();
+                    method = "GET";
+                    path = `/api/v1/agent/pedido/${encodeURIComponent(ref)}`;
+                }
+                else if (resource === "pedido" && operation === "criar") {
+                    const telefone = this.getNodeParameter("telefone", i).trim();
+                    const itens = asArray(this.getNodeParameter("itens", i));
+                    const tipoEntrega = this.getNodeParameter("tipoEntrega", i);
+                    const observacoes = this.getNodeParameter("observacoes", i, "").trim();
+                    const agendadoPara = this.getNodeParameter("agendadoPara", i, "").trim();
+                    const unitId = this.getNodeParameter("unitId", i, "").trim();
+                    idempotencyKey =
+                        this.getNodeParameter("idempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
+                    const b = { telefone, itens };
+                    if (tipoEntrega)
+                        b.tipo_entrega = tipoEntrega;
+                    if (observacoes)
+                        b.observacoes = observacoes;
+                    if (agendadoPara)
+                        b.agendado_para = agendadoPara;
+                    if (unitId)
+                        b.unit_id = unitId;
+                    method = "POST";
+                    path = "/api/v1/agent/pedido";
+                    bodyObj = b;
+                }
+                else if (resource === "pedido" && operation === "alterar") {
+                    const pedidoId = this.getNodeParameter("pedidoId", i).trim();
+                    const observacoes = this.getNodeParameter("observacoes", i, "");
+                    const agendadoPara = this.getNodeParameter("agendadoPara", i, "");
+                    const adicionar = asArray(this.getNodeParameter("adicionarItens", i, "[]"));
+                    const remover = parseIds(this.getNodeParameter("removerItemIds", i, ""));
+                    const alterar = asArray(this.getNodeParameter("alterarItens", i, "[]"));
+                    const b = {};
+                    if (observacoes.trim())
+                        b.observacoes = observacoes.trim();
+                    if (agendadoPara.trim())
+                        b.agendado_para = agendadoPara.trim();
+                    if (adicionar.length)
+                        b.adicionar_itens = adicionar;
+                    if (remover.length)
+                        b.remover_item_ids = remover;
+                    if (alterar.length)
+                        b.alterar_itens = alterar;
+                    method = "PATCH";
+                    path = `/api/v1/agent/pedido/${encodeURIComponent(pedidoId)}`;
+                    bodyObj = b;
+                }
+                else if (resource === "pedido" && operation === "cancelar") {
+                    const pedidoId = this.getNodeParameter("pedidoId", i).trim();
+                    const motivo = this.getNodeParameter("motivo", i, "").trim();
+                    method = "POST";
+                    path = `/api/v1/agent/pedido/${encodeURIComponent(pedidoId)}/cancelar`;
+                    bodyObj = motivo ? { motivo } : {};
+                }
+                else if (resource === "conversa" && operation === "registrar") {
+                    const resumo = this.getNodeParameter("resumo", i).trim();
+                    const resultado = this.getNodeParameter("resultado", i);
+                    const convTelefone = this.getNodeParameter("convTelefone", i, "").trim();
+                    const convPedidoId = this.getNodeParameter("convPedidoId", i, "").trim();
+                    const b = { resumo, resultado };
+                    if (convTelefone)
+                        b.telefone = convTelefone;
+                    if (convPedidoId)
+                        b.pedido_id = convPedidoId;
+                    method = "POST";
+                    path = "/api/v1/agent/conversa/fechar";
+                    bodyObj = b;
+                }
+                else {
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+                        message: `Operação não suportada: ${resource}.${operation}`,
+                    });
+                }
+                // ---- assina e envia (HMAC v1) ----
+                const rawBody = bodyObj === undefined ? "" : JSON.stringify(bodyObj);
+                const timestamp = Math.floor(Date.now() / 1000).toString();
+                const nonce = (0, node_crypto_1.randomUUID)();
+                const canonical = canonicalString(method, path, timestamp, nonce, rawBody);
+                const signature = sign(signingSecret, canonical);
+                const headers = {
+                    [HEADERS.key]: tokenId,
+                    [HEADERS.timestamp]: timestamp,
+                    [HEADERS.nonce]: nonce,
+                    [HEADERS.signature]: signature,
+                };
+                if (rawBody)
+                    headers["content-type"] = "application/json";
+                if (idempotencyKey)
+                    headers["idempotency-key"] = idempotencyKey;
+                const res = await this.helpers.httpRequest({
+                    method,
+                    url: baseUrl + path,
+                    headers,
+                    body: rawBody || undefined,
+                    json: false,
+                    returnFullResponse: true,
+                    ignoreHttpStatusErrors: true,
+                });
+                const status = res.statusCode;
+                const rawRes = res.body;
+                let payload;
+                try {
+                    payload = typeof rawRes === "string" ? JSON.parse(rawRes) : rawRes;
+                }
+                catch {
+                    payload = { raw: rawRes };
+                }
+                if (status >= 400) {
+                    const msg = (payload && payload.error) || `Núcleo respondeu HTTP ${status}.`;
+                    if (this.continueOnFail()) {
+                        returned.push({ json: { error: msg, status }, pairedItem: { item: i } });
+                        continue;
+                    }
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), payload, {
+                        message: msg,
+                        httpCode: String(status),
+                        itemIndex: i,
+                    });
+                }
+                returned.push({ json: payload, pairedItem: { item: i } });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returned.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returned];
+    }
+}
+exports.Nucleo = Nucleo;

package/dist/nodes/Nucleo/nucleo.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" fill="none">
+  <rect width="60" height="60" rx="13" fill="#6D28D9"/>
+  <ellipse cx="30" cy="30" rx="20" ry="9" stroke="#C4B5FD" stroke-width="2.5" transform="rotate(-30 30 30)"/>
+  <ellipse cx="30" cy="30" rx="20" ry="9" stroke="#C4B5FD" stroke-width="2.5" transform="rotate(30 30 30)"/>
+  <circle cx="30" cy="30" r="7.5" fill="#FFFFFF"/>
+  <circle cx="48" cy="20" r="2.6" fill="#C4B5FD"/>
+</svg>

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@wondai/n8n-nodes-nucleo",
+  "version": "0.2.1",
+  "description": "Node n8n para o Núcleo Wondai — atendimento de IA (cliente, catálogo fuzzy, pedidos) com assinatura HMAC v1. Tenant vem do token (a parede, ADR-013).",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "wondai",
+    "nucleo",
+    "crm",
+    "padaria",
+    "ai-tool"
+  ],
+  "license": "MIT",
+  "author": "Wondai",
+  "homepage": "https://github.com/wondai/n8n-nodes-nucleo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wondai/n8n-nodes-nucleo.git"
+  },
+  "engines": {
+    "node": ">=18.10"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "dev": "tsc --watch",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/NucleoApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Nucleo/Nucleo.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "n8n-workflow": "*",
+    "typescript": "^5.6.0"
+  }
+}