@wondai/n8n-nodes-nucleo 0.5.4 → 0.5.5

package/README.md

@@ -32,6 +32,29 @@ parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o tok
 **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`).
+Produtos configuráveis também devolvem `regras_compra`. O agente deve coletar as opções
+obrigatórias e enviá-las em `itens[].configuracao`; o Núcleo recusa com HTTP 422 qualquer combo
+incompleto, opção inventada, quantidade inválida, prazo impossível ou personalização proibida.
+
+Exemplo de item configurável:
+
+```json
+{
+  "produto_id": "uuid-do-produto",
+  "quantidade": 1,
+  "configuracao": {
+    "opcoes": [
+      {
+        "grupo_id": "uuid-do-grupo",
+        "opcao_id": "uuid-da-opcao"
+      }
+    ]
+  }
+}
+```
+
+O node não interpreta essas regras: ele encaminha o JSON sem alteração. A validação e o snapshot
+imutável do contrato aplicado pertencem à API do Núcleo (ADR-035).
 
 **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`

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

@@ -189,7 +189,7 @@ class Nucleo {
                             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",
+                            description: "Busca vários produtos numa chamada, tolera erro de digitação e apelidos e devolve regras_compra quando houver escolhas, limites ou restrições obrigatórias",
                         },
                         {
                             name: "Disponibilidade Na Rede",
@@ -319,7 +319,7 @@ class Nucleo {
                     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'.",
+                    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. Para produto configurável, use regras_compra como fonte da verdade e colete todas as opções obrigatórias antes de criar o pedido.",
                     displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
                 },
                 // ----------------------------------------------------------------- catalogo:disponibilidadeRede
@@ -385,7 +385,7 @@ class Nucleo {
                     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}]',
+                    description: 'Array de itens. Cada item: {"produto_id" OU "alias", "variacao_id"?, "quantidade", "personalizacao"?, "configuracao"?}. Para produto configurável, copie somente escolhas devolvidas em regras_compra: {"configuracao":{"opcoes":[{"grupo_id":"uuid","opcao_id":"uuid"}],"quantidade_referencia":100,"confirmacao_humana":true}}. A API recusa combo incompleto ou opção inventada com 422.',
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
                 {
@@ -531,7 +531,7 @@ class Nucleo {
                     name: "adicionarItens",
                     type: "json",
                     default: "[]",
-                    description: "Mesma forma de Itens. Vazio = não adiciona.",
+                    description: "Mesma forma de Itens, incluindo configuracao para escolhas obrigatórias retornadas em regras_compra. Vazio = não adiciona; item incompleto é recusado com 422.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
                 },
                 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Node n8n para o Núcleo Wondai — atendimento de IA (gate liga/desliga, cliente, catálogo fuzzy, disponibilidade em rede, pedidos, contexto operacional, telemetria) com assinatura HMAC v1. Tenant vem do token (a parede, ADR-013).",
   "keywords": [
     "n8n-community-node-package",