next-finance-mcp 0.9.76 → 0.9.78

package/dist/client.d.ts

@@ -1019,6 +1019,42 @@ export interface ContatoDetalhado {
         valor?: number;
     }[];
 }
+/** Lista contratos da carteira (opcionalmente por pessoa). */
+export declare function listarContratos(o?: {
+    pessoa?: string;
+    pagina?: number;
+    limite?: number;
+}): Promise<{
+    contratos: Record<string, unknown>[];
+    pagina: number;
+}>;
+/** Detalha um contrato (valor, reajuste, parcelas, índice detectado no texto). */
+export declare function detalharContrato(o: {
+    numero?: number | string;
+    pessoa?: string;
+}): Promise<Record<string, unknown>>;
+/** Calcula o reajuste (sem gravar): índice acumulado 12m (BCB) × valor atual. */
+export declare function calcularReajusteContrato(o: {
+    numero?: number | string;
+    pessoa?: string;
+    indice?: string;
+    meses?: number;
+}): Promise<Record<string, unknown>>;
+/** Aplica o reajuste no contrato (PUT), acrescenta a nota no texto e, por padrão,
+ *  gera as parcelas (GerarFaturamento). Retorna o antes/depois. */
+export declare function reajustarContrato(o: {
+    numero?: number | string;
+    pessoa?: string;
+    indice?: string;
+    meses?: number;
+    responsavel?: string;
+    gerarParcelas?: boolean;
+}): Promise<Record<string, unknown>>;
+/** Gera (fatura) as parcelas do contrato — GerarFaturamento. */
+export declare function gerarParcelasContrato(o: {
+    numero?: number | string;
+    pessoa?: string;
+}): Promise<Record<string, unknown>>;
 /** Invalida o cache de pessoas (chamar após criar/editar contato). */
 export declare function invalidarCachePessoas(): void;
 export type ResultadoBuscaContato = {

package/dist/client.js

@@ -410,6 +410,45 @@ async function apiPost(path, body, retry = true) {
         return text;
     }
 }
+/** PUT JSON para a API REST — mesma máquina de auth/refresh do apiPost. */
+async function apiPut(path, body, retry = true) {
+    const auth = getAuthHeader();
+    const { statusCode, headers, body: resBody } = await reqWithTimeout(`${API_BASE}${path}`, {
+        method: "PUT",
+        headers: {
+            ...BASE_HEADERS, ...NEXT_BUSINESS_HEADERS, ...getApiKeyHeaders(),
+            Cookie: getCookieHeader("finance.net.br"),
+            "Content-Type": "application/json", Accept: "application/json",
+            ...(auth ? { Authorization: auth } : {}),
+        },
+        body: JSON.stringify(body),
+        dispatcher: agentFollow,
+    });
+    const setCookies = headers["set-cookie"];
+    storeCookies(Array.isArray(setCookies) ? setCookies : setCookies ? [setCookies] : [], "finance.net.br");
+    const text = await resBody.text();
+    if (isSessionExpired(statusCode, text)) {
+        if (retry && await recoverSession())
+            return apiPut(path, body, false);
+        throwSessionExpired();
+    }
+    if (retry && isCarteiraTokenExpired(statusCode, text)) {
+        if (await recoverSession())
+            return apiPut(path, body, false);
+        throw new Error("Não foi possível renovar o token da carteira no momento. Tente novamente em instantes.");
+    }
+    if (statusCode >= 400)
+        throw new Error(extrairMensagemApi(text) ?? `API PUT ${path}: ${statusCode}`);
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        const msg = extrairMensagemApi(text);
+        if (msg)
+            throw new Error(msg);
+        return text;
+    }
+}
 function extractCsrf(html) {
     return html.match(/name="__RequestVerificationToken"[^>]+value="([^"]+)"/)?.[1] ?? "";
 }
@@ -1016,7 +1055,7 @@ async function resolverIdPlanoDeContas(nome, contexto) {
     // Usa a lista COMPLETA (GET /api/PlanoDeContas, cacheada) — inclui despesa, receita
     // E transferência. O /Filtrar retorna só parte (ex: só receitas em algumas carteiras),
     // o que escondia planos de despesa como "Semanadas e Mesadas".
-    const termo = nome.trim().toLowerCase().replace(/^\[|\]$/g, "");
+    const termo = normalizar(nome.trim().replace(/^\[|\]$/g, "")); // sem acento/caixa
     const lista = await fetchPlanoDeContasCompleto();
     const nomeDe = nomePlano;
     const tipoDe = (p) => String(p["NomeTipoPlanoDeContas"] ?? "");
@@ -1031,13 +1070,13 @@ async function resolverIdPlanoDeContas(nome, contexto) {
             return t === "Despesa";
         return false;
     };
-    const matches = lista.filter(p => p["Ativo"] !== false && nomeDe(p).toLowerCase().includes(termo));
+    const matches = lista.filter(p => p["Ativo"] !== false && normalizar(nomeDe(p)).includes(termo));
     if (matches.length === 0) {
         throw new Error(`Plano de contas "${nome}" não encontrado (nem categoria, nem transferência entre contas).`);
     }
     const compat = matches.filter(p => !incompativel(p));
     // Match exato (inclui plano de transferência "[Conta]") de tipo compatível.
-    const exata = compat.find(p => nomeDe(p).toLowerCase() === termo);
+    const exata = compat.find(p => normalizar(nomeDe(p)) === termo);
     if (exata)
         return String(exata["Id"] ?? "");
     // Entre os compatíveis: categorias têm prioridade sobre transferência.
@@ -1123,11 +1162,11 @@ async function resolverPlanoTransferencia(nomeContaDestino) {
 async function resolverIdCentroDeCustos(nome) {
     const raw = await apiGet("/api/CentroDeCustos");
     const arr = Array.isArray(raw) ? raw : (Object.values(raw).find(v => Array.isArray(v)) ?? []);
-    const termo = nome.trim().toLowerCase();
-    const matches = arr.filter(c => String(c["Nome"] ?? c["Descricao"] ?? "").toLowerCase().includes(termo));
+    const termo = normalizar(nome.trim()); // sem acento/caixa
+    const matches = arr.filter(c => normalizar(String(c["Nome"] ?? c["Descricao"] ?? "")).includes(termo));
     if (matches.length === 0)
         throw new Error(`Centro de custo "${nome}" não encontrado.`);
-    const exata = matches.find(c => String(c["Nome"] ?? c["Descricao"] ?? "").toLowerCase() === termo);
+    const exata = matches.find(c => normalizar(String(c["Nome"] ?? c["Descricao"] ?? "")) === termo);
     const escolhido = exata ?? (matches.length === 1 ? matches[0] : null);
     if (!escolhido) {
         const nomes = matches.slice(0, 10).map(c => String(c["Nome"] ?? c["Descricao"] ?? "")).join(", ");
@@ -3871,6 +3910,212 @@ async function contratosDaPessoa(idPessoa) {
         return [];
     }
 }
+// ── Contratos (NEXT Business) — reajuste por índice + parcelas ────────────────
+// Índice de reajuste NÃO é campo do contrato no NEXT: fica no texto de
+// `InformacaoAdicional` ("Informações sobre o contrato"). O valor do índice vem
+// da API pública do Banco Central (SGS): IPCA=433, IGP-M=189.
+const SGS_SERIE = { IPCA: 433, IGPM: 189 };
+const MESES_PT = ["Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho", "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro"];
+const arred2 = (n) => Math.round(n * 100) / 100;
+const pctBR = (n) => n.toFixed(2).replace(".", ",");
+const dataBR = (d) => `${String(d.getDate()).padStart(2, "0")}/${String(d.getMonth() + 1).padStart(2, "0")}/${d.getFullYear()}`;
+/** Normaliza rótulo de índice para IPCA | IGPM. */
+function normalizarIndice(s) {
+    const t = normalizar(s ?? "");
+    if (/igp[\s-]?m|igpm/.test(t))
+        return "IGPM";
+    if (/ipca/.test(t))
+        return "IPCA";
+    return null;
+}
+/** Detecta o índice de reajuste no texto de "Informações sobre o contrato". */
+function detectarIndiceReajuste(texto) {
+    return normalizarIndice(texto);
+}
+/** Índice acumulado dos últimos `meses` (default 12) até o último mês fechado
+ *  antes de `ateData` (default hoje). Fonte: BCB SGS (público, sem chave). */
+async function indiceReajusteAcumulado(indice, meses = 12, ateData) {
+    const serie = SGS_SERIE[indice];
+    if (!serie)
+        throw new Error(`Índice "${indice}" não suportado (use IPCA ou IGPM).`);
+    const ref = ateData ?? new Date();
+    // Último mês fechado = mês anterior ao de referência. Puxa uma janela maior e pega os últimos N disponíveis.
+    const fimRef = new Date(ref.getFullYear(), ref.getMonth() - 1, 1);
+    const ini = new Date(fimRef.getFullYear(), fimRef.getMonth() - (meses + 2), 1);
+    const dd = (d, last = false) => {
+        const dia = last ? new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate() : 1;
+        return `${String(dia).padStart(2, "0")}/${String(d.getMonth() + 1).padStart(2, "0")}/${d.getFullYear()}`;
+    };
+    const url = `https://api.bcb.gov.br/dados/serie/bcdata.sgs.${serie}/dados?formato=json&dataInicial=${dd(ini)}&dataFinal=${dd(fimRef, true)}`;
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), 20000);
+    let arr;
+    try {
+        const resp = await fetch(url, { signal: ctrl.signal });
+        if (!resp.ok)
+            throw new Error(`Banco Central respondeu HTTP ${resp.status}`);
+        arr = await resp.json();
+    }
+    catch (e) {
+        throw new Error(`Não consegui consultar o ${indice} no Banco Central agora (${e?.message ?? e}). Tente de novo em instantes.`);
+    }
+    finally {
+        clearTimeout(t);
+    }
+    if (!Array.isArray(arr) || arr.length === 0)
+        throw new Error(`O Banco Central não retornou dados de ${indice} para o período.`);
+    const pts = arr.slice(-meses); // últimos N meses disponíveis (fechados)
+    let fator = 1;
+    const series = pts.map(x => { const v = parseFloat(x.valor); fator *= (1 + v / 100); return { mes: x.data.slice(3), valor: v }; });
+    const [mFim, aFim] = series[series.length - 1].mes.split("/");
+    return {
+        indice, percentual: (fator - 1) * 100, fator,
+        mesInicial: series[0].mes, mesFinal: series[series.length - 1].mes,
+        mesFinalLabel: `${MESES_PT[Number(mFim) - 1]}/${aFim}`,
+        series,
+    };
+}
+/** Localiza um contrato pelo número (e opcionalmente pessoa). Retorna o objeto COMPLETO do GET. */
+async function resolverContratoCompleto(o) {
+    const numero = o.numero != null && String(o.numero).trim() !== "" ? Number(String(o.numero).replace(/\D/g, "")) : undefined;
+    let idPessoa;
+    if (o.pessoa) {
+        try {
+            idPessoa = String((await resolverPessoa(o.pessoa))["Id"] ?? "");
+        }
+        catch { /* ignora */ }
+    }
+    // Pagina o Filtrar até achar o número (ou lista a 1ª página se só a pessoa foi dada).
+    let achado;
+    for (let pagina = 1; pagina <= 20 && !achado; pagina++) {
+        const raw = await apiPost("/api/Contrato/Filtrar", { NumeroPagina: pagina, TamanhoPagina: 50, Nome: o.pessoa ?? "", PessoaId: idPessoa ?? null });
+        const arr = (Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? []);
+        if (arr.length === 0)
+            break;
+        if (numero != null)
+            achado = arr.find(c => Number(c["Numero"]) === numero);
+        else if (arr.length === 1)
+            achado = arr[0];
+        if (arr.length < 50)
+            break;
+    }
+    if (!achado)
+        throw new Error(numero != null ? `Contrato número ${numero} não encontrado${o.pessoa ? ` para "${o.pessoa}"` : ""}.` : `Informe o número do contrato (não consegui identificar um único).`);
+    const id = String(achado["Id"] ?? "");
+    return await apiGet(`/api/Contrato/${encodeURIComponent(id)}`);
+}
+/** Versão exibível de um contrato (sem IDs internos). */
+function slimContrato(c) {
+    return {
+        numero: c["Numero"] != null ? Number(c["Numero"]) : undefined,
+        pessoa: c["PessoaNome"] ? String(c["PessoaNome"]).trim() : undefined,
+        valor: c["Valor"] != null ? Number(c["Valor"]) : undefined,
+        situacao: c["Situacao"] ? String(c["Situacao"]).trim() : undefined,
+        inicio: c["DataInicio"] ? String(c["DataInicio"]).slice(0, 10) : undefined,
+        fim: c["DataFim"] ? String(c["DataFim"]).slice(0, 10) : undefined,
+        reajuste_periodo: c["Reajuste"] != null ? `${c["Reajuste"]} ${c["ReajustePeriodo"] ?? ""}`.trim() : undefined,
+        reajuste_status: c["ReajusteStatus"] ? String(c["ReajusteStatus"]).trim() : undefined,
+        parcela_periodo: c["Parcela"] != null ? `${c["Parcela"]} ${c["ParcelaPeriodo"] ?? ""}`.trim() : undefined,
+        indice_detectado: detectarIndiceReajuste(c["InformacaoAdicional"]) ?? undefined,
+    };
+}
+/** Lista contratos da carteira (opcionalmente por pessoa). */
+export async function listarContratos(o = {}) {
+    const pagina = o.pagina ?? 1;
+    let idPessoa;
+    if (o.pessoa) {
+        try {
+            idPessoa = String((await resolverPessoa(o.pessoa))["Id"] ?? "");
+        }
+        catch { /* ignora */ }
+    }
+    const raw = await apiPost("/api/Contrato/Filtrar", { NumeroPagina: pagina, TamanhoPagina: o.limite ?? 50, Nome: o.pessoa ?? "", PessoaId: idPessoa ?? null });
+    const arr = (Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? []);
+    return { contratos: arr.map(slimContrato), pagina };
+}
+/** Detalha um contrato (valor, reajuste, parcelas, índice detectado no texto). */
+export async function detalharContrato(o) {
+    const c = await resolverContratoCompleto(o);
+    const slim = slimContrato(c);
+    slim["informacoes"] = c["InformacaoAdicional"] ? String(c["InformacaoAdicional"]).trim() : undefined;
+    return slim;
+}
+/** Calcula o reajuste (sem gravar): índice acumulado 12m (BCB) × valor atual. */
+export async function calcularReajusteContrato(o) {
+    const c = await resolverContratoCompleto(o);
+    const indice = normalizarIndice(o.indice) ?? detectarIndiceReajuste(c["InformacaoAdicional"]);
+    if (!indice) {
+        throw new Error(`Não identifiquei o índice (IPCA/IGPM) nas informações do contrato ${c["Numero"]}. Diga qual índice usar (ex.: "reajusta pelo IGPM").`);
+    }
+    const idx = await indiceReajusteAcumulado(indice, o.meses ?? 12);
+    const valorAtual = Number(c["Valor"] ?? 0);
+    const novoValor = arred2(valorAtual * idx.fator);
+    return {
+        contrato: Number(c["Numero"]),
+        pessoa: c["PessoaNome"] ? String(c["PessoaNome"]).trim() : undefined,
+        indice,
+        periodo: `${idx.mesInicial} a ${idx.mesFinal}`,
+        indice_referencia: idx.mesFinalLabel,
+        variacao_percent: arred2(idx.percentual),
+        valor_atual: valorAtual,
+        valor_novo: novoValor,
+        diferenca: arred2(novoValor - valorAtual),
+        observacao: "Cálculo apenas — nada foi gravado. Use reajustar_contrato para aplicar.",
+    };
+}
+// Campos SÓ de resposta (não devem voltar no PUT do contrato).
+const CONTRATO_CAMPOS_RESPOSTA = ["ContaNome", "TipoContratoNome", "PessoaNome", "ReajusteStatus", "PagamentoStatus", "PossuiAnexo"];
+/** Aplica o reajuste no contrato (PUT), acrescenta a nota no texto e, por padrão,
+ *  gera as parcelas (GerarFaturamento). Retorna o antes/depois. */
+export async function reajustarContrato(o) {
+    const c = await resolverContratoCompleto(o);
+    const indice = normalizarIndice(o.indice) ?? detectarIndiceReajuste(c["InformacaoAdicional"]);
+    if (!indice)
+        throw new Error(`Não identifiquei o índice (IPCA/IGPM) nas informações do contrato ${c["Numero"]}. Diga qual índice usar (ex.: "reajusta pelo IGPM").`);
+    const idx = await indiceReajusteAcumulado(indice, o.meses ?? 12);
+    const valorAtual = Number(c["Valor"] ?? 0);
+    const novoValor = arred2(valorAtual * idx.fator);
+    // Eco do próprio objeto do GET (remove campos de resposta), mutando só valor/serviços/nota.
+    const body = { ...c };
+    for (const k of CONTRATO_CAMPOS_RESPOSTA)
+        delete body[k];
+    body["Valor"] = novoValor;
+    if (Array.isArray(body["ContratoServico"])) {
+        body["ContratoServico"] = body["ContratoServico"].map(s => ({
+            ...s,
+            Valor: s["Valor"] != null ? arred2(Number(s["Valor"]) * idx.fator) : s["Valor"],
+            ValorTotal: s["ValorTotal"] != null ? arred2(Number(s["ValorTotal"]) * idx.fator) : s["ValorTotal"],
+        }));
+    }
+    const nota = `Contrato reajustado dia ${dataBR(new Date())}, com Variação ${indice} ${pctBR(idx.percentual)}% (Indice de ${idx.mesFinalLabel}).${o.responsavel ? ` P/${o.responsavel}` : ""}`;
+    const infoAtual = c["InformacaoAdicional"] ? String(c["InformacaoAdicional"]).replace(/\s+$/, "") : "";
+    body["InformacaoAdicional"] = infoAtual ? `${infoAtual}\n\n${nota}` : nota;
+    await apiPut(`/api/Contrato/${encodeURIComponent(String(c["Id"]))}`, body);
+    // Gera as parcelas no valor novo (padrão true).
+    let parcelasGeradas = false;
+    if (o.gerarParcelas !== false) {
+        try {
+            await apiGet(`/api/Contrato/GerarFaturamento/${encodeURIComponent(String(c["Id"]))}`);
+            parcelasGeradas = true;
+        }
+        catch { /* faturamento pode ser feito depois com gerar_parcelas_contrato */ }
+    }
+    return {
+        sucesso: true,
+        contrato: Number(c["Numero"]),
+        pessoa: c["PessoaNome"] ? String(c["PessoaNome"]).trim() : undefined,
+        indice, indice_referencia: idx.mesFinalLabel, variacao_percent: arred2(idx.percentual),
+        valor_anterior: valorAtual, valor_novo: novoValor,
+        parcelas_geradas: parcelasGeradas,
+        nota_adicionada: nota,
+    };
+}
+/** Gera (fatura) as parcelas do contrato — GerarFaturamento. */
+export async function gerarParcelasContrato(o) {
+    const c = await resolverContratoCompleto(o);
+    await apiGet(`/api/Contrato/GerarFaturamento/${encodeURIComponent(String(c["Id"]))}`);
+    return { sucesso: true, contrato: Number(c["Numero"]), mensagem: "Faturamento gerado — as parcelas 'A RECEBER' foram criadas/atualizadas." };
+}
 /** Monta a ficha completa de um contato a partir do registro slim (precisa do Id). */
 async function detalharContato(p) {
     const id = String(p["Id"] ?? "");

package/dist/http-index.js

@@ -27,7 +27,7 @@ import * as client from "./client.js";
 import { createCtx, runInCtx, enterDefaultCtx } from "./context.js";
 import { toolDefinitions, handleTool, ok, SOFIA_INSTRUCTIONS } from "./tools.js";
 import { TenantStoreEnv } from "./tenant-store.js";
-const VERSION = "0.9.76";
+const VERSION = "0.9.78";
 // Contexto default (fallback do ALS). No HTTP cada request roda em runInCtx().
 enterDefaultCtx();
 // Multi-tenant: NUNCA persistir sessão no disco compartilhado do container.

package/dist/index.js

@@ -13,7 +13,7 @@ import { openLoginUI } from "./login-server.js";
 import { toolDefinitions, handleTool, ok, SOFIA_INSTRUCTIONS } from "./tools.js";
 // Modo stdio: ativa um contexto único global no startup. Multi-tenancy só no modo HTTP.
 enterDefaultCtx();
-const VERSION = "0.9.76";
+const VERSION = "0.9.78";
 const server = new Server({ name: "SofIA", version: VERSION }, {
     capabilities: { tools: {} },
     instructions: SOFIA_INSTRUCTIONS,