@metronome/mcp 2.2.0 → 3.4.1

package/src/tools/v1/contracts/archive-v1-contracts.ts

@@ -1,61 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/archive',
-  operationId: 'archiveContract-v1',
-};
-
-export const tool: Tool = {
-  name: 'archive_v1_contracts',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently end and archive a contract along with all its terms. Any draft invoices will be canceled, and all upcoming scheduled invoices will be voided–also all finalized invoices can optionally be voided. Use this in the event a contract was incorrectly created and needed to be removed from a customer.\n\n#### Impact on commits and credits:\nWhen archiving a contract, all associated commits and credits are also archived. For prepaid commits with active segments, Metronome automatically generates expiration ledger entries to close out any remaining balances, ensuring accurate accounting of unused prepaid amounts. These ledger entries will appear in the commit's transaction history with type `PREPAID_COMMIT_EXPIRATION`.\n\n#### Archived contract visibility: \nArchived contracts remain accessible for historical reporting and audit purposes. They can be retrieved using the `ListContracts` endpoint by setting the `include_archived` parameter to `true` or in the Metronome UI when the \"Show archived\" option is enabled.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contract_archive_response',\n  $defs: {\n    contract_archive_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      contract_id: {
-        type: 'string',
-        description: 'ID of the contract to archive',
-      },
-      customer_id: {
-        type: 'string',
-        description: 'ID of the customer whose contract is to be archived',
-      },
-      void_invoices: {
-        type: 'boolean',
-        description: 'If false, the existing finalized invoices will remain after the contract is archived.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['contract_id', 'customer_id', 'void_invoices'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.v1.contracts.archive(body)));
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/contracts/create-historical-invoices-v1-contracts.ts

@@ -1,148 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/createHistoricalInvoices',
-  operationId: 'createHistoricalContractUsageInvoices-v1',
-};
-
-export const tool: Tool = {
-  name: 'create_historical_invoices_v1_contracts',
-  description:
-    'Create historical usage invoices for past billing periods on specific contracts. Use this endpoint to generate retroactive invoices with custom usage line items, quantities, and date ranges. Supports preview mode to validate invoice data before creation. Ideal for billing migrations or correcting past billing periods.\n',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      invoices: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            contract_id: {
-              type: 'string',
-            },
-            credit_type_id: {
-              type: 'string',
-            },
-            customer_id: {
-              type: 'string',
-            },
-            exclusive_end_date: {
-              type: 'string',
-              format: 'date-time',
-            },
-            inclusive_start_date: {
-              type: 'string',
-              format: 'date-time',
-            },
-            issue_date: {
-              type: 'string',
-              format: 'date-time',
-            },
-            usage_line_items: {
-              type: 'array',
-              items: {
-                type: 'object',
-                properties: {
-                  exclusive_end_date: {
-                    type: 'string',
-                    format: 'date-time',
-                  },
-                  inclusive_start_date: {
-                    type: 'string',
-                    format: 'date-time',
-                  },
-                  product_id: {
-                    type: 'string',
-                  },
-                  presentation_group_values: {
-                    type: 'object',
-                    additionalProperties: true,
-                  },
-                  pricing_group_values: {
-                    type: 'object',
-                    additionalProperties: true,
-                  },
-                  quantity: {
-                    type: 'number',
-                  },
-                  subtotals_with_quantity: {
-                    type: 'array',
-                    items: {
-                      type: 'object',
-                      properties: {
-                        exclusive_end_date: {
-                          type: 'string',
-                          format: 'date-time',
-                        },
-                        inclusive_start_date: {
-                          type: 'string',
-                          format: 'date-time',
-                        },
-                        quantity: {
-                          type: 'number',
-                        },
-                      },
-                      required: ['exclusive_end_date', 'inclusive_start_date', 'quantity'],
-                    },
-                  },
-                },
-                required: ['exclusive_end_date', 'inclusive_start_date', 'product_id'],
-              },
-            },
-            billable_status: {
-              type: 'string',
-              description: "This field's availability is dependent on your client's configuration.",
-              enum: ['billable', 'unbillable'],
-            },
-            breakdown_granularity: {
-              type: 'string',
-              enum: ['HOUR', 'DAY'],
-            },
-            custom_fields: {
-              type: 'object',
-              description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
-              additionalProperties: true,
-            },
-          },
-          required: [
-            'contract_id',
-            'credit_type_id',
-            'customer_id',
-            'exclusive_end_date',
-            'inclusive_start_date',
-            'issue_date',
-            'usage_line_items',
-          ],
-        },
-      },
-      preview: {
-        type: 'boolean',
-      },
-    },
-    required: ['invoices', 'preview'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  try {
-    return asTextContentResult(await client.v1.contracts.createHistoricalInvoices(body));
-  } catch (error) {
-    if (error instanceof Metronome.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };