@raytio/mcp-server 10.2.0 → 10.3.0

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

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

@@ -0,0 +1,8 @@
+import { Tool } from '../registry.js';
+/**
+ * State-transition semantic tool: clear a QOM order hold flag
+ * (`qom_order_headers.is_on_hold=false`). The reason is merged into
+ * `metadata.hold_release_reason`.
+ */
+export declare const qomOrderHoldReleaseTool: Tool;
+//# sourceMappingURL=qom-order-hold-release.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+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';
+/**
+ * State-transition semantic tool: clear a QOM order hold flag
+ * (`qom_order_headers.is_on_hold=false`). The reason is merged into
+ * `metadata.hold_release_reason`.
+ */
+export const qomOrderHoldReleaseTool = {
+    name: 'qom_order_hold_release',
+    description: 'Clear a QOM order hold flag (is_on_hold=false) and merge the reason into metadata. ' +
+        'Requires confirm=true and a reason. An order not on hold is returned unchanged, so retries ' +
+        'are safe.',
+    inputSchema: z.object({
+        id: z.string().min(1).describe('UUID of the order whose hold is being released'),
+        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: 'release hold on',
+            isDone: (row) => row.is_on_hold !== true,
+            changes: () => ({ is_on_hold: false }),
+            reasonKey: 'hold_release_reason',
+            reason: input.reason,
+            idempotencyKey: input.idempotency_key,
+            present: redactRow,
+        });
+    },
+};
+//# sourceMappingURL=qom-order-hold-release.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-hold-release.js","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-hold-release.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;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,qFAAqF;QACrF,6FAA6F;QAC7F,WAAW;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAChF,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,iBAAiB;YACvB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI;YACxC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YACtC,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-line-add.d.ts

@@ -0,0 +1,18 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for a QOM order line (`qom_order_lines`).
+ *
+ * The tool omits every fulfilment / cancellation column
+ * (`fulfilled_qty`, `shipped_qty`, `cancelled_qty`, `actual_ship_date`,
+ * `is_cancelled`, `is_on_hold`, `is_open`), so a caller cannot mark a
+ * line shipped without a shipment.
+ *
+ * Persist stores `unit_list_price` and `unit_selling_price` as supplied
+ * and accepts a new line on any order, so the tool reads the order first
+ * and refuses one that is not DRAFT or OPEN. That check is not atomic
+ * (see the Persist work item for QOM order state rules).
+ *
+ * Unique key: (tenant_id, order_header_id, order_line_number).
+ */
+export declare const qomOrderLineAddTool: Tool;
+//# sourceMappingURL=qom-order-line-add.d.ts.map

package/dist/tools/qom/qom-order-line-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-order-line-add.d.ts","sourceRoot":"","sources":["../../../src/tools/qom/qom-order-line-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,EAAE,IA6FjC,CAAC"}

package/dist/tools/qom/qom-order-line-add.js

@@ -0,0 +1,101 @@
+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';
+const OPEN_ORDER_STATUSES = ['DRAFT', 'OPEN'];
+/**
+ * Explicit-schema create for a QOM order line (`qom_order_lines`).
+ *
+ * The tool omits every fulfilment / cancellation column
+ * (`fulfilled_qty`, `shipped_qty`, `cancelled_qty`, `actual_ship_date`,
+ * `is_cancelled`, `is_on_hold`, `is_open`), so a caller cannot mark a
+ * line shipped without a shipment.
+ *
+ * Persist stores `unit_list_price` and `unit_selling_price` as supplied
+ * and accepts a new line on any order, so the tool reads the order first
+ * and refuses one that is not DRAFT or OPEN. That check is not atomic
+ * (see the Persist work item for QOM order state rules).
+ *
+ * Unique key: (tenant_id, order_header_id, order_line_number).
+ */
+export const qomOrderLineAddTool = {
+    name: 'qom_order_line_add',
+    description: 'Add a line to a DRAFT or OPEN order (qom_order_lines). Fulfilment and cancellation columns ' +
+        'cannot be set. Persist stores the prices as supplied and does not check them against the ' +
+        'price list. One line per order_line_number: a retry fails with a duplicate-key error ' +
+        'instead of adding a second line.',
+    inputSchema: z.object({
+        order_header_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the parent qom_order_headers row (required)'),
+        order_line_number: z
+            .number()
+            .int()
+            .min(1)
+            .describe('Line number, unique within the order'),
+        order_line_status: z.enum(['OPEN', 'CONFIRMED']).describe('Initial line status (required)'),
+        order_line_type: z.enum(['STANDARD']).describe('Line type (required)'),
+        item_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the pcm_items row being ordered (required)'),
+        merchant_item_id: z.string().min(1).optional(),
+        item_order_line_description: z.string().optional(),
+        ordered_qty: z.number().describe('Quantity ordered (required)'),
+        ordered_uom: z.string().max(3).optional(),
+        unit_list_price: z.number().optional(),
+        unit_selling_price: z.number().optional(),
+        scheduled_ship_date: z.string().min(1).optional(),
+        customer_line_reference: z.string().max(256).optional(),
+        org_id: z.string().min(1).optional(),
+        metadata: z.record(z.unknown()).optional(),
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('qom_order_lines', 'INSERT'), cap('qom_order_headers', 'SELECT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            order_header_id: input.order_header_id,
+            order_line_number: input.order_line_number,
+            order_line_status: input.order_line_status,
+            order_line_type: input.order_line_type,
+            item_id: input.item_id,
+            ordered_qty: input.ordered_qty,
+        };
+        for (const field of [
+            'merchant_item_id',
+            'item_order_line_description',
+            'ordered_uom',
+            'unit_list_price',
+            'unit_selling_price',
+            'scheduled_ship_date',
+            'customer_line_reference',
+            'org_id',
+            'metadata',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const orders = await ctx.apiClient.get(`${ctx.apiClient.dbBasePath}/qom_order_headers?id=eq.${input.order_header_id}&select=id,order_status,is_cancelled`);
+            const order = orders?.[0];
+            if (!order) {
+                return errorResponse(API_ERROR, `QOM order ${input.order_header_id} not found or not accessible`);
+            }
+            if (order.is_cancelled === true || !OPEN_ORDER_STATUSES.includes(order.order_status)) {
+                return errorResponse(API_ERROR, `QOM order ${input.order_header_id} is ${order.order_status}: ` +
+                    'lines can only be added to DRAFT or OPEN orders');
+            }
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/qom_order_lines?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to add QOM order line: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=qom-order-line-add.js.map

package/dist/tools/qom/qom-order-line-add.js.map

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

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

@@ -0,0 +1,20 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for a QOM quote header (`qom_quote_headers`),
+ * the parent of quote versions and quote lines. Quotes are sold to a
+ * party (`prm_parties`), not a customer, so `sold_to_party_id` is
+ * required, as it is in Persist.
+ *
+ * `quote_status` is not an input: Persist defaults it to `O` (open), and
+ * the other QOM_QUOTE_STATUS values (CUSTOMER_CONFIRMED,
+ * SUPPLIER_CONFIRMED, FINAL, CLOSED) are later lifecycle steps.
+ * `is_open`, `is_on_hold` and `is_cancelled` are not inputs either.
+ *
+ * Persist has no unique key on `quote_code` and generates one when none
+ * is sent, so a retry creates a second quote. When the caller supplies a
+ * `quote_code`, the tool first looks for a visible quote with that code
+ * (in `org_id`, if given) and refuses to create another. That check is
+ * not atomic.
+ */
+export declare const qomQuoteCreateTool: Tool;
+//# sourceMappingURL=qom-quote-create.d.ts.map

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

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

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

@@ -0,0 +1,142 @@
+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';
+/**
+ * Explicit-schema create for a QOM quote header (`qom_quote_headers`),
+ * the parent of quote versions and quote lines. Quotes are sold to a
+ * party (`prm_parties`), not a customer, so `sold_to_party_id` is
+ * required, as it is in Persist.
+ *
+ * `quote_status` is not an input: Persist defaults it to `O` (open), and
+ * the other QOM_QUOTE_STATUS values (CUSTOMER_CONFIRMED,
+ * SUPPLIER_CONFIRMED, FINAL, CLOSED) are later lifecycle steps.
+ * `is_open`, `is_on_hold` and `is_cancelled` are not inputs either.
+ *
+ * Persist has no unique key on `quote_code` and generates one when none
+ * is sent, so a retry creates a second quote. When the caller supplies a
+ * `quote_code`, the tool first looks for a visible quote with that code
+ * (in `org_id`, if given) and refuses to create another. That check is
+ * not atomic.
+ */
+export const qomQuoteCreateTool = {
+    name: 'qom_quote_create',
+    description: 'Create a new open quote (qom_quote_headers) for a party, to which quote versions and lines ' +
+        'are then added. Requires confirm=true. quote_status always starts as O (open), and ' +
+        'is_open, is_on_hold and is_cancelled cannot be set. Persist generates quote_code when it ' +
+        'is omitted. Not deduplicated: a retry without quote_code creates a second quote, so check ' +
+        'qom_quote_headers_list before retrying. A quote_code already used by a visible quote is refused.',
+    inputSchema: z.object({
+        quote_type: z.enum(['QUOTATION', 'ESTIMATE']).describe('Quote type (required)'),
+        sold_to_party_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the prm_parties row the quote is for (required)'),
+        quote_code: z
+            .string()
+            .min(1)
+            .max(32)
+            .optional()
+            .describe('Business quote reference. Persist generates one when omitted'),
+        quote_date: z.string().min(1).optional().describe('ISO 8601 quote date (defaults to today)'),
+        start_date: z.string().min(1).optional().describe('ISO 8601 date the quote is valid from'),
+        end_date: z.string().min(1).optional().describe('ISO 8601 date the quote expires'),
+        quote_currency_code: z.string().length(3).optional(),
+        sold_to_party_site_id: z.string().min(1).optional(),
+        sold_to_contact_point_id: z.string().min(1).optional(),
+        ship_to_party_id: z.string().min(1).optional(),
+        ship_to_party_site_id: z.string().min(1).optional(),
+        ship_to_contact_point_id: z.string().min(1).optional(),
+        payment_term_id: z.string().min(1).optional(),
+        payment_method_id: z.string().min(1).optional(),
+        priced_date: z.string().min(1).optional(),
+        requested_ship_date: z.string().min(1).optional(),
+        earliest_ship_date: z.string().min(1).optional(),
+        latest_ship_date: z.string().min(1).optional(),
+        requested_arrival_date: z.string().min(1).optional(),
+        earliest_arrival_date: z.string().min(1).optional(),
+        latest_arrival_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 quote is for'),
+        org_id: z.string().min(1).optional(),
+        metadata: z.record(z.unknown()).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: unenforcedIdempotencyKeySchema,
+    }),
+    capabilities: [cap('qom_quote_headers', 'INSERT'), cap('qom_quote_headers', 'SELECT')],
+    sideEffect: 'provisioning',
+    confirmation: 'caller_confirms',
+    idempotency: 'not_idempotent',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            quote_type: input.quote_type,
+            sold_to_party_id: input.sold_to_party_id,
+        };
+        for (const field of [
+            'quote_code',
+            'quote_date',
+            'start_date',
+            'end_date',
+            'quote_currency_code',
+            'sold_to_party_site_id',
+            'sold_to_contact_point_id',
+            'ship_to_party_id',
+            'ship_to_party_site_id',
+            'ship_to_contact_point_id',
+            'payment_term_id',
+            'payment_method_id',
+            'priced_date',
+            'requested_ship_date',
+            'earliest_ship_date',
+            'latest_ship_date',
+            'requested_arrival_date',
+            'earliest_arrival_date',
+            'latest_arrival_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 {
+            if (input.quote_code !== undefined) {
+                const filters = [`quote_code=eq.${encodeURIComponent(input.quote_code)}`];
+                if (input.org_id !== undefined) {
+                    filters.push(`org_id=eq.${encodeURIComponent(input.org_id)}`);
+                }
+                const existing = await ctx.apiClient.get(`${ctx.apiClient.dbBasePath}/qom_quote_headers?${filters.join('&')}&select=id&limit=1`);
+                if (existing?.[0]) {
+                    return errorResponse(API_ERROR, `QOM quote ${input.quote_code} already exists (id ${existing[0].id}): ` +
+                        'use that quote or choose another quote_code');
+                }
+            }
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/qom_quote_headers?select=*`, body, { headers: writeHeadersWithIdempotency(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create QOM quote: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=qom-quote-create.js.map

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

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

package/dist/tools/qom/qom-quote-line-add.d.ts

@@ -0,0 +1,13 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for a QOM quote line (`qom_quote_lines`).
+ *
+ * The tool omits line status, which defaults to `O` in Persist.
+ * `quote_header_id` and `org_id` are derived by Persist triggers.
+ *
+ * Persist stores the prices as supplied: it does not compare them with
+ * the price list or with each other. Unique key:
+ * (tenant_id, quote_version_id, quote_line_number).
+ */
+export declare const qomQuoteLineAddTool: Tool;
+//# sourceMappingURL=qom-quote-line-add.d.ts.map

package/dist/tools/qom/qom-quote-line-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qom-quote-line-add.d.ts","sourceRoot":"","sources":["../../../src/tools/qom/qom-quote-line-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQtC;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAkFjC,CAAC"}