@comando.one/mcp-server 0.3.2 → 0.4.0

package/dist/index.js

@@ -172,6 +172,7 @@ var MANIFEST = [
   { operationId: "getPurchaseInvoice", tool: "purchase_invoices_get" },
   { operationId: "createPurchaseInvoice", tool: "purchase_invoices_create", write: true },
   { operationId: "cancelPurchaseInvoice", tool: "purchase_invoices_cancel", write: true, destructive: true },
+  { operationId: "deletePurchaseInvoice", tool: "purchase_invoices_delete", write: true, destructive: true },
   // ----- Despesas & Serviços -----
   { operationId: "listExpenses", tool: "expenses_list" },
   { operationId: "createExpense", tool: "expenses_create", write: true },
@@ -834,10 +835,32 @@ var SCHEMAS = {
             description: { type: "string" },
             amount: { type: "number" },
             due_date: { type: "string", format: "date" },
-            payment_status: { type: "string", enum: ["pendente", "parcial", "pago", "vencido"], default: "pendente" }
+            payment_status: { type: "string", enum: ["pendente", "parcial", "pago", "vencido"], default: "pendente" },
+            boleto_barcode: { type: "string", description: "Linha digit\xE1vel / c\xF3digo de barras do boleto (s\xF3 d\xEDgitos)." },
+            pix_key: { type: "string" },
+            pix_copia_e_cola: { type: "string" }
           }
         }
       },
+      items: {
+        type: "array",
+        description: "Itens da fatura. Se omitido, o valor de 'amount' vira um item \xFAnico \u2014 a fatura n\xE3o pode ficar sem item (o formul\xE1rio do app n\xE3o salva assim).",
+        items: {
+          type: "object",
+          required: ["name"],
+          properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            unit: { type: "string", default: "un" },
+            quantity: { type: "number", default: 1 },
+            unit_price: { type: "number" },
+            subtotal: { type: "number", description: "Calculado de quantity \xD7 unit_price quando omitido." }
+          }
+        }
+      },
+      title: { type: "string", description: "Descri\xE7\xE3o da fatura; vira o nome do item quando 'items' n\xE3o \xE9 informado." },
+      digitable_line: { type: "string", description: "Atalho: grava o boleto na parcela \xFAnica criada por 'due_date'." },
+      pix_key: { type: "string", description: "Atalho: grava a chave Pix na parcela \xFAnica." },
       notes: { type: "string" }
     }
   },
@@ -2643,6 +2666,14 @@ var OPENAPI_SPEC = {
         operationId: "getPurchaseInvoice",
         security: [{ ApiKeyAuth: ["purchase_invoices:read"] }],
         responses: { "200": { description: "Conta a pagar", content: { "application/json": { schema: { $ref: "#/components/schemas/PurchaseInvoice" } } } }, "404": errorResponse("Conta a pagar n\xE3o encontrada"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Contas a Pagar"],
+        summary: "Excluir conta a pagar",
+        operationId: "deletePurchaseInvoice",
+        description: "Exclus\xE3o definitiva. Recusa (409) contas com pagamento registrado ou parcela paga \u2014 nesses casos use o cancelamento, que preserva o hist\xF3rico.",
+        security: [{ ApiKeyAuth: ["purchase_invoices:delete"] }],
+        responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Conta a pagar n\xE3o encontrada"), "409": errorResponse("H\xE1 pagamento registrado ou registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
       }
     },
     "/purchase-invoices/{id}/cancel": {
@@ -3233,7 +3264,8 @@ var API_MODULES = [
     permissions: [
       { key: "read", label: "Listar e visualizar", description: "Consultar contas a pagar" },
       { key: "create", label: "Criar", description: "Lan\xE7ar contas a pagar" },
-      { key: "cancel", label: "Cancelar", description: "Cancelar contas a pagar" }
+      { key: "cancel", label: "Cancelar", description: "Cancelar contas a pagar" },
+      { key: "delete", label: "Excluir", description: "Excluir contas a pagar definitivamente" }
     ]
   },
   {
@@ -3358,7 +3390,9 @@ function describeOperation(operationId) {
     const d = declaredByName.get(name);
     properties[name] = {
       ...d?.schema ?? { type: "string" },
-      description: d?.description ?? `Identificador (${name}).`
+      description: d?.description ?? // Sem dizer que é UUID, o planner manda o identificador humano que tem em mãos
+      // (o número da nota) e a chamada morre. Observado em 2026-08-24.
+      `UUID do registro (${name}). Obtenha em uma listagem ou consulta \u2014 N\xC3O \xE9 n\xFAmero, c\xF3digo ou nome.`
     };
     required.push(name);
   }
@@ -3399,6 +3433,7 @@ function describeOperation(operationId) {
     scopes: extractScopes(operation),
     inputSchema,
     summary: operation.summary,
+    description: operation.description,
     description: operation.description
   };
 }

package/package.json

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