@raytio/mcp-server 10.2.0 → 10.4.0

package/dist/tools/pcm/pcm-price-list-register.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, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+import { END_AFTER_START_MESSAGE, endsAfterStart, isoDateTimeSchema, } from '../_shared/date-range.js';
+const CURRENCY_REGEX = /^[A-Z]{3}$/;
+/** Values of the Persist PCM_PRICE_LISTS_VISIBILITY lookup. */
+export const PCM_PRICE_LIST_VISIBILITIES = ['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 const pcmPriceListRegisterTool = {
+    name: 'pcm_price_list_register',
+    description: 'Register a price list (pcm_price_lists). Requires confirm=true and org_id. ' +
+        'price_list_name + price_list_type must be unique among active price lists in the tenant: ' +
+        'a retry fails with a duplicate-key error instead of creating a second list. ' +
+        'visibility is PARTY (default), AUTHENTICATED or PUBLIC; PUBLIC makes the list readable by ' +
+        'anyone, including unauthenticated callers, and also needs allow_public=true.',
+    inputSchema: z
+        .object({
+        price_list_name: z
+            .string()
+            .min(1)
+            .max(256)
+            .describe('Price list name, unique with price_list_type among active lists'),
+        price_list_type: z
+            .string()
+            .min(1)
+            .max(32)
+            .describe('A pcm_price_list_price_list_type_lookup lookup_value_code'),
+        price_list_currency: z
+            .string()
+            .regex(CURRENCY_REGEX, 'price_list_currency must be a 3-letter uppercase ISO 4217 code')
+            .describe('ISO 4217 currency code enabled in fnd_currencies (e.g. NZD, AUD)'),
+        price_list_description: z.string().max(2048).optional(),
+        visibility: z
+            .enum(PCM_PRICE_LIST_VISIBILITIES)
+            .optional()
+            .describe('Who can read the list: PARTY (default), AUTHENTICATED or PUBLIC'),
+        allow_public: z
+            .literal(true)
+            .optional()
+            .describe('Must be true when visibility is PUBLIC'),
+        org_id: z
+            .string()
+            .uuid()
+            .describe('UUID of the owning organisation (required: Persist does not route price lists)'),
+        start_date: isoDateTimeSchema('ISO 8601 effective start (defaults to now)').optional(),
+        end_date: isoDateTimeSchema('ISO 8601 end, after start_date').optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    })
+        .refine((v) => endsAfterStart(v.start_date, v.end_date), { message: END_AFTER_START_MESSAGE })
+        .refine((v) => v.visibility !== 'PUBLIC' || v.allow_public === true, {
+        message: 'visibility PUBLIC makes the price list readable by anyone: set allow_public=true',
+        path: ['allow_public'],
+    }),
+    capabilities: [cap('pcm_price_lists', 'INSERT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            price_list_name: input.price_list_name,
+            price_list_type: input.price_list_type,
+            price_list_currency: input.price_list_currency,
+            org_id: input.org_id,
+        };
+        for (const field of ['price_list_description', 'visibility', 'start_date', 'end_date']) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/pcm_price_lists?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to register PCM price list: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pcm-price-list-register.js.map

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

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

package/dist/tools/pcm/pcm-price-list-version-create.d.ts

@@ -0,0 +1,19 @@
+import { Tool } from '../registry.js';
+/**
+ * Create a price list version (`pcm_price_list_versions`). Persist has
+ * no publish step: a version is used once its date range is current.
+ * Lines are loaded separately through the shared PCM_PRICE_LIST_LINES
+ * import, which MCP cannot drive until WI-0009453.
+ *
+ * Persist does not route versions to their price list's organisation and
+ * fills a missing `org_id` with the tenant's lowest organisation id. The
+ * managed price-line import only loads into a version in its destination
+ * organisation, so the tool reads the price list and stores the version
+ * in the list's organisation, refusing a different `org_id`.
+ *
+ * Unique key: `t_pcm_price_list_versions_uk2` on (price_list_id,
+ * price_list_version_name, org_id), so a retry fails with a duplicate-key
+ * error instead of creating a second version.
+ */
+export declare const pcmPriceListVersionCreateTool: Tool;
+//# sourceMappingURL=pcm-price-list-version-create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-price-list-version-create.d.ts","sourceRoot":"","sources":["../../../src/tools/pcm/pcm-price-list-version-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AActC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6BAA6B,EAAE,IA+E3C,CAAC"}

package/dist/tools/pcm/pcm-price-list-version-create.js

@@ -0,0 +1,85 @@
+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';
+import { END_AFTER_START_MESSAGE, endsAfterStart, isoDateTimeSchema, } from '../_shared/date-range.js';
+/**
+ * Create a price list version (`pcm_price_list_versions`). Persist has
+ * no publish step: a version is used once its date range is current.
+ * Lines are loaded separately through the shared PCM_PRICE_LIST_LINES
+ * import, which MCP cannot drive until WI-0009453.
+ *
+ * Persist does not route versions to their price list's organisation and
+ * fills a missing `org_id` with the tenant's lowest organisation id. The
+ * managed price-line import only loads into a version in its destination
+ * organisation, so the tool reads the price list and stores the version
+ * in the list's organisation, refusing a different `org_id`.
+ *
+ * Unique key: `t_pcm_price_list_versions_uk2` on (price_list_id,
+ * price_list_version_name, org_id), so a retry fails with a duplicate-key
+ * error instead of creating a second version.
+ */
+export const pcmPriceListVersionCreateTool = {
+    name: 'pcm_price_list_version_create',
+    description: 'Create a version of an active price list (pcm_price_list_versions). Requires confirm=true. ' +
+        'The version is stored in the price list\'s organisation; a different org_id is refused. ' +
+        'There is no separate publish step: the version applies while its date range is current. ' +
+        'MCP cannot load its lines yet. ' +
+        'price_list_version_name is unique within the price list: a retry fails with a duplicate-key ' +
+        'error instead of creating a second version.',
+    inputSchema: z
+        .object({
+        price_list_id: z.string().uuid().describe('UUID of the parent pcm_price_lists row'),
+        price_list_version_name: z
+            .string()
+            .min(1)
+            .max(256)
+            .describe('Version label, unique within the price list'),
+        price_list_version_description: z.string().max(2048).optional(),
+        start_date: isoDateTimeSchema('ISO 8601 effective start (defaults to now)').optional(),
+        end_date: isoDateTimeSchema('ISO 8601 end, after start_date').optional(),
+        org_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Optional. Must equal the price list\'s org_id, which is used when omitted.'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    })
+        .refine((v) => endsAfterStart(v.start_date, v.end_date), { message: END_AFTER_START_MESSAGE }),
+    capabilities: [cap('pcm_price_list_versions', 'INSERT'), cap('pcm_price_lists', 'SELECT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        try {
+            const lists = await ctx.apiClient.get(`${ctx.apiClient.dbBasePath}/pcm_price_lists?id=eq.${input.price_list_id}&select=id,org_id,active`);
+            const list = lists?.[0];
+            if (!list) {
+                return errorResponse(API_ERROR, `PCM price list ${input.price_list_id} not found or not accessible`);
+            }
+            if (list.active === false) {
+                return errorResponse(API_ERROR, `PCM price list ${input.price_list_id} is inactive: versions can only be added to an active list`);
+            }
+            if (input.org_id !== undefined && input.org_id !== list.org_id) {
+                return errorResponse(API_ERROR, `org_id ${input.org_id} differs from the price list's organisation ${list.org_id}`);
+            }
+            const body = {
+                price_list_id: input.price_list_id,
+                price_list_version_name: input.price_list_version_name,
+                org_id: list.org_id,
+            };
+            for (const field of ['price_list_version_description', 'start_date', 'end_date']) {
+                if (input[field] !== undefined)
+                    body[field] = input[field];
+            }
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/pcm_price_list_versions?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create PCM price list version: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=pcm-price-list-version-create.js.map

package/dist/tools/pcm/pcm-price-list-version-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-price-list-version-create.js","sourceRoot":"","sources":["../../../src/tools/pcm/pcm-price-list-version-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;AACnC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAS;IACjD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,6FAA6F;QAC7F,0FAA0F;QAC1F,0FAA0F;QAC1F,iCAAiC;QACjC,8FAA8F;QAC9F,6CAA6C;IAC/C,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACnF,uBAAuB,EAAE,CAAC;aACvB,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,6CAA6C,CAAC;QAC1D,8BAA8B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAC/D,UAAU,EAAE,iBAAiB,CAAC,4CAA4C,CAAC,CAAC,QAAQ,EAAE;QACtF,QAAQ,EAAE,iBAAiB,CAAC,gCAAgC,CAAC,CAAC,QAAQ,EAAE;QACxE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,IAAI,EAAE;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,4EAA4E,CAAC;QACzF,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAChG,YAAY,EAAE,CAAC,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAC1F,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,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CACnC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,0BAA0B,KAAK,CAAC,aAAa,0BAA0B,CACnG,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,aAAa,CAClB,SAAS,EACT,kBAAkB,KAAK,CAAC,aAAa,8BAA8B,CACpE,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC1B,OAAO,aAAa,CAClB,SAAS,EACT,kBAAkB,KAAK,CAAC,aAAa,4DAA4D,CAClG,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC/D,OAAO,aAAa,CAClB,SAAS,EACT,UAAU,KAAK,CAAC,MAAM,+CAA+C,IAAI,CAAC,MAAM,EAAE,CACnF,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAwB;gBAChC,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;gBACtD,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,KAAK,MAAM,KAAK,IAAI,CAAC,gCAAgC,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;gBACjF,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS;oBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CACnC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,mCAAmC,EAC9D,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,4CAA4C,KAAK,CAAC,OAAO,EAAE,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+import { buildGeneratedReadCatalogue, buildGeneratedReadCatalogueReport, } from '../../generated-reads/index.js';
+import { loadPersistResourceContract } from '../../contracts/persist-resource-contract.js';
+/**
+ * Bounded read tools for the QOM module (WI-0003507).
+ *
+ * The schema-driven catalogue (WI-0003500) emits describe/list/get for
+ * every `normal`-sensitivity QOM resource that declares a read
+ * operation and has no side effects. All QOM tables are classified
+ * `normal` — quote headers, quote versions and lines, order headers
+ * and lines, and the batch/interface staging tables — so no
+ * `includeSensitive` opt-in is required.
+ *
+ * Every write on a quote or order lives in a dedicated hand-written
+ * tool with explicit confirmation/idempotency semantics (see
+ * `qom-quote-*`, `qom-order-*`). Generic PATCHes are refused so
+ * totals, transitions, cancellation and hold state stay owned by the
+ * persist layer.
+ */
+const contract = loadPersistResourceContract();
+export const qomGeneratedReadReport = buildGeneratedReadCatalogueReport(contract, { modules: ['qom'] });
+export const qomGeneratedReadTools = buildGeneratedReadCatalogue(contract, { modules: ['qom'] });
+//# sourceMappingURL=generated-reads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generated-reads.js","sourceRoot":"","sources":["../../../src/tools/qom/generated-reads.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAElC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAE3F;;;;;;;;;;;;;;;GAeG;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/qom/index.d.ts

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

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

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

package/dist/tools/qom/index.js

@@ -0,0 +1,23 @@
+import { qomGeneratedReadTools } from './generated-reads.js';
+import { qomQuoteCreateTool } from './qom-quote-create.js';
+import { qomQuoteVersionCreateTool } from './qom-quote-version-create.js';
+import { qomQuoteLineAddTool } from './qom-quote-line-add.js';
+import { qomOrderCreateTool } from './qom-order-create.js';
+import { qomOrderLineAddTool } from './qom-order-line-add.js';
+import { qomOrderCancelTool } from './qom-order-cancel.js';
+import { qomOrderHoldPlaceTool } from './qom-order-hold-place.js';
+import { qomOrderHoldReleaseTool } from './qom-order-hold-release.js';
+const qomWriteTools = [
+    qomQuoteCreateTool,
+    qomQuoteVersionCreateTool,
+    qomQuoteLineAddTool,
+    qomOrderCreateTool,
+    qomOrderLineAddTool,
+    qomOrderCancelTool,
+    qomOrderHoldPlaceTool,
+    qomOrderHoldReleaseTool,
+];
+export const qomTools = [...qomGeneratedReadTools, ...qomWriteTools];
+/** Read-only slice used by the `qom-readonly` selectable sub-domain. */
+export const qomReadOnlyTools = qomGeneratedReadTools;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/qom/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,aAAa,GAAW;IAC5B,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,qBAAqB;IACrB,uBAAuB;CACxB,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/qom/qom-order-cancel.d.ts

@@ -0,0 +1,16 @@
+import { Tool } from '../registry.js';
+/**
+ * Cancellation semantic tool for a QOM order (`qom_order_headers`).
+ *
+ * Sets `order_status='CANCELLED'`, which is the column Persist's own
+ * cancel path writes (`qom_guest_clear_cart`), plus `is_cancelled=true`
+ * and `is_open=false`. The reason is merged into `metadata`.
+ *
+ * Nothing in Persist or persist-functions reacts to the change: no
+ * refund, no payment void, no stock release, and the order lines keep
+ * their status. The tool therefore only accepts DRAFT and OPEN orders,
+ * where no money has moved. Persist does not enforce this
+ * (see the Persist work item for QOM order state rules).
+ */
+export declare const qomOrderCancelTool: Tool;
+//# sourceMappingURL=qom-order-cancel.d.ts.map

package/dist/tools/qom/qom-order-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-cancel.d.ts","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-cancel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAqChC,CAAC"}

package/dist/tools/qom/qom-order-cancel.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { cap } from '../../capabilities/tool-capability.js';
+import { redactRow } from '../../generated-reads/index.js';
+import { confirmFlagSchema, reasonSchema, unenforcedIdempotencyKeySchema, } from '../_shared/side-effect.js';
+import { softDeactivate } from '../_shared/soft-deactivate.js';
+const CANCELLABLE_STATUSES = ['DRAFT', 'OPEN'];
+/**
+ * Cancellation semantic tool for a QOM order (`qom_order_headers`).
+ *
+ * Sets `order_status='CANCELLED'`, which is the column Persist's own
+ * cancel path writes (`qom_guest_clear_cart`), plus `is_cancelled=true`
+ * and `is_open=false`. The reason is merged into `metadata`.
+ *
+ * Nothing in Persist or persist-functions reacts to the change: no
+ * refund, no payment void, no stock release, and the order lines keep
+ * their status. The tool therefore only accepts DRAFT and OPEN orders,
+ * where no money has moved. Persist does not enforce this
+ * (see the Persist work item for QOM order state rules).
+ */
+export const qomOrderCancelTool = {
+    name: 'qom_order_cancel',
+    description: 'Cancel a DRAFT or OPEN QOM order: sets order_status=CANCELLED, is_cancelled=true and ' +
+        'is_open=false, and merges the reason into metadata. Any other status is refused, because ' +
+        'cancelling triggers no refund or stock release and does not change the order lines. ' +
+        'Requires confirm=true and a reason. An order already cancelled is returned unchanged, so ' +
+        'retries are safe.',
+    inputSchema: z.object({
+        id: z.string().min(1).describe('UUID of the order to cancel'),
+        reason: reasonSchema.describe('Human-readable reason, merged into metadata'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('qom_order_headers', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        return softDeactivate(ctx, {
+            table: 'qom_order_headers',
+            id: input.id,
+            label: 'QOM order',
+            verb: 'cancel',
+            isDone: (row) => row.is_cancelled === true || row.order_status === 'CANCELLED',
+            reject: (row) => CANCELLABLE_STATUSES.includes(row.order_status)
+                ? undefined
+                : `QOM order ${input.id} is ${row.order_status}: only DRAFT or OPEN orders can be cancelled`,
+            changes: () => ({ order_status: 'CANCELLED', is_cancelled: true, is_open: false }),
+            reasonKey: 'cancellation_reason',
+            reason: input.reason,
+            idempotencyKey: input.idempotency_key,
+            present: redactRow,
+        });
+    },
+};
+//# sourceMappingURL=qom-order-cancel.js.map

package/dist/tools/qom/qom-order-cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-cancel.js","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-cancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,uFAAuF;QACvF,2FAA2F;QAC3F,sFAAsF;QACtF,2FAA2F;QAC3F,mBAAmB;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC7D,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC5E,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClD,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,IAAgE,CAAC;QAC/E,OAAO,cAAc,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,mBAAmB;YAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI,IAAI,GAAG,CAAC,YAAY,KAAK,WAAW;YAC9E,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC7C,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,aAAa,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,YAAY,8CAA8C;YAChG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAClF,SAAS,EAAE,qBAAqB;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,eAAe;YACrC,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/qom/qom-order-create.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from '../registry.js';
+/**
+ * Provisioning semantic tool: create a QOM order header
+ * (`qom_order_headers`). The tool requires `confirm: true` and a
+ * business `order_code`, because the unique key
+ * (tenant_id, org_id, order_code) is what stops a retry creating a
+ * second order. Persist would generate a code if none were sent.
+ *
+ * `order_status` is limited to DRAFT and OPEN: Persist accepts any
+ * lookup value, so a caller could otherwise create an order already
+ * PAID or FULFILLED. `order_type` omits MARKETPLACE_GUEST, which belongs
+ * to the guest cart RPCs.
+ *
+ * `is_open`, `is_on_hold`, `is_cancelled` are intentionally NOT
+ * writable through this tool — they belong to `qom_order_cancel`,
+ * `qom_order_hold_place` and `qom_order_hold_release`.
+ * `guest_session_token_hash` is a credential-shaped field: it is not an
+ * input and is removed from the returned row.
+ *
+ * `source_deal_id` links the order back to the SFA deal it was
+ * quoted from, if any.
+ */
+export declare const qomOrderCreateTool: Tool;
+//# sourceMappingURL=qom-order-create.d.ts.map

package/dist/tools/qom/qom-order-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-create.d.ts","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB,EAAE,IA+GhC,CAAC"}

package/dist/tools/qom/qom-order-create.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { redactRow } from '../../generated-reads/index.js';
+import { confirmFlagSchema, unenforcedIdempotencyKeySchema, writeHeadersWithIdempotency, } from '../_shared/side-effect.js';
+/**
+ * Provisioning semantic tool: create a QOM order header
+ * (`qom_order_headers`). The tool requires `confirm: true` and a
+ * business `order_code`, because the unique key
+ * (tenant_id, org_id, order_code) is what stops a retry creating a
+ * second order. Persist would generate a code if none were sent.
+ *
+ * `order_status` is limited to DRAFT and OPEN: Persist accepts any
+ * lookup value, so a caller could otherwise create an order already
+ * PAID or FULFILLED. `order_type` omits MARKETPLACE_GUEST, which belongs
+ * to the guest cart RPCs.
+ *
+ * `is_open`, `is_on_hold`, `is_cancelled` are intentionally NOT
+ * writable through this tool — they belong to `qom_order_cancel`,
+ * `qom_order_hold_place` and `qom_order_hold_release`.
+ * `guest_session_token_hash` is a credential-shaped field: it is not an
+ * input and is removed from the returned row.
+ *
+ * `source_deal_id` links the order back to the SFA deal it was
+ * quoted from, if any.
+ */
+export const qomOrderCreateTool = {
+    name: 'qom_order_create',
+    description: 'Create a new sales order (qom_order_headers) as DRAFT or OPEN. Requires confirm=true. ' +
+        'is_open, is_on_hold and is_cancelled cannot be set here: use qom_order_cancel, ' +
+        'qom_order_hold_place or qom_order_hold_release. One order per order_code in an ' +
+        'organisation: a retry fails with a duplicate-key error instead of creating a second order.',
+    inputSchema: z.object({
+        order_code: z
+            .string()
+            .min(1)
+            .max(32)
+            .describe('Business order reference, unique within the organisation (required)'),
+        order_status: z.enum(['DRAFT', 'OPEN']).describe('Initial order status (required)'),
+        order_type: z
+            .enum(['SALES_ORDER', 'STANDARD', 'SUBSCRIPTION'])
+            .describe('Order type (required)'),
+        order_date: z.string().min(1).optional().describe('ISO 8601 order date'),
+        order_currency_code: z.string().length(3).optional(),
+        sold_to_customer_id: z.string().min(1).optional(),
+        sold_to_customer_site_id: z.string().min(1).optional(),
+        sold_to_party_contact_point_id: z.string().min(1).optional(),
+        ship_to_customer_id: z.string().min(1).optional(),
+        ship_to_customer_site_id: z.string().min(1).optional(),
+        ship_to_party_contact_point_id: z.string().min(1).optional(),
+        payment_term_id: z.string().min(1).optional(),
+        payment_method_id: z.string().min(1).optional(),
+        price_list_version_id: z.string().min(1).optional(),
+        priced_date: z.string().min(1).optional(),
+        request_arrival_date: z.string().min(1).optional(),
+        request_ship_date: z.string().min(1).optional(),
+        earliest_arrival_date: z.string().min(1).optional(),
+        latest_arrival_date: z.string().min(1).optional(),
+        earliest_ship_date: z.string().min(1).optional(),
+        latest_ship_date: z.string().min(1).optional(),
+        allow_partial_ship: z.boolean().optional(),
+        shipment_terms_name: z.string().max(32).optional(),
+        shipping_instructions: z.string().max(2048).optional(),
+        packing_instructions: z.string().max(2048).optional(),
+        customer_po_number: z.string().max(64).optional(),
+        customer_reference: z.string().max(256).optional(),
+        sales_channel_name: z.string().max(32).optional(),
+        salesperson_number: z.number().int().optional(),
+        source_deal_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the sfa_deals row this order was quoted from'),
+        org_id: z.string().min(1).optional(),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('qom_order_headers', 'INSERT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            order_code: input.order_code,
+            order_status: input.order_status,
+            order_type: input.order_type,
+        };
+        for (const field of [
+            'order_date',
+            'order_currency_code',
+            'sold_to_customer_id',
+            'sold_to_customer_site_id',
+            'sold_to_party_contact_point_id',
+            'ship_to_customer_id',
+            'ship_to_customer_site_id',
+            'ship_to_party_contact_point_id',
+            'payment_term_id',
+            'payment_method_id',
+            'price_list_version_id',
+            'priced_date',
+            'request_arrival_date',
+            'request_ship_date',
+            'earliest_arrival_date',
+            'latest_arrival_date',
+            'earliest_ship_date',
+            'latest_ship_date',
+            'allow_partial_ship',
+            'shipment_terms_name',
+            'shipping_instructions',
+            'packing_instructions',
+            'customer_po_number',
+            'customer_reference',
+            'sales_channel_name',
+            'salesperson_number',
+            'source_deal_id',
+            'org_id',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/qom_order_headers?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(redactRow(rows[0]));
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create QOM order: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=qom-order-create.js.map

package/dist/tools/qom/qom-order-create.js.map

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

package/dist/tools/qom/qom-order-hold-place.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '../registry.js';
+/**
+ * State-transition semantic tool: flag a QOM order as on hold
+ * (`qom_order_headers.is_on_hold=true`).
+ *
+ * Nothing in Persist or persist-functions reads `is_on_hold` on an
+ * order, so the flag records intent and does not stop payment or
+ * fulfilment. The reason is merged into `metadata.hold_reason`.
+ */
+export declare const qomOrderHoldPlaceTool: Tool;
+//# sourceMappingURL=qom-order-hold-place.d.ts.map

package/dist/tools/qom/qom-order-hold-place.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-hold-place.d.ts","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-hold-place.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAoCnC,CAAC"}

package/dist/tools/qom/qom-order-hold-place.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { cap } from '../../capabilities/tool-capability.js';
+import { redactRow } from '../../generated-reads/index.js';
+import { confirmFlagSchema, reasonSchema, unenforcedIdempotencyKeySchema, } from '../_shared/side-effect.js';
+import { softDeactivate } from '../_shared/soft-deactivate.js';
+const FINISHED_STATUSES = ['CANCELLED', 'EXPIRED', 'FULFILLED'];
+/**
+ * State-transition semantic tool: flag a QOM order as on hold
+ * (`qom_order_headers.is_on_hold=true`).
+ *
+ * Nothing in Persist or persist-functions reads `is_on_hold` on an
+ * order, so the flag records intent and does not stop payment or
+ * fulfilment. The reason is merged into `metadata.hold_reason`.
+ */
+export const qomOrderHoldPlaceTool = {
+    name: 'qom_order_hold_place',
+    description: 'Flag a QOM order as on hold (is_on_hold=true) and merge the reason into metadata. The flag ' +
+        'is a record only: Persist does not read it, so it does not stop payment or fulfilment. ' +
+        'Refused for CANCELLED, EXPIRED and FULFILLED orders. Requires confirm=true and a reason. ' +
+        'An order already on hold is returned unchanged, so retries are safe.',
+    inputSchema: z.object({
+        id: z.string().min(1).describe('UUID of the order to hold'),
+        reason: reasonSchema.describe('Human-readable reason, merged into metadata'),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('qom_order_headers', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        return softDeactivate(ctx, {
+            table: 'qom_order_headers',
+            id: input.id,
+            label: 'QOM order',
+            verb: 'place hold on',
+            isDone: (row) => row.is_on_hold === true,
+            reject: (row) => FINISHED_STATUSES.includes(row.order_status)
+                ? `QOM order ${input.id} is ${row.order_status} and cannot be put on hold`
+                : undefined,
+            changes: () => ({ is_on_hold: true }),
+            reasonKey: 'hold_reason',
+            reason: input.reason,
+            idempotencyKey: input.idempotency_key,
+            present: redactRow,
+        });
+    },
+};
+//# sourceMappingURL=qom-order-hold-place.js.map

package/dist/tools/qom/qom-order-hold-place.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-hold-place.js","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-hold-place.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,6FAA6F;QAC7F,yFAAyF;QACzF,2FAA2F;QAC3F,sEAAsE;IACxE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC3D,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC5E,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,8BAA8B;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClD,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,IAAgE,CAAC;QAC/E,OAAO,cAAc,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,mBAAmB;YAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI;YACxC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC1C,CAAC,CAAC,aAAa,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,YAAY,4BAA4B;gBAC1E,CAAC,CAAC,SAAS;YACf,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YACrC,SAAS,EAAE,aAAa;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,eAAe;YACrC,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}