@fayz-ai/plugin-fiscal-br 0.3.7 → 0.4.1

package/dist/views/ManifestView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManifestView.d.ts","sourceRoot":"","sources":["../../src/views/ManifestView.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAmBxE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC;AAED,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,iBAAiB,qBAyI7D"}
+{"version":3,"file":"ManifestView.d.ts","sourceRoot":"","sources":["../../src/views/ManifestView.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAmBxE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,iBAAiB,qBA0IrE"}

package/dist/views/NoteReconcileView.d.ts

@@ -4,6 +4,12 @@ export interface NoteReconcileViewProps {
     onBack: () => void;
     /** Onde o título a pagar abre depois de aceitar. O host sabe a rota; esta tela não. */
     onOpenInvoice?: (invoiceId: string) => void;
+    /**
+     * `modal` quando o anfitrião já desenhou a moldura (título e fechar): o
+     * cabeçalho de subpágina sai, porque dois títulos na mesma caixa é o defeito
+     * que o `page-header-no-duplicate-title` descreve.
+     */
+    chrome?: 'page' | 'modal';
 }
-export declare function NoteReconcileView({ noteId, onBack, onOpenInvoice }: NoteReconcileViewProps): React.JSX.Element;
+export declare function NoteReconcileView({ noteId, onBack, onOpenInvoice, chrome }: NoteReconcileViewProps): React.JSX.Element;
 //# sourceMappingURL=NoteReconcileView.d.ts.map

package/dist/views/NoteReconcileView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoteReconcileView.d.ts","sourceRoot":"","sources":["../../src/views/NoteReconcileView.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAmExE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,uFAAuF;IACvF,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,sBAAsB,qBA0wB1F"}
+{"version":3,"file":"NoteReconcileView.d.ts","sourceRoot":"","sources":["../../src/views/NoteReconcileView.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAoD,MAAM,OAAO,CAAA;AA4ExE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,uFAAuF;IACvF,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAe,EAAE,EAAE,sBAAsB,qBA8kC3G"}

package/dist/views/UnitFiscalWidgets.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+interface UnitItem {
+    id?: string;
+    tenantId?: string;
+    legalEntityId?: string | null;
+    legalName?: string | null;
+    cnpj?: string | null;
+    stateRegistration?: string | null;
+    municipalRegistration?: string | null;
+    taxRegime?: string | null;
+    cnae?: string | null;
+    ibgeCityCode?: string | null;
+}
+export declare function UnitCertificateWidget({ item }: {
+    item?: UnitItem;
+}): React.JSX.Element | null;
+export declare function UnitFiscalWidget({ item }: {
+    item?: UnitItem;
+}): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=UnitFiscalWidgets.d.ts.map

package/dist/views/UnitFiscalWidgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnitFiscalWidgets.d.ts","sourceRoot":"","sources":["../../src/views/UnitFiscalWidgets.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgCzB,UAAU,QAAQ;IAChB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAmID,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,4BA+ElE;AA6BD,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,4BA+J7D"}

package/dist/views/inventoryView.d.ts

@@ -4,6 +4,7 @@ export declare function inboundNotesInventoryView(options?: InboundNotesPageProp
     id: string;
     label: string;
     icon: string;
+    defaultChildLabel: string;
     render: () => React.JSX.Element;
     children: {
         id: string;
@@ -11,4 +12,34 @@ export declare function inboundNotesInventoryView(options?: InboundNotesPageProp
         render: () => React.JSX.Element;
     }[];
 };
+/**
+ * A NOTA que originou um movimento de estoque, dentro do modal que o Estoque abre.
+ *
+ * O Estoque guarda `operation_id` no movimento e não sabe o que é uma NF-e; esta
+ * é a peça que faz a ponte — `plg_fiscalbr_inbox_documents.inventory_operation_id`
+ * aponta para a mesma operação. A resolução é assíncrona (só o banco sabe qual
+ * nota é), então o modal abre com esqueleto e preenche.
+ *
+ * Abre em MODAL e não em rota porque o documento é uma consulta, não um destino:
+ * quem está percorrendo o razão clica no motivo para conferir e volta para onde
+ * estava — e uma rota desmontaria a lista inteira para remontá-la sem o recorte.
+ */
+export declare function InboundNoteDocumentModal({ movement, onClose }: {
+    movement: {
+        operationId?: string;
+        documentNumber?: string;
+        reason?: string;
+    };
+    onClose: () => void;
+}): React.JSX.Element;
+/**
+ * O que o app passa em `createInventoryPlugin({ documentModal })`.
+ *
+ * Devolve `undefined` quando o movimento não veio de NF-e — e aí a legenda do
+ * razão continua texto, em vez de virar um link que não abre nada.
+ */
+export declare function inboundNoteDocumentModal(movement: {
+    documentType?: string;
+    operationId?: string;
+}, close: () => void): React.ReactNode | undefined;
 //# sourceMappingURL=inventoryView.d.ts.map

package/dist/views/inventoryView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inventoryView.d.ts","sourceRoot":"","sources":["../../src/views/inventoryView.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAGjF,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;EAqB5E"}
+{"version":3,"file":"inventoryView.d.ts","sourceRoot":"","sources":["../../src/views/inventoryView.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAGjF,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;EA6B5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAC9D,QAAQ,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5E,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,qBA2DA;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EACzD,KAAK,EAAE,MAAM,IAAI,GAChB,KAAK,CAAC,SAAS,GAAG,SAAS,CAG7B"}

package/functions/fiscalbr-suggest-note-items/index.ts

@@ -0,0 +1,425 @@
+// fiscalbr-suggest-note-items — os itens de uma NF-e de entrada, associados ao
+// catálogo da casa: produto, tipo de registro, fator de conversão e plano de contas.
+//
+// Env: OPENAI_API_KEY (ou FISCALBR_SUGGEST_MODEL para trocar o modelo),
+//      SUPABASE_URL, SUPABASE_ANON_KEY.
+//
+// ---------------------------------------------------------------------------
+// Porte do `danfe-ai-suggest` do V1 — e por que é edge function e não o agente
+// ---------------------------------------------------------------------------
+// A primeira versão foi pelo broker do agente, e ele recusou no primeiro clique
+// real: `400 {"status":"error","message":"Message is too long"}`. O teto era o
+// sintoma; o lugar estava errado pelas mesmas quatro razões que o
+// `scribe-generate` já tinha escrito: teto de rodadas, morre na navegação, roda
+// no plano do cliente, e persiste tudo no histórico de conversa de alguém.
+//
+// Então: servidor, como no V1. O que NÃO se repetiu do V1 foram três decisões:
+//
+// ① NADA É LIDO NEM ESCRITO COM SERVICE ROLE.
+//    O V1 lia a nota pelo cliente do usuário (RLS) mas gravava os itens pelo
+//    admin, e o comentário de lá diz por quê isso dói: «pelo admin, qualquer
+//    logado sugeria — e gravava — nos itens de qualquer rede». Aqui TODO acesso
+//    é com o JWT de quem clicou. A RLS é a mesma da tela, e a gravação passa
+//    pela RPC que já exige `financial.edit` na unidade da nota.
+//
+// ② A ESCRITA É PELO CAMINHO QUE JÁ EXISTE.
+//    `fiscalbr_save_inbox_decision` — a mesma RPC do botão «Salvar conciliação».
+//    O V1 dava `UPDATE` direto nas colunas e, com isso, duplicou regras: a de
+//    `reconciled` existia em dois lugares. Um caminho de escrita, uma regra.
+//    Nenhuma coluna `ai_*` paralela aos campos de verdade — só `suggested_by`,
+//    que diz QUEM escreveu (migration 013).
+//
+// ③ PERGUNTA-SE AO ÍNDICE ANTES DE PERGUNTAR AO MODELO.
+//    O V1 despejava 400 produtos do catálogo em todo turno (`.slice(0, 400)`
+//    sobre um `.limit(800)` sem `order by` — corte arbitrário e silencioso, e
+//    acima de 400 produtos respondia «crie este produto» para produto
+//    cadastrado). Aqui vem primeiro `fiscalbr_match_product_candidates`
+//    (migration 012): de-para do fornecedor e EAN são igualdade e resolvem o
+//    item SEM modelo; o resto vai com os seus 8 candidatos.
+//
+//    Medido em dado real, 25 itens de um tenant com 3.116: o `ILIKE` que estava
+//    no lugar achava candidato para 7; o índice acha para 23.
+//
+// ---------------------------------------------------------------------------
+// callModel: um ponto, um dia trocável
+// ---------------------------------------------------------------------------
+// Toda chamada de modelo passa por `callModel`, como no `scribe-generate`. Quando
+// o broker Fayz expuser um endpoint headless sem conversa persistida e sem teto
+// de mensagem, a troca é o corpo desta função e nenhum app volta a segurar chave.
+import { createClient } from 'https://esm.sh/@supabase/supabase-js@2.45.0'
+import {
+  MESSAGE_BUDGET,
+  SUGGESTION_PROMPT,
+  SUGGESTION_TOOL,
+  buildSuggestionPayload,
+  enforceFactorEvidence,
+  isCountingUnit,
+  packagingCount,
+  parseNoteSuggestionReply,
+  splitToFit,
+  type NoteItemSuggestion,
+  type SuggestionCandidate,
+} from '../../src/lib/note-suggestion.ts'
+
+const corsHeaders = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
+}
+
+const DEFAULT_MODEL = 'gpt-4o-mini'
+
+const json = (body: unknown, status = 200) =>
+  new Response(JSON.stringify(body), {
+    status,
+    headers: { ...corsHeaders, 'Content-Type': 'application/json' },
+  })
+
+/**
+ * O que deu errado, em palavras.
+ *
+ * `String(e)` sobre um erro do PostgREST devolve `[object Object]` — eles são
+ * objetos simples (`{message, details, hint, code}`), não instâncias de `Error`.
+ * A primeira chamada real desta function respondeu exatamente isso, e um 500 que
+ * não diz nada custa a mesma investigação que um erro sem log.
+ */
+function describe(e: unknown): string {
+  if (e instanceof Error) return e.message
+  if (e && typeof e === 'object') {
+    const o = e as Record<string, unknown>
+    const partes = [o.message, o.details, o.hint]
+      .filter((p): p is string => typeof p === 'string' && p.trim() !== '')
+    const codigo = typeof o.code === 'string' && o.code ? ` (${o.code})` : ''
+    if (partes.length) return partes.join(' · ') + codigo
+    return JSON.stringify(e).slice(0, 300)
+  }
+  return String(e)
+}
+
+/** Chama o modelo com a tool FORÇADA: a resposta é dado, nunca prosa. */
+async function callModel(message: string): Promise<unknown> {
+  const key = Deno.env.get('OPENAI_API_KEY')
+  if (!key) throw new Error('OPENAI_API_KEY não configurada')
+  const model = Deno.env.get('FISCALBR_SUGGEST_MODEL') ?? DEFAULT_MODEL
+
+  const res = await fetch('https://api.openai.com/v1/chat/completions', {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      model,
+      messages: [{ role: 'user', content: message }],
+      tools: [SUGGESTION_TOOL],
+      tool_choice: { type: 'function', function: { name: 'aplicar_sugestoes' } },
+      // Zero: associar item a produto não é escrita criativa, e duas rodadas da
+      // mesma nota devem dar a mesma resposta — senão «rodar de novo» é loteria.
+      temperature: 0,
+    }),
+  })
+
+  if (!res.ok) {
+    const txt = await res.text()
+    // Os dois estados do provedor que o balcão resolve sozinho. O V1 traduzia
+    // estes dois e só estes — «429» cru não diz a ninguém o que fazer.
+    if (res.status === 429) throw new Error('Limite de IA atingido. Tente de novo em alguns minutos.')
+    if (res.status === 402) throw new Error('Os créditos de IA acabaram. Avise quem administra a conta.')
+    throw new Error(`modelo ${res.status}: ${txt.slice(0, 300)}`)
+  }
+
+  const body = await res.json()
+  const call = body.choices?.[0]?.message?.tool_calls?.[0]
+  if (!call) return body.choices?.[0]?.message?.content ?? ''
+  try {
+    return JSON.parse(call.function.arguments)
+  } catch {
+    return call.function.arguments
+  }
+}
+
+Deno.serve(async (req) => {
+  if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders })
+
+  try {
+    const { documentId, reevaluate, tenantId } = await req.json().catch(() => ({}))
+    if (!documentId) return json({ ok: false, error: 'documentId é obrigatório' }, 400)
+
+    // O JWT de quem clicou, e NADA além dele. Sem service role: a RLS que vale na
+    // tela vale aqui, e nota de outra rede simplesmente não existe.
+    const authorization = req.headers.get('Authorization') ?? ''
+    if (!authorization) return json({ ok: false, error: 'Não autenticado' }, 401)
+
+    // EM QUE CONTA A PESSOA ESTÁ. Chega no CORPO e não em cabeçalho, porque um
+    // cabeçalho fora da lista de `Access-Control-Allow-Headers` faz o navegador
+    // recusar o preflight e bloquear o POST antes de ele sair.
+    //
+    // Daqui para o PostgREST, sim, vira cabeçalho: é `app.requested_tenant()` que
+    // o lê, e entre servidor e banco não há preflight. Sem ele, quem tem mais de
+    // uma conta não tem tenant nenhum — o recuo de `_current_tenant_id_raw` é
+    // «sua única conta» — e a RLS escondia a nota, que a tela lia como 404.
+    //
+    // ISTO NÃO CONCEDE NADA. A 145 validou o cabeçalho contra `app.memberships`:
+    // ele ESCOLHE entre as contas que a pessoa já tem. Estreita, nunca alarga —
+    // tenant de outra rede volta NULL e a nota continua invisível.
+    const db = createClient(
+      Deno.env.get('SUPABASE_URL')!,
+      Deno.env.get('SUPABASE_ANON_KEY')!,
+      {
+        global: {
+          headers: {
+            Authorization: authorization,
+            ...(typeof tenantId === 'string' && tenantId ? { 'x-fayz-tenant': tenantId } : {}),
+          },
+        },
+      },
+    )
+
+    // ── A nota e os cadastros ────────────────────────────────────────────────
+    const { data: doc, error: docErr } = await db
+      .from('plg_fiscalbr_inbox_documents')
+      .select('id, nfe_number, supplier_name, supplier_cnpj, nature_operation, stocked_at, invoice_id, default_chart_account_id')
+      .eq('id', documentId)
+      .maybeSingle()
+    if (docErr) throw docErr
+    if (!doc) {
+      // «Não encontrada» e «não alcançada» se parecem na tela e têm conserto
+      // diferente. Sem conta no corpo, a RLS não tinha como achar nada.
+      return json({
+        ok: false,
+        error: tenantId
+          ? 'Nota não encontrada nesta conta.'
+          : 'Nota não encontrada: a requisição não disse em que conta você está.',
+      }, 404)
+    }
+    if (doc.stocked_at || doc.invoice_id) {
+      return json({ ok: false, error: 'Esta nota já foi aceita — a decisão não muda depois do estoque' }, 409)
+    }
+
+    const { data: itemRows, error: itemErr } = await db
+      .from('plg_fiscalbr_inbox_items')
+      .select('id, item_number, description, ean_barcode, supplier_product_code, ncm, cfop, unit_commercial, quantity_commercial, unit_price_commercial, total_price, unit_taxable, quantity_taxable, product_id, entry_type, chart_account_id, stock_unit_id, conversion_factor, cost_mode, shortage_quantity, shortage_reason, shortage_note, suggested_by')
+      .eq('inbox_document_id', documentId)
+      .order('item_number')
+    if (itemErr) throw itemErr
+
+    // Só o que falta decidir. «Reavaliar» acrescenta o que a MÁQUINA decidiu, e
+    // nunca o que uma pessoa escolheu: `suggested_by` nulo é escolha humana, e
+    // sobrescrevê-la seria desfazer trabalho.
+    const pendente = (r: Record<string, unknown>) =>
+      !r.entry_type
+      || (!['despesa', 'servico'].includes(String(r.entry_type)) && !r.product_id)
+    const alvo = (itemRows ?? []).filter((r) =>
+      pendente(r) || (reevaluate === true && r.suggested_by !== null))
+
+    if (alvo.length === 0) return json({ ok: true, applied: 0, bound: 0, warnings: [] })
+
+    const items = alvo.map((r) => ({
+      id: String(r.id),
+      itemNumber: Number(r.item_number ?? 0),
+      description: String(r.description ?? ''),
+      eanBarcode: (r.ean_barcode as string) ?? null,
+      supplierProductCode: String(r.supplier_product_code ?? ''),
+      ncm: (r.ncm as string) ?? null,
+      unit: (r.unit_commercial as string) ?? null,
+      quantity: Number(r.quantity_commercial ?? 0),
+      unitPrice: Number(r.unit_price_commercial ?? 0),
+      total: Number(r.total_price ?? 0),
+      unitTaxable: (r.unit_taxable as string) ?? null,
+      quantityTaxable: r.quantity_taxable == null ? null : Number(r.quantity_taxable),
+    }))
+
+    const [{ data: unitRows }, { data: accountRows }] = await Promise.all([
+      db.from('plg_inventory_measurement_units').select('id, name, abbreviation, is_base').eq('is_active', true),
+      db.from('plg_financial_chart_of_accounts').select('id, code, name, account_type, node_type, parent_id, is_active'),
+    ])
+
+    const units = (unitRows ?? []).map((u: Record<string, unknown>) => ({
+      id: String(u.id), name: String(u.name ?? ''),
+      abbreviation: String(u.abbreviation ?? ''), isBase: Boolean(u.is_base),
+    }))
+
+    // Folhas só, como `listChartAccounts` do cliente: um grupo não recebe
+    // lançamento, e oferecê-lo ao modelo é oferecer uma resposta que a RPC recusa.
+    const contas = (accountRows ?? []).filter((a: Record<string, unknown>) => a.is_active !== false)
+    const pais = new Set(contas.map((a) => a.parent_id).filter(Boolean).map(String))
+    const accounts = contas
+      .filter((a) => a.node_type !== 'group' && !pais.has(String(a.id)))
+      .map((a: Record<string, unknown>) => ({
+        id: String(a.id), code: String(a.code ?? ''), name: String(a.name ?? ''),
+        kind: (a.account_type as string) ?? null,
+      }))
+
+    // ── 1. O ÍNDICE PRIMEIRO (migration 012) ────────────────────────────────
+    const { data: matchRows, error: matchErr } = await db.rpc('fiscalbr_match_product_candidates', {
+      p_queries: items.map((i) => ({
+        ref: i.id, text: i.description, ean: i.eanBarcode, code: i.supplierProductCode || null,
+      })),
+      p_supplier_cnpj: doc.supplier_cnpj ?? null,
+      p_per_query: 8,
+    })
+    if (matchErr) throw matchErr
+
+    const porItem = new Map<string, Array<{ productId: string; name: string; sku: string | null; unit: string | null; reason: string }>>()
+    for (const m of (matchRows ?? []) as Record<string, unknown>[]) {
+      const ref = String(m.ref)
+      const lista = porItem.get(ref) ?? []
+      lista.push({
+        productId: String(m.product_id),
+        name: String(m.name ?? ''),
+        sku: (m.sku as string) ?? null,
+        unit: (m.unit as string) ?? null,
+        reason: String(m.reason),
+      })
+      porItem.set(ref, lista)
+    }
+
+    const warnings: string[] = []
+    const sugestoes = new Map<string, NoteItemSuggestion>()
+    const autoria = new Map<string, 'ai' | 'ean' | 'supplier_map'>()
+    const paraModelo: typeof items = []
+
+    for (const item of items) {
+      const exato = porItem.get(item.id)?.find((m) => m.reason !== 'text')
+      if (!exato) { paraModelo.push(item); continue }
+
+      // O VÍNCULO NÃO ESCAPA DA GUARDA DE EMBALAGEM. A igualdade resolve QUAL
+      // produto é, não QUANTO entra: um milheiro ligado pelo EAN com fator 1 põe
+      // mil peças no estoque como mil milheiros — o mesmo erro de 1.000x, por um
+      // caminho que não passa pelo modelo nem pelo `enforcePackagingFactor`.
+      // Mesma regra do `enforceFactorEvidence`: entre 1 e 1.000, o padrão é
+      // 1.000 — a palavra «milheiro» diz mil peças. Só o estoque em PESO escapa,
+      // porque quanto pesa um milheiro é outra pergunta.
+      const conteudo = packagingCount(item.unit)
+      const contaPeca = isCountingUnit(exato.unit)
+      const pesoConhecido = Boolean(exato.unit) && !contaPeca
+      if (conteudo && pesoConhecido) {
+        warnings.push(`«${item.description}» vem em ${item.unit} (${conteudo} por embalagem) e o estoque é em ${exato.unit}: confira o fator.`)
+      }
+      sugestoes.set(item.id, {
+        itemId: item.id,
+        // Sem tipo o item continua «falta decidir» e o vínculo não serviria de
+        // nada. Revenda é o que EAN e de-para quase sempre são.
+        entryType: 'revenda',
+        productId: exato.productId,
+        newProductName: null,
+        stockUnitId: units.find((u) =>
+          u.abbreviation.trim().toUpperCase() === (exato.unit ?? '').trim().toUpperCase())?.id ?? null,
+        conversionFactor: conteudo && !pesoConhecido ? conteudo : 1,
+        chartAccountId: null,
+        confidence: 1,
+      })
+      autoria.set(item.id, exato.reason === 'ean' ? 'ean' : 'supplier_map')
+    }
+
+    // ── 2. SÓ O QUE SOBROU VAI AO MODELO ────────────────────────────────────
+    const candidates: Record<string, SuggestionCandidate[]> = {}
+    for (const item of paraModelo) {
+      candidates[item.id] = (porItem.get(item.id) ?? [])
+        .filter((m) => m.reason === 'text')
+        .map((m) => ({ id: m.productId, name: m.name, sku: m.sku, unit: m.unit }))
+    }
+
+    const header = {
+      number: String(doc.nfe_number ?? ''),
+      supplierName: String(doc.supplier_name ?? ''),
+      natureOperation: (doc.nature_operation as string) ?? null,
+    }
+
+    if (paraModelo.length > 0) {
+      const lotes = splitToFit(
+        { items: paraModelo as never, candidates, accounts, units, note: header },
+        MESSAGE_BUDGET,
+      )
+      for (const book of lotes) {
+        const reply = await callModel(
+          `${SUGGESTION_PROMPT}\n\nDADOS:\n${buildSuggestionPayload(book, header)}`,
+        )
+        const lido = parseNoteSuggestionReply(reply, book)
+        const guardado = enforceFactorEvidence(lido, book.items, units)
+        for (const s of guardado.items) {
+          sugestoes.set(s.itemId, s)
+          autoria.set(s.itemId, 'ai')
+        }
+        warnings.push(...guardado.warnings)
+      }
+    }
+
+    const semSugestao = items.filter((i) => !sugestoes.has(i.id))
+    if (semSugestao.length) {
+      // Corte silencioso não existe: a tela precisa poder dizer quais linhas
+      // continuam vazias, senão «preenchi» vale por uma nota inteira.
+      warnings.push(
+        `${semSugestao.length} ${semSugestao.length === 1 ? 'item ficou' : 'itens ficaram'} sem sugestão: `
+        + semSugestao.slice(0, 3).map((i) => i.description).join(', ')
+        + (semSugestao.length > 3 ? '…' : ''),
+      )
+    }
+
+    if (sugestoes.size === 0) return json({ ok: true, applied: 0, bound: 0, warnings })
+
+    // ── 3. GRAVA PELO CAMINHO QUE JÁ EXISTE ─────────────────────────────────
+    // `fiscalbr_save_inbox_decision` não marca `reconciled` por conta própria:
+    // ela deriva de ter produto (ou de ser despesa/serviço), que é a mesma regra
+    // do «Salvar conciliação». Então persistir NÃO é aceitar — a pessoa ainda
+    // confere e clica em «Aceitar».
+    //
+    // Só os itens tocados entram no payload: mandar a nota inteira reescreveria
+    // decisão que uma pessoa tomou e que nada aqui examinou.
+    const herdaConta = (doc.default_chart_account_id as string) ?? null
+    const payload = [...sugestoes.values()].map((s) => {
+      const base = (itemRows ?? []).find((r) => String(r.id) === s.itemId) ?? {}
+      return {
+        id: s.itemId,
+        product_id: s.productId,
+        entry_type: s.entryType,
+        chart_account_id: s.chartAccountId ?? (base.chart_account_id as string) ?? herdaConta,
+        stock_unit_id: s.stockUnitId ?? (base.stock_unit_id as string) ?? null,
+        conversion_factor: s.conversionFactor,
+        cost_mode: (base.cost_mode as string) ?? 'novo',
+        suggested_by: autoria.get(s.itemId) ?? null,
+        suggestion_confidence: autoria.get(s.itemId) === 'ai' ? s.confidence : null,
+        shortage_quantity: base.shortage_quantity ?? null,
+        shortage_reason: base.shortage_reason ?? null,
+        shortage_note: base.shortage_note ?? null,
+      }
+    })
+
+    const { error: saveErr } = await db.rpc('fiscalbr_save_inbox_decision', {
+      p_document_id: documentId,
+      p_items: payload,
+      // Nulos de propósito: a RPC faz `coalesce`, então o padrão da nota e as
+      // parcelas ficam como estão. Sugerir não mexe em parcela.
+      p_default_chart_account_id: null,
+      p_default_location_id: null,
+      p_duplicates: null,
+    })
+    if (saveErr) throw saveErr
+
+    // O QUE CONTAR COMO «PREENCHIDO». Contar toda linha que o modelo tocou fazia
+    // a tela dizer «1 item preenchido» sobre uma linha que ficou com o tipo e sem
+    // produto — ou seja, ainda em «Falta decidir». Quem lê a frase e olha a linha
+    // vê a tela mentindo, e uma tela que mente sobre o próprio trabalho é pior
+    // que uma que não faz o trabalho.
+    const daIA = [...sugestoes.values()].filter((s) => autoria.get(s.itemId) === 'ai')
+    const comProduto = daIA.filter((s) => s.productId)
+    const semProdutoAgora = daIA.filter((s) => !s.productId)
+    return json({
+      ok: true,
+      /** Linhas que a IA deixou PRONTAS: com produto (ou que não precisam de um). */
+      applied: comProduto.length,
+      /** Linhas em que ela só soube dizer o tipo — continuam «falta decidir». */
+      typedOnly: semProdutoAgora.length,
+      bound: [...autoria.values()].filter((a) => a !== 'ai').length,
+      boundByEan: [...autoria.values()].filter((a) => a === 'ean').length,
+      /** O que a IA propõe cadastrar, na ordem das linhas que ficaram vazias. */
+      newProductNames: semProdutoAgora.map((s) => s.newProductName).filter(Boolean),
+      warnings,
+    })
+  } catch (e) {
+    // `42501` é a RLS fazendo o trabalho dela: quem chamou não alcança a tabela.
+    // Isso é 403 e não 500 — um 500 manda procurar defeito onde há regra.
+    const codigo = (e as { code?: string } | null)?.code
+    const msg = describe(e)
+    if (codigo === '42501' || /permission denied/i.test(msg)) {
+      return json({ ok: false, error: 'Sem permissão para esta nota.' }, 403)
+    }
+    return json({ ok: false, error: msg }, 500)
+  }
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fayz-ai/plugin-fiscal-br",
-  "version": "0.3.7",
+  "version": "0.4.1",
   "description": "[preview] Brazilian fiscal addon for asynchronous NFC-e emission through PlugNotas",
   "type": "module",
   "sideEffects": false,
@@ -14,7 +14,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "functions"
   ],
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -23,10 +24,10 @@
   },
   "dependencies": {
     "@tanstack/react-table": "^8.20.0",
-    "@fayz-ai/admin": "^0.35.0",
-    "@fayz-ai/core": "^0.35.0",
-    "@fayz-ai/plugin-financial": "^0.18.3",
-    "@fayz-ai/ui": "^0.35.0"
+    "@fayz-ai/admin": "^0.37.0",
+    "@fayz-ai/core": "^0.36.1",
+    "@fayz-ai/plugin-financial": "^0.20.0",
+    "@fayz-ai/ui": "^0.37.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",