@wondai/n8n-nodes-nucleo 0.5.5 → 0.6.0

package/README.md

@@ -56,6 +56,11 @@ Exemplo de item configurável:
 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).
 
+A partir da v0.5.6, `Pedido Criar` falha antes da requisição quando `itens` está vazio ou quando
+alguma linha não traz `produto_id`/`alias` e `quantidade` positiva. É uma proteção de integração:
+o Núcleo continua sendo a autoridade final das regras, mas o workflow não envia pedido vazio por
+erro de tool schema.
+
 **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

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

@@ -86,6 +86,29 @@ function asArray(value) {
     }
     return [];
 }
+function hasPedidoItemIdentifier(item) {
+    const produtoId = String(item.produto_id ?? "").trim();
+    const alias = String(item.alias ?? "").trim();
+    return Boolean(produtoId || alias);
+}
+function hasPositiveQuantidade(item) {
+    const quantidade = Number(item.quantidade);
+    return Number.isFinite(quantidade) && quantidade > 0;
+}
+function assertPedidoCriarItens(itens) {
+    if (!Array.isArray(itens) || itens.length === 0) {
+        throw new Error("Pedido Criar bloqueado: o campo itens precisa ser um array JSON não vazio com produto_id ou alias e quantidade. Resolva o catálogo e envie os itens estruturados antes de criar o pedido.");
+    }
+    const invalidIndex = itens.findIndex((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return true;
+        const itemObject = item;
+        return !hasPedidoItemIdentifier(itemObject) || !hasPositiveQuantidade(itemObject);
+    });
+    if (invalidIndex >= 0) {
+        throw new Error(`Pedido Criar bloqueado: itens[${invalidIndex}] precisa ter produto_id ou alias e quantidade positiva.`);
+    }
+}
 /** Lê um parâmetro JSON (string ou objeto) como objeto simples. Vazio → null. */
 function asObject(value) {
     if (value && typeof value === "object" && !Array.isArray(value))
@@ -158,6 +181,11 @@ class Nucleo {
                         { name: "Conversa", value: "conversa" },
                         { name: "Contexto", value: "contexto" },
                         { name: "Telemetria", value: "telemetria" },
+                        // --- odonto (ADR-036/038): resources próprios do vertical; server roteia pelo token ---
+                        { name: "Paciente", value: "paciente" },
+                        { name: "Procedimento", value: "procedimento" },
+                        { name: "Agenda", value: "agenda" },
+                        { name: "Agendamento", value: "agendamento" },
                     ],
                     default: "catalogo",
                 },
@@ -299,6 +327,82 @@ class Nucleo {
                     ],
                     default: "enviar",
                 },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["paciente"] } },
+                    options: [
+                        {
+                            name: "Buscar",
+                            value: "buscar",
+                            action: "Buscar paciente por telefone",
+                            description: "Lookup do paciente (cliente + dados clínicos) + agendamentos recentes",
+                        },
+                    ],
+                    default: "buscar",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["procedimento"] } },
+                    options: [
+                        {
+                            name: "Resolver",
+                            value: "resolver",
+                            action: "Resolver procedimentos por nome",
+                            description: "Busca vários procedimentos numa chamada, tolera erro de digitação e apelidos e devolve id, duração e preço (status achou/ambiguo/nao_encontrado)",
+                        },
+                    ],
+                    default: "resolver",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["agenda"] } },
+                    options: [
+                        {
+                            name: "Consultar",
+                            value: "consultar",
+                            action: "Consultar horários livres numa data",
+                            description: "Horários livres por profissional numa data (horário publicado − ocupado). Sem config do dia ⇒ unknown honesto",
+                        },
+                    ],
+                    default: "consultar",
+                },
+                {
+                    displayName: "Operação",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ["agendamento"] } },
+                    options: [
+                        {
+                            name: "Criar",
+                            value: "criar",
+                            action: "Criar agendamento",
+                            description: "Marca um horário (idempotente). Overlap do profissional ⇒ 409",
+                        },
+                        {
+                            name: "Alterar",
+                            value: "alterar",
+                            action: "Alterar agendamento",
+                            description: "Remarca / troca procedimento ou profissional / observação / status (idempotente). Transição inválida ⇒ 409",
+                        },
+                        {
+                            name: "Cancelar",
+                            value: "cancelar",
+                            action: "Cancelar agendamento",
+                            description: "Cancela o agendamento (idempotente). Libera o horário",
+                        },
+                    ],
+                    default: "criar",
+                },
                 // ----------------------------------------------------------------- cliente:buscar
                 {
                     displayName: "Telefone",
@@ -831,6 +935,211 @@ class Nucleo {
                     description: "Opcional. UUID do pedido vinculado (validado contra o tenant).",
                     displayOptions: { show: { resource: ["telemetria"], operation: ["enviar"] } },
                 },
+                // ===================================================================== ODONTO (ADR-036/038)
+                // ----------------------------------------------------------------- paciente:buscar
+                {
+                    displayName: "Telefone",
+                    name: "pacTelefone",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "+5511999999999",
+                    description: "Telefone do paciente em E.164 (só dígitos + DDI). Devolve o paciente (cliente + dados clínicos) e os agendamentos recentes.",
+                    displayOptions: { show: { resource: ["paciente"], operation: ["buscar"] } },
+                },
+                // ----------------------------------------------------------------- procedimento:resolver
+                {
+                    displayName: "Consultas",
+                    name: "procConsultas",
+                    type: "string",
+                    typeOptions: { rows: 3 },
+                    default: "",
+                    required: true,
+                    placeholder: "limpeza, clareamento, canal",
+                    description: "Procedimentos a buscar: um por linha ou separados por vírgula (máx 10). Tolera erro de digitação, falta de acento e apelidos. Devolve status (achou/ambiguo/nao_encontrado) + candidatos com id, duração e preço.",
+                    displayOptions: { show: { resource: ["procedimento"], operation: ["resolver"] } },
+                },
+                // ----------------------------------------------------------------- agenda:consultar
+                {
+                    displayName: "Data",
+                    name: "agdData",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "2026-07-15",
+                    description: "UMA data YYYY-MM-DD. Devolve horários livres por profissional (horário publicado − ocupado). Sem config do dia ⇒ status unknown (não invente horário).",
+                    displayOptions: { show: { resource: ["agenda"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Procedimento (ID, opcional)",
+                    name: "agdProcedimentoId",
+                    type: "string",
+                    default: "",
+                    description: "UUID do procedimento (do Procedimento Resolver). Define a duração dos slots; vazio = 30 min.",
+                    displayOptions: { show: { resource: ["agenda"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Profissional (ID, opcional)",
+                    name: "agdProfissionalId",
+                    type: "string",
+                    default: "",
+                    description: "UUID do profissional. Vazio = todos os profissionais ativos.",
+                    displayOptions: { show: { resource: ["agenda"], operation: ["consultar"] } },
+                },
+                {
+                    displayName: "Passo (min, opcional)",
+                    name: "agdPassoMin",
+                    type: "number",
+                    default: 30,
+                    description: "Granularidade dos horários oferecidos, em minutos (1..240). Default 30.",
+                    displayOptions: { show: { resource: ["agenda"], operation: ["consultar"] } },
+                },
+                // ----------------------------------------------------------------- agendamento:criar
+                {
+                    displayName: "Telefone",
+                    name: "agcTelefone",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "+5511999999999",
+                    description: "Telefone do paciente (E.164). Resolve o paciente existente ou cria um novo.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Nome do Paciente",
+                    name: "agcNomePaciente",
+                    type: "string",
+                    default: "",
+                    description: "Opcional. Preenche paciente novo ou existente ainda sem nome. Não sobrescreve nome já cadastrado.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Profissional (ID)",
+                    name: "agcProfissionalId",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    description: "UUID do profissional (obrigatório). Horário ocupado desse profissional ⇒ 409 (indisponível).",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Procedimento (ID, opcional)",
+                    name: "agcProcedimentoId",
+                    type: "string",
+                    default: "",
+                    description: "UUID do procedimento (do Procedimento Resolver). Define a duração quando 'Fim' não é enviado.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Início",
+                    name: "agcInicio",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    placeholder: "2026-07-15T14:00:00-03:00",
+                    description: "Instante ISO 8601 do início do agendamento.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Fim (opcional)",
+                    name: "agcFim",
+                    type: "string",
+                    default: "",
+                    placeholder: "2026-07-15T14:30:00-03:00",
+                    description: "Instante ISO 8601 do fim. Vazio = início + duração do procedimento (ou 30 min).",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                {
+                    displayName: "Observações",
+                    name: "agcObservacoes",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["criar"] } },
+                },
+                // ----------------------------------------------------------------- agendamento:alterar / cancelar
+                {
+                    displayName: "Agendamento ID",
+                    name: "agAgendamentoId",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    description: "UUID do agendamento (do tenant). Agendamento de outro tenant → 404.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar", "cancelar"] } },
+                },
+                {
+                    displayName: "Início (remarcar)",
+                    name: "agaInicio",
+                    type: "string",
+                    default: "",
+                    placeholder: "2026-07-16T09:00:00-03:00",
+                    description: "ISO 8601. Vazio = não remarca.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Fim (remarcar)",
+                    name: "agaFim",
+                    type: "string",
+                    default: "",
+                    description: "ISO 8601. Vazio = mantém/recalcula pelo início.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Procedimento (ID, alterar)",
+                    name: "agaProcedimentoId",
+                    type: "string",
+                    default: "",
+                    description: "UUID do novo procedimento. Vazio = não altera. Use 'null' para desvincular.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Profissional (ID, alterar)",
+                    name: "agaProfissionalId",
+                    type: "string",
+                    default: "",
+                    description: "UUID do novo profissional. Vazio = não altera. Overlap ⇒ 409.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Observações (alterar)",
+                    name: "agaObservacoes",
+                    type: "string",
+                    default: "",
+                    description: "Vazio = não altera.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Status",
+                    name: "agaStatus",
+                    type: "options",
+                    options: [
+                        { name: "(não alterar)", value: "" },
+                        { name: "Confirmado", value: "confirmado" },
+                        { name: "Realizado", value: "realizado" },
+                        { name: "Faltou", value: "faltou" },
+                        { name: "Cancelado", value: "cancelado" },
+                    ],
+                    default: "",
+                    description: "Transição de status (a API recusa transição inválida com 409). Válidas: agendado→confirmado/cancelado; confirmado→realizado/faltou/cancelado.",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Motivo",
+                    name: "agxMotivo",
+                    type: "string",
+                    default: "",
+                    description: "Motivo do cancelamento (opcional).",
+                    displayOptions: { show: { resource: ["agendamento"], operation: ["cancelar"] } },
+                },
+                {
+                    displayName: "Idempotency Key",
+                    name: "agIdempotencyKey",
+                    type: "string",
+                    default: "",
+                    description: "Criar: vazio = gerada automaticamente. Alterar/cancelar: use a MESMA chave (ex.: messageID do WhatsApp) num retry para não reaplicar a operação.",
+                    displayOptions: {
+                        show: { resource: ["agendamento"], operation: ["criar", "alterar", "cancelar"] },
+                    },
+                },
             ],
         };
     }
@@ -884,6 +1193,7 @@ class Nucleo {
                     const telefone = this.getNodeParameter("telefone", i).trim();
                     const nomeCliente = this.getNodeParameter("nomeCliente", i, "").trim();
                     const itens = asArray(this.getNodeParameter("itens", i));
+                    assertPedidoCriarItens(itens);
                     const tipoEntrega = this.getNodeParameter("tipoEntrega", i);
                     const observacoes = this.getNodeParameter("observacoes", i, "").trim();
                     const agendadoPara = this.getNodeParameter("agendadoPara", i, "").trim();
@@ -1081,6 +1391,96 @@ class Nucleo {
                     path = "/api/v1/agent/telemetria";
                     bodyObj = b;
                 }
+                else if (resource === "paciente" && operation === "buscar") {
+                    const telefone = this.getNodeParameter("pacTelefone", i).trim();
+                    method = "POST";
+                    path = "/api/v1/agent/paciente";
+                    bodyObj = { telefone };
+                }
+                else if (resource === "procedimento" && operation === "resolver") {
+                    const consultas = parseConsultas(this.getNodeParameter("procConsultas", i));
+                    method = "POST";
+                    path = "/api/v1/agent/procedimento/resolver";
+                    bodyObj = { consultas };
+                }
+                else if (resource === "agenda" && operation === "consultar") {
+                    const data = this.getNodeParameter("agdData", i).trim();
+                    const procedimentoId = this.getNodeParameter("agdProcedimentoId", i, "").trim();
+                    const profissionalId = this.getNodeParameter("agdProfissionalId", i, "").trim();
+                    const passoMin = Number(this.getNodeParameter("agdPassoMin", i, 30));
+                    const b = { data };
+                    if (procedimentoId)
+                        b.procedimento_id = procedimentoId;
+                    if (profissionalId)
+                        b.profissional_id = profissionalId;
+                    if (Number.isFinite(passoMin) && passoMin > 0)
+                        b.passo_min = passoMin;
+                    method = "POST";
+                    path = "/api/v1/agent/agenda/consultar";
+                    bodyObj = b;
+                }
+                else if (resource === "agendamento" && operation === "criar") {
+                    const telefone = this.getNodeParameter("agcTelefone", i).trim();
+                    const nomePaciente = this.getNodeParameter("agcNomePaciente", i, "").trim();
+                    const profissionalId = this.getNodeParameter("agcProfissionalId", i).trim();
+                    const procedimentoId = this.getNodeParameter("agcProcedimentoId", i, "").trim();
+                    const inicio = this.getNodeParameter("agcInicio", i).trim();
+                    const fim = this.getNodeParameter("agcFim", i, "").trim();
+                    const observacoes = this.getNodeParameter("agcObservacoes", i, "").trim();
+                    // Escrita de agenda EXIGE Idempotency-Key no servidor (400 se vazia) — gera se não vier.
+                    idempotencyKey =
+                        this.getNodeParameter("agIdempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
+                    const b = { telefone, profissional_id: profissionalId, inicio };
+                    if (nomePaciente)
+                        b.nome_paciente = nomePaciente;
+                    if (procedimentoId)
+                        b.procedimento_id = procedimentoId;
+                    if (fim)
+                        b.fim = fim;
+                    if (observacoes)
+                        b.observacoes = observacoes;
+                    method = "POST";
+                    path = "/api/v1/agent/agendamento";
+                    bodyObj = b;
+                }
+                else if (resource === "agendamento" && operation === "alterar") {
+                    const agendamentoId = this.getNodeParameter("agAgendamentoId", i).trim();
+                    const inicio = this.getNodeParameter("agaInicio", i, "").trim();
+                    const fim = this.getNodeParameter("agaFim", i, "").trim();
+                    const procedimentoId = this.getNodeParameter("agaProcedimentoId", i, "").trim();
+                    const profissionalId = this.getNodeParameter("agaProfissionalId", i, "").trim();
+                    const observacoes = this.getNodeParameter("agaObservacoes", i, "").trim();
+                    const status = this.getNodeParameter("agaStatus", i, "").trim();
+                    const b = {};
+                    if (inicio)
+                        b.inicio = inicio;
+                    if (fim)
+                        b.fim = fim;
+                    // "null" (string) desvincula o procedimento; vazio = não mexe no campo.
+                    if (procedimentoId) {
+                        b.procedimento_id = procedimentoId.toLowerCase() === "null" ? null : procedimentoId;
+                    }
+                    if (profissionalId)
+                        b.profissional_id = profissionalId;
+                    if (observacoes)
+                        b.observacoes = observacoes;
+                    if (status)
+                        b.status = status;
+                    idempotencyKey =
+                        this.getNodeParameter("agIdempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
+                    method = "PATCH";
+                    path = `/api/v1/agent/agendamento/${encodeURIComponent(agendamentoId)}`;
+                    bodyObj = b;
+                }
+                else if (resource === "agendamento" && operation === "cancelar") {
+                    const agendamentoId = this.getNodeParameter("agAgendamentoId", i).trim();
+                    const motivo = this.getNodeParameter("agxMotivo", i, "").trim();
+                    idempotencyKey =
+                        this.getNodeParameter("agIdempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
+                    method = "POST";
+                    path = `/api/v1/agent/agendamento/${encodeURIComponent(agendamentoId)}/cancelar`;
+                    bodyObj = motivo ? { motivo } : {};
+                }
                 else {
                     throw new n8n_workflow_1.NodeApiError(this.getNode(), {
                         message: `Operação não suportada: ${resource}.${operation}`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "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).",
+  "version": "0.6.0",
+  "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",
     "n8n",
@@ -9,6 +9,7 @@
     "nucleo",
     "crm",
     "padaria",
+    "odonto",
     "ai-tool"
   ],
   "license": "MIT",