@meuecommerce/frete-adapter-node 0.8.1 → 0.10.0

package/dist/cjs/openAIDimensionEstimator.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DIMENSION_PROMPT_VERSION = void 0;
 exports.createOpenAIDimensionEstimator = createOpenAIDimensionEstimator;
+const frete_1 = require("@meuecommerce/frete");
 const openAIResponsesAgentRunner_js_1 = require("./openAIResponsesAgentRunner.js");
 /**
  * Bump whenever the prompt or the schema changes. It is written next to every
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-exports.DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+exports.DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v3-detalhes";
 /**
  * Strict JSON schema for the response.
  *
@@ -29,8 +30,20 @@ const DIMENSIONS_SCHEMA = {
                     length: { type: "number", description: "Comprimento em cm" },
                     width: { type: "number", description: "Largura em cm" },
                     height: { type: "number", description: "Altura em cm" },
+                    attrs: {
+                        type: "object",
+                        description: "Como o produto ocupa espaço. Na dúvida, false — cada traço afrouxa o encaixe.",
+                        properties: {
+                            fragile: { type: "boolean", description: "Quebra se receber peso em cima (vidro, cerâmica, ovo)" },
+                            compressible: { type: "boolean", description: "Cede quando espremido (roupa, tecido, espuma, travesseiro)" },
+                            nestable: { type: "boolean", description: "Unidades iguais encaixam uma na outra (tigela, copo, cone, pote)" },
+                            keepUpright: { type: "boolean", description: "Precisa viajar em pé (líquido, bolo, planta)" },
+                        },
+                        required: ["fragile", "compressible", "nestable", "keepUpright"],
+                        additionalProperties: false,
+                    },
                 },
-                required: ["name", "length", "width", "height"],
+                required: ["name", "length", "width", "height", "attrs"],
                 additionalProperties: false,
             },
         },
@@ -41,6 +54,28 @@ const DIMENSIONS_SCHEMA = {
 function largestBox(boxes) {
     return boxes.reduce((largest, current) => current.width * current.height * current.length > largest.width * largest.height * largest.length ? current : largest);
 }
+/**
+ * Uma entrada da lista numerada: a linha de identificação e, recuado embaixo
+ * dela, o contexto que a loja tiver mandado.
+ *
+ * A separação é o que faz a resposta voltar: a primeira linha é curta e é dela
+ * que sai o `name` que o modelo copia. Antes de `details` existir, quem tinha
+ * descrição e categoria para mandar empurrava tudo para dentro do `name`, a
+ * lista numerada virava um bloco de cinco linhas por item, e o modelo
+ * respondia o título limpo — correto, e impossível de casar com o que foi
+ * perguntado.
+ */
+function descreverProduto(p, i) {
+    const linha = `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`;
+    if (!p.details?.trim())
+        return linha;
+    const contexto = p.details
+        .trim()
+        .split("\n")
+        .map((l) => `   ${l.trim()}`)
+        .join("\n");
+    return `${linha}\n${contexto}`;
+}
 function createPrompt(products, boxes, samples) {
     const box = largestBox(boxes);
     const maxWidth = Math.floor(box.width * 0.8);
@@ -52,9 +87,32 @@ function createPrompt(products, boxes, samples) {
         : `\n📋 INSTRUÇÕES (SEM EXEMPLOS):\n1. Considere a embalagem comercial típica brasileira\n2. Use conhecimento sobre produtos similares\n3. Ajuste baseado no peso\n`;
     return (`Você é um especialista em dimensões de produtos brasileiros para e-commerce.\n\n` +
         `🚨 LIMITES FÍSICOS OBRIGATÓRIOS:\n- Largura máxima: ${maxWidth}cm\n- Altura máxima: ${maxHeight}cm\n- Comprimento máximo: ${maxLength}cm\n(Maior caixa: ${box.name ?? "—"})\n\n` +
-        `📦 PRODUTOS PARA ESTIMAR:\n${products.map((p, i) => `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`).join("\n")}\n` +
+        `📦 PRODUTOS PARA ESTIMAR:\n${products.map(descreverProduto).join("\n")}\n` +
         samplesSection +
-        `\n⚠️ REGRAS: respeite os limites; preserve os nomes EXATOS; retorne length×width×height em cm.`);
+        `\n🧱 COMO O PRODUTO OCUPA ESPAÇO (campo attrs, um por produto):\n` +
+        `- fragile: quebra se levar peso em cima — vidro, cerâmica, garrafa, ovo\n` +
+        `- compressible: cede quando espremido — roupa, tecido, espuma, travesseiro, pelúcia\n` +
+        `- nestable: unidades IGUAIS encaixam uma na outra — tigela, copo, cone, pote, vaso\n` +
+        `- keepUpright: precisa viajar em pé — líquido, tinta, bolo, planta\n` +
+        `Na dúvida responda false. Cada traço afrouxa o encaixe, e afrouxar errado faz o pacote não fechar.\n` +
+        `\n⚠️ REGRAS: respeite os limites; retorne length×width×height em cm; ` +
+        `copie em "name" o nome EXATO da linha numerada do produto, sem as linhas recuadas de contexto — ` +
+        `é por ele que a resposta é reconhecida, e um nome diferente descarta a estimativa.`);
+}
+/**
+ * Só os traços verdadeiros, e nada quando não há nenhum.
+ *
+ * O schema obriga o modelo a responder os quatro booleanos, então quase todo
+ * produto volta com `{fragile:false, compressible:false, ...}`. Guardar isso é
+ * gravar ruído em cada linha da memória e, pior, apagar a diferença entre
+ * "sabemos que é um tijolo" e "não perguntamos" — que é justamente o que o
+ * empacotador precisa distinguir.
+ */
+function attrsVerdadeiros(attrs) {
+    if (!attrs)
+        return null;
+    const so = Object.fromEntries(Object.entries(attrs).filter(([, v]) => v === true));
+    return Object.keys(so).length ? { attrs: so } : null;
 }
 /** Apply the largest-box physical limits + a minimum-volume floor to AI output. */
 function validateAndOptimize(aiResult, products, boxes) {
@@ -71,7 +129,10 @@ function validateAndOptimize(aiResult, products, boxes) {
         if (height > maxHeight)
             height = maxHeight;
         const volume = length * width * height;
-        const original = products.find((p) => p.name === product.name);
+        // Mesma normalização que liga a resposta de volta ao produto na memória.
+        // Comparando as strings cruas, um espaço a mais fazia o peso sumir e o
+        // piso de volume cair para o de um produto de 100 g.
+        const original = products.find((p) => (0, frete_1.productNameKey)(p.name) === (0, frete_1.productNameKey)(product.name));
         const minVolume = (original?.weight || 0.1) * 500;
         if (volume > 0 && volume < minVolume) {
             const scale = Math.cbrt(minVolume / volume);
@@ -84,6 +145,7 @@ function validateAndOptimize(aiResult, products, boxes) {
             length: Math.round(length * 10) / 10,
             width: Math.round(width * 10) / 10,
             height: Math.round(height * 10) / 10,
+            ...(attrsVerdadeiros(product.attrs) ?? {}),
         };
     });
     return { products: optimized };

package/dist/openAIDimensionEstimator.d.ts

@@ -25,7 +25,7 @@ type FetchLike = typeof globalThis.fetch;
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-export declare const DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+export declare const DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v3-detalhes";
 export interface OpenAIDimensionEstimatorOptions {
     apiKey?: string;
     fetch?: FetchLike;

package/dist/openAIDimensionEstimator.js

@@ -1,10 +1,11 @@
+import { productNameKey } from "@meuecommerce/frete";
 import { createOpenAIResponsesAgentRunner } from "./openAIResponsesAgentRunner.js";
 /**
  * Bump whenever the prompt or the schema changes. It is written next to every
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-export const DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+export const DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v3-detalhes";
 /**
  * Strict JSON schema for the response.
  *
@@ -25,8 +26,20 @@ const DIMENSIONS_SCHEMA = {
                     length: { type: "number", description: "Comprimento em cm" },
                     width: { type: "number", description: "Largura em cm" },
                     height: { type: "number", description: "Altura em cm" },
+                    attrs: {
+                        type: "object",
+                        description: "Como o produto ocupa espaço. Na dúvida, false — cada traço afrouxa o encaixe.",
+                        properties: {
+                            fragile: { type: "boolean", description: "Quebra se receber peso em cima (vidro, cerâmica, ovo)" },
+                            compressible: { type: "boolean", description: "Cede quando espremido (roupa, tecido, espuma, travesseiro)" },
+                            nestable: { type: "boolean", description: "Unidades iguais encaixam uma na outra (tigela, copo, cone, pote)" },
+                            keepUpright: { type: "boolean", description: "Precisa viajar em pé (líquido, bolo, planta)" },
+                        },
+                        required: ["fragile", "compressible", "nestable", "keepUpright"],
+                        additionalProperties: false,
+                    },
                 },
-                required: ["name", "length", "width", "height"],
+                required: ["name", "length", "width", "height", "attrs"],
                 additionalProperties: false,
             },
         },
@@ -37,6 +50,28 @@ const DIMENSIONS_SCHEMA = {
 function largestBox(boxes) {
     return boxes.reduce((largest, current) => current.width * current.height * current.length > largest.width * largest.height * largest.length ? current : largest);
 }
+/**
+ * Uma entrada da lista numerada: a linha de identificação e, recuado embaixo
+ * dela, o contexto que a loja tiver mandado.
+ *
+ * A separação é o que faz a resposta voltar: a primeira linha é curta e é dela
+ * que sai o `name` que o modelo copia. Antes de `details` existir, quem tinha
+ * descrição e categoria para mandar empurrava tudo para dentro do `name`, a
+ * lista numerada virava um bloco de cinco linhas por item, e o modelo
+ * respondia o título limpo — correto, e impossível de casar com o que foi
+ * perguntado.
+ */
+function descreverProduto(p, i) {
+    const linha = `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`;
+    if (!p.details?.trim())
+        return linha;
+    const contexto = p.details
+        .trim()
+        .split("\n")
+        .map((l) => `   ${l.trim()}`)
+        .join("\n");
+    return `${linha}\n${contexto}`;
+}
 function createPrompt(products, boxes, samples) {
     const box = largestBox(boxes);
     const maxWidth = Math.floor(box.width * 0.8);
@@ -48,9 +83,32 @@ function createPrompt(products, boxes, samples) {
         : `\n📋 INSTRUÇÕES (SEM EXEMPLOS):\n1. Considere a embalagem comercial típica brasileira\n2. Use conhecimento sobre produtos similares\n3. Ajuste baseado no peso\n`;
     return (`Você é um especialista em dimensões de produtos brasileiros para e-commerce.\n\n` +
         `🚨 LIMITES FÍSICOS OBRIGATÓRIOS:\n- Largura máxima: ${maxWidth}cm\n- Altura máxima: ${maxHeight}cm\n- Comprimento máximo: ${maxLength}cm\n(Maior caixa: ${box.name ?? "—"})\n\n` +
-        `📦 PRODUTOS PARA ESTIMAR:\n${products.map((p, i) => `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`).join("\n")}\n` +
+        `📦 PRODUTOS PARA ESTIMAR:\n${products.map(descreverProduto).join("\n")}\n` +
         samplesSection +
-        `\n⚠️ REGRAS: respeite os limites; preserve os nomes EXATOS; retorne length×width×height em cm.`);
+        `\n🧱 COMO O PRODUTO OCUPA ESPAÇO (campo attrs, um por produto):\n` +
+        `- fragile: quebra se levar peso em cima — vidro, cerâmica, garrafa, ovo\n` +
+        `- compressible: cede quando espremido — roupa, tecido, espuma, travesseiro, pelúcia\n` +
+        `- nestable: unidades IGUAIS encaixam uma na outra — tigela, copo, cone, pote, vaso\n` +
+        `- keepUpright: precisa viajar em pé — líquido, tinta, bolo, planta\n` +
+        `Na dúvida responda false. Cada traço afrouxa o encaixe, e afrouxar errado faz o pacote não fechar.\n` +
+        `\n⚠️ REGRAS: respeite os limites; retorne length×width×height em cm; ` +
+        `copie em "name" o nome EXATO da linha numerada do produto, sem as linhas recuadas de contexto — ` +
+        `é por ele que a resposta é reconhecida, e um nome diferente descarta a estimativa.`);
+}
+/**
+ * Só os traços verdadeiros, e nada quando não há nenhum.
+ *
+ * O schema obriga o modelo a responder os quatro booleanos, então quase todo
+ * produto volta com `{fragile:false, compressible:false, ...}`. Guardar isso é
+ * gravar ruído em cada linha da memória e, pior, apagar a diferença entre
+ * "sabemos que é um tijolo" e "não perguntamos" — que é justamente o que o
+ * empacotador precisa distinguir.
+ */
+function attrsVerdadeiros(attrs) {
+    if (!attrs)
+        return null;
+    const so = Object.fromEntries(Object.entries(attrs).filter(([, v]) => v === true));
+    return Object.keys(so).length ? { attrs: so } : null;
 }
 /** Apply the largest-box physical limits + a minimum-volume floor to AI output. */
 function validateAndOptimize(aiResult, products, boxes) {
@@ -67,7 +125,10 @@ function validateAndOptimize(aiResult, products, boxes) {
         if (height > maxHeight)
             height = maxHeight;
         const volume = length * width * height;
-        const original = products.find((p) => p.name === product.name);
+        // Mesma normalização que liga a resposta de volta ao produto na memória.
+        // Comparando as strings cruas, um espaço a mais fazia o peso sumir e o
+        // piso de volume cair para o de um produto de 100 g.
+        const original = products.find((p) => productNameKey(p.name) === productNameKey(product.name));
         const minVolume = (original?.weight || 0.1) * 500;
         if (volume > 0 && volume < minVolume) {
             const scale = Math.cbrt(minVolume / volume);
@@ -80,6 +141,7 @@ function validateAndOptimize(aiResult, products, boxes) {
             length: Math.round(length * 10) / 10,
             width: Math.round(width * 10) / 10,
             height: Math.round(height * 10) / 10,
+            ...(attrsVerdadeiros(product.attrs) ?? {}),
         };
     });
     return { products: optimized };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meuecommerce/frete-adapter-node",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Node implementation of @meuecommerce/frete ports (Correios HTTP client) using global fetch. Used by the Shopify/Fly deployment and the MCP server.",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@meuecommerce/frete": "^0.8.1"
+    "@meuecommerce/frete": "^0.10.0"
   },
   "module": "./dist/index.js",
   "repository": {