@comando.one/mcp-server 0.12.0 → 0.12.1

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 +61 -10
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -561,6 +561,37 @@ var SCHEMAS = {
561
561
  notes: { type: "string" }
562
562
  }
563
563
  },
564
+ // Schemas de ATUALIZAÇÃO: o PATCH reusava o de criação, que carrega `required` — o MCP
565
+ // derivava a tool de update exigindo `customer_id` em toda edição — e não dizia o que cada
566
+ // campo faz depois que o registro existe (trocar cliente, reagendar, anexar).
567
+ ProposalUpdate: {
568
+ type: "object",
569
+ description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio.",
570
+ properties: {
571
+ customer_id: { type: "string", format: "uuid", description: "Troca o cliente da proposta. Precisa ser cliente desta empresa (404 se n\xE3o for)." },
572
+ status: { type: "string", enum: ["rascunho", "enviada", "aceita", "recusada", "cancelada"] },
573
+ total_amount: { type: "number" },
574
+ valid_until: { type: ["string", "null"], format: "date" },
575
+ notes: { type: ["string", "null"] }
576
+ }
577
+ },
578
+ ContractUpdate: {
579
+ type: "object",
580
+ description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio. Itens e se\xE7\xF5es do contrato n\xE3o s\xE3o edit\xE1veis por esta rota.",
581
+ properties: {
582
+ customer_id: { type: "string", format: "uuid", description: "Troca o cliente do contrato. Precisa ser cliente desta empresa (404). Recusado com 409 se o contrato tem autoriza\xE7\xE3o de d\xE9bito recorrente ativa (cart\xE3o salvo ou Pix Autom\xE1tico) \u2014 ela \xE9 do pagador atual; revogue-a antes. Faturas j\xE1 geradas continuam no cliente antigo." },
583
+ title: { type: ["string", "null"] },
584
+ status: { type: "string", enum: ["ativo", "suspenso", "cancelado", "finalizado"] },
585
+ frequency: { type: "string", enum: ["semanal", "quinzenal", "mensal", "bimestral", "trimestral", "semestral", "anual"] },
586
+ start_date: { type: "string", format: "date" },
587
+ end_date: { type: ["string", "null"], format: "date" },
588
+ due_days: { type: "integer" },
589
+ amount: { type: "number" },
590
+ payment_method_id: { type: ["string", "null"], format: "uuid" },
591
+ next_generation_date: { type: "string", format: "date", description: "Reagenda a pr\xF3xima gera\xE7\xE3o de fatura (rodada di\xE1ria das 03:00). S\xF3 hoje (fuso de Bras\xEDlia) em diante: data no passado \xE9 400, porque o gerador emitiria de uma vez uma fatura por ciclo atrasado. Para gerar um ciclo agora use POST /contracts/{id}/generate-invoices." },
592
+ notes: { type: ["string", "null"] }
593
+ }
594
+ },
564
595
  ContractReadjustment: {
565
596
  type: "object",
566
597
  description: "Reajuste aplicado a um contrato (specs/reajustes/).",
@@ -833,6 +864,27 @@ var SCHEMAS = {
833
864
  }
834
865
  }
835
866
  },
867
+ ExpenseUpdate: {
868
+ type: "object",
869
+ description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio (`attachment_ids` sozinho vale).",
870
+ properties: {
871
+ supplier_id: { type: "string", format: "uuid", description: "Troca o fornecedor. Precisa ser fornecedor desta empresa (404 se n\xE3o for)." },
872
+ description: { type: "string" },
873
+ amount: { type: "number" },
874
+ expense_date: { type: "string", format: "date" },
875
+ payment_date: { type: ["string", "null"], format: "date" },
876
+ category_id: { type: ["string", "null"], format: "uuid" },
877
+ status: { type: "string", enum: ["pendente", "pago", "cancelado"] },
878
+ bank_account_id: { type: ["string", "null"], format: "uuid" },
879
+ payment_method_id: { type: ["string", "null"], format: "uuid" },
880
+ notes: { type: ["string", "null"] },
881
+ attachment_ids: {
882
+ type: "array",
883
+ items: { type: "string", format: "uuid" },
884
+ description: "ACRESCENTA anexos j\xE1 enviados \xE0 despesa (n\xE3o substitui os atuais). Anexo que a despesa j\xE1 tem \xE9 ignorado, ent\xE3o repetir a chamada n\xE3o duplica. Id inexistente nesta empresa \u2192 404, sem gravar nada."
885
+ }
886
+ }
887
+ },
836
888
  PurchaseInvoice: {
837
889
  type: "object",
838
890
  properties: {
@@ -974,7 +1026,7 @@ var SCHEMAS = {
974
1026
  type: "object",
975
1027
  required: ["url"],
976
1028
  properties: {
977
- name: { type: "string", description: "R\xF3tulo opcional" },
1029
+ name: { type: ["string", "null"], description: "R\xF3tulo opcional. No PUT /webhooks/payments, omitido preserva o r\xF3tulo atual; null apaga." },
978
1030
  url: { type: "string", format: "uri", description: "Deve come\xE7ar com https://" },
979
1031
  events: { type: "array", items: { type: "string", enum: WEBHOOK_EVENT_KEYS }, description: "Eventos assinados (default: charge.paid, charge.cancelled, charge.expired)" },
980
1032
  active: { type: "boolean", default: true }
@@ -1280,8 +1332,7 @@ var SCHEMAS = {
1280
1332
  pix_key_type: { type: "string", enum: ["cpf", "cnpj", "email", "phone", "random"] },
1281
1333
  pix_copia_e_cola: { type: "string", description: "QR Pix copia e cola (EMV)" },
1282
1334
  boleto_barcode: { type: "string" },
1283
- scheduled_for: { type: "string", format: "date", description: "Data de agendamento (YYYY-MM-DD); omitir paga \xE0 vista" },
1284
- description: { type: "string" }
1335
+ scheduled_for: { type: "string", format: "date", description: "Data de agendamento (YYYY-MM-DD); omitir paga \xE0 vista" }
1285
1336
  }
1286
1337
  },
1287
1338
  SplitRuleRecipient: {
@@ -2116,8 +2167,8 @@ var OPENAPI_SPEC = {
2116
2167
  summary: "Atualizar proposta",
2117
2168
  operationId: "updateProposal",
2118
2169
  security: [{ ApiKeyAuth: ["proposals:write"] }],
2119
- requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ProposalCreate" } } } },
2120
- responses: { "200": { description: "Proposta atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Proposal" } } } }, "404": errorResponse("Proposta n\xE3o encontrada"), ...COMMON_ERRORS }
2170
+ requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ProposalUpdate" } } } },
2171
+ responses: { "200": { description: "Proposta atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Proposal" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Proposta ou cliente n\xE3o encontrado"), ...COMMON_ERRORS }
2121
2172
  },
2122
2173
  delete: {
2123
2174
  tags: ["Propostas"],
@@ -2186,8 +2237,8 @@ var OPENAPI_SPEC = {
2186
2237
  summary: "Atualizar contrato",
2187
2238
  operationId: "updateContract",
2188
2239
  security: [{ ApiKeyAuth: ["contracts:write"] }],
2189
- requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractCreate" } } } },
2190
- responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "404": errorResponse("Contrato n\xE3o encontrado"), ...COMMON_ERRORS }
2240
+ requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractUpdate" } } } },
2241
+ responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Contrato ou cliente n\xE3o encontrado"), "409": errorResponse("Troca de cliente com autoriza\xE7\xE3o de d\xE9bito recorrente ativa"), ...COMMON_ERRORS }
2191
2242
  },
2192
2243
  delete: {
2193
2244
  tags: ["Contratos"],
@@ -3299,8 +3350,8 @@ var OPENAPI_SPEC = {
3299
3350
  summary: "Atualizar despesa",
3300
3351
  operationId: "updateExpense",
3301
3352
  security: [{ ApiKeyAuth: ["expenses:write"] }],
3302
- requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ExpenseCreate" } } } },
3303
- responses: { "200": { description: "Despesa atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Expense" } } } }, "404": errorResponse("Despesa n\xE3o encontrada"), ...COMMON_ERRORS }
3353
+ requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ExpenseUpdate" } } } },
3354
+ responses: { "200": { description: "Despesa atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Expense" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Despesa, fornecedor ou anexo n\xE3o encontrado"), ...COMMON_ERRORS }
3304
3355
  },
3305
3356
  delete: {
3306
3357
  tags: ["Despesas"],
@@ -4896,7 +4947,7 @@ function buildWhoamiTool(api) {
4896
4947
  // src/branding.ts
4897
4948
  var MCP_SERVER_NAME = "comando-one";
4898
4949
  var MCP_SERVER_TITLE = "Comando1";
4899
- var MCP_SERVER_VERSION = "0.12.0";
4950
+ var MCP_SERVER_VERSION = "0.12.1";
4900
4951
  var MCP_SERVER_DESCRIPTION = "ERP das empresas de servi\xE7o brasileiras: clientes, propostas, contratos, faturas, cobran\xE7as Pix e boleto, NFS-e, contas a pagar e financeiro.";
4901
4952
  var MCP_SERVER_WEBSITE = "https://comando.one";
4902
4953
  var MCP_SERVER_ICONS = [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.12.0",
3
+ "version": "0.12.1",
4
4
  "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "author": "Orbital Tecnologia e Desenvolvimento LTDA <contato@comando.one> (https://orbitaldev.com.br)",
6
6
  "homepage": "https://comando.one",