@wondai/n8n-nodes-nucleo 0.6.1 → 0.6.3

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),
@@ -38,6 +38,11 @@ incompleto, opção inventada, quantidade inválida, prazo impossível ou person
 
 Exemplo de item configurável:
 
+Para pedidos de festa/orcamento, use `Modo Saida = Compacto Orcamento`, `Incluir Imagens = false`
+e, quando existir, envie `Orcamento Contexto (JSON)` com estado pequeno do atendimento
+(`pessoas`, `perfil`, `familias`, `preferencias`). O servidor monta `orcamento_sugerido` e omite
+listas largas quando possivel; o node nao calcula preco nem escolhe produto.
+
 ```json
 {
   "produto_id": "uuid-do-produto",
@@ -70,6 +75,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
@@ -81,7 +96,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",
@@ -435,6 +435,35 @@ class Nucleo {
                     description: "Cursor opaco retornado por resultados[].continuacao.cursor. Use somente quando o cliente pedir a proxima pagina da mesma lista ('mostrar os outros', 'mais sabores'). Se informado, vence Consultas.",
                     displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
                 },
+                {
+                    displayName: "Modo Saida",
+                    name: "modoSaidaCatalogo",
+                    type: "options",
+                    default: "normal",
+                    options: [
+                        { name: "Normal", value: "normal" },
+                        { name: "Compacto Orcamento", value: "compacto_orcamento" },
+                    ],
+                    description: "Use Compacto Orcamento quando a consulta for de festa/kit/orcamento. O servidor prioriza orcamento_sugerido e reduz payload da tool.",
+                    displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
+                },
+                {
+                    displayName: "Incluir Imagens",
+                    name: "incluirImagensCatalogo",
+                    type: "boolean",
+                    default: true,
+                    description: "Quando falso, o resolver omite image_url. Desligue em orcamentos; ligue apenas quando o cliente pedir foto/imagem.",
+                    displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
+                },
+                {
+                    displayName: "Orcamento Contexto (JSON)",
+                    name: "orcamentoContexto",
+                    type: "json",
+                    default: "",
+                    required: false,
+                    description: "Estado compacto opcional do orcamento em andamento: pessoas, perfil, familias e preferencias. Nao envie catalogo, preco nem produto_id aqui.",
+                    displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
+                },
                 // ----------------------------------------------------------------- catalogo:disponibilidadeRede
                 {
                     displayName: "Produto (ID)",
@@ -849,9 +878,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
@@ -1175,9 +1247,19 @@ class Nucleo {
                 else if (resource === "catalogo" && operation === "resolver") {
                     const consultas = parseConsultas(this.getNodeParameter("consultas", i));
                     const continuacaoCursor = this.getNodeParameter("continuacaoCursor", i, "").trim();
+                    const modoSaida = this.getNodeParameter("modoSaidaCatalogo", i, "normal");
+                    const incluirImagens = this.getNodeParameter("incluirImagensCatalogo", i, true);
+                    const orcamentoContexto = asObject(this.getNodeParameter("orcamentoContexto", i, ""));
                     method = "POST";
                     path = "/api/v1/agent/catalogo/resolver";
-                    bodyObj = continuacaoCursor ? { continuacao_cursor: continuacaoCursor } : { consultas };
+                    const b = continuacaoCursor ? { continuacao_cursor: continuacaoCursor } : { consultas };
+                    if (modoSaida === "compacto_orcamento")
+                        b.modo_saida = "compacto_orcamento";
+                    if (!incluirImagens)
+                        b.incluir_imagens = false;
+                    if (orcamentoContexto)
+                        b.orcamento_contexto = orcamentoContexto;
+                    bodyObj = b;
                 }
                 else if (resource === "catalogo" && operation === "disponibilidadeRede") {
                     const produtoId = this.getNodeParameter("produtoIdRede", i, "").trim();
@@ -1363,9 +1445,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.1",
+  "version": "0.6.3",
   "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",