@raytio/mcp-server 10.1.0 → 10.3.0

package/dist/tools/ixn/ixn-conversation-start.js

@@ -0,0 +1,98 @@
+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';
+/**
+ * State-change semantic tool: open a new interaction conversation
+ * (`ixn_conversations`). Starting a conversation binds a channel
+ * endpoint / queue to a work-item, lead, or deal, so the tool
+ * requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a `channel_endpoint_id` (the outbound / inbound channel this
+ *    thread is being opened on) — required by the pinned contract.
+ *
+ * Only `thread_id` protects a retry: (channel_endpoint_id, thread_id,
+ * tenant_id) is unique, so a repeat fails with a duplicate-key error.
+ * Without it each call opens another conversation, so the tool is not
+ * idempotent by default.
+ *
+ * `ixn_queues` is EXCLUDED from the MCP surface by the queue
+ * guardrail; queue routing is a persist-side concern and callers
+ * reference the queue by id only.
+ */
+export const ixnConversationStartTool = {
+    name: 'ixn_conversation_start',
+    description: 'Start a new interaction conversation (ixn_conversations) on a channel endpoint. ' +
+        'Requires confirm=true and a channel_endpoint_id. With thread_id, a retry on the same ' +
+        'channel endpoint fails with a duplicate-key error. Without it, calling again opens another ' +
+        'conversation, so check ixn_conversations_list before retrying.',
+    inputSchema: z.object({
+        channel_endpoint_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the ixn_channel_endpoints row this conversation runs on'),
+        queue_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the ixn_queues row that routes this conversation'),
+        thread_id: z
+            .string()
+            .max(512)
+            .optional()
+            .describe('External channel-side thread identifier. Unique per channel endpoint.'),
+        conversation_status: z
+            .string()
+            .max(32)
+            .optional()
+            .describe('Initial status from the IXN_CONVERSATIONS_CONVERSATION_STATUS lookup (OPEN, CLOSED)'),
+        lead_id: z.string().min(1).optional().describe('UUID of the sfa_leads row this conversation is scoped to'),
+        deal_id: z.string().min(1).optional().describe('UUID of the sfa_deals row this conversation is scoped to'),
+        org_id: z.string().min(1).optional().describe('UUID of the hrm_organizations_c row this conversation is scoped to'),
+        work_item_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the ppm_work_items row this conversation is scoped to'),
+        resource_url: z
+            .string()
+            .optional()
+            .describe('Optional URL of the external resource this conversation is anchored on'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('ixn_conversations', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            channel_endpoint_id: input.channel_endpoint_id,
+        };
+        for (const field of [
+            'queue_id',
+            'thread_id',
+            'conversation_status',
+            'lead_id',
+            'deal_id',
+            'org_id',
+            'work_item_id',
+            'resource_url',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/ixn_conversations?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to start IXN conversation: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=ixn-conversation-start.js.map

package/dist/tools/ixn/ixn-conversation-start.js.map

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

package/dist/tools/ixn/ixn-message-send.d.ts

@@ -0,0 +1,28 @@
+import { Tool } from '../registry.js';
+/**
+ * Communication semantic tool: dispatch an outbound message on an
+ * existing conversation (`ixn_messages`). The row this creates is
+ * picked up by the channel delivery worker and sent to the customer,
+ * so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation.
+ *
+ * Not deduplicated: Persist ignores the `Idempotency-Key` header and
+ * `ixn_messages` has no idempotent create path yet, so a repeat call
+ * sends a second message. The description tells callers to check first.
+ *
+ * `direction` is force-set to `OUTBOUND`, the exact value the
+ * `IXN_MESSAGES_DIRECTION` lookup holds and the only value the delivery
+ * trigger fires on — inbound messages arrive
+ * via the channel delivery worker, never via MCP; a caller wanting
+ * to log an inbound message should use the read tools plus the
+ * dedicated inbound-processing endpoints. `delivery_status` is
+ * server-assigned and returned on the created row for status
+ * polling via `ixn_messages_get`.
+ *
+ * Provider credentials (`ixn_channel_endpoints.outbound_credential_ssm_names`)
+ * are never read or set from this tool — the delivery worker
+ * resolves them server-side.
+ */
+export declare const ixnMessageSendTool: Tool;
+//# sourceMappingURL=ixn-message-send.d.ts.map

package/dist/tools/ixn/ixn-message-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ixn-message-send.d.ts","sourceRoot":"","sources":["../../../src/tools/ixn/ixn-message-send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAmEhC,CAAC"}

package/dist/tools/ixn/ixn-message-send.js

@@ -0,0 +1,92 @@
+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';
+/**
+ * Communication semantic tool: dispatch an outbound message on an
+ * existing conversation (`ixn_messages`). The row this creates is
+ * picked up by the channel delivery worker and sent to the customer,
+ * so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation.
+ *
+ * Not deduplicated: Persist ignores the `Idempotency-Key` header and
+ * `ixn_messages` has no idempotent create path yet, so a repeat call
+ * sends a second message. The description tells callers to check first.
+ *
+ * `direction` is force-set to `OUTBOUND`, the exact value the
+ * `IXN_MESSAGES_DIRECTION` lookup holds and the only value the delivery
+ * trigger fires on — inbound messages arrive
+ * via the channel delivery worker, never via MCP; a caller wanting
+ * to log an inbound message should use the read tools plus the
+ * dedicated inbound-processing endpoints. `delivery_status` is
+ * server-assigned and returned on the created row for status
+ * polling via `ixn_messages_get`.
+ *
+ * Provider credentials (`ixn_channel_endpoints.outbound_credential_ssm_names`)
+ * are never read or set from this tool — the delivery worker
+ * resolves them server-side.
+ */
+export const ixnMessageSendTool = {
+    name: 'ixn_message_send',
+    description: 'Dispatch an outbound message on an existing IXN conversation (ixn_messages). ' +
+        'Requires confirm=true, conversation_id, sender_identity and body_text. direction is ' +
+        'forced to OUTBOUND. delivery_status is server-assigned; poll status via ixn_messages_get ' +
+        'on the returned row id. Not deduplicated: calling it again sends the message again, so ' +
+        'check ixn_messages_list filtered on conversation_id before retrying.',
+    inputSchema: z.object({
+        conversation_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the ixn_conversations row this message is posted to'),
+        sender_identity: z
+            .string()
+            .min(1)
+            .max(256)
+            .describe('The sender recorded on the message. Email is sent from the channel endpoint address, not this value.'),
+        body_text: z.string().min(1).describe('The plain-text message body to dispatch'),
+        channel_msg_id: z
+            .string()
+            .max(256)
+            .optional()
+            .describe('Optional caller-supplied channel-side message identifier'),
+        sent_by_worker_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Optional UUID of the wrm_workers row this send is attributed to'),
+        org_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the hrm_organizations_c row this send is scoped to'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('ixn_messages', 'INSERT')],
+    sideEffect: 'communication',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            conversation_id: input.conversation_id,
+            sender_identity: input.sender_identity,
+            body_text: input.body_text,
+            direction: 'OUTBOUND',
+        };
+        for (const field of ['channel_msg_id', 'sent_by_worker_id', 'org_id', 'metadata']) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/ixn_messages?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to send IXN outbound message: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=ixn-message-send.js.map

package/dist/tools/ixn/ixn-message-send.js.map

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

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

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

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

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

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

@@ -0,0 +1,32 @@
+import { buildGeneratedReadCatalogue, buildGeneratedReadCatalogueReport, } from '../../generated-reads/index.js';
+import { loadPersistResourceContract } from '../../contracts/persist-resource-contract.js';
+/**
+ * Bounded read tools for the PBM module (WI-0003507).
+ *
+ * The schema-driven catalogue (WI-0003500) emits describe/list/get for
+ * every PBM resource that declares a read operation and has no side
+ * effects. The billing profile / subscription resources are classified
+ * `sensitive`; they carry customer billing state (billing cycle,
+ * cancellation dates, subscribed price lines) that operators
+ * legitimately need to see to answer subscription/billing questions,
+ * so we opt them in via `includeSensitive: true`. The credential /
+ * secrets guardrail still applies — the redactor drops any column
+ * matching credential-shaped patterns — but the sensitive-flag opt-in
+ * is what makes the billing surface visible on reads at all.
+ *
+ * Provider credentials for billing gateways (fxm_payment_processor_*
+ * tables) live in a separate FXM module and are excluded from the
+ * pinned contract entirely; no read from this module can reach them.
+ *
+ * Every write on a billing / subscription / entitlement row lives in
+ * a dedicated hand-written tool with explicit confirmation and
+ * idempotency semantics (see `pbm-subscription-*`,
+ * `pbm-*-entitlement-override-*`).
+ */
+const contract = loadPersistResourceContract();
+export const pbmGeneratedReadReport = buildGeneratedReadCatalogueReport(contract, {
+    modules: ['pbm'],
+    includeSensitive: true,
+});
+export const pbmGeneratedReadTools = buildGeneratedReadCatalogue(contract, { modules: ['pbm'], includeSensitive: true });
+//# sourceMappingURL=generated-reads.js.map

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

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

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

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

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

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

package/dist/tools/pbm/index.js

@@ -0,0 +1,17 @@
+import { pbmGeneratedReadTools } from './generated-reads.js';
+import { pbmSubscriptionCreateTool } from './pbm-subscription-create.js';
+import { pbmSubscriptionCancelTool } from './pbm-subscription-cancel.js';
+import { pbmSubscriptionLineAddTool } from './pbm-subscription-line-add.js';
+import { pbmSubscriptionLineEndTool } from './pbm-subscription-line-end.js';
+import { pbmCustomerEntitlementOverrideSetTool } from './pbm-customer-entitlement-override-set.js';
+const pbmWriteTools = [
+    pbmSubscriptionCreateTool,
+    pbmSubscriptionCancelTool,
+    pbmSubscriptionLineAddTool,
+    pbmSubscriptionLineEndTool,
+    pbmCustomerEntitlementOverrideSetTool,
+];
+export const pbmTools = [...pbmGeneratedReadTools, ...pbmWriteTools];
+/** Read-only slice used by the `pbm-readonly` selectable sub-domain. */
+export const pbmReadOnlyTools = pbmGeneratedReadTools;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/pbm/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AAEnG,MAAM,aAAa,GAAW;IAC5B,yBAAyB;IACzB,yBAAyB;IACzB,0BAA0B;IAC1B,0BAA0B;IAC1B,qCAAqC;CACtC,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/pbm/pbm-customer-entitlement-override-set.d.ts

@@ -0,0 +1,26 @@
+import { Tool } from '../registry.js';
+/**
+ * Entitlement-management semantic tool: create a customer-scoped
+ * entitlement override (`pbm_customer_entitlement_overrides`).
+ *
+ * Overrides bypass the tenant / platform entitlement defaults for a
+ * specific customer, so they can quietly expand or contract what the
+ * customer sees or can consume — cutting a customer off from a
+ * feature, or granting a promo tier ahead of billing. The tool
+ * therefore requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a caller-supplied `reason` (this maps to the `reason` column on
+ *    the row, which the pinned contract marks as REQUIRED).
+ *
+ * `granted_by` is read-only in the pinned contract — persist assigns
+ * it from the authenticated caller. `value` is a JSON object per PBM
+ * schema (typically `{ "enabled": true }` or a quota override).
+ *
+ * Create only, despite the name. The primary key
+ * (customer_id, feature_id, tenant_id) allows one override per customer
+ * and feature, so a retry, or a call with a new value, fails with a
+ * duplicate-key error.
+ */
+export declare const pbmCustomerEntitlementOverrideSetTool: Tool;
+//# sourceMappingURL=pbm-customer-entitlement-override-set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pbm-customer-entitlement-override-set.d.ts","sourceRoot":"","sources":["../../../src/tools/pbm/pbm-customer-entitlement-override-set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qCAAqC,EAAE,IA2DnD,CAAC"}

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

@@ -0,0 +1,78 @@
+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';
+/**
+ * Entitlement-management semantic tool: create a customer-scoped
+ * entitlement override (`pbm_customer_entitlement_overrides`).
+ *
+ * Overrides bypass the tenant / platform entitlement defaults for a
+ * specific customer, so they can quietly expand or contract what the
+ * customer sees or can consume — cutting a customer off from a
+ * feature, or granting a promo tier ahead of billing. The tool
+ * therefore requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a caller-supplied `reason` (this maps to the `reason` column on
+ *    the row, which the pinned contract marks as REQUIRED).
+ *
+ * `granted_by` is read-only in the pinned contract — persist assigns
+ * it from the authenticated caller. `value` is a JSON object per PBM
+ * schema (typically `{ "enabled": true }` or a quota override).
+ *
+ * Create only, despite the name. The primary key
+ * (customer_id, feature_id, tenant_id) allows one override per customer
+ * and feature, so a retry, or a call with a new value, fails with a
+ * duplicate-key error.
+ */
+export const pbmCustomerEntitlementOverrideSetTool = {
+    name: 'pbm_customer_entitlement_override_set',
+    description: 'Create a customer-scoped entitlement override (pbm_customer_entitlement_overrides) ' +
+        'that bypasses tenant / platform defaults. Requires confirm=true and a reason ' +
+        '(recorded in the row). granted_by is server-assigned. One override per customer and ' +
+        'feature: a retry, or a call with a new value, fails with a duplicate-key error.',
+    inputSchema: z.object({
+        customer_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the far_customers row this override applies to (required)'),
+        feature_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the pbm_features row being overridden (required)'),
+        value: z
+            .record(z.unknown())
+            .describe('JSON object describing the override (e.g. {"enabled": true} or a quota override)'),
+        reason: reasonSchema.describe('Human-readable justification recorded on the row and audit trail'),
+        start_date: z.string().min(1).optional().describe('ISO 8601 override start'),
+        end_date: z.string().min(1).optional().describe('ISO 8601 override end'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('pbm_customer_entitlement_overrides', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            customer_id: input.customer_id,
+            feature_id: input.feature_id,
+            value: input.value,
+            reason: input.reason,
+        };
+        for (const field of ['start_date', 'end_date', 'metadata']) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/pbm_customer_entitlement_overrides?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to set PBM customer entitlement override: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pbm-customer-entitlement-override-set.js.map

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"}