@wondai/n8n-nodes-nucleo 0.6.2 → 0.6.4

package/README.md

@@ -26,7 +26,7 @@ parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o tok
 | Pedido | Alterar | `PATCH /api/v1/agent/pedido/:id` | `pedido:escrever` |
 | Pedido | Cancelar | `POST /api/v1/agent/pedido/:id/cancelar` | `pedido:escrever` |
 | Conversa | Preparar | `POST /api/v1/agent/conversa/preparar` | `contexto:ler` |
-| Contexto | Consultar Data | `POST /api/v1/agent/contexto/consultar` | `contexto:ler` |
+| Contexto | Consultar por Escopo | `POST /api/v1/agent/contexto/consultar` | `contexto:ler` |
 | Conversa | Registrar | `POST /api/v1/agent/conversa/fechar` | `conversa:escrever` |
 
 **Resolver Produtos** é a operação inteligente: manda várias consultas numa chamada (máx 10),
@@ -66,6 +66,11 @@ alguma linha não traz `produto_id`/`alias` e `quantidade` positiva. É uma prot
 o Núcleo continua sendo a autoridade final das regras, mas o workflow não envia pedido vazio por
 erro de tool schema.
 
+A partir da v0.6.4, `Pedido Criar` e `Pedido Alterar` aceitam `Cobranças Comerciais (JSON)`.
+Use para adicionais pagos vindos de `Contexto -> commercial_rules`, por exemplo
+`[{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules"}]`.
+Essas linhas entram no valor a cobrar, mas nao viram produto de catalogo nem pagamento.
+
 **Disponibilidade na Rede** ("tem na outra loja?") é exposta como **tool** do AI Agent, mas com regra
 estrita no prompt: **usar SÓ quando o cliente pedir explicitamente outra unidade**. Passe o `produto_id`
 já resolvido (ou uma `consulta` curta). A loja que pergunta vem do **vínculo do token** (a IA não
@@ -75,6 +80,16 @@ telefone/endereço (allowlist) e distância opcional. **Disponibilidade NÃO é
 declarou e oferece o contato para o cliente confirmar. Este endpoint **não** entra no contexto fixo do
 gate; é chamado sob demanda. Tenant/unidade vêm do token — nunca do prompt.
 
+**Contexto -> Consultar por Escopo** deve ser usado como **AI Tool** dentro do agente, sob demanda.
+Passe `escopos` para buscar apenas o necessario:
+
+- `hours` exige `data` (`YYYY-MM-DD`) e devolve horario/status da data, sem despejar semana inteira.
+- `identity`, `delivery`, `payment` e `commercial_rules` devolvem somente o recorte pedido.
+- `menus` e `promotions` continuam opcionais e so entram quando a pergunta pedir cardapio/promocao.
+
+Chamadas antigas com apenas `data` seguem funcionando como `escopos=["hours"]`, mas o workflow novo nao
+deve injetar horario/endereco/entrega/pagamento/regras comerciais em todo prompt.
+
 ## Gate da IA — Preparar como PRIMEIRO passo (ADR-021, Plano 004)
 
 **Conversa → Preparar** é o **gate determinístico** da IA. Use-o como **node normal** no primeiro
@@ -86,7 +101,8 @@ A resposta vem sempre em **HTTP 200** e o node a entrega **intacta** (não vira
 - `{ "allowed": false, "state": "disabled", "reason": "tenant_disabled" | "unit_disabled" | "configuration_error" | "unavailable" }`
   → **PARE o fluxo sem responder** ao cliente (a empresa/unidade desligou a IA; falha de consulta também para).
 - `{ "allowed": true, "state": "enabled", "runtime_version": N, "session_id": "...", "primeiro_contato": true, "contexto": { ... } }`
-  → **siga** para memória/router/LLM. O `contexto` traz horário/status/flags/regras (Plano 003).
+  → **siga** para memória/router/LLM. O `contexto` inicial e compacto; detalhes de horario,
+  endereco, entrega, pagamento, regras comerciais, cardapio e promocoes devem vir da tool Contexto sob demanda.
 
 O Núcleo é a fonte da verdade do liga/desliga; o estado `active` do workflow no n8n **não** é usado
 como controle por padaria. Quem desliga é o dono/gerente em `/configuracoes` (ou o super-admin).

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

@@ -303,8 +303,8 @@ class Nucleo {
                         {
                             name: "Consultar Data",
                             value: "consultar",
-                            action: "Consultar contexto de uma data",
-                            description: "Horário/exceção/regra vigente para UMA data (ex.: 'abrem no feriado?')",
+                            action: "Consultar contexto por escopo",
+                            description: "Busca somente os escopos necessarios (horario, identidade, entrega, pagamento, regras comerciais, cardapios ou promocoes). Use como AI Tool sob demanda, nao como contexto fixo do prompt.",
                         },
                     ],
                     default: "consultar",
@@ -603,6 +603,14 @@ class Nucleo {
                     description: "Opcional. Desconto concedido em reais (ex.: 5). Abate do valor a cobrar e do troco. 0/vazio = sem desconto.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
+                {
+                    displayName: "Cobranças Comerciais (JSON)",
+                    name: "cobrancas",
+                    type: "json",
+                    default: "[]",
+                    description: 'Opcional. Array de cobranças comerciais que entram no valor a cobrar sem virar produto: [{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules","operational_config_revision_id":"...","snapshot":{"label":"Confetes - R$35,00"}}]. Use quando vier de Contexto Loja/commercial_rules.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
                 {
                     displayName: "Loja (unit_id)",
                     name: "unitId",
@@ -754,6 +762,14 @@ class Nucleo {
                     description: "Redefine o desconto (recalcula o valor a cobrar e o pagamento pendente). Ex.: 5. Vazio = não altera o desconto. Use 0 para zerar.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
                 },
+                {
+                    displayName: "Cobranças Comerciais (JSON)",
+                    name: "cobrancasNovo",
+                    type: "json",
+                    default: "[]",
+                    description: 'Opcional. Substitui as cobranças comerciais do pedido. Envie [] para limpar. Ex.: [{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules"}].',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
                 {
                     displayName: "Motivo",
                     name: "motivo",
@@ -878,9 +894,52 @@ class Nucleo {
                     name: "data",
                     type: "string",
                     default: "",
-                    required: true,
+                    required: false,
                     placeholder: "2026-12-25",
-                    description: "UMA data no formato YYYY-MM-DD (janela ±366 dias). Devolve horário/exceção/regra vigente para a data.",
+                    description: "Obrigatoria apenas quando o escopo incluir Horarios. Use YYYY-MM-DD (janela ±366 dias).",
+                    displayOptions: { show: { resource: ["contexto"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Escopos",
+                    name: "contextoEscopos",
+                    type: "multiOptions",
+                    default: ["hours"],
+                    description: "Recortes de contexto que a IA precisa para a pergunta atual.",
+                    options: [
+                        { name: "Identidade/Endereco", value: "identity" },
+                        { name: "Operacao", value: "operation" },
+                        { name: "Horarios", value: "hours" },
+                        { name: "Entrega", value: "delivery" },
+                        { name: "Pagamento", value: "payment" },
+                        { name: "Regras Comerciais", value: "commercial_rules" },
+                        { name: "Cardapios", value: "menus" },
+                        { name: "Promocoes", value: "promotions" },
+                    ],
+                    displayOptions: { show: { resource: ["contexto"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Cidade",
+                    name: "contextoCidade",
+                    type: "string",
+                    default: "",
+                    description: "Opcional para validar se a cidade/bairro esta em area de entrega.",
+                    displayOptions: { show: { resource: ["contexto"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Assuntos",
+                    name: "contextoAssuntos",
+                    type: "string",
+                    default: "",
+                    placeholder: "frete, pagamento",
+                    description: "Opcional; texto livre separado por linhas ou virgulas para telemetria/contexto da pergunta.",
+                    displayOptions: { show: { resource: ["contexto"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Unidade ID",
+                    name: "contextoUnitId",
+                    type: "string",
+                    default: "",
+                    description: "Opcional e somente compatibilidade: o servidor valida contra o vinculo do token.",
                     displayOptions: { show: { resource: ["contexto"], operation: ["consultar"] } },
                 },
                 // ----------------------------------------------------------------- telemetria:enviar
@@ -1251,6 +1310,7 @@ class Nucleo {
                     const trocoPara = Number(this.getNodeParameter("trocoPara", i, 0));
                     const taxaEntrega = Number(this.getNodeParameter("taxaEntrega", i, 0));
                     const desconto = Number(this.getNodeParameter("desconto", i, 0));
+                    const cobrancas = asArray(this.getNodeParameter("cobrancas", i, "[]"));
                     const unitId = this.getNodeParameter("unitId", i, "").trim();
                     idempotencyKey =
                         this.getNodeParameter("idempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
@@ -1277,6 +1337,8 @@ class Nucleo {
                         b.taxa_entrega = taxaEntrega;
                     if (Number.isFinite(desconto) && desconto > 0)
                         b.desconto = desconto;
+                    if (cobrancas.length)
+                        b.cobrancas = cobrancas;
                     if (unitId)
                         b.unit_id = unitId;
                     method = "POST";
@@ -1299,6 +1361,7 @@ class Nucleo {
                     const trocoParaNovo = Number(this.getNodeParameter("trocoParaNovo", i, 0));
                     const taxaEntregaNova = this.getNodeParameter("taxaEntregaNova", i, "").trim();
                     const descontoNovo = this.getNodeParameter("descontoNovo", i, "").trim();
+                    const cobrancasNovo = asArray(this.getNodeParameter("cobrancasNovo", i, "[]"));
                     const b = {};
                     if (observacoes.trim())
                         b.observacoes = observacoes.trim();
@@ -1334,6 +1397,8 @@ class Nucleo {
                     if (descontoNovo !== "" && Number.isFinite(Number(descontoNovo))) {
                         b.desconto = Number(descontoNovo);
                     }
+                    if (cobrancasNovo.length)
+                        b.cobrancas = cobrancasNovo;
                     // Idempotência (opcional): mesma chave num retry → backend não reaplica a alteração.
                     idempotencyKey =
                         this.getNodeParameter("idempotencyKey", i, "").trim() || undefined;
@@ -1402,9 +1467,24 @@ class Nucleo {
                 }
                 else if (resource === "contexto" && operation === "consultar") {
                     const data = this.getNodeParameter("data", i).trim();
+                    const escopos = this.getNodeParameter("contextoEscopos", i, ["hours"]);
+                    const cidade = this.getNodeParameter("contextoCidade", i, "").trim();
+                    const assuntos = parseIds(this.getNodeParameter("contextoAssuntos", i, ""));
+                    const unitId = this.getNodeParameter("contextoUnitId", i, "").trim();
+                    const b = {};
+                    if (data)
+                        b.data = data;
+                    if (Array.isArray(escopos) && escopos.length > 0)
+                        b.escopos = escopos;
+                    if (cidade)
+                        b.cidade = cidade;
+                    if (assuntos.length > 0)
+                        b.assuntos = assuntos;
+                    if (unitId)
+                        b.unit_id = unitId;
                     method = "POST";
                     path = "/api/v1/agent/contexto/consultar";
-                    bodyObj = { data };
+                    bodyObj = b;
                 }
                 else if (resource === "telemetria" && operation === "enviar") {
                     const eventKey = this.getNodeParameter("telEventKey", i).trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Node n8n para o Núcleo Wondai — atendimento de IA multi-vertical (gate liga/desliga, cliente/paciente, catálogo fuzzy, pedidos [padaria], procedimento/agenda/agendamento [odonto], contexto operacional, telemetria) com assinatura HMAC v1. Tenant e vertical vêm do token (a parede, ADR-013/038).",
   "keywords": [
     "n8n-community-node-package",