@raytio/mcp-server 10.2.0 → 10.4.0

package/dist/tools/pbm/pbm-customer-entitlement-override-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-customer-entitlement-override-set.js","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-customer-entitlement-override-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAS;IACzD,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,qFAAqF;QACrF,+EAA+E;QAC/E,sFAAsF;QACtF,iFAAiF;IACnF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,mEAAmE,CAAC;QAChF,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,0DAA0D,CAAC;QACvE,KAAK,EAAE,CAAC;aACL,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,CACP,kFAAkF,CACnF;QACH,MAAM,EAAE,YAAY,CAAC,QAAQ,CAC3B,kEAAkE,CACnE;QACD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,oCAAoC,EAAE,QAAQ,CAAC,CAAC;IACnE,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAA2B,CAAC;QAC1C,MAAM,IAAI,GAAwB;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CACnC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,8CAA8C,EACzE,IAAI,EACJ,EAAE,OAAO,EAAE,2BAA2B,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAChE,CAAC;YACF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAClB,SAAS,EACT,oDAAoD,KAAK,CAAC,OAAO,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/pbm/pbm-subscription-cancel.d.ts

@@ -0,0 +1,21 @@
+import { Tool } from '../registry.js';
+/**
+ * Cancellation semantic tool for a PBM billing subscription.
+ *
+ * Writes the cancellation columns through the
+ * `pbm_billing_subscriptions_u` update view. Persist's
+ * `call_generate_billing_invoices_cancellation_update` trigger then
+ * schedules the final invoice job, but only for an active BILLABLE
+ * subscription: on any other status the columns would be stored and
+ * nothing would happen. The tool reads the row first and refuses those.
+ *
+ * It also returns a subscription that already has a cancellation date
+ * unchanged. Persist resets `cancellation_request_date` to now on every
+ * update of such a row, and a changed reason or action could schedule
+ * another job, so a retry must not write.
+ *
+ * `cancellation_request_date` is not an input because that trigger
+ * overwrites whatever is supplied.
+ */
+export declare const pbmSubscriptionCancelTool: Tool;
+//# sourceMappingURL=pbm-subscription-cancel.d.ts.map

package/dist/tools/pbm/pbm-subscription-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-cancel.d.ts","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-cancel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,yBAAyB,EAAE,IAmFvC,CAAC"}

package/dist/tools/pbm/pbm-subscription-cancel.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema, reasonSchema, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Cancellation semantic tool for a PBM billing subscription.
+ *
+ * Writes the cancellation columns through the
+ * `pbm_billing_subscriptions_u` update view. Persist's
+ * `call_generate_billing_invoices_cancellation_update` trigger then
+ * schedules the final invoice job, but only for an active BILLABLE
+ * subscription: on any other status the columns would be stored and
+ * nothing would happen. The tool reads the row first and refuses those.
+ *
+ * It also returns a subscription that already has a cancellation date
+ * unchanged. Persist resets `cancellation_request_date` to now on every
+ * update of such a row, and a changed reason or action could schedule
+ * another job, so a retry must not write.
+ *
+ * `cancellation_request_date` is not an input because that trigger
+ * overwrites whatever is supplied.
+ */
+export const pbmSubscriptionCancelTool = {
+    name: 'pbm_subscription_cancel',
+    description: 'Cancel a BILLABLE PBM billing subscription: records the cancellation and Persist schedules ' +
+        'the final invoice job. The subscription closes when that job runs, so subscription_status ' +
+        'stays BILLABLE until then. Any other status is refused, because no job would be scheduled. ' +
+        'Requires confirm=true and a reason. A subscription already cancelled is returned unchanged, ' +
+        'so retries are safe.',
+    inputSchema: z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe('UUID of the pbm_billing_subscriptions row to cancel'),
+        cancellation_effective_date: z
+            .string()
+            .min(1)
+            .describe('ISO 8601 date cancellation takes effect (required). Persist rejects a date before ' +
+            'the current billing period start.'),
+        cancellation_final_invoice_action: z
+            .enum(['CYCLE_END', 'PRORATE_CYCLE_END', 'IMMEDIATE', 'PRORATE_IMMEDIATE'])
+            .optional()
+            .describe('Final invoice policy. Defaults to the value on the subscription, normally CYCLE_END.'),
+        reason: reasonSchema.describe('Human-readable reason, stored in cancellation_request_reason'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [
+        cap('pbm_billing_subscriptions', 'SELECT'),
+        cap('pbm_billing_subscriptions_u', 'UPDATE'),
+    ],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const notFound = () => errorResponse(API_ERROR, `PBM billing subscription ${input.id} not found or not accessible`);
+        const body = {
+            cancellation_effective_date: input.cancellation_effective_date,
+            cancellation_request_reason: input.reason,
+        };
+        if (input.cancellation_final_invoice_action !== undefined) {
+            body.cancellation_final_invoice_action = input.cancellation_final_invoice_action;
+        }
+        try {
+            const current = await ctx.apiClient.get(`${ctx.apiClient.dbBasePath}/pbm_billing_subscriptions?id=eq.${input.id}&select=*`);
+            if (!current || current.length === 0)
+                return notFound();
+            const row = current[0];
+            if (row.cancellation_effective_date)
+                return successResponse(row);
+            if (row.subscription_status !== 'BILLABLE' || row.active === false) {
+                return errorResponse(API_ERROR, `PBM billing subscription ${input.id} is ${row.subscription_status}: ` +
+                    'only an active BILLABLE subscription can be cancelled');
+            }
+            const rows = await ctx.apiClient.patch(`${ctx.apiClient.dbBasePath}/pbm_billing_subscriptions_u?id=eq.${input.id}&select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            if (!rows || rows.length === 0)
+                return notFound();
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to cancel PBM billing subscription: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pbm-subscription-cancel.js.map

package/dist/tools/pbm/pbm-subscription-cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-cancel.js","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-cancel.ts"],"names":[],"mappings":"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"}

package/dist/tools/pbm/pbm-subscription-create.d.ts

@@ -0,0 +1,20 @@
+import { Tool } from '../registry.js';
+/**
+ * Provisioning semantic tool: create a PBM billing subscription
+ * (`pbm_billing_subscriptions`). Requires `confirm: true`.
+ *
+ * The subscription starts PENDING, and billing starts when it becomes
+ * BILLABLE. MCP has no tool for that step. Persist has no unique key
+ * here, so a retry creates a second subscription.
+ *
+ * Cancellation columns (`cancellation_effective_date`,
+ * `cancellation_request_date`, `cancellation_request_reason`,
+ * `cancellation_final_invoice_action`) are intentionally NOT writable
+ * through this tool — cancellation is a lifecycle event handled by
+ * `pbm_subscription_cancel`. `subscription_status` is not an input.
+ *
+ * Payment method / gateway credentials live in an excluded FXM table
+ * (fxm_payment_processor_credentials) and cannot be set through MCP.
+ */
+export declare const pbmSubscriptionCreateTool: Tool;
+//# sourceMappingURL=pbm-subscription-create.d.ts.map

package/dist/tools/pbm/pbm-subscription-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-create.d.ts","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,EAAE,IA0EvC,CAAC"}

package/dist/tools/pbm/pbm-subscription-create.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Provisioning semantic tool: create a PBM billing subscription
+ * (`pbm_billing_subscriptions`). Requires `confirm: true`.
+ *
+ * The subscription starts PENDING, and billing starts when it becomes
+ * BILLABLE. MCP has no tool for that step. Persist has no unique key
+ * here, so a retry creates a second subscription.
+ *
+ * Cancellation columns (`cancellation_effective_date`,
+ * `cancellation_request_date`, `cancellation_request_reason`,
+ * `cancellation_final_invoice_action`) are intentionally NOT writable
+ * through this tool — cancellation is a lifecycle event handled by
+ * `pbm_subscription_cancel`. `subscription_status` is not an input.
+ *
+ * Payment method / gateway credentials live in an excluded FXM table
+ * (fxm_payment_processor_credentials) and cannot be set through MCP.
+ */
+export const pbmSubscriptionCreateTool = {
+    name: 'pbm_subscription_create',
+    description: 'Create a PBM billing subscription (pbm_billing_subscriptions). It starts PENDING and is ' +
+        'not billed until it becomes BILLABLE, which MCP cannot do. Requires confirm=true. ' +
+        'Not deduplicated: calling it again creates another subscription, so check ' +
+        'pbm_billing_subscriptions_list filtered on subscribed_to_customer_id before retrying.',
+    inputSchema: z.object({
+        subscribed_to_customer_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the far_customers row this subscription bills'),
+        subscribed_to_party_contact_point_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the party contact point (billing contact) — required'),
+        subscribed_to_customer_site_id: z.string().min(1).optional(),
+        subscription_name: z.string().max(256).optional(),
+        subscription_name_i18n: z.record(z.string()).optional(),
+        billing_cycle_month: z.number().int().min(1).max(12).optional(),
+        billing_cycle_day_of_month: z.number().int().min(1).max(31).optional(),
+        billing_cycle_day_of_week: z.number().int().min(0).max(6).optional(),
+        billing_cycle_hour: z.number().int().min(0).max(23).optional(),
+        billing_cycle_minute: z.number().int().min(0).max(59).optional(),
+        billing_cycle_second: z.number().int().min(0).max(59).optional(),
+        subscription_timezone_offset_minutes: z.number().int().optional(),
+        start_date: z.string().min(1).optional().describe('ISO 8601 subscription start'),
+        end_date: z.string().min(1).optional().describe('ISO 8601 subscription end (rare on create)'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('pbm_billing_subscriptions', 'INSERT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            subscribed_to_customer_id: input.subscribed_to_customer_id,
+            subscribed_to_party_contact_point_id: input.subscribed_to_party_contact_point_id,
+        };
+        for (const field of [
+            'subscribed_to_customer_site_id',
+            'subscription_name',
+            'subscription_name_i18n',
+            'billing_cycle_month',
+            'billing_cycle_day_of_month',
+            'billing_cycle_day_of_week',
+            'billing_cycle_hour',
+            'billing_cycle_minute',
+            'billing_cycle_second',
+            'subscription_timezone_offset_minutes',
+            'start_date',
+            'end_date',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/pbm_billing_subscriptions?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create PBM billing subscription: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pbm-subscription-create.js.map

package/dist/tools/pbm/pbm-subscription-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-create.js","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAS;IAC7C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,0FAA0F;QAC1F,oFAAoF;QACpF,4EAA4E;QAC5E,uFAAuF;IACzF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,yBAAyB,EAAE,CAAC;aACzB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,uDAAuD,CAAC;QACpE,oCAAoC,EAAE,CAAC;aACpC,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,8DAA8D,CAAC;QAC3E,8BAA8B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACjD,sBAAsB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACvD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC/D,0BAA0B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtE,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACpE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC9D,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAChE,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAChE,oCAAoC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACjE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC7F,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IAC1D,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAA2B,CAAC;QAC1C,MAAM,IAAI,GAAwB;YAChC,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;YAC1D,oCAAoC,EAClC,KAAK,CAAC,oCAAoC;SAC7C,CAAC;QACF,KAAK,MAAM,KAAK,IAAI;YAClB,gCAAgC;YAChC,mBAAmB;YACnB,wBAAwB;YACxB,qBAAqB;YACrB,4BAA4B;YAC5B,2BAA2B;YAC3B,oBAAoB;YACpB,sBAAsB;YACtB,sBAAsB;YACtB,sCAAsC;YACtC,YAAY;YACZ,UAAU;YACV,UAAU;SACX,EAAE,CAAC;YACF,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CACnC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,qCAAqC,EAChE,IAAI,EACJ,EAAE,OAAO,EAAE,2BAA2B,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAChE,CAAC;YACF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAClB,SAAS,EACT,8CAA8C,KAAK,CAAC,OAAO,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/pbm/pbm-subscription-line-add.d.ts

@@ -0,0 +1,13 @@
+import { Tool } from '../registry.js';
+/**
+ * Provisioning semantic tool: add a line (priced item) to a PBM billing
+ * subscription (`pbm_billing_subscription_lines`).
+ *
+ * Persist refuses the insert unless the parent is PENDING, and requires
+ * every line on a subscription to share a currency and billing interval.
+ * `subscribed_to_customer_id` is set from the parent by a trigger, so it
+ * is not an input. There is no unique key on these lines, so a retry
+ * adds a second line and the customer would be billed for both.
+ */
+export declare const pbmSubscriptionLineAddTool: Tool;
+//# sourceMappingURL=pbm-subscription-line-add.d.ts.map

package/dist/tools/pbm/pbm-subscription-line-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-line-add.d.ts","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-line-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAuDxC,CAAC"}

package/dist/tools/pbm/pbm-subscription-line-add.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Provisioning semantic tool: add a line (priced item) to a PBM billing
+ * subscription (`pbm_billing_subscription_lines`).
+ *
+ * Persist refuses the insert unless the parent is PENDING, and requires
+ * every line on a subscription to share a currency and billing interval.
+ * `subscribed_to_customer_id` is set from the parent by a trigger, so it
+ * is not an input. There is no unique key on these lines, so a retry
+ * adds a second line and the customer would be billed for both.
+ */
+export const pbmSubscriptionLineAddTool = {
+    name: 'pbm_subscription_line_add',
+    description: 'Add a priced line to a PENDING PBM billing subscription (pbm_billing_subscription_lines). ' +
+        'Persist refuses any other status, and every line must share a currency and billing ' +
+        'interval. Requires confirm=true. Not deduplicated: calling it again adds another line that ' +
+        'would also be billed, so check pbm_billing_subscription_lines_list before retrying.',
+    inputSchema: z.object({
+        billing_subscription_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the parent pbm_billing_subscriptions row (required)'),
+        price_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the pcm_prices row this line bills against (required)'),
+        subscribed_qty: z.number().optional().describe('Quantity of the priced item'),
+        start_date: z.string().min(1).optional().describe('ISO 8601 line start (defaults to today)'),
+        end_date: z.string().min(1).optional().describe('ISO 8601 line end (rarely on create)'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('pbm_billing_subscription_lines', 'INSERT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            billing_subscription_id: input.billing_subscription_id,
+            price_id: input.price_id,
+        };
+        for (const field of [
+            'subscribed_qty',
+            'start_date',
+            'end_date',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/pbm_billing_subscription_lines?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to add PBM subscription line: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pbm-subscription-line-add.js.map

package/dist/tools/pbm/pbm-subscription-line-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-line-add.js","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-line-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,4FAA4F;QAC5F,qFAAqF;QACrF,6FAA6F;QAC7F,qFAAqF;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,uBAAuB,EAAE,CAAC;aACvB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,+DAA+D,CAAC;QAC5E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAC5F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACvF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IAC/D,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAA2B,CAAC;QAC1C,MAAM,IAAI,GAAwB;YAChC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;YACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;QACF,KAAK,MAAM,KAAK,IAAI;YAClB,gBAAgB;YAChB,YAAY;YACZ,UAAU;YACV,UAAU;SACX,EAAE,CAAC;YACF,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CACnC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,0CAA0C,EACrE,IAAI,EACJ,EAAE,OAAO,EAAE,2BAA2B,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAChE,CAAC;YACF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAClB,SAAS,EACT,wCAAwC,KAAK,CAAC,OAAO,EAAE,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/pbm/pbm-subscription-line-end.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from '../registry.js';
+/**
+ * State-change semantic tool: close a subscription line by setting its
+ * `end_date` (`pbm_billing_subscription_lines`). The reason is merged
+ * into `metadata.line_end_reason`.
+ *
+ * Persist's `prevent_subscription_line_for_parent_status` trigger
+ * refuses every insert and update unless the parent subscription is
+ * PENDING, so this cannot change a subscription that is already billing.
+ */
+export declare const pbmSubscriptionLineEndTool: Tool;
+//# sourceMappingURL=pbm-subscription-line-end.d.ts.map

package/dist/tools/pbm/pbm-subscription-line-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-line-end.d.ts","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-line-end.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAwCxC,CAAC"}

package/dist/tools/pbm/pbm-subscription-line-end.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema, reasonSchema, unenforcedIdempotencyKeySchema, } from '../_shared/side-effect.js';
+import { softDeactivate } from '../_shared/soft-deactivate.js';
+/**
+ * State-change semantic tool: close a subscription line by setting its
+ * `end_date` (`pbm_billing_subscription_lines`). The reason is merged
+ * into `metadata.line_end_reason`.
+ *
+ * Persist's `prevent_subscription_line_for_parent_status` trigger
+ * refuses every insert and update unless the parent subscription is
+ * PENDING, so this cannot change a subscription that is already billing.
+ */
+export const pbmSubscriptionLineEndTool = {
+    name: 'pbm_subscription_line_end',
+    description: 'Close a PBM subscription line by setting end_date and merge the reason into metadata. ' +
+        'Persist only allows this while the parent subscription is PENDING, so it cannot change what ' +
+        'a billing subscription charges. Requires confirm=true and a reason. A line already ending ' +
+        'on that date is returned unchanged, so retries are safe.',
+    inputSchema: z.object({
+        id: z.string().min(1).describe('UUID of the pbm_billing_subscription_lines row to close'),
+        end_date: z
+            .string()
+            .min(1)
+            .describe('ISO 8601 date the line ends (required)'),
+        reason: reasonSchema.describe('Human-readable reason, merged into metadata'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('pbm_billing_subscription_lines', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        return softDeactivate(ctx, {
+            table: 'pbm_billing_subscription_lines',
+            id: input.id,
+            label: 'PBM subscription line',
+            verb: 'end',
+            isDone: (row) => new Date(row.end_date).getTime() === new Date(input.end_date).getTime(),
+            changes: () => ({ end_date: input.end_date }),
+            reasonKey: 'line_end_reason',
+            reason: input.reason,
+            idempotencyKey: input.idempotency_key,
+        });
+    },
+};
+//# sourceMappingURL=pbm-subscription-line-end.js.map

package/dist/tools/pbm/pbm-subscription-line-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-subscription-line-end.js","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-subscription-line-end.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,wFAAwF;QACxF,8FAA8F;QAC9F,4FAA4F;QAC5F,0DAA0D;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACzF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,wCAAwC,CAAC;QACrD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC5E,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IAC/D,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAKb,CAAC;QACF,OAAO,cAAc,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,gCAAgC;YACvC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,uBAAuB;YAC9B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;YACxF,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC7C,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/pcm/generated-reads.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '../registry.js';
+import { CatalogueReport } from '../../generated-reads/index.js';
+export declare const pcmGeneratedReadReport: CatalogueReport;
+export declare const pcmGeneratedReadTools: Tool[];
+//# sourceMappingURL=generated-reads.d.ts.map

package/dist/tools/pcm/generated-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-reads.d.ts","sourceRoot":"","sources":["../../../src/tools/pcm/generated-reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAGL,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAwBxC,eAAO,MAAM,sBAAsB,EAAE,eAGjC,CAAC;AAEL,eAAO,MAAM,qBAAqB,EAAE,IAAI,EAGvC,CAAC"}

package/dist/tools/pcm/generated-reads.js

@@ -0,0 +1,26 @@
+import { buildGeneratedReadCatalogue, buildGeneratedReadCatalogueReport, } from '../../generated-reads/index.js';
+import { loadPersistResourceContract } from '../../contracts/persist-resource-contract.js';
+/**
+ * Bounded read tools for the PCM (Price / Cost Management) module
+ * (WI-0003506).
+ *
+ * Every PCM resource is classified `normal` (no credentials), so no
+ * field-level redaction is required — but the framework still refuses
+ * to emit generic `create` / `update` / `delete` tools for tables that
+ * carry pricing state. Writes (register or deactivate a price list,
+ * create a version) are dedicated tools that require confirm=true.
+ *
+ * Resources surfaced (all `list`+`read`):
+ *  - pcm_price_lists, pcm_price_list_versions
+ *  - pcm_price_list_lines, pcm_price_list_lines_interface,
+ *    pcm_price_list_lines_interface_batch
+ *  - pcm_price_list_rules, pcm_price_list_rule_lines
+ *  - pcm_price_list_parties, pcm_price_list_price_list_type_lookup
+ *  - pcm_prices, pcm_price_tiers
+ */
+const contract = loadPersistResourceContract();
+export const pcmGeneratedReadReport = buildGeneratedReadCatalogueReport(contract, {
+    modules: ['pcm'],
+});
+export const pcmGeneratedReadTools = buildGeneratedReadCatalogue(contract, { modules: ['pcm'] });
+//# sourceMappingURL=generated-reads.js.map

package/dist/tools/pcm/generated-reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-reads.js","sourceRoot":"","sources":["../../../src/tools/pcm/generated-reads.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAElC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAE3F;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GACjC,iCAAiC,CAAC,QAAQ,EAAE;IAC1C,OAAO,EAAE,CAAC,KAAK,CAAC;CACjB,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,qBAAqB,GAAW,2BAA2B,CACtE,QAAQ,EACR,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CACrB,CAAC"}

package/dist/tools/pcm/index.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '../registry.js';
+export declare const pcmTools: Tool[];
+/** Read-only slice used by the `pcm-readonly` selectable sub-domain. */
+export declare const pcmReadOnlyTools: Tool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/pcm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/pcm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAetC,eAAO,MAAM,QAAQ,EAAE,IAAI,EAAiD,CAAC;AAE7E,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAA0B,CAAC"}

package/dist/tools/pcm/index.js

@@ -0,0 +1,16 @@
+import { pcmGeneratedReadTools } from './generated-reads.js';
+import { pcmPriceListRegisterTool } from './pcm-price-list-register.js';
+import { pcmPriceListDeactivateTool } from './pcm-price-list-deactivate.js';
+import { pcmPriceListVersionCreateTool } from './pcm-price-list-version-create.js';
+// Price list lines belong to the shared import tools (definition_code
+// PCM_PRICE_LIST_LINES), which need moving to the PostgREST import API first (WI-0009453).
+// Pricing rules have no write tool: see the 10.4.0 changelog.
+const pcmWriteTools = [
+    pcmPriceListRegisterTool,
+    pcmPriceListDeactivateTool,
+    pcmPriceListVersionCreateTool,
+];
+export const pcmTools = [...pcmGeneratedReadTools, ...pcmWriteTools];
+/** Read-only slice used by the `pcm-readonly` selectable sub-domain. */
+export const pcmReadOnlyTools = pcmGeneratedReadTools;
+//# sourceMappingURL=index.js.map

package/dist/tools/pcm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/pcm/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,sEAAsE;AACtE,2FAA2F;AAC3F,8DAA8D;AAC9D,MAAM,aAAa,GAAW;IAC5B,wBAAwB;IACxB,0BAA0B;IAC1B,6BAA6B;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAW,CAAC,GAAG,qBAAqB,EAAE,GAAG,aAAa,CAAC,CAAC;AAE7E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAW,qBAAqB,CAAC"}

package/dist/tools/pcm/pcm-price-list-deactivate.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '../registry.js';
+/**
+ * Deactivate a price list (`pcm_price_lists`) by setting `active=false`.
+ * Its versions and lines are kept. The unique key on name and type only
+ * covers active lists, so deactivating frees the name for a new list.
+ *
+ * The tool reads the list first: the reason is merged into `metadata`,
+ * and a list already inactive is returned unchanged.
+ */
+export declare const pcmPriceListDeactivateTool: Tool;
+//# sourceMappingURL=pcm-price-list-deactivate.d.ts.map

package/dist/tools/pcm/pcm-price-list-deactivate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-price-list-deactivate.d.ts","sourceRoot":"","sources":["../../../src/tools/pcm/pcm-price-list-deactivate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAsCxC,CAAC"}

package/dist/tools/pcm/pcm-price-list-deactivate.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema, reasonSchema, unenforcedIdempotencyKeySchema, } from '../_shared/side-effect.js';
+import { softDeactivate, softDeactivateEndDateSchema } from '../_shared/soft-deactivate.js';
+/**
+ * Deactivate a price list (`pcm_price_lists`) by setting `active=false`.
+ * Its versions and lines are kept. The unique key on name and type only
+ * covers active lists, so deactivating frees the name for a new list.
+ *
+ * The tool reads the list first: the reason is merged into `metadata`,
+ * and a list already inactive is returned unchanged.
+ */
+export const pcmPriceListDeactivateTool = {
+    name: 'pcm_price_list_deactivate',
+    description: 'Deactivate a price list (pcm_price_lists) by setting active=false and merging the reason ' +
+        'into metadata. Requires confirm=true and a reason. Versions and lines are kept, and the ' +
+        'name and type become free for a new active list. A list already inactive is returned ' +
+        'unchanged, so retries are safe. end_date is left alone unless supplied.',
+    inputSchema: z.object({
+        id: z.string().uuid().describe('UUID of the pcm_price_lists row to deactivate'),
+        reason: reasonSchema.describe('Human-readable reason, merged into metadata'),
+        end_date: softDeactivateEndDateSchema,
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('pcm_price_lists', 'UPDATE'), cap('pcm_price_lists', 'SELECT')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        return softDeactivate(ctx, {
+            table: 'pcm_price_lists',
+            id: input.id,
+            label: 'PCM price list',
+            verb: 'deactivate',
+            isDone: (row) => row.active === false,
+            changes: () => ({ active: false }),
+            reasonKey: 'deactivation_reason',
+            reason: input.reason,
+            endDate: input.end_date,
+            idempotencyKey: input.idempotency_key,
+        });
+    },
+};
+//# sourceMappingURL=pcm-price-list-deactivate.js.map

package/dist/tools/pcm/pcm-price-list-deactivate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-price-list-deactivate.js","sourceRoot":"","sources":["../../../src/tools/pcm/pcm-price-list-deactivate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,2FAA2F;QAC3F,0FAA0F;QAC1F,uFAAuF;QACvF,yEAAyE;IAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC/E,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC5E,QAAQ,EAAE,2BAA2B;QACrC,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAClF,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAKb,CAAC;QACF,OAAO,cAAc,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,iBAAiB;YACxB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,gBAAgB;YACvB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK;YACrC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAClC,SAAS,EAAE,qBAAqB;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,cAAc,EAAE,KAAK,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/pcm/pcm-price-list-register.d.ts

@@ -0,0 +1,21 @@
+import { Tool } from '../registry.js';
+/** Values of the Persist PCM_PRICE_LISTS_VISIBILITY lookup. */
+export declare const PCM_PRICE_LIST_VISIBILITIES: readonly ["PARTY", "AUTHENTICATED", "PUBLIC"];
+/**
+ * Register a price list (`pcm_price_lists`), the container that price
+ * list versions and lines attach to.
+ *
+ * Unique key: `t_pcm_price_lists_ui` on (price_list_name,
+ * price_list_type) among active price lists in the tenant, so a retry
+ * fails with a duplicate-key error instead of creating a second list.
+ *
+ * `pcm_price_lists` is not routed by organisation: Persist fills a
+ * missing `org_id` with the tenant's lowest organisation id, so the tool
+ * requires it.
+ *
+ * `visibility=PUBLIC` makes Persist write a wildcard viewer tuple, so
+ * anyone, including unauthenticated callers, can read the list. The
+ * tool needs `allow_public=true` as well as `confirm=true` for that.
+ */
+export declare const pcmPriceListRegisterTool: Tool;
+//# sourceMappingURL=pcm-price-list-register.d.ts.map

package/dist/tools/pcm/pcm-price-list-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-price-list-register.d.ts","sourceRoot":"","sources":["../../../src/tools/pcm/pcm-price-list-register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAgBtC,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,+CAAgD,CAAC;AAEzF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAyEtC,CAAC"}