beplus-mcp 0.13.0 → 0.14.0

package/dist/index.js

@@ -215,6 +215,10 @@ var TEAM_GATING_NOTE = " \u26A0\uFE0F DESTINO DA GERA\xC7\xC3O: toda imagem/v\xE
 function isTeamGatingError(msg) {
   return !!msg && /cliente e um projeto|selecione um cliente|sem cliente vinculado|antes de gerar/i.test(msg);
 }
+function isBudgetBlockedError(msg) {
+  return !!msg && /budget/i.test(msg);
+}
+var BUDGET_BLOCKED_GUIDANCE = "\u{1F4A1} O pote deste projeto/cliente acabou. Um admin pode recarregar em Admin \u2192 IA Lab \u2192 Projetos/Clientes. Alternativa: trocar o projeto ativo com `set_active_project`.";
 async function buildPickProjectMessage(client) {
   let clientsTxt = "  (n\xE3o foi poss\xEDvel listar clientes)";
   let projectsTxt = "  (n\xE3o foi poss\xEDvel listar projetos)";
@@ -401,6 +405,16 @@ function weeklyAllowanceLine(wa) {
   }
   return line;
 }
+function budgetLine(b) {
+  if (!b || !b.enabled) return "";
+  const scope = b.scope === "client" ? "cliente" : "projeto";
+  const pct = b.percentUsed;
+  const exhausted = pct >= 100 || b.remainingDiamonds <= 0;
+  const icon = exhausted ? "\u{1F6D1}" : pct >= 80 ? "\u26A0\uFE0F" : "\u{1F9FE}";
+  let line = `${icon} Budget do ${scope}: ${b.remainingDiamonds} de ${b.quotaDiamonds}\u{1F48E} restantes (${pct}% usado)`;
+  if (exhausted) line += " \u2014 pe\xE7a a um admin para recarregar";
+  return line;
+}
 function textResult(s) {
   return { content: [{ type: "text", text: s }] };
 }
@@ -423,10 +437,16 @@ function costFooter(start, cfg) {
     footer = `\u26A0 Custo alto (${start.diamond_cost} \u{1F48E})
 ${footer}`;
   }
+  const budget = budgetLine(start.budget);
   if (start.project_code) {
-    const proj = `\u{1F4C1} Projeto: ${start.project_code}${start.project_name ? ` \u2014 ${start.project_name}` : ""}`;
+    let proj = `\u{1F4C1} Projeto: ${start.project_code}${start.project_name ? ` \u2014 ${start.project_name}` : ""}`;
+    if (budget) proj = `${proj}
+${budget}`;
     footer = footer ? `${proj}
 ${footer}` : proj;
+  } else if (budget) {
+    footer = footer ? `${budget}
+${footer}` : budget;
   }
   const wa = weeklyAllowanceLine(start.weekly_allowance);
   if (wa) footer = footer ? `${footer}
@@ -664,6 +684,10 @@ ${footer}` }, ...blocks]
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -721,6 +745,10 @@ ${footer}` }, ...blocks] };
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -813,6 +841,10 @@ ${footer}`);
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -990,15 +1022,21 @@ function registerAudioTools(server, client, cfg) {
         const projLine = res.project_code ? `
 \u{1F4C1} Projeto: ${res.project_code}${res.project_name ? ` \u2014 ${res.project_name}` : ""}` : "";
         const wa = weeklyAllowanceLine(res.weekly_allowance);
+        const budget = budgetLine(res.budget);
         return textResult(
           `\u2705 \xC1udio gerado (${res.model}, voz ${res.voice}, ${res.duration_sec.toFixed(1)}s).
 ${res.url}
-${parts.join(" \xB7 ")}${projLine}` + (wa ? `
+${parts.join(" \xB7 ")}${projLine}` + (budget ? `
+${budget}` : "") + (wa ? `
 ${wa}` : "")
         );
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -1082,6 +1120,10 @@ ${footer}`);
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -1102,10 +1144,12 @@ function registerAccountTools(server, client, _cfg) {
       try {
         const me = await client.me();
         const wa = weeklyAllowanceLine(me.weekly_allowance);
+        const budget = budgetLine(me.budget);
         return textResult(
           `\u{1F464} ${me.name ?? "(sem nome)"} <${me.email ?? "sem email"}>
 Saldo: ${me.diamonds} \u{1F48E} \xB7 auth: ${me.authType}` + (wa ? `
-${wa}` : "")
+${wa}` : "") + (budget ? `
+${budget}` : "")
         );
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
@@ -1123,8 +1167,12 @@ ${wa}` : "")
       try {
         const b = await client.balance();
         const wa = weeklyAllowanceLine(b.weekly_allowance);
-        return textResult(`Saldo: ${b.diamonds} \u{1F48E}` + (wa ? `
-${wa}` : ""));
+        const budget = budgetLine(b.budget);
+        return textResult(
+          `Saldo: ${b.diamonds} \u{1F48E}` + (wa ? `
+${wa}` : "") + (budget ? `
+${budget}` : "")
+        );
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
       }
@@ -1242,7 +1290,8 @@ function projectLine(p, active) {
   const marker = active ? "\u25CF " : "\u25CB ";
   const counts = `${p.generation_count ?? 0} gera\xE7\xF5es`;
   const owner = p.client_name ? ` \xB7 cliente: ${p.client_name}` : "";
-  return `${marker}${p.code} \u2014 ${p.name} (${counts}${owner})`;
+  const budget = p.budget?.enabled ? ` \xB7 budget ${p.budget.remainingDiamonds}/${p.budget.quotaDiamonds}\u{1F48E}` : "";
+  return `${marker}${p.code} \u2014 ${p.name} (${counts}${owner})${budget}`;
 }
 function registerProjectTools(server, client, _cfg) {
   server.registerTool(
@@ -1262,7 +1311,10 @@ function registerProjectTools(server, client, _cfg) {
         }
         const lines = projects.map((p) => projectLine(p, !!p.is_active_for_user));
         const active = projects.find((p) => p.is_active_for_user);
-        const header = active ? `Projeto ativo: ${active.code} \u2014 ${active.name}` : "Nenhum projeto ativo (gera\xE7\xF5es ficam sem projeto).";
+        let header = active ? `Projeto ativo: ${active.code} \u2014 ${active.name}` : "Nenhum projeto ativo (gera\xE7\xF5es ficam sem projeto).";
+        const activeBudget = budgetLine(active?.budget);
+        if (activeBudget) header += `
+${activeBudget}`;
         return textResult(`${header}
 
 ${lines.join("\n")}`);
@@ -1313,7 +1365,9 @@ ${lines.join("\n")}`);
       try {
         const { project: active } = await client.setActiveProject(project ?? null);
         if (!active) return textResult("\u2705 Projeto ativo removido \u2014 novas gera\xE7\xF5es ficar\xE3o sem projeto.");
-        return textResult(`\u2705 Projeto ativo: ${active.code} \u2014 ${active.name}.`);
+        const budget = budgetLine(active.budget);
+        return textResult(`\u2705 Projeto ativo: ${active.code} \u2014 ${active.name}.` + (budget ? `
+${budget}` : ""));
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beplus-mcp",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Conector MCP da equipe BePlus — gere imagens/vídeos/áudio e consulte calls, projetos e clientes pela sua conta BePlus (diamantes, limites e histórico aplicados pela plataforma).",
   "type": "module",
   "bin": {