@metronome/mcp 2.2.0 → 3.0.0

package/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.js

@@ -1,53 +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 filtering_1 = require("@metronome/mcp/filtering");
-const types_1 = require("@metronome/mcp/tools/types");
-const sdk_1 = __importDefault(require("@metronome/sdk"));
-exports.metadata = {
-    resource: 'v1.settings.billing_providers',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/listConfiguredBillingProviders',
-    operationId: 'listConfiguredBillingProviders-v1',
-};
-exports.tool = {
-    name: 'list_settings_v1_billing_providers',
-    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\nLists all configured billing providers and their delivery method configurations for your account. Returns provider details, delivery method IDs, and configuration settings needed for mapping individual customer contracts to billing integrations.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/billing_provider_list_response',\n  $defs: {\n    billing_provider_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              billing_provider: {\n                type: 'string',\n                description: 'The billing provider set for this configuration.',\n                enum: [                  'aws_marketplace',\n                  'stripe',\n                  'netsuite',\n                  'custom',\n                  'azure_marketplace',\n                  'quickbooks_online',\n                  'workday',\n                  'gcp_marketplace',\n                  'metronome'\n                ]\n              },\n              delivery_method: {\n                type: 'string',\n                description: 'The method to use for delivering invoices to this customer.',\n                enum: [                  'direct_to_billing_provider',\n                  'aws_sqs',\n                  'tackle',\n                  'aws_sns'\n                ]\n              },\n              delivery_method_configuration: {\n                type: 'object',\n                description: 'Configuration for the delivery method. The structure of this object is specific to the delivery method. Some configuration may be omitted for security reasons.',\n                additionalProperties: true\n              },\n              delivery_method_id: {\n                type: 'string',\n                description: 'ID of the delivery method to use for this customer.'\n              }\n            },\n            required: [              'billing_provider',\n              'delivery_method',\n              'delivery_method_configuration',\n              'delivery_method_id'\n            ]\n          }\n        },\n        next_page: {\n          type: 'string'\n        }\n      },\n      required: [        'data'\n      ]\n    }\n  }\n}\n```",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            next_page: {
-                type: 'string',
-                description: 'The cursor to the next page of results',
-            },
-            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: [],
-    },
-    annotations: {},
-};
-const handler = async (client, args) => {
-    const { jq_filter, ...body } = args;
-    try {
-        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.v1.settings.billingProviders.list(body)));
-    }
-    catch (error) {
-        if (error instanceof sdk_1.default.APIError || (0, filtering_1.isJqError)(error)) {
-            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-settings-v1-billing-providers.js.map

package/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-settings-v1-billing-providers.js","sourceRoot":"","sources":["../../../../src/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,wDAAkE;AAClE,sDAA0F;AAG1F,yDAAuC;AAE1B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,+BAA+B;IACzC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,oCAAoC;IAC9C,WAAW,EAAE,mCAAmC;CACjD,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,05EAA05E;IAC55E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EACxB,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACnF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAS,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAZW,QAAA,OAAO,WAYlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.mjs

@@ -1,46 +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.settings.billing_providers',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/listConfiguredBillingProviders',
-    operationId: 'listConfiguredBillingProviders-v1',
-};
-export const tool = {
-    name: 'list_settings_v1_billing_providers',
-    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\nLists all configured billing providers and their delivery method configurations for your account. Returns provider details, delivery method IDs, and configuration settings needed for mapping individual customer contracts to billing integrations.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/billing_provider_list_response',\n  $defs: {\n    billing_provider_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              billing_provider: {\n                type: 'string',\n                description: 'The billing provider set for this configuration.',\n                enum: [                  'aws_marketplace',\n                  'stripe',\n                  'netsuite',\n                  'custom',\n                  'azure_marketplace',\n                  'quickbooks_online',\n                  'workday',\n                  'gcp_marketplace',\n                  'metronome'\n                ]\n              },\n              delivery_method: {\n                type: 'string',\n                description: 'The method to use for delivering invoices to this customer.',\n                enum: [                  'direct_to_billing_provider',\n                  'aws_sqs',\n                  'tackle',\n                  'aws_sns'\n                ]\n              },\n              delivery_method_configuration: {\n                type: 'object',\n                description: 'Configuration for the delivery method. The structure of this object is specific to the delivery method. Some configuration may be omitted for security reasons.',\n                additionalProperties: true\n              },\n              delivery_method_id: {\n                type: 'string',\n                description: 'ID of the delivery method to use for this customer.'\n              }\n            },\n            required: [              'billing_provider',\n              'delivery_method',\n              'delivery_method_configuration',\n              'delivery_method_id'\n            ]\n          }\n        },\n        next_page: {\n          type: 'string'\n        }\n      },\n      required: [        'data'\n      ]\n    }\n  }\n}\n```",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            next_page: {
-                type: 'string',
-                description: 'The cursor to the next page of results',
-            },
-            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: [],
-    },
-    annotations: {},
-};
-export const handler = async (client, args) => {
-    const { jq_filter, ...body } = args;
-    try {
-        return asTextContentResult(await maybeFilter(jq_filter, await client.v1.settings.billingProviders.list(body)));
-    }
-    catch (error) {
-        if (error instanceof Metronome.APIError || isJqError(error)) {
-            return asErrorResult(error.message);
-        }
-        throw error;
-    }
-};
-export default { metadata, tool, handler };
-//# sourceMappingURL=list-settings-v1-billing-providers.mjs.map

package/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-settings-v1-billing-providers.mjs","sourceRoot":"","sources":["../../../../src/tools/v1/settings/billing-providers/list-settings-v1-billing-providers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC1D,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B;OAGlF,SAAS,MAAM,gBAAgB;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,+BAA+B;IACzC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,oCAAoC;IAC9C,WAAW,EAAE,mCAAmC;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,05EAA05E;IAC55E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,mBAAmB,CACxB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACnF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,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/settings/upsert-avalara-credentials-v1-settings.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=upsert-avalara-credentials-v1-settings.d.mts.map

package/tools/v1/settings/upsert-avalara-credentials-v1-settings.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upsert-avalara-credentials-v1-settings.d.mts","sourceRoot":"","sources":["../../../src/tools/v1/settings/upsert-avalara-credentials-v1-settings.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,IA2ClB,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/settings/upsert-avalara-credentials-v1-settings.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=upsert-avalara-credentials-v1-settings.d.ts.map

package/tools/v1/settings/upsert-avalara-credentials-v1-settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upsert-avalara-credentials-v1-settings.d.ts","sourceRoot":"","sources":["../../../src/tools/v1/settings/upsert-avalara-credentials-v1-settings.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,IA2ClB,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/settings/upsert-avalara-credentials-v1-settings.js

@@ -1,73 +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 filtering_1 = require("@metronome/mcp/filtering");
-const types_1 = require("@metronome/mcp/tools/types");
-const sdk_1 = __importDefault(require("@metronome/sdk"));
-exports.metadata = {
-    resource: 'v1.settings',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/upsertAvalaraCredentials',
-    operationId: 'upsertAvalaraCredentials-v1',
-};
-exports.tool = {
-    name: 'upsert_avalara_credentials_v1_settings',
-    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\nSet the Avalara credentials for some specified `delivery_method_ids`, which can be found in the `/listConfiguredBillingProviders` response. This maps the Avalara credentials to the appropriate billing entity. These credentials are only used for PLG Invoicing today.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/setting_upsert_avalara_credentials_response',\n  $defs: {\n    setting_upsert_avalara_credentials_response: {\n      type: 'object',\n      properties: {}\n    }\n  }\n}\n```",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            avalara_environment: {
-                type: 'string',
-                description: 'The Avalara environment to use (SANDBOX or PRODUCTION).',
-                enum: ['PRODUCTION', 'SANDBOX'],
-            },
-            avalara_password: {
-                type: 'string',
-                description: 'The password for the Avalara account.',
-            },
-            avalara_username: {
-                type: 'string',
-                description: 'The username for the Avalara account.',
-            },
-            delivery_method_ids: {
-                type: 'array',
-                description: 'The delivery method IDs of the billing provider configurations to update, can be found in the response of the `/listConfiguredBillingProviders` endpoint.',
-                items: {
-                    type: 'string',
-                },
-            },
-            commit_transactions: {
-                type: 'boolean',
-                description: 'Commit transactions if you want Metronome tax calculations used for reporting and tax filings.',
-            },
-            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: ['avalara_environment', 'avalara_password', 'avalara_username', 'delivery_method_ids'],
-    },
-    annotations: {},
-};
-const handler = async (client, args) => {
-    const { jq_filter, ...body } = args;
-    try {
-        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.v1.settings.upsertAvalaraCredentials(body)));
-    }
-    catch (error) {
-        if (error instanceof sdk_1.default.APIError || (0, filtering_1.isJqError)(error)) {
-            return (0, types_1.asErrorResult)(error.message);
-        }
-        throw error;
-    }
-};
-exports.handler = handler;
-exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
-//# sourceMappingURL=upsert-avalara-credentials-v1-settings.js.map

package/tools/v1/settings/upsert-avalara-credentials-v1-settings.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"upsert-avalara-credentials-v1-settings.js","sourceRoot":"","sources":["../../../src/tools/v1/settings/upsert-avalara-credentials-v1-settings.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,wDAAkE;AAClE,sDAA0F;AAG1F,yDAAuC;AAE1B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,8BAA8B;IACxC,WAAW,EAAE,6BAA6B;CAC3C,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,upBAAupB;IACzpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;aAChC;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,2JAA2J;gBAC7J,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,gGAAgG;aACnG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;KACjG;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EACxB,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CACtF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAS,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAZW,QAAA,OAAO,WAYlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/v1/settings/upsert-avalara-credentials-v1-settings.mjs

@@ -1,66 +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.settings',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/upsertAvalaraCredentials',
-    operationId: 'upsertAvalaraCredentials-v1',
-};
-export const tool = {
-    name: 'upsert_avalara_credentials_v1_settings',
-    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\nSet the Avalara credentials for some specified `delivery_method_ids`, which can be found in the `/listConfiguredBillingProviders` response. This maps the Avalara credentials to the appropriate billing entity. These credentials are only used for PLG Invoicing today.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/setting_upsert_avalara_credentials_response',\n  $defs: {\n    setting_upsert_avalara_credentials_response: {\n      type: 'object',\n      properties: {}\n    }\n  }\n}\n```",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            avalara_environment: {
-                type: 'string',
-                description: 'The Avalara environment to use (SANDBOX or PRODUCTION).',
-                enum: ['PRODUCTION', 'SANDBOX'],
-            },
-            avalara_password: {
-                type: 'string',
-                description: 'The password for the Avalara account.',
-            },
-            avalara_username: {
-                type: 'string',
-                description: 'The username for the Avalara account.',
-            },
-            delivery_method_ids: {
-                type: 'array',
-                description: 'The delivery method IDs of the billing provider configurations to update, can be found in the response of the `/listConfiguredBillingProviders` endpoint.',
-                items: {
-                    type: 'string',
-                },
-            },
-            commit_transactions: {
-                type: 'boolean',
-                description: 'Commit transactions if you want Metronome tax calculations used for reporting and tax filings.',
-            },
-            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: ['avalara_environment', 'avalara_password', 'avalara_username', 'delivery_method_ids'],
-    },
-    annotations: {},
-};
-export const handler = async (client, args) => {
-    const { jq_filter, ...body } = args;
-    try {
-        return asTextContentResult(await maybeFilter(jq_filter, await client.v1.settings.upsertAvalaraCredentials(body)));
-    }
-    catch (error) {
-        if (error instanceof Metronome.APIError || isJqError(error)) {
-            return asErrorResult(error.message);
-        }
-        throw error;
-    }
-};
-export default { metadata, tool, handler };
-//# sourceMappingURL=upsert-avalara-credentials-v1-settings.mjs.map

package/tools/v1/settings/upsert-avalara-credentials-v1-settings.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"upsert-avalara-credentials-v1-settings.mjs","sourceRoot":"","sources":["../../../src/tools/v1/settings/upsert-avalara-credentials-v1-settings.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC1D,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B;OAGlF,SAAS,MAAM,gBAAgB;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,8BAA8B;IACxC,WAAW,EAAE,6BAA6B;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,upBAAupB;IACzpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;aAChC;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,2JAA2J;gBAC7J,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,gGAAgG;aACnG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;KACjG;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAiB,EAAE,IAAyC,EAAE,EAAE;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,mBAAmB,CACxB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CACtF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,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/usage/ingest-v1-usage.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=ingest-v1-usage.d.mts.map

package/tools/v1/usage/ingest-v1-usage.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-v1-usage.d.mts","sourceRoot":"","sources":["../../../src/tools/v1/usage/ingest-v1-usage.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAqClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAIzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAM1F,wBAA2C"}

package/tools/v1/usage/ingest-v1-usage.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=ingest-v1-usage.d.ts.map

package/tools/v1/usage/ingest-v1-usage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-v1-usage.d.ts","sourceRoot":"","sources":["../../../src/tools/v1/usage/ingest-v1-usage.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAqClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAIzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJoC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAM1F,wBAA2C"}

package/tools/v1/usage/ingest-v1-usage.js

@@ -1,58 +0,0 @@
-"use strict";
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handler = exports.tool = exports.metadata = void 0;
-const types_1 = require("@metronome/mcp/tools/types");
-exports.metadata = {
-    resource: 'v1.usage',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/ingest',
-    operationId: 'ingest-v1',
-};
-exports.tool = {
-    name: 'ingest_v1_usage',
-    description: 'The ingest endpoint is the primary method for sending usage events to Metronome, serving as the foundation for all billing calculations in your usage-based pricing model. This high-throughput endpoint is designed for real-time streaming ingestion, supports backdating 34 days, and is built to handle mission-critical usage data with enterprise-grade reliability. Metronome supports 100,000 events per second without requiring pre-aggregation or rollups and can scale up from there. See the [Send usage events](/guides/events/send-usage-events) guide to learn more about usage events.\n\n### Use this endpoint to:\nCreate a customer usage pipeline into Metronome that drives billable metrics, credit drawdown, and invoicing. Track customer behavior, resource consumption, and feature usage\n\n### What happens when you send events:\n- Events are validated and processed in real-time\n- Events are matched to customers using customer IDs or customer ingest aliases\n- Events are matched to billable metrics and are immediately available for usage and spend calculations\n\n### Usage guidelines:\n- Historical events can be backdated up to 34 days and will immediately impact live customer spend\n- Duplicate events are automatically detected and ignored (34-day deduplication window)\n\n#### Event structure:\nUsage events are simple JSON objects designed for flexibility and ease of integration:\n```json\n{\n  "transaction_id": "2021-01-01T00:00:00Z_cluster42",\n  "customer_id": "team@example.com",\n  "event_type": "api_request",\n  "timestamp": "2021-01-01T00:00:00Z",\n  "properties": {\n    "endpoint": "/v1/users",\n    "method": "POST",\n    "response_time_ms": 45,\n    "region": "us-west-2"\n  }\n}\n```\n\nLearn more about [usage event structure definitions](/guides/events/design-usage-events).\n\n#### Transaction ID\n  The transaction_id serves as your idempotency key, ensuring events are processed exactly once. Metronome maintains a 34-day deduplication window - significantly longer than typical 12-hour windows - enabling robust backfill scenarios without duplicate billing.\n  - Best Practices:\n    - Use UUIDs for one-time events: uuid4()\n    - For heartbeat events, use deterministic IDs\n    - Include enough context to avoid collisions across different event sources\n\n#### Customer ID\nIdentifies which customer should be billed for this usage. Supports two identification methods:\n  - Metronome Customer ID: The UUID returned when creating a customer\n  - Ingest Alias: Your system\'s identifier (email, account number, etc.) \n\nIngest aliases enable seamless integration without requiring ID mapping, and customers can have multiple aliases for flexibility.\n\n#### Event Type:\nCategorizes the event type for billable metric matching. Choose descriptive names that aligns with the product surface area.\n\n#### Properties:\nFlexible metadata also used to match billable metrics or to be used to serve as group keys to create multiple pricing dimensions or breakdown costs by novel properties for end customers or internal finance teams measuring underlying COGs.\n',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            usage: {
-                type: 'array',
-                items: {
-                    type: 'object',
-                    properties: {
-                        customer_id: {
-                            type: 'string',
-                        },
-                        event_type: {
-                            type: 'string',
-                        },
-                        timestamp: {
-                            type: 'string',
-                            description: 'RFC 3339 formatted',
-                        },
-                        transaction_id: {
-                            type: 'string',
-                        },
-                        properties: {
-                            type: 'object',
-                            additionalProperties: true,
-                        },
-                    },
-                    required: ['customer_id', 'event_type', 'timestamp', 'transaction_id'],
-                },
-            },
-        },
-        required: [],
-    },
-    annotations: {},
-};
-const handler = async (client, args) => {
-    const body = args;
-    const response = await client.v1.usage.ingest(body).asResponse();
-    return (0, types_1.asTextContentResult)(await response.text());
-};
-exports.handler = handler;
-exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
-//# sourceMappingURL=ingest-v1-usage.js.map

package/tools/v1/usage/ingest-v1-usage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-v1-usage.js","sourceRoot":"","sources":["../../../src/tools/v1/usage/ingest-v1-usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,WAAW;CACzB,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,0hGAA0hG;IAC5hG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;yBACf;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,oBAAoB;yBAClC;wBACD,cAAc,EAAE;4BACd,IAAI,EAAE,QAAQ;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,IAAI;yBAC3B;qBACF;oBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,CAAC;iBACvE;aACF;SACF;QACD,QAAQ,EAAE,EAAE;KACb;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,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACjE,OAAO,IAAA,2BAAmB,EAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/v1/usage/ingest-v1-usage.mjs

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { asTextContentResult } from '@metronome/mcp/tools/types';
-export const metadata = {
-    resource: 'v1.usage',
-    operation: 'write',
-    tags: [],
-    httpMethod: 'post',
-    httpPath: '/v1/ingest',
-    operationId: 'ingest-v1',
-};
-export const tool = {
-    name: 'ingest_v1_usage',
-    description: 'The ingest endpoint is the primary method for sending usage events to Metronome, serving as the foundation for all billing calculations in your usage-based pricing model. This high-throughput endpoint is designed for real-time streaming ingestion, supports backdating 34 days, and is built to handle mission-critical usage data with enterprise-grade reliability. Metronome supports 100,000 events per second without requiring pre-aggregation or rollups and can scale up from there. See the [Send usage events](/guides/events/send-usage-events) guide to learn more about usage events.\n\n### Use this endpoint to:\nCreate a customer usage pipeline into Metronome that drives billable metrics, credit drawdown, and invoicing. Track customer behavior, resource consumption, and feature usage\n\n### What happens when you send events:\n- Events are validated and processed in real-time\n- Events are matched to customers using customer IDs or customer ingest aliases\n- Events are matched to billable metrics and are immediately available for usage and spend calculations\n\n### Usage guidelines:\n- Historical events can be backdated up to 34 days and will immediately impact live customer spend\n- Duplicate events are automatically detected and ignored (34-day deduplication window)\n\n#### Event structure:\nUsage events are simple JSON objects designed for flexibility and ease of integration:\n```json\n{\n  "transaction_id": "2021-01-01T00:00:00Z_cluster42",\n  "customer_id": "team@example.com",\n  "event_type": "api_request",\n  "timestamp": "2021-01-01T00:00:00Z",\n  "properties": {\n    "endpoint": "/v1/users",\n    "method": "POST",\n    "response_time_ms": 45,\n    "region": "us-west-2"\n  }\n}\n```\n\nLearn more about [usage event structure definitions](/guides/events/design-usage-events).\n\n#### Transaction ID\n  The transaction_id serves as your idempotency key, ensuring events are processed exactly once. Metronome maintains a 34-day deduplication window - significantly longer than typical 12-hour windows - enabling robust backfill scenarios without duplicate billing.\n  - Best Practices:\n    - Use UUIDs for one-time events: uuid4()\n    - For heartbeat events, use deterministic IDs\n    - Include enough context to avoid collisions across different event sources\n\n#### Customer ID\nIdentifies which customer should be billed for this usage. Supports two identification methods:\n  - Metronome Customer ID: The UUID returned when creating a customer\n  - Ingest Alias: Your system\'s identifier (email, account number, etc.) \n\nIngest aliases enable seamless integration without requiring ID mapping, and customers can have multiple aliases for flexibility.\n\n#### Event Type:\nCategorizes the event type for billable metric matching. Choose descriptive names that aligns with the product surface area.\n\n#### Properties:\nFlexible metadata also used to match billable metrics or to be used to serve as group keys to create multiple pricing dimensions or breakdown costs by novel properties for end customers or internal finance teams measuring underlying COGs.\n',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            usage: {
-                type: 'array',
-                items: {
-                    type: 'object',
-                    properties: {
-                        customer_id: {
-                            type: 'string',
-                        },
-                        event_type: {
-                            type: 'string',
-                        },
-                        timestamp: {
-                            type: 'string',
-                            description: 'RFC 3339 formatted',
-                        },
-                        transaction_id: {
-                            type: 'string',
-                        },
-                        properties: {
-                            type: 'object',
-                            additionalProperties: true,
-                        },
-                    },
-                    required: ['customer_id', 'event_type', 'timestamp', 'transaction_id'],
-                },
-            },
-        },
-        required: [],
-    },
-    annotations: {},
-};
-export const handler = async (client, args) => {
-    const body = args;
-    const response = await client.v1.usage.ingest(body).asResponse();
-    return asTextContentResult(await response.text());
-};
-export default { metadata, tool, handler };
-//# sourceMappingURL=ingest-v1-usage.mjs.map

package/tools/v1/usage/ingest-v1-usage.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-v1-usage.mjs","sourceRoot":"","sources":["../../../src/tools/v1/usage/ingest-v1-usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,WAAW;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,0hGAA0hG;IAC5hG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;yBACf;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,oBAAoB;yBAClC;wBACD,cAAc,EAAE;4BACd,IAAI,EAAE,QAAQ;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,IAAI;yBAC3B;qBACF;oBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,CAAC;iBACvE;aACF;SACF;QACD,QAAQ,EAAE,EAAE;KACb;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,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACjE,OAAO,mBAAmB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}