@metronome/mcp 2.2.0 → 3.0.0

package/tools/v1/customers/credits/create-customers-v1-credits.mjs

@@ -1,168 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-import Metronome from '@metronome/sdk';
-export const metadata = {
-    resource: 'v1.customers.credits',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/contracts/customerCredits/create',
-    operationId: 'createCustomerCredit-v1',
-};
-export const tool = {
-    name: 'create_customers_v1_credits',
-    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\nCreates customer-level credits that provide spending allowances or free credit balances for customers across their Metronome usage. Note: In most cases, you should add credits directly to customer contracts using the contract/create or contract/edit APIs.\n\n### Use this endpoint to:\nUse this endpoint when you need to provision credits directly at the customer level that can be applied across multiple contracts or scoped to specific contracts. Customer-level credits are ideal for:\n- Customer onboarding incentives that apply globally\n- Flexible spending allowances that aren't tied to a single contract\n- Migration scenarios where you need to preserve existing customer balances\n\n#### Scoping flexibility: \nCustomer-level credits can be configured in two ways:\n- Contract-specific: Use the applicable_contract_ids field to limit the credit to specific contracts\n- Cross-contract: Leave applicable_contract_ids empty to allow the credit to be used across all of the customer's contracts\n\n#### Product Targeting: \nCredits can be scoped to specific products using `applicable_product_ids` or `applicable_product_tags`, or left unrestricted to apply to all products.\n\n#### Priority considerations: \nWhen multiple credits are applicable, the one with the lower priority value will be consumed first. If there is a tie, contract level commits and credits will be applied before customer level commits and credits. Plan your priority scheme carefully to ensure credits are applied in the desired order.\n\n#### Access Schedule Required: \nYou must provide an `access_schedule` that defines when and how much credit becomes available to the customer over time. This usually is aligned to the contract schedule or starts immediately and is set to expire in the future.\n\n### Usage Guidelines:\n⚠️ Preferred Alternative: In most cases, you should add credits directly to contracts using the contract/create or contract/edit APIs instead of creating customer-level credits. Contract-level credits provide better organization, and are easier for finance teams to recognize revenue, and are the recommended approach for most use cases.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/credit_create_response',\n  $defs: {\n    credit_create_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: {
-            access_schedule: {
-                type: 'object',
-                description: 'Schedule for distributing the credit to the customer.',
-                properties: {
-                    schedule_items: {
-                        type: 'array',
-                        items: {
-                            type: 'object',
-                            properties: {
-                                amount: {
-                                    type: 'number',
-                                },
-                                ending_before: {
-                                    type: 'string',
-                                    description: 'RFC 3339 timestamp (exclusive)',
-                                    format: 'date-time',
-                                },
-                                starting_at: {
-                                    type: 'string',
-                                    description: 'RFC 3339 timestamp (inclusive)',
-                                    format: 'date-time',
-                                },
-                            },
-                            required: ['amount', 'ending_before', 'starting_at'],
-                        },
-                    },
-                    credit_type_id: {
-                        type: 'string',
-                        description: 'Defaults to USD (cents) if not passed',
-                    },
-                },
-                required: ['schedule_items'],
-            },
-            customer_id: {
-                type: 'string',
-            },
-            priority: {
-                type: 'number',
-                description: 'If multiple credits or commits are applicable, the one with the lower priority will apply first.',
-            },
-            product_id: {
-                type: 'string',
-            },
-            applicable_contract_ids: {
-                type: 'array',
-                description: 'Which contract the credit applies to. If not provided, the credit applies to all contracts.',
-                items: {
-                    type: 'string',
-                },
-            },
-            applicable_product_ids: {
-                type: 'array',
-                description: 'Which products the credit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the credit applies to all products.',
-                items: {
-                    type: 'string',
-                },
-            },
-            applicable_product_tags: {
-                type: 'array',
-                description: 'Which tags the credit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the credit applies to all products.',
-                items: {
-                    type: 'string',
-                },
-            },
-            custom_fields: {
-                type: 'object',
-                description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
-                additionalProperties: true,
-            },
-            description: {
-                type: 'string',
-                description: 'Used only in UI/API. It is not exposed to end customers.',
-            },
-            name: {
-                type: 'string',
-                description: 'displayed on invoices',
-            },
-            netsuite_sales_order_id: {
-                type: 'string',
-                description: "This field's availability is dependent on your client's configuration.",
-            },
-            rate_type: {
-                type: 'string',
-                enum: ['COMMIT_RATE', 'LIST_RATE'],
-            },
-            salesforce_opportunity_id: {
-                type: 'string',
-                description: "This field's availability is dependent on your client's configuration.",
-            },
-            specifiers: {
-                type: 'array',
-                description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
-                items: {
-                    $ref: '#/$defs/commit_specifier_input',
-                },
-            },
-            uniqueness_key: {
-                type: 'string',
-                description: 'Prevents the creation of duplicates. If a request to create a commit or credit is made with a uniqueness key that was previously used to create a commit or credit, a new record will not be created and the request will fail with a 409 error.',
-            },
-            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: ['access_schedule', 'customer_id', 'priority', 'product_id'],
-        $defs: {
-            commit_specifier_input: {
-                type: 'object',
-                properties: {
-                    presentation_group_values: {
-                        type: 'object',
-                        additionalProperties: true,
-                    },
-                    pricing_group_values: {
-                        type: 'object',
-                        additionalProperties: true,
-                    },
-                    product_id: {
-                        type: 'string',
-                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                    },
-                    product_tags: {
-                        type: 'array',
-                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                        items: {
-                            type: 'string',
-                        },
-                    },
-                },
-            },
-        },
-    },
-    annotations: {},
-};
-export const handler = async (client, args) => {
-    const { jq_filter, ...body } = args;
-    try {
-        return asTextContentResult(await maybeFilter(jq_filter, await client.v1.customers.credits.create(body)));
-    }
-    catch (error) {
-        if (error instanceof Metronome.APIError || isJqError(error)) {
-            return asErrorResult(error.message);
-        }
-        throw error;
-    }
-};
-export default { metadata, tool, handler };
-//# sourceMappingURL=create-customers-v1-credits.mjs.map

package/tools/v1/customers/credits/create-customers-v1-credits.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-customers-v1-credits.mjs","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/create-customers-v1-credits.ts"],"names":[],"mappings":"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"}

package/tools/v1/customers/credits/list-customers-v1-credits.d.mts

@@ -1,51 +0,0 @@
-import { Metadata } from '@metronome/mcp/tools/types';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-export declare const metadata: Metadata;
-export declare const tool: Tool;
-export declare const handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-declare const _default: {
-    metadata: Metadata;
-    tool: {
-        inputSchema: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        };
-        name: string;
-        description?: string | undefined;
-        outputSchema?: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        } | undefined;
-        annotations?: {
-            title?: string | undefined;
-            readOnlyHint?: boolean | undefined;
-            destructiveHint?: boolean | undefined;
-            idempotentHint?: boolean | undefined;
-            openWorldHint?: boolean | undefined;
-        } | undefined;
-        execution?: {
-            taskSupport?: "optional" | "required" | "forbidden" | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    };
-    handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-};
-export default _default;
-//# sourceMappingURL=list-customers-v1-credits.d.mts.map

package/tools/v1/customers/credits/list-customers-v1-credits.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-customers-v1-credits.d.mts","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/list-customers-v1-credits.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAsC,MAAM,4BAA4B;OAElF,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0DlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAWzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAa1F,wBAA2C"}

package/tools/v1/customers/credits/list-customers-v1-credits.d.ts

@@ -1,51 +0,0 @@
-import { Metadata } from '@metronome/mcp/tools/types';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-export declare const metadata: Metadata;
-export declare const tool: Tool;
-export declare const handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-declare const _default: {
-    metadata: Metadata;
-    tool: {
-        inputSchema: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        };
-        name: string;
-        description?: string | undefined;
-        outputSchema?: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        } | undefined;
-        annotations?: {
-            title?: string | undefined;
-            readOnlyHint?: boolean | undefined;
-            destructiveHint?: boolean | undefined;
-            idempotentHint?: boolean | undefined;
-            openWorldHint?: boolean | undefined;
-        } | undefined;
-        execution?: {
-            taskSupport?: "optional" | "required" | "forbidden" | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    };
-    handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-};
-export default _default;
-//# sourceMappingURL=list-customers-v1-credits.d.ts.map

package/tools/v1/customers/credits/list-customers-v1-credits.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-customers-v1-credits.d.ts","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/list-customers-v1-credits.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAsC,MAAM,4BAA4B;OAElF,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0DlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAWzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAa1F,wBAA2C"}

package/tools/v1/customers/credits/list-customers-v1-credits.js

@@ -1,89 +0,0 @@
-"use strict";
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handler = exports.tool = exports.metadata = void 0;
-const types_1 = require("@metronome/mcp/tools/types");
-const sdk_1 = __importDefault(require("@metronome/sdk"));
-exports.metadata = {
-    resource: 'v1.customers.credits',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/contracts/customerCredits/list',
-    operationId: 'listCustomerCredits-v1',
-};
-exports.tool = {
-    name: 'list_customers_v1_credits',
-    description: 'Retrieve a detailed list of all credits available to a customer, including promotional credits and contract-specific credits. This endpoint provides comprehensive visibility into credit balances, access schedules, and usage rules, enabling you to build credit management interfaces and track available funding.\n\n### Use this endpoint to:\n- Display all available credits in customer billing dashboards\n- Show credit balances and expiration dates\n- Track credit usage history with optional ledger details\n- Build credit management and reporting tools\n- Monitor promotional credit utilization\n• Support customer inquiries about available credits\n\n### Key response fields:\nAn array of Credit objects containing:\n- Credit details: Name, priority, and which applicable products/tags it applies to\n- Product ID: The `product_id` of the credit. This is for external mapping into your quote-to-cash stack, not the product it applies to. \n- Access schedule: When credits become available and expire\n- Optional ledger entries: Transaction history (if `include_ledgers=true`)\n- Balance information: Current available amount (if `include_balance=true`)\n- Metadata: Custom fields and usage specifiers\n\n### Usage guidelines:\n- Pagination: Results limited to 25 commits per page; use next_page for more\n- Date filtering options:\n    - `covering_date`: Credits active on a specific date\n    - `starting_at`: Credits with access on/after a date\n    - `effective_before`: Credits with access before a date (exclusive)\n- Scope options:\n    - `include_contract_credits`: Include contract-level credits (not just customer-level)\n    - `include_archived`: Include archived credits and credits from archived contracts\n- Performance considerations:\n    - `include_ledgers`: Adds detailed transaction history (slower)\n    - `include_balance`: Adds current balance calculation (slower)\n- Optional filtering: Use credit_id to retrieve a specific commit\n',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            customer_id: {
-                type: 'string',
-            },
-            covering_date: {
-                type: 'string',
-                description: 'Return only credits that have access schedules that "cover" the provided date',
-                format: 'date-time',
-            },
-            credit_id: {
-                type: 'string',
-            },
-            effective_before: {
-                type: 'string',
-                description: 'Include only credits that have any access before the provided date (exclusive)',
-                format: 'date-time',
-            },
-            include_archived: {
-                type: 'boolean',
-                description: 'Include archived credits and credits from archived contracts.',
-            },
-            include_balance: {
-                type: 'boolean',
-                description: 'Include the balance in the response. Setting this flag may cause the query to be slower.',
-            },
-            include_contract_credits: {
-                type: 'boolean',
-                description: 'Include credits on the contract level.',
-            },
-            include_ledgers: {
-                type: 'boolean',
-                description: 'Include credit ledgers in the response. Setting this flag may cause the query to be slower.',
-            },
-            limit: {
-                type: 'integer',
-                description: 'The maximum number of commits to return. Defaults to 25.',
-            },
-            next_page: {
-                type: 'string',
-                description: 'The next page token from a previous response.',
-            },
-            starting_at: {
-                type: 'string',
-                description: 'Include only credits that have any access on or after the provided date',
-                format: 'date-time',
-            },
-        },
-        required: ['customer_id'],
-    },
-    annotations: {},
-};
-const handler = async (client, args) => {
-    const body = args;
-    const response = await client.v1.customers.credits.list(body).asResponse();
-    try {
-        return (0, types_1.asTextContentResult)(await response.json());
-    }
-    catch (error) {
-        if (error instanceof sdk_1.default.APIError) {
-            return (0, types_1.asErrorResult)(error.message);
-        }
-        throw error;
-    }
-};
-exports.handler = handler;
-exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
-//# sourceMappingURL=list-customers-v1-credits.js.map

package/tools/v1/customers/credits/list-customers-v1-credits.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-customers-v1-credits.js","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/list-customers-v1-credits.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,sDAA0F;AAG1F,yDAAuC;AAE1B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,sBAAsB;IAChC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,oCAAoC;IAC9C,WAAW,EAAE,wBAAwB;CACtC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,u6DAAu6D;IACz6D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+EAA+E;gBAC5F,MAAM,EAAE,WAAW;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;aACf;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gFAAgF;gBAC7F,MAAM,EAAE,WAAW;aACpB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+DAA+D;aAC7E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,0FAA0F;aAC7F;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wCAAwC;aACtD;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,6FAA6F;aAChG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0DAA0D;aACxE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;gBACtF,MAAM,EAAE,WAAW;aACpB;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3E,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAS,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,OAAO,WAWlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/v1/customers/credits/list-customers-v1-credits.mjs

@@ -1,82 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-import Metronome from '@metronome/sdk';
-export const metadata = {
-    resource: 'v1.customers.credits',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/contracts/customerCredits/list',
-    operationId: 'listCustomerCredits-v1',
-};
-export const tool = {
-    name: 'list_customers_v1_credits',
-    description: 'Retrieve a detailed list of all credits available to a customer, including promotional credits and contract-specific credits. This endpoint provides comprehensive visibility into credit balances, access schedules, and usage rules, enabling you to build credit management interfaces and track available funding.\n\n### Use this endpoint to:\n- Display all available credits in customer billing dashboards\n- Show credit balances and expiration dates\n- Track credit usage history with optional ledger details\n- Build credit management and reporting tools\n- Monitor promotional credit utilization\n• Support customer inquiries about available credits\n\n### Key response fields:\nAn array of Credit objects containing:\n- Credit details: Name, priority, and which applicable products/tags it applies to\n- Product ID: The `product_id` of the credit. This is for external mapping into your quote-to-cash stack, not the product it applies to. \n- Access schedule: When credits become available and expire\n- Optional ledger entries: Transaction history (if `include_ledgers=true`)\n- Balance information: Current available amount (if `include_balance=true`)\n- Metadata: Custom fields and usage specifiers\n\n### Usage guidelines:\n- Pagination: Results limited to 25 commits per page; use next_page for more\n- Date filtering options:\n    - `covering_date`: Credits active on a specific date\n    - `starting_at`: Credits with access on/after a date\n    - `effective_before`: Credits with access before a date (exclusive)\n- Scope options:\n    - `include_contract_credits`: Include contract-level credits (not just customer-level)\n    - `include_archived`: Include archived credits and credits from archived contracts\n- Performance considerations:\n    - `include_ledgers`: Adds detailed transaction history (slower)\n    - `include_balance`: Adds current balance calculation (slower)\n- Optional filtering: Use credit_id to retrieve a specific commit\n',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            customer_id: {
-                type: 'string',
-            },
-            covering_date: {
-                type: 'string',
-                description: 'Return only credits that have access schedules that "cover" the provided date',
-                format: 'date-time',
-            },
-            credit_id: {
-                type: 'string',
-            },
-            effective_before: {
-                type: 'string',
-                description: 'Include only credits that have any access before the provided date (exclusive)',
-                format: 'date-time',
-            },
-            include_archived: {
-                type: 'boolean',
-                description: 'Include archived credits and credits from archived contracts.',
-            },
-            include_balance: {
-                type: 'boolean',
-                description: 'Include the balance in the response. Setting this flag may cause the query to be slower.',
-            },
-            include_contract_credits: {
-                type: 'boolean',
-                description: 'Include credits on the contract level.',
-            },
-            include_ledgers: {
-                type: 'boolean',
-                description: 'Include credit ledgers in the response. Setting this flag may cause the query to be slower.',
-            },
-            limit: {
-                type: 'integer',
-                description: 'The maximum number of commits to return. Defaults to 25.',
-            },
-            next_page: {
-                type: 'string',
-                description: 'The next page token from a previous response.',
-            },
-            starting_at: {
-                type: 'string',
-                description: 'Include only credits that have any access on or after the provided date',
-                format: 'date-time',
-            },
-        },
-        required: ['customer_id'],
-    },
-    annotations: {},
-};
-export const handler = async (client, args) => {
-    const body = args;
-    const response = await client.v1.customers.credits.list(body).asResponse();
-    try {
-        return asTextContentResult(await response.json());
-    }
-    catch (error) {
-        if (error instanceof Metronome.APIError) {
-            return asErrorResult(error.message);
-        }
-        throw error;
-    }
-};
-export default { metadata, tool, handler };
-//# sourceMappingURL=list-customers-v1-credits.mjs.map

package/tools/v1/customers/credits/list-customers-v1-credits.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-customers-v1-credits.mjs","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/list-customers-v1-credits.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B;OAGlF,SAAS,MAAM,gBAAgB;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,sBAAsB;IAChC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,oCAAoC;IAC9C,WAAW,EAAE,wBAAwB;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,u6DAAu6D;IACz6D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+EAA+E;gBAC5F,MAAM,EAAE,WAAW;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;aACf;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gFAAgF;gBAC7F,MAAM,EAAE,WAAW;aACpB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+DAA+D;aAC7E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,0FAA0F;aAC7F;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wCAAwC;aACtD;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,6FAA6F;aAChG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0DAA0D;aACxE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;gBACtF,MAAM,EAAE,WAAW;aACpB;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3E,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/v1/customers/credits/update-end-date-customers-v1-credits.d.mts

@@ -1,51 +0,0 @@
-import { Metadata } from '@metronome/mcp/tools/types';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-export declare const metadata: Metadata;
-export declare const tool: Tool;
-export declare const handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-declare const _default: {
-    metadata: Metadata;
-    tool: {
-        inputSchema: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        };
-        name: string;
-        description?: string | undefined;
-        outputSchema?: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        } | undefined;
-        annotations?: {
-            title?: string | undefined;
-            readOnlyHint?: boolean | undefined;
-            destructiveHint?: boolean | undefined;
-            idempotentHint?: boolean | undefined;
-            openWorldHint?: boolean | undefined;
-        } | undefined;
-        execution?: {
-            taskSupport?: "optional" | "required" | "forbidden" | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    };
-    handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-};
-export default _default;
-//# sourceMappingURL=update-end-date-customers-v1-credits.d.mts.map

package/tools/v1/customers/credits/update-end-date-customers-v1-credits.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-end-date-customers-v1-credits.d.mts","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/update-end-date-customers-v1-credits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,4BAA4B;OAElF,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA+BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAYzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAZoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAc1F,wBAA2C"}

package/tools/v1/customers/credits/update-end-date-customers-v1-credits.d.ts

@@ -1,51 +0,0 @@
-import { Metadata } from '@metronome/mcp/tools/types';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-export declare const metadata: Metadata;
-export declare const tool: Tool;
-export declare const handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-declare const _default: {
-    metadata: Metadata;
-    tool: {
-        inputSchema: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        };
-        name: string;
-        description?: string | undefined;
-        outputSchema?: {
-            [x: string]: unknown;
-            type: "object";
-            properties?: {
-                [x: string]: object;
-            } | undefined;
-            required?: string[] | undefined;
-        } | undefined;
-        annotations?: {
-            title?: string | undefined;
-            readOnlyHint?: boolean | undefined;
-            destructiveHint?: boolean | undefined;
-            idempotentHint?: boolean | undefined;
-            openWorldHint?: boolean | undefined;
-        } | undefined;
-        execution?: {
-            taskSupport?: "optional" | "required" | "forbidden" | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    };
-    handler: (client: Metronome, args: Record<string, unknown> | undefined) => Promise<import("@metronome/mcp/tools/types").ToolCallResult>;
-};
-export default _default;
-//# sourceMappingURL=update-end-date-customers-v1-credits.d.ts.map

package/tools/v1/customers/credits/update-end-date-customers-v1-credits.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-end-date-customers-v1-credits.d.ts","sourceRoot":"","sources":["../../../../src/tools/v1/customers/credits/update-end-date-customers-v1-credits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,4BAA4B;OAElF,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA+BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAYzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAZoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAc1F,wBAA2C"}