@comando.one/mcp-server 0.9.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +137 -6
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -278,6 +278,15 @@ var MANIFEST = [
278
278
  { operationId: "deleteFinancialMovement", tool: "finance_delete_movement", write: true, destructive: true },
279
279
  // Módulos operacionais que tinham tela e nenhuma exposição (COBERTURA.md item 1).
280
280
  // Somente leitura — escrever em conciliação/cartão/DDA mexe em dinheiro e entra depois.
281
+ { operationId: "updateInboxMessageStatus", tool: "inbox_messages_update_status", write: true },
282
+ { operationId: "deleteReconciliationMatch", tool: "reconciliation_unmatch", write: true, destructive: true },
283
+ { operationId: "triageDdaBoleto", tool: "dda_boletos_triage", write: true },
284
+ { operationId: "updateRecurringExpenseStatus", tool: "recurring_expenses_set_status", write: true },
285
+ { operationId: "updateRecurringPurchaseInvoiceStatus", tool: "recurring_purchase_invoices_set_status", write: true },
286
+ { operationId: "updateNotificationRead", tool: "notifications_mark_read", write: true },
287
+ { operationId: "createInsumo", tool: "insumos_create", write: true },
288
+ { operationId: "updateInsumo", tool: "insumos_update", write: true },
289
+ { operationId: "deleteInsumo", tool: "insumos_delete", write: true, destructive: true },
281
290
  { operationId: "listInboxMessages", tool: "inbox_messages_list" },
282
291
  { operationId: "getInboxMessage", tool: "inbox_messages_get" },
283
292
  { operationId: "listInboxDocuments", tool: "inbox_documents_list" },
@@ -1153,6 +1162,17 @@ var SCHEMAS = {
1153
1162
  updated_at: { type: "string", format: "date-time" }
1154
1163
  }
1155
1164
  },
1165
+ InsumoWrite: {
1166
+ type: "object",
1167
+ required: ["name"],
1168
+ properties: {
1169
+ name: { type: "string" },
1170
+ description: { type: "string" },
1171
+ unit: { type: "string", default: "un" },
1172
+ unit_price: { type: "number" },
1173
+ active: { type: "boolean", default: true }
1174
+ }
1175
+ },
1156
1176
  Insumo: {
1157
1177
  type: "object",
1158
1178
  properties: {
@@ -3503,6 +3523,87 @@ var OPENAPI_SPEC = {
3503
3523
  // -----------------------------------------------------------------------
3504
3524
  // Contas bancárias (read-only)
3505
3525
  // -----------------------------------------------------------------------
3526
+ "/inbox/messages/{id}/status": {
3527
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3528
+ patch: {
3529
+ tags: ["Caixa de Entrada"],
3530
+ summary: "Reprocessar ou arquivar mensagem",
3531
+ operationId: "updateInboxMessageStatus",
3532
+ description: "`recebido` devolve a mensagem ao processamento (limpando o erro anterior); `ignorado` a arquiva. Os demais estados s\xE3o escritos pelo processamento, n\xE3o pelo cliente.",
3533
+ security: [{ ApiKeyAuth: ["inbox:update"] }],
3534
+ requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["status"], properties: {
3535
+ status: { type: "string", enum: ["recebido", "ignorado"] }
3536
+ } } } } },
3537
+ responses: { "200": { description: "Mensagem atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/InboxMessage" } } } }, "404": errorResponse("Mensagem n\xE3o encontrada"), ...COMMON_ERRORS }
3538
+ }
3539
+ },
3540
+ "/reconciliation/matches/{id}": {
3541
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3542
+ delete: {
3543
+ tags: ["Concilia\xE7\xE3o"],
3544
+ summary: "Desfazer uma concilia\xE7\xE3o",
3545
+ operationId: "deleteReconciliationMatch",
3546
+ description: "Desconcilia o lan\xE7amento, pela mesma rotina que o bot\xE3o da tela usa. CONCILIAR n\xE3o \xE9 exposto na API: depende de a\xE7\xE3o/alvo/payload e merece desenho pr\xF3prio.",
3547
+ security: [{ ApiKeyAuth: ["reconciliation:write"] }],
3548
+ responses: { "200": { description: "Desconciliado", content: { "application/json": { schema: { type: "object", properties: { ok: { type: "boolean" }, match_id: { type: "string", format: "uuid" }, desconciliado: { type: "boolean" } } } } } }, "404": errorResponse("Concilia\xE7\xE3o n\xE3o encontrada"), ...COMMON_ERRORS }
3549
+ }
3550
+ },
3551
+ "/dda-boletos/{id}/triage": {
3552
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3553
+ post: {
3554
+ tags: ["DDA"],
3555
+ summary: "Arquivar ou reabrir boleto do DDA",
3556
+ operationId: "triageDdaBoleto",
3557
+ description: "`ignore` arquiva; `reopen` devolve \xE0 fila. As a\xE7\xF5es que criam ou vinculam documento (conta a pagar, fatura de cart\xE3o) e o bloqueio de benefici\xE1rio ficam no aplicativo \u2014 registram quem fez, e uma chave de API n\xE3o tem usu\xE1rio.",
3558
+ security: [{ ApiKeyAuth: ["dda:triage"] }],
3559
+ requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["action"], properties: {
3560
+ action: { type: "string", enum: ["ignore", "reopen"] },
3561
+ note: { type: "string", description: "Observa\xE7\xE3o da triagem (s\xF3 em `ignore`)." }
3562
+ } } } } },
3563
+ responses: { "200": { description: "Boleto triado", content: { "application/json": { schema: { $ref: "#/components/schemas/DdaBoleto" } } } }, "404": errorResponse("Boleto n\xE3o encontrado"), ...COMMON_ERRORS }
3564
+ }
3565
+ },
3566
+ "/recurring-expenses/{id}/status": {
3567
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3568
+ patch: {
3569
+ tags: ["Recorrentes"],
3570
+ summary: "Pausar ou retomar despesa recorrente",
3571
+ operationId: "updateRecurringExpenseStatus",
3572
+ description: "S\xF3 `ativo` \u2194 `pausado`. Regra `finalizado` \xE9 terminal: n\xE3o volta a gerar documentos, e reativar seria ressuscitar um ciclo encerrado \u2014 crie uma regra nova.",
3573
+ security: [{ ApiKeyAuth: ["recurring:update"] }],
3574
+ requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["status"], properties: {
3575
+ status: { type: "string", enum: ["ativo", "pausado"] }
3576
+ } } } } },
3577
+ responses: { "200": { description: "Regra atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/RecurringExpense" } } } }, "409": errorResponse("Regra finalizada"), "404": errorResponse("Regra n\xE3o encontrada"), ...COMMON_ERRORS }
3578
+ }
3579
+ },
3580
+ "/recurring-purchase-invoices/{id}/status": {
3581
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3582
+ patch: {
3583
+ tags: ["Recorrentes"],
3584
+ summary: "Pausar ou retomar conta a pagar recorrente",
3585
+ operationId: "updateRecurringPurchaseInvoiceStatus",
3586
+ description: "S\xF3 `ativo` \u2194 `pausado`; `finalizado` \xE9 terminal.",
3587
+ security: [{ ApiKeyAuth: ["recurring:update"] }],
3588
+ requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["status"], properties: {
3589
+ status: { type: "string", enum: ["ativo", "pausado"] }
3590
+ } } } } },
3591
+ responses: { "200": { description: "Regra atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/RecurringPurchaseInvoice" } } } }, "409": errorResponse("Regra finalizada"), "404": errorResponse("Regra n\xE3o encontrada"), ...COMMON_ERRORS }
3592
+ }
3593
+ },
3594
+ "/notifications/{id}/read": {
3595
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3596
+ patch: {
3597
+ tags: ["Notifica\xE7\xF5es"],
3598
+ summary: "Marcar notifica\xE7\xE3o como lida",
3599
+ operationId: "updateNotificationRead",
3600
+ security: [{ ApiKeyAuth: ["notifications:update"] }],
3601
+ requestBody: { required: false, content: { "application/json": { schema: { type: "object", properties: {
3602
+ read: { type: "boolean", default: true, description: "`false` marca como N\xC3O lida." }
3603
+ } } } } },
3604
+ responses: { "200": { description: "Notifica\xE7\xE3o atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Notification" } } } }, "404": errorResponse("Notifica\xE7\xE3o n\xE3o encontrada"), ...COMMON_ERRORS }
3605
+ }
3606
+ },
3506
3607
  "/inbox/messages": {
3507
3608
  get: {
3508
3609
  tags: ["Caixa de Entrada"],
@@ -3733,6 +3834,14 @@ var OPENAPI_SPEC = {
3733
3834
  { name: "active", in: "query", description: "Somente ativos (true) ou inativos (false).", schema: { type: "string", enum: ["true", "false"] } }
3734
3835
  ],
3735
3836
  responses: { "200": paginatedResponse("#/components/schemas/Insumo"), ...COMMON_ERRORS }
3837
+ },
3838
+ post: {
3839
+ tags: ["Insumos"],
3840
+ summary: "Criar insumo",
3841
+ operationId: "createInsumo",
3842
+ security: [{ ApiKeyAuth: ["insumos:write"] }],
3843
+ requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InsumoWrite" } } } },
3844
+ responses: { "201": { description: "Insumo criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Insumo" } } } }, ...COMMON_ERRORS }
3736
3845
  }
3737
3846
  },
3738
3847
  "/insumos/{id}": {
@@ -3743,6 +3852,21 @@ var OPENAPI_SPEC = {
3743
3852
  operationId: "getInsumo",
3744
3853
  security: [{ ApiKeyAuth: ["insumos:read"] }],
3745
3854
  responses: { "200": { description: "Insumo", content: { "application/json": { schema: { $ref: "#/components/schemas/Insumo" } } } }, "404": errorResponse("Insumo n\xE3o encontrado"), ...COMMON_ERRORS }
3855
+ },
3856
+ patch: {
3857
+ tags: ["Insumos"],
3858
+ summary: "Editar insumo",
3859
+ operationId: "updateInsumo",
3860
+ security: [{ ApiKeyAuth: ["insumos:write"] }],
3861
+ requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InsumoWrite" } } } },
3862
+ responses: { "200": { description: "Insumo atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Insumo" } } } }, "404": errorResponse("Insumo n\xE3o encontrado"), ...COMMON_ERRORS }
3863
+ },
3864
+ delete: {
3865
+ tags: ["Insumos"],
3866
+ summary: "Excluir insumo",
3867
+ operationId: "deleteInsumo",
3868
+ security: [{ ApiKeyAuth: ["insumos:delete"] }],
3869
+ responses: { "204": { description: "Exclu\xEDdo" }, "404": errorResponse("Insumo n\xE3o encontrado"), ...COMMON_ERRORS }
3746
3870
  }
3747
3871
  },
3748
3872
  "/notifications": {
@@ -4194,14 +4318,16 @@ var API_MODULES = [
4194
4318
  key: "inbox",
4195
4319
  label: "Caixa de Entrada",
4196
4320
  permissions: [
4197
- { key: "read", label: "Consultar mensagens e documentos", description: "Ver os e-mails recebidos e os boletos/notas extra\xEDdos deles" }
4321
+ { key: "read", label: "Consultar mensagens e documentos", description: "Ver os e-mails recebidos e os boletos/notas extra\xEDdos deles" },
4322
+ { key: "update", label: "Reprocessar e arquivar", description: "Devolver a mensagem ao processamento ou arquiv\xE1-la" }
4198
4323
  ]
4199
4324
  },
4200
4325
  {
4201
4326
  key: "reconciliation",
4202
4327
  label: "Concilia\xE7\xE3o Banc\xE1ria",
4203
4328
  permissions: [
4204
- { key: "read", label: "Consultar extrato e per\xEDodos", description: "Ver lan\xE7amentos do extrato e os per\xEDodos de concilia\xE7\xE3o" }
4329
+ { key: "read", label: "Consultar extrato e per\xEDodos", description: "Ver lan\xE7amentos do extrato e os per\xEDodos de concilia\xE7\xE3o" },
4330
+ { key: "write", label: "Desfazer concilia\xE7\xE3o", description: "Desconciliar um lan\xE7amento j\xE1 casado (a concilia\xE7\xE3o em si \xE9 feita no aplicativo)" }
4205
4331
  ]
4206
4332
  },
4207
4333
  {
@@ -4215,28 +4341,33 @@ var API_MODULES = [
4215
4341
  key: "dda",
4216
4342
  label: "DDA",
4217
4343
  permissions: [
4218
- { key: "read", label: "Consultar boletos", description: "Ver os boletos que o banco avisou por DDA e o status de casamento" }
4344
+ { key: "read", label: "Consultar boletos", description: "Ver os boletos que o banco avisou por DDA e o status de casamento" },
4345
+ { key: "triage", label: "Arquivar e reabrir", description: "Arquivar um boleto do DDA ou devolv\xEA-lo \xE0 fila" }
4219
4346
  ]
4220
4347
  },
4221
4348
  {
4222
4349
  key: "recurring",
4223
4350
  label: "Recorrentes",
4224
4351
  permissions: [
4225
- { key: "read", label: "Consultar regras", description: "Ver as regras que geram despesas e contas a pagar recorrentes" }
4352
+ { key: "read", label: "Consultar regras", description: "Ver as regras que geram despesas e contas a pagar recorrentes" },
4353
+ { key: "update", label: "Pausar e retomar", description: "Pausar ou retomar uma regra recorrente" }
4226
4354
  ]
4227
4355
  },
4228
4356
  {
4229
4357
  key: "insumos",
4230
4358
  label: "Insumos",
4231
4359
  permissions: [
4232
- { key: "read", label: "Listar e visualizar", description: "Consultar o cat\xE1logo de insumos" }
4360
+ { key: "read", label: "Listar e visualizar", description: "Consultar o cat\xE1logo de insumos" },
4361
+ { key: "write", label: "Criar e editar", description: "Criar e editar insumos" },
4362
+ { key: "delete", label: "Excluir", description: "Excluir insumos" }
4233
4363
  ]
4234
4364
  },
4235
4365
  {
4236
4366
  key: "notifications",
4237
4367
  label: "Notifica\xE7\xF5es",
4238
4368
  permissions: [
4239
- { key: "read", label: "Consultar notifica\xE7\xF5es", description: "Ver as notifica\xE7\xF5es geradas para os usu\xE1rios da empresa" }
4369
+ { key: "read", label: "Consultar notifica\xE7\xF5es", description: "Ver as notifica\xE7\xF5es geradas para os usu\xE1rios da empresa" },
4370
+ { key: "update", label: "Marcar como lida", description: "Marcar notifica\xE7\xE3o como lida ou n\xE3o lida" }
4240
4371
  ]
4241
4372
  },
4242
4373
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.9.1",
3
+ "version": "0.10.0",
4
4
  "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "type": "module",
6
6
  "license": "MIT",