@comando.one/mcp-server 0.5.0 → 0.5.1

package/dist/index.js

@@ -2038,7 +2038,8 @@ var OPENAPI_SPEC = {
         tags: ["Contratos"],
         summary: "Gerar as faturas devidas do contrato",
         operationId: "generateContractInvoices",
-        description: "Gera as faturas em aberto do contrato conforme a periodicidade dele. A regra de compet\xEAncia (e a prote\xE7\xE3o contra duplicar fatura do mesmo per\xEDodo) \xE9 da rotina de gera\xE7\xE3o, n\xE3o deste endpoint.",
+        description: "Gera fatura do contrato. Por padr\xE3o (mode=extra) cria uma fatura AVULSA fora do ciclo: n\xE3o avan\xE7a o agendamento, ent\xE3o chamar duas vezes gera DUAS faturas. Use mode=cycle para antecipar a fatura do ciclo corrente \u2014 \xE9 esse modo que avan\xE7a next_generation_date e evita duplicar a compet\xEAncia. mode=skip pula o ciclo sem gerar nada. Contrato cancelado ou suspenso \xE9 recusado.",
+        requestBody: { required: false, content: { "application/json": { schema: { type: "object", properties: { mode: { type: "string", enum: ["extra", "cycle", "skip"], default: "extra", description: "extra = avulsa (repet\xEDvel) \xB7 cycle = fatura do ciclo, avan\xE7a o agendamento \xB7 skip = s\xF3 avan\xE7a" } } } } } },
         security: [{ ApiKeyAuth: ["invoices:create"] }],
         responses: {
           "200": {
@@ -2510,6 +2511,7 @@ var OPENAPI_SPEC = {
           { name: "include_shared", in: "query", schema: { type: "boolean", default: true }, description: "Incluir clientes compartilhados" },
           { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "search", in: "query", schema: { type: "string" } },
+          { name: "company_id", in: "query", schema: { type: "string", format: "uuid" }, description: "Restringe a UMA empresa: a sua, ou a dona de um cliente compartilhado. Aplicado SOBRE o escopo permitido \u2014 nunca amplia acesso." },
           { name: "query", in: "query", schema: { type: "string" }, description: "Apelido de 'search' \u2014 o c\xF3digo j\xE1 aceitava os dois nomes; agora est\xE1 documentado." }
         ],
         responses: { "200": { description: "Faturas em atraso + a\xE7\xF5es recomendadas", content: { "application/json": { schema: { type: "object", properties: {
@@ -2520,6 +2522,8 @@ var OPENAPI_SPEC = {
           total_invoiced_amount: { type: "number", description: "Soma do valor cheio das mesmas faturas, ignorando pagamentos parciais." },
           actions: { type: "array", items: { type: "object", properties: {
             invoice_id: { type: "string", format: "uuid" },
+            company_id: { type: "string", format: "uuid", description: "Empresa DONA da fatura. Com clientes compartilhados a lista mistura empresas; sem este campo n\xE3o d\xE1 para saber de quem \xE9 cada linha." },
+            company_name: { type: "string", nullable: true },
             invoice_number: { type: "string", nullable: true },
             title: { type: "string", nullable: true },
             customer_id: { type: "string", format: "uuid" },
@@ -3759,6 +3763,27 @@ function buildCuratedTools(api, heldScopes) {
 
 // src/tools/request.ts
 var METHODS = ["GET", "POST", "PATCH", "PUT", "DELETE"];
+var ROTAS_DESTRUTIVAS = (() => {
+  const out = [];
+  for (const entry of MANIFEST) {
+    if (!entry.destructive) continue;
+    let desc;
+    try {
+      desc = describeOperation(entry.operationId);
+    } catch {
+      continue;
+    }
+    const padrao = desc.pathTemplate.split("/").map(
+      (seg) => seg.startsWith("{") && seg.endsWith("}") ? "[^/]+" : seg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+    ).join("/");
+    out.push({ method: desc.method.toUpperCase(), re: new RegExp(`^${padrao}/?$`) });
+  }
+  return out;
+})();
+function ehRotaDestrutiva(method, path) {
+  const semQuery = path.split("?")[0];
+  return ROTAS_DESTRUTIVAS.some((r) => r.method === method.toUpperCase() && r.re.test(semQuery));
+}
 function buildRequestTool(api) {
   return {
     name: "comando_request",
@@ -3782,7 +3807,7 @@ function buildRequestTool(api) {
         company_id: { type: "string", description: "Opcional: UUID da empresa (header X-Company-Id)." },
         idempotency_key: { type: "string", description: "Opcional: chave de idempot\xEAncia (POST)." },
         dry_run: { type: "boolean", description: "Se true, n\xE3o executa \u2014 s\xF3 mostra o que seria enviado." },
-        confirm: { type: "boolean", description: "Obrigat\xF3rio para DELETE: confirma a exclus\xE3o." }
+        confirm: { type: "boolean", description: "Obrigat\xF3rio para DELETE e para qualquer rota destrutiva (cancelar, estornar, pagar, reverter)." }
       }
     },
     handler: async (args) => {
@@ -3791,13 +3816,13 @@ function buildRequestTool(api) {
         if (!METHODS.includes(method)) {
           return fail(`M\xE9todo inv\xE1lido: ${args.method}. Use um de: ${METHODS.join(", ")}.`);
         }
-        if (method === "DELETE" && args.confirm !== true && args.dry_run !== true) {
+        let path = String(args.path ?? "");
+        if (!path.startsWith("/")) return fail("path deve come\xE7ar com / (ex.: /customers).");
+        if ((method === "DELETE" || ehRotaDestrutiva(method, path)) && args.confirm !== true && args.dry_run !== true) {
           return fail(
             "A\xE7\xE3o destrutiva bloqueada. Passe confirm: true para executar, ou dry_run: true para pr\xE9-visualizar."
           );
         }
-        let path = String(args.path ?? "");
-        if (!path.startsWith("/")) return fail("path deve come\xE7ar com / (ex.: /customers).");
         const queryArg = coerceObjectArg(args.query);
         if (queryArg) {
           const u = new URLSearchParams();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comando.one/mcp-server",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando.One — opere seu ERP por linguagem natural.",
   "type": "module",
   "license": "MIT",