@raytio/mcp-server 9.4.0 → 10.1.0

package/dist/tools/bkm/bkm-availability-search-start.js

@@ -0,0 +1,110 @@
+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';
+/**
+ * External-synchronisation semantic tool: start a real-time
+ * availability search (`bkm_availability_searches`). Kicks off
+ * concurrent fetches against every connected third-party booking
+ * provider, so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental provider load;
+ *  - a bounded search radius / time window.
+ *
+ * This tool is NOT retry-safe: nothing identifies a repeat call and
+ * Persist ignores `Idempotency-Key` (WI-0008817), so a retry starts a
+ * second wave of provider calls. The created row's `id` is the polling
+ * handle — callers use `bkm_availability_searches_get`
+ *    to watch `status` and `providers_completed` transition to a
+ *    terminal state, then list `bkm_availability_slots?search_id=eq.<id>`
+ *    for the results.
+ */
+export const bkmAvailabilitySearchStartTool = {
+    name: 'bkm_availability_search_start',
+    description: 'Start a real-time BKM availability search (bkm_availability_searches). Fans out to every ' +
+        'connected booking provider. Requires confirm=true. Poll status via ' +
+        'bkm_availability_searches_get; fetch results via bkm_availability_slots_list ' +
+        'filtered by search_id. Not deduplicated: calling it again starts another search, so ' +
+        'check bkm_availability_searches_list before retrying.',
+    inputSchema: z.object({
+        base_latitude: z
+            .number()
+            .min(-90)
+            .max(90)
+            .describe('Latitude of the search origin (WGS84 degrees)'),
+        base_longitude: z
+            .number()
+            .min(-180)
+            .max(180)
+            .describe('Longitude of the search origin (WGS84 degrees)'),
+        search_radius: z
+            .number()
+            .positive()
+            .describe('Search radius (unit set by search_radius_unit; defaults to KM)'),
+        search_radius_unit: z
+            .string()
+            .max(8)
+            .optional()
+            .describe('Radius unit from the BKM_SEARCH_RADIUS_UNIT lookup (KM, MI, M); defaults per provider config'),
+        search_time: z
+            .number()
+            .int()
+            .positive()
+            .describe('Time window before the search returns (unit set by search_time_unit)'),
+        search_time_unit: z
+            .string()
+            .max(8)
+            .optional()
+            .describe('Time window unit from the BKM_SEARCH_TIME_UNIT lookup (DAYS, HOURS, WEEKS); defaults per provider config'),
+        item_ids: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Restrict search to specific gpm_items UUIDs'),
+        item_keys: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Restrict search to specific item business keys'),
+        merchant_ids: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Restrict search to specific merchants (xrm_merchants UUIDs)'),
+        party_site_ids: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Restrict search to specific party sites (prm_party_sites UUIDs)'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('bkm_availability_searches', 'INSERT')],
+    sideEffect: 'command',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            base_latitude: input.base_latitude,
+            base_longitude: input.base_longitude,
+            search_radius: input.search_radius,
+            search_time: input.search_time,
+        };
+        for (const field of [
+            'search_radius_unit',
+            'search_time_unit',
+            'item_ids',
+            'item_keys',
+            'merchant_ids',
+            'party_site_ids',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/bkm_availability_searches?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to start BKM availability search: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=bkm-availability-search-start.js.map

package/dist/tools/bkm/bkm-availability-search-start.js.map

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

package/dist/tools/bkm/bkm-provider-item-mapping-create.d.ts

@@ -0,0 +1,15 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for `bkm_provider_item_mappings`. Registers
+ * the translation between an internal `xrm_merchant_items` row and
+ * the provider-specific codes needed for the booking API integration.
+ * Not a "command" — no external call fires at create time — but it
+ * shapes how downstream availability searches route requests, so the
+ * mapping is validated at the MCP boundary. Unique key:
+ * `t_bkm_provider_item_mappings_unique_mapping` (merchant_item_id,
+ * provider_category_code, provider_service_code,
+ * provider_location_code, tenant_id), so a retry with the same values
+ * fails with a duplicate-key error.
+ */
+export declare const bkmProviderItemMappingCreateTool: Tool;
+//# sourceMappingURL=bkm-provider-item-mapping-create.d.ts.map

package/dist/tools/bkm/bkm-provider-item-mapping-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bkm-provider-item-mapping-create.d.ts","sourceRoot":"","sources":["../../../src/tools/bkm/bkm-provider-item-mapping-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,EAAE,IAkD9C,CAAC"}

package/dist/tools/bkm/bkm-provider-item-mapping-create.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Explicit-schema create for `bkm_provider_item_mappings`. Registers
+ * the translation between an internal `xrm_merchant_items` row and
+ * the provider-specific codes needed for the booking API integration.
+ * Not a "command" — no external call fires at create time — but it
+ * shapes how downstream availability searches route requests, so the
+ * mapping is validated at the MCP boundary. Unique key:
+ * `t_bkm_provider_item_mappings_unique_mapping` (merchant_item_id,
+ * provider_category_code, provider_service_code,
+ * provider_location_code, tenant_id), so a retry with the same values
+ * fails with a duplicate-key error.
+ */
+export const bkmProviderItemMappingCreateTool = {
+    name: 'bkm_provider_item_mapping_create',
+    description: 'Create a BKM provider item mapping (bkm_provider_item_mappings). Registers the ' +
+        'provider-side codes for a merchant item so future availability searches route ' +
+        'correctly. One mapping per merchant_item_id, provider_category_code, ' +
+        'provider_service_code and provider_location_code: a retry with the same values fails ' +
+        'with a duplicate-key error instead of creating a second mapping.',
+    inputSchema: z.object({
+        merchant_item_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the xrm_merchant_items row this mapping is for'),
+        provider_service_code: z
+            .string()
+            .min(1)
+            .max(64)
+            .describe('Provider service code (part of the unique key)'),
+        provider_category_code: z.string().max(64).optional(),
+        provider_location_code: z.string().max(64).optional(),
+        metadata: z.record(z.unknown()).optional(),
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('bkm_provider_item_mappings', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            merchant_item_id: input.merchant_item_id,
+            provider_service_code: input.provider_service_code,
+        };
+        for (const field of ['provider_category_code', 'provider_location_code', 'metadata']) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/bkm_provider_item_mappings?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create BKM provider item mapping: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=bkm-provider-item-mapping-create.js.map

package/dist/tools/bkm/bkm-provider-item-mapping-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bkm-provider-item-mapping-create.js","sourceRoot":"","sources":["../../../src/tools/bkm/bkm-provider-item-mapping-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,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAS;IACpD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,iFAAiF;QACjF,gFAAgF;QAChF,uEAAuE;QACvE,uFAAuF;QACvF,kEAAkE;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,gBAAgB,EAAE,CAAC;aAChB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,wDAAwD,CAAC;QACrE,qBAAqB,EAAE,CAAC;aACrB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,CAAC,gDAAgD,CAAC;QAC7D,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrD,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC1C,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IAC3D,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAA2B,CAAC;QAC1C,MAAM,IAAI,GAAwB;YAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;SACnD,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,UAAU,CAAC,EAAE,CAAC;YACrF,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,sCAAsC,EACjE,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,+CAA+C,KAAK,CAAC,OAAO,EAAE,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,33 @@
+import { buildGeneratedReadCatalogue, buildGeneratedReadCatalogueReport, } from '../../generated-reads/index.js';
+import { loadPersistResourceContract } from '../../contracts/persist-resource-contract.js';
+/**
+ * Bounded read tools for the BKM module (WI-0003509).
+ *
+ * The schema-driven catalogue (WI-0003500) emits describe/list/get for
+ * every `normal`-sensitivity BKM resource that declares a read
+ * operation and has no side effects. The pinned Persist contract does
+ * not classify any BKM resource as sensitive, so no `includeSensitive`
+ * opt-in is needed. Connector credentials are stored in tables not
+ * declared in the resource contract (Persist keeps them behind the
+ * credential guardrail) and are therefore not surfaced here.
+ *
+ * The catalogue emits `_describe` / `_list` / `_get` tools for:
+ *
+ *  - `bkm_adapter_configurations` — third-party booking adapter
+ *    connection/sync configuration (excludes credential columns).
+ *  - `bkm_availability_searches` — the caller's own availability
+ *    search requests and their status (used for polling after
+ *    `bkm_availability_search_start`).
+ *  - `bkm_availability_slots` — scraped/fetched availability
+ *    slot inventory used by downstream booking flows.
+ *  - `bkm_provider_item_mappings` — internal-to-provider item code
+ *    mappings that drive the booking API integration.
+ *
+ * Every write on these tables lives in a dedicated hand-written tool
+ * with an explicit safety envelope (see `bkm-availability-*`,
+ * `bkm-provider-item-*`, `bkm-adapter-configuration-update`).
+ */
+const contract = loadPersistResourceContract();
+export const bkmGeneratedReadReport = buildGeneratedReadCatalogueReport(contract, { modules: ['bkm'] });
+export const bkmGeneratedReadTools = buildGeneratedReadCatalogue(contract, { modules: ['bkm'] });
+//# sourceMappingURL=generated-reads.js.map

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

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

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

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

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

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

package/dist/tools/bkm/index.js

@@ -0,0 +1,13 @@
+import { bkmGeneratedReadTools } from './generated-reads.js';
+import { bkmAvailabilitySearchStartTool } from './bkm-availability-search-start.js';
+import { bkmProviderItemMappingCreateTool } from './bkm-provider-item-mapping-create.js';
+import { bkmAdapterConfigurationUpdateTool } from './bkm-adapter-configuration-update.js';
+const bkmWriteTools = [
+    bkmAvailabilitySearchStartTool,
+    bkmProviderItemMappingCreateTool,
+    bkmAdapterConfigurationUpdateTool,
+];
+export const bkmTools = [...bkmGeneratedReadTools, ...bkmWriteTools];
+/** Read-only slice used by the `bkm-readonly` selectable sub-domain. */
+export const bkmReadOnlyTools = bkmGeneratedReadTools;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/bkm/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAE1F,MAAM,aAAa,GAAW;IAC5B,8BAA8B;IAC9B,gCAAgC;IAChC,iCAAiC;CAClC,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/dcm/dcm-device-command-dispatch.d.ts

@@ -0,0 +1,28 @@
+import { Tool } from '../registry.js';
+/**
+ * Command semantic tool: dispatch a control message to a registered
+ * device through `POST /persist/v2/dcm/devices/{id}/command`. The
+ * endpoint rejects a device that is not ONLINE, validates the slot and
+ * session-start item, and records `requested_by`. A direct insert into
+ * `dcm_device_commands` gets none of that: the send job has no ONLINE
+ * check of its own, so a command for an offline device would still
+ * report SENT.
+ *
+ * The tool requires `confirm: true` and a `command_type_code`, which is
+ * validated at the boundary for shape only; persist rejects unknown
+ * codes. `correlation_id` is server-assigned.
+ *
+ * ACKNOWLEDGED means the device replied, not that the command worked: a
+ * device that does not support a command still acknowledges it, with
+ * `success: false` in `response_payload`.
+ *
+ * This tool is NOT retry-safe. Nothing identifies a repeat call, so a
+ * retry sends the command to the device again. It takes no
+ * `idempotency_key` because the endpoint would ignore it (WI-0009332).
+ *
+ * Internal command queues (`fnd_http_outbox`, `ixn_queues`) are
+ * EXCLUDED from the MCP surface by the queue guardrail and must not
+ * be surfaced by this or any other tool.
+ */
+export declare const dcmDeviceCommandDispatchTool: Tool;
+//# sourceMappingURL=dcm-device-command-dispatch.d.ts.map

package/dist/tools/dcm/dcm-device-command-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcm-device-command-dispatch.d.ts","sourceRoot":"","sources":["../../../src/tools/dcm/dcm-device-command-dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,4BAA4B,EAAE,IA0E1C,CAAC"}

package/dist/tools/dcm/dcm-device-command-dispatch.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { confirmFlagSchema } from '../_shared/side-effect.js';
+/**
+ * Command semantic tool: dispatch a control message to a registered
+ * device through `POST /persist/v2/dcm/devices/{id}/command`. The
+ * endpoint rejects a device that is not ONLINE, validates the slot and
+ * session-start item, and records `requested_by`. A direct insert into
+ * `dcm_device_commands` gets none of that: the send job has no ONLINE
+ * check of its own, so a command for an offline device would still
+ * report SENT.
+ *
+ * The tool requires `confirm: true` and a `command_type_code`, which is
+ * validated at the boundary for shape only; persist rejects unknown
+ * codes. `correlation_id` is server-assigned.
+ *
+ * ACKNOWLEDGED means the device replied, not that the command worked: a
+ * device that does not support a command still acknowledges it, with
+ * `success: false` in `response_payload`.
+ *
+ * This tool is NOT retry-safe. Nothing identifies a repeat call, so a
+ * retry sends the command to the device again. It takes no
+ * `idempotency_key` because the endpoint would ignore it (WI-0009332).
+ *
+ * Internal command queues (`fnd_http_outbox`, `ixn_queues`) are
+ * EXCLUDED from the MCP surface by the queue guardrail and must not
+ * be surfaced by this or any other tool.
+ */
+export const dcmDeviceCommandDispatchTool = {
+    name: 'dcm_device_command_dispatch',
+    description: 'Send a control command to a registered DCM device. Fails if the device is not ONLINE. ' +
+        'Requires confirm=true and command_type_code. Poll dcm_device_commands_get with the ' +
+        'returned command_id: ACKNOWLEDGED only means the device replied, so also check ' +
+        'response_payload.success. Not deduplicated: calling it again sends the command to the ' +
+        'device again, so check dcm_device_commands_list filtered on device_id before retrying.',
+    inputSchema: z.object({
+        device_id: z.string().min(1).describe('UUID of the target device'),
+        command_type_code: z
+            .string()
+            .min(1)
+            .max(64)
+            .describe('Command from the DCM_COMMAND_TYPE lookup (e.g. GET_STATUS, HALT_STATUS, DISPENSE). ' +
+            'Validated at persist. Not every device supports every command.'),
+        command_payload: z
+            .record(z.unknown())
+            .optional()
+            .describe('Command-specific payload sent to the device'),
+        slot_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Optional UUID of a dcm_device_slots row on this device'),
+        item_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Optional UUID of an item in the slot catalogue, for session-start commands ' +
+            '(SET_STATUS, SELECT_PRODUCT, SELECT_TIMER). Requires slot_id.'),
+        timeout_seconds: z
+            .number()
+            .int()
+            .positive()
+            .max(3600)
+            .optional()
+            .describe('Command timeout in seconds (defaults per command type)'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+    }),
+    capabilities: [cap('dcm_device_commands', 'INSERT')],
+    sideEffect: 'command',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = { command_type_code: input.command_type_code };
+        for (const field of [
+            'command_payload',
+            'slot_id',
+            'item_id',
+            'timeout_seconds',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const result = await ctx.apiClient.postLambda(`/dcm/devices/${encodeURIComponent(input.device_id)}/command`, body);
+            return successResponse(result);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to dispatch DCM device command: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=dcm-device-command-dispatch.js.map

package/dist/tools/dcm/dcm-device-command-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcm-device-command-dispatch.js","sourceRoot":"","sources":["../../../src/tools/dcm/dcm-device-command-dispatch.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,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAS;IAChD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,wFAAwF;QACxF,qFAAqF;QACrF,iFAAiF;QACjF,wFAAwF;QACxF,wFAAwF;IAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAClE,iBAAiB,EAAE,CAAC;aACjB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,CACP,qFAAqF;YACnF,gEAAgE,CACnE;QACH,eAAe,EAAE,CAAC;aACf,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,EAAE;aACV,QAAQ,CAAC,6CAA6C,CAAC;QAC1D,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CACP,6EAA6E;YAC3E,+DAA+D,CAClE;QACH,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,iBAAiB;KAC3B,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACpD,UAAU,EAAE,SAAS;IACrB,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,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACjF,KAAK,MAAM,KAAK,IAAI;YAClB,iBAAiB;YACjB,SAAS;YACT,SAAS;YACT,iBAAiB;YACjB,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,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,UAAU,CAC3C,gBAAgB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,EAC7D,IAAI,CACL,CAAC;YACF,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAClB,SAAS,EACT,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/dcm/dcm-device-register.d.ts

@@ -0,0 +1,22 @@
+import { Tool } from '../registry.js';
+/**
+ * Provisioning semantic tool: register a new IoT device on the tenant
+ * (`dcm_devices`). Creating a device provisions an IoT identity and
+ * causes downstream cloud resources to be allocated on the caller's
+ * behalf, so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a `device_key`. `t_dcm_devices_key_tenant_uk` makes it unique per
+ *    tenant, so a retry fails with a duplicate-key error rather than
+ *    provisioning a second device.
+ *
+ * `device_status_code`, `firmware_version`, `iot_endpoint_name`,
+ * `iot_thing_name`, `shadow_state`, and `last_seen_at` are read-only
+ * per the pinned contract — persist assigns them during
+ * provisioning, and MCP does not attempt to write them.
+ *
+ * Certificate material (`dcm_device_certificates`) is EXCLUDED from
+ * the MCP surface by the credentials guardrail and is never returned.
+ */
+export declare const dcmDeviceRegisterTool: Tool;
+//# sourceMappingURL=dcm-device-register.d.ts.map

package/dist/tools/dcm/dcm-device-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcm-device-register.d.ts","sourceRoot":"","sources":["../../../src/tools/dcm/dcm-device-register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAgEnC,CAAC"}

package/dist/tools/dcm/dcm-device-register.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, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Provisioning semantic tool: register a new IoT device on the tenant
+ * (`dcm_devices`). Creating a device provisions an IoT identity and
+ * causes downstream cloud resources to be allocated on the caller's
+ * behalf, so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a `device_key`. `t_dcm_devices_key_tenant_uk` makes it unique per
+ *    tenant, so a retry fails with a duplicate-key error rather than
+ *    provisioning a second device.
+ *
+ * `device_status_code`, `firmware_version`, `iot_endpoint_name`,
+ * `iot_thing_name`, `shadow_state`, and `last_seen_at` are read-only
+ * per the pinned contract — persist assigns them during
+ * provisioning, and MCP does not attempt to write them.
+ *
+ * Certificate material (`dcm_device_certificates`) is EXCLUDED from
+ * the MCP surface by the credentials guardrail and is never returned.
+ */
+export const dcmDeviceRegisterTool = {
+    name: 'dcm_device_register',
+    description: 'Provision a new IoT device on the tenant (dcm_devices). Requires confirm=true and ' +
+        'a device_key. Certificate material is never returned. device_key is unique within ' +
+        'the tenant: a retry fails with a duplicate-key error instead of registering a second device.',
+    inputSchema: z.object({
+        device_key: z
+            .string()
+            .min(1)
+            .max(128)
+            .describe('Stable device identifier, unique within the tenant'),
+        device_name: z.string().min(1).max(256).describe('Human-readable device name'),
+        device_type_code: z.string().max(64).optional(),
+        party_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the PRM party (merchant) this device is owned by'),
+        location_id: z.string().min(1).optional().describe('UUID of the PRM location'),
+        is_public: z
+            .boolean()
+            .optional()
+            .describe('Whether this device is discoverable via the anonymous public view'),
+        iot_thing_arn: z
+            .string()
+            .max(2048)
+            .optional()
+            .describe('Optional pre-provisioned AWS IoT thing ARN'),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('dcm_devices', 'INSERT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            device_key: input.device_key,
+            device_name: input.device_name,
+        };
+        for (const field of [
+            'device_type_code',
+            'party_id',
+            'location_id',
+            'is_public',
+            'iot_thing_arn',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/dcm_devices?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to register DCM device: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=dcm-device-register.js.map

package/dist/tools/dcm/dcm-device-register.js.map

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

package/dist/tools/dcm/dcm-device-slot-configure.d.ts

@@ -0,0 +1,13 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema update for a DCM device slot (`dcm_device_slots`).
+ * Configures the assigned item, quantity, and capacity so slot-level
+ * inventory state stays in sync with reality. `slot_state` and
+ * `device_id` / `slot_number` are read-only per the pinned contract
+ * and cannot be reassigned through this tool (delete + recreate the
+ * slot for that).
+ *
+ * Retry-safe (converges on the same target state).
+ */
+export declare const dcmDeviceSlotConfigureTool: Tool;
+//# sourceMappingURL=dcm-device-slot-configure.d.ts.map

package/dist/tools/dcm/dcm-device-slot-configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcm-device-slot-configure.d.ts","sourceRoot":"","sources":["../../../src/tools/dcm/dcm-device-slot-configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQtC;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAoExC,CAAC"}

package/dist/tools/dcm/dcm-device-slot-configure.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Explicit-schema update for a DCM device slot (`dcm_device_slots`).
+ * Configures the assigned item, quantity, and capacity so slot-level
+ * inventory state stays in sync with reality. `slot_state` and
+ * `device_id` / `slot_number` are read-only per the pinned contract
+ * and cannot be reassigned through this tool (delete + recreate the
+ * slot for that).
+ *
+ * Retry-safe (converges on the same target state).
+ */
+export const dcmDeviceSlotConfigureTool = {
+    name: 'dcm_device_slot_configure',
+    description: 'Configure a DCM device slot (dcm_device_slots): assigned item, quantity, capacity, ' +
+        'status, and UoM. slot_state, device_id, and slot_number are read-only. Retry-safe.',
+    inputSchema: z
+        .object({
+        id: z.string().min(1).describe('UUID of the dcm_device_slots row'),
+        item_id: z
+            .string()
+            .min(1)
+            .nullable()
+            .optional()
+            .describe('UUID of the gpm_items row assigned to this slot; null to clear'),
+        quantity: z.number().nonnegative().optional(),
+        capacity: z.number().positive().optional(),
+        slot_status_code: z.string().max(64).optional(),
+        slot_uom: z.string().max(3).optional(),
+        slot_name: z.string().max(256).optional(),
+        metadata: z.record(z.unknown()).nullable().optional(),
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    })
+        .refine((v) => v.item_id !== undefined ||
+        v.quantity !== undefined ||
+        v.capacity !== undefined ||
+        v.slot_status_code !== undefined ||
+        v.slot_uom !== undefined ||
+        v.slot_name !== undefined ||
+        v.metadata !== undefined, {
+        message: 'supply at least one field to change.',
+    }),
+    capabilities: [cap('dcm_device_slots', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const { id, idempotency_key, ...rest } = args;
+        const body = {};
+        for (const [k, v] of Object.entries(rest)) {
+            if (v !== undefined)
+                body[k] = v;
+        }
+        try {
+            const rows = await ctx.apiClient.patch(`${ctx.apiClient.dbBasePath}/dcm_device_slots?id=eq.${id}&select=*`, body, { headers: writeHeadersWithIdempotency(idempotency_key) });
+            if (!rows || rows.length === 0) {
+                return errorResponse(API_ERROR, `DCM device slot ${id} not found or not accessible`);
+            }
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to configure DCM device slot: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=dcm-device-slot-configure.js.map

package/dist/tools/dcm/dcm-device-slot-configure.js.map

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