@raytio/mcp-server 9.3.0 → 10.0.0

package/dist/tools/fap/fap-supplier-update.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { currencyCodeSchema } from '../_shared/money.js';
+import { financeWriteHeaders, idempotencyKeySchema, } from '../_shared/finance-idempotency.js';
+/**
+ * Explicit-schema update for `fap_suppliers`. Status/approval columns
+ * are excluded — use `fap_supplier_status_set` for lifecycle
+ * transitions so a reason is recorded on the audit trail.
+ */
+export const fapSupplierUpdateTool = {
+    name: 'fap_supplier_update',
+    description: 'Update a FAP supplier with an explicit safe field set. Status/approval ' +
+        'columns are excluded — use fap_supplier_status_set for lifecycle transitions. ' +
+        'Retry-safe (converges on the same target state).',
+    inputSchema: z.object({
+        id: z.string().min(1).describe('UUID of the supplier'),
+        supplier_code: z.string().max(64).nullable().optional(),
+        supplier_class_code: z.string().max(64).nullable().optional(),
+        supplier_type_code: z.string().max(64).nullable().optional(),
+        invoice_currency_code: currencyCodeSchema.nullable().optional(),
+        payment_term_id: z.string().nullable().optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('fap_suppliers', '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;
+        }
+        if (Object.keys(body).length === 0) {
+            return errorResponse(API_ERROR, 'Update payload is empty — supply at least one field to change.');
+        }
+        try {
+            const rows = await ctx.apiClient.patch(`${ctx.apiClient.dbBasePath}/fap_suppliers?id=eq.${id}&select=*`, body, { headers: financeWriteHeaders(idempotency_key) });
+            if (!rows || rows.length === 0) {
+                return errorResponse(API_ERROR, `FAP supplier ${id} not found or not accessible`);
+            }
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to update FAP supplier: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=fap-supplier-update.js.map

package/dist/tools/fap/fap-supplier-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-update.js","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-update.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,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,yEAAyE;QACzE,gFAAgF;QAChF,kDAAkD;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACtD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACvD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC7D,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC5D,qBAAqB,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC/D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACjD,eAAe,EAAE,oBAAoB;KACtC,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC9C,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,IAGd,CAAC;QAC5B,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,aAAa,CAClB,SAAS,EACT,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,CACpC,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,wBAAwB,EAAE,WAAW,EAChE,IAAI,EACJ,EAAE,OAAO,EAAE,mBAAmB,CAAC,eAAe,CAAC,EAAE,CAClD,CAAC;YACF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,aAAa,CAAC,SAAS,EAAE,gBAAgB,EAAE,8BAA8B,CAAC,CAAC;YACpF,CAAC;YACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,SAAS,EAAE,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,19 @@
+import { buildGeneratedReadCatalogue, buildGeneratedReadCatalogueReport, } from '../../generated-reads/index.js';
+import { loadPersistResourceContract } from '../../contracts/persist-resource-contract.js';
+/**
+ * Bounded read tools for the FAP module (WI-0003504).
+ *
+ * Emits describe/list/get for every FAP resource that declares a read
+ * operation. Sensitive resources (`fap_invoice_holds`,
+ * `fap_payment_schedules`) are explicitly opted in — the WI acceptance
+ * criteria call for bounded reads over payables and payment schedules,
+ * and neither resource carries credential-shaped columns the redaction
+ * guardrail would need to blank.
+ */
+const contract = loadPersistResourceContract();
+export const fapGeneratedReadReport = buildGeneratedReadCatalogueReport(contract, {
+    modules: ['fap'],
+    includeSensitive: true,
+});
+export const fapGeneratedReadTools = buildGeneratedReadCatalogue(contract, { modules: ['fap'], includeSensitive: true });
+//# sourceMappingURL=generated-reads.js.map

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

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

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

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

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

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

package/dist/tools/fap/index.js

@@ -0,0 +1,21 @@
+import { fapGeneratedReadTools } from './generated-reads.js';
+import { fapSupplierCreateTool } from './fap-supplier-create.js';
+import { fapSupplierUpdateTool } from './fap-supplier-update.js';
+import { fapSupplierStatusSetTool } from './fap-supplier-status-set.js';
+import { fapSupplierBillCreateTool } from './fap-supplier-bill-create.js';
+import { fapSupplierBillLineAddTool } from './fap-supplier-bill-line-add.js';
+import { fapInvoiceHoldPlaceTool } from './fap-invoice-hold-place.js';
+import { fapInvoiceHoldReleaseTool } from './fap-invoice-hold-release.js';
+const fapWriteTools = [
+    fapSupplierCreateTool,
+    fapSupplierUpdateTool,
+    fapSupplierStatusSetTool,
+    fapSupplierBillCreateTool,
+    fapSupplierBillLineAddTool,
+    fapInvoiceHoldPlaceTool,
+    fapInvoiceHoldReleaseTool,
+];
+export const fapTools = [...fapGeneratedReadTools, ...fapWriteTools];
+/** Read-only slice used by the `fap-readonly` selectable sub-domain. */
+export const fapReadOnlyTools = fapGeneratedReadTools;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/fap/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,aAAa,GAAW;IAC5B,qBAAqB;IACrB,qBAAqB;IACrB,wBAAwB;IACxB,yBAAyB;IACzB,0BAA0B;IAC1B,uBAAuB;IACvB,yBAAyB;CAC1B,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/far/far-cash-receipt-record.d.ts

@@ -0,0 +1,22 @@
+import { Tool } from '../registry.js';
+/**
+ * Payment semantic tool: record a cash receipt against a customer.
+ * Moves value on the ledger, so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a positive `receipt_amount` validated at the MCP boundary;
+ *  - a 3-letter ISO currency code;
+ *  - a `receipt_number`. It is stored as `receipt_code`, which is
+ *    unique per organisation (`t_far_cash_receipts_code_uk`), so a
+ *    retry fails with a duplicate-key error. Without it Persist
+ *    generates a new code on every insert, and Persist ignores
+ *    `Idempotency-Key` (WI-0008817), so an `idempotency_key` alone
+ *    would record the payment twice.
+ *
+ * The generated bounded read framework filters `far_cash_receipts` out
+ * of the auto-read surface (sensitivity=`sensitive`); the module opts
+ * it back in with credential redaction, and this dedicated tool is the
+ * ONLY approved write path.
+ */
+export declare const farCashReceiptRecordTool: Tool;
+//# sourceMappingURL=far-cash-receipt-record.d.ts.map

package/dist/tools/far/far-cash-receipt-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-cash-receipt-record.d.ts","sourceRoot":"","sources":["../../../src/tools/far/far-cash-receipt-record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAatC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAiFtC,CAAC"}

package/dist/tools/far/far-cash-receipt-record.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 { currencyCodeSchema, positiveMoneySchema, } from '../_shared/money.js';
+import { confirmFlagSchema, financeWriteHeaders, idempotencyKeySchema, } from '../_shared/finance-idempotency.js';
+/**
+ * Payment semantic tool: record a cash receipt against a customer.
+ * Moves value on the ledger, so the tool requires:
+ *
+ *  - `confirm: true` to prevent accidental invocation;
+ *  - a positive `receipt_amount` validated at the MCP boundary;
+ *  - a 3-letter ISO currency code;
+ *  - a `receipt_number`. It is stored as `receipt_code`, which is
+ *    unique per organisation (`t_far_cash_receipts_code_uk`), so a
+ *    retry fails with a duplicate-key error. Without it Persist
+ *    generates a new code on every insert, and Persist ignores
+ *    `Idempotency-Key` (WI-0008817), so an `idempotency_key` alone
+ *    would record the payment twice.
+ *
+ * The generated bounded read framework filters `far_cash_receipts` out
+ * of the auto-read surface (sensitivity=`sensitive`); the module opts
+ * it back in with credential redaction, and this dedicated tool is the
+ * ONLY approved write path.
+ */
+export const farCashReceiptRecordTool = {
+    name: 'far_cash_receipt_record',
+    description: 'Record a cash receipt against a customer (far_cash_receipts). Requires ' +
+        'confirm=true, a positive receipt_amount, ISO currency, and a receipt_number. ' +
+        'receipt_number is unique within the organisation: a retry with the same ' +
+        'receipt_number fails with a duplicate-key error instead of recording the payment twice.',
+    inputSchema: z
+        .object({
+        customer_id: z.string().min(1).describe('UUID of the customer'),
+        customer_site_use_id: z.string().min(1).optional(),
+        receipt_amount: positiveMoneySchema.describe('Positive amount to record'),
+        receipt_currency_code: currencyCodeSchema,
+        receipt_date: z.string().min(1).describe('ISO 8601 date the funds cleared'),
+        receipt_number: z
+            .string()
+            .min(1)
+            .max(30)
+            .describe('Business receipt number, unique within the organisation. Required so a retry ' +
+            'cannot record the same payment twice.'),
+        receipt_type: z
+            .string()
+            .max(20)
+            .optional()
+            .describe('Receipt type from the FAR_CASH_RECEIPTS_RECEIPT_TYPE lookup (e.g. CASH, MISC)'),
+        customer_reference: z.string().max(30).optional(),
+        customer_bank_account_id: z.string().min(1).optional(),
+        remittance_bank_account_use_id: z.string().min(1).optional(),
+        exchange_rate: z.number().positive().optional(),
+        exchange_rate_type: z.string().max(30).optional(),
+        exchange_date: z.string().min(1).optional(),
+        confirm: confirmFlagSchema,
+        idempotency_key: idempotencyKeySchema,
+    })
+        .refine((v) => v.exchange_rate === undefined || v.exchange_rate_type !== undefined, {
+        message: 'exchange_rate requires exchange_rate_type (and typically exchange_date)',
+    }),
+    capabilities: [cap('far_cash_receipts', 'INSERT')],
+    sideEffect: 'payment',
+    confirmation: 'caller_confirms',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            customer_id: input.customer_id,
+            receipt_code: input.receipt_number,
+            receipt_amount: input.receipt_amount,
+            receipt_currency_code: input.receipt_currency_code,
+            receipt_date: input.receipt_date,
+        };
+        for (const field of [
+            'customer_site_use_id',
+            'receipt_type',
+            'customer_reference',
+            'customer_bank_account_id',
+            'remittance_bank_account_use_id',
+            'exchange_rate',
+            'exchange_rate_type',
+            'exchange_date',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/far_cash_receipts?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to record FAR cash receipt: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=far-cash-receipt-record.js.map

package/dist/tools/far/far-cash-receipt-record.js.map

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

package/dist/tools/far/far-customer-create.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for `far_customers`. The generated bounded
+ * read framework refuses to auto-generate mutations for FAR/FAP
+ * resources (WI-0003501 / WI-0003504), so every writeable field is
+ * spelled out here and consequential defaults (approval status,
+ * status) are OMITTED — the backend applies its own initial state,
+ * which prevents a caller from provisioning an already-approved
+ * customer via MCP.
+ */
+export declare const farCustomerCreateTool: Tool;
+//# sourceMappingURL=far-customer-create.d.ts.map

package/dist/tools/far/far-customer-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-customer-create.d.ts","sourceRoot":"","sources":["../../../src/tools/far/far-customer-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQtC;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,IA0CnC,CAAC"}

package/dist/tools/far/far-customer-create.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { financeWriteHeaders, idempotencyKeySchema, } from '../_shared/finance-idempotency.js';
+/**
+ * Explicit-schema create for `far_customers`. The generated bounded
+ * read framework refuses to auto-generate mutations for FAR/FAP
+ * resources (WI-0003501 / WI-0003504), so every writeable field is
+ * spelled out here and consequential defaults (approval status,
+ * status) are OMITTED — the backend applies its own initial state,
+ * which prevents a caller from provisioning an already-approved
+ * customer via MCP.
+ */
+export const farCustomerCreateTool = {
+    name: 'far_customer_create',
+    description: 'Create a new FAR customer with an explicit safe field set. Approval/status ' +
+        'fields are intentionally excluded — the persist layer assigns the initial ' +
+        'lifecycle state. One customer per party, and customer_code is unique, within the ' +
+        'tenant: a retry fails with a duplicate-key error instead of creating a second customer.',
+    inputSchema: z.object({
+        party_id: z.string().min(1).describe('UUID of the PRM party this customer represents'),
+        customer_code: z.string().min(1).max(64).optional().describe('Optional stable code'),
+        customer_class_code: z.string().max(64).optional(),
+        customer_type_code: z.string().max(64).optional(),
+        payment_term_id: z.string().min(1).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('far_customers', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = { party_id: input.party_id };
+        const optional = [
+            'customer_code',
+            'customer_class_code',
+            'customer_type_code',
+            'payment_term_id',
+        ];
+        for (const field of optional) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/far_customers?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create FAR customer: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=far-customer-create.js.map

package/dist/tools/far/far-customer-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-customer-create.js","sourceRoot":"","sources":["../../../src/tools/far/far-customer-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,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,6EAA6E;QAC7E,4EAA4E;QAC5E,mFAAmF;QACjF,yFAAyF;IAC7F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACtF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpF,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAClD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACjD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC7C,eAAe,EAAE,oBAAoB;KACtC,CAAC;IACF,YAAY,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC9C,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,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAG;YACf,eAAe;YACf,qBAAqB;YACrB,oBAAoB;YACpB,iBAAiB;SAClB,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,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,yBAAyB,EACpD,IAAI,EACJ,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CACxD,CAAC;YACF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,SAAS,EAAE,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/far/far-customer-invoice-create.d.ts

@@ -0,0 +1,13 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for an FAR customer invoice (transaction
+ * header). The `transaction_status` column is read-only per the pinned
+ * contract — the persist layer assigns the initial state — so we omit
+ * every lifecycle-transition column from this generic path.
+ *
+ * Unique key: `t_far_cust_tx_headers_uk` (transaction_code, org_id,
+ * tenant_id), so a retry with the same transaction_code fails with a
+ * duplicate-key error.
+ */
+export declare const farCustomerInvoiceCreateTool: Tool;
+//# sourceMappingURL=far-customer-invoice-create.d.ts.map

package/dist/tools/far/far-customer-invoice-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-customer-invoice-create.d.ts","sourceRoot":"","sources":["../../../src/tools/far/far-customer-invoice-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,EAAE,IAmE1C,CAAC"}

package/dist/tools/far/far-customer-invoice-create.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { currencyCodeSchema } from '../_shared/money.js';
+import { financeWriteHeaders, idempotencyKeySchema, } from '../_shared/finance-idempotency.js';
+/**
+ * Explicit-schema create for an FAR customer invoice (transaction
+ * header). The `transaction_status` column is read-only per the pinned
+ * contract — the persist layer assigns the initial state — so we omit
+ * every lifecycle-transition column from this generic path.
+ *
+ * Unique key: `t_far_cust_tx_headers_uk` (transaction_code, org_id,
+ * tenant_id), so a retry with the same transaction_code fails with a
+ * duplicate-key error.
+ */
+export const farCustomerInvoiceCreateTool = {
+    name: 'far_customer_invoice_create',
+    description: 'Create a customer invoice (far_customer_transaction_headers). transaction_status ' +
+        'is read-only and assigned by persist. transaction_code is unique within the ' +
+        'organisation: a retry with the same transaction_code fails with a duplicate-key ' +
+        'error instead of creating a second invoice.',
+    inputSchema: z.object({
+        sold_to_customer_id: z.string().min(1).describe('UUID of the customer being billed'),
+        sold_to_customer_site_id: z.string().min(1).optional(),
+        transaction_code: z
+            .string()
+            .min(1)
+            .max(64)
+            .describe('Business invoice/transaction reference (natural key column)'),
+        transaction_date: z.string().min(1).describe('ISO 8601 date (YYYY-MM-DD)'),
+        transaction_currency_code: currencyCodeSchema,
+        transaction_type: z
+            .string()
+            .max(32)
+            .optional()
+            .describe('Transaction type from the FAR_CUSTOMER_TRANSACTION_HEADERS_TRANSACTION_TYPE lookup ' +
+            '(INVOICE, CREDIT_MEMO, DEBIT_MEMO). Defaults to INVOICE.'),
+        payment_term_id: z.string().min(1).optional(),
+        payment_method_id: z.string().min(1).optional(),
+        customer_po_number: z.string().max(64).optional(),
+        customer_reference: z.string().max(255).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('far_customer_transaction_headers', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            sold_to_customer_id: input.sold_to_customer_id,
+            transaction_code: input.transaction_code,
+            transaction_date: input.transaction_date,
+            transaction_currency_code: input.transaction_currency_code,
+        };
+        for (const field of [
+            'sold_to_customer_site_id',
+            'transaction_type',
+            'payment_term_id',
+            'payment_method_id',
+            'customer_po_number',
+            'customer_reference',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/far_customer_transaction_headers?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create FAR customer invoice: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=far-customer-invoice-create.js.map

package/dist/tools/far/far-customer-invoice-create.js.map

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

package/dist/tools/far/far-customer-invoice-line-add.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema tool for adding a line to a FAR customer invoice.
+ * The invoice header must already exist and be in a modifiable state —
+ * the persist layer enforces the guard; MCP does not need to
+ * pre-check it. Retry-safe via
+ * (customer_transaction_header_id, customer_transaction_line_number).
+ */
+export declare const farCustomerInvoiceLineAddTool: Tool;
+//# sourceMappingURL=far-customer-invoice-line-add.d.ts.map

package/dist/tools/far/far-customer-invoice-line-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-customer-invoice-line-add.d.ts","sourceRoot":"","sources":["../../../src/tools/far/far-customer-invoice-line-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,IA2E3C,CAAC"}

package/dist/tools/far/far-customer-invoice-line-add.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { API_ERROR, errorResponse, successResponse } from '../types.js';
+import { cap } from '../../capabilities/tool-capability.js';
+import { positiveMoneySchema, signedMoneySchema, } from '../_shared/money.js';
+import { financeWriteHeaders, idempotencyKeySchema, } from '../_shared/finance-idempotency.js';
+/**
+ * Explicit-schema tool for adding a line to a FAR customer invoice.
+ * The invoice header must already exist and be in a modifiable state —
+ * the persist layer enforces the guard; MCP does not need to
+ * pre-check it. Retry-safe via
+ * (customer_transaction_header_id, customer_transaction_line_number).
+ */
+export const farCustomerInvoiceLineAddTool = {
+    name: 'far_customer_invoice_line_add',
+    description: 'Append a line to an existing customer invoice. Amount/qty validated at the ' +
+        'MCP boundary. Natural key: (customer_transaction_header_id, customer_transaction_line_number). ' +
+        'Retry-safe.',
+    inputSchema: z.object({
+        customer_transaction_header_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the invoice header this line belongs to'),
+        sold_to_customer_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the customer (must match the header)'),
+        customer_transaction_line_number: z
+            .number()
+            .int()
+            .positive()
+            .describe('1-based line number, unique within the header'),
+        customer_transaction_line_qty: signedMoneySchema.describe('Line quantity — signed to permit credit-note negative lines'),
+        extended_transaction_price: positiveMoneySchema.describe('Line total (qty × unit_transaction_price) — must be > 0'),
+        unit_transaction_price: positiveMoneySchema.describe('Unit price at the invoice currency — must be > 0'),
+        unit_list_price: positiveMoneySchema.optional(),
+        extended_list_price: positiveMoneySchema.optional(),
+        customer_transaction_line_item_id: z.string().min(1).optional(),
+        customer_transaction_line_item_description: z.string().max(255).optional(),
+        customer_transaction_line_uom: z.string().max(32).optional(),
+        customer_transaction_line_reference: z.string().max(255).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('far_customer_transaction_lines', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            customer_transaction_header_id: input.customer_transaction_header_id,
+            sold_to_customer_id: input.sold_to_customer_id,
+            customer_transaction_line_number: input.customer_transaction_line_number,
+            customer_transaction_line_qty: input.customer_transaction_line_qty,
+            extended_transaction_price: input.extended_transaction_price,
+            unit_transaction_price: input.unit_transaction_price,
+        };
+        for (const field of [
+            'unit_list_price',
+            'extended_list_price',
+            'customer_transaction_line_item_id',
+            'customer_transaction_line_item_description',
+            'customer_transaction_line_uom',
+            'customer_transaction_line_reference',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/far_customer_transaction_lines?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to add FAR customer invoice line: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=far-customer-invoice-line-add.js.map

package/dist/tools/far/far-customer-invoice-line-add.js.map

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

package/dist/tools/far/far-customer-status-set.d.ts

@@ -0,0 +1,15 @@
+import { Tool } from '../registry.js';
+/**
+ * Semantic tool for a customer lifecycle transition. Wrapping this as a
+ * dedicated tool (rather than exposing status columns on the generic
+ * update path) records a reason and gives the caller a single fact to
+ * reason about ("set status to A") rather than a bag of columns.
+ *
+ * Callers must supply a target `customer_status_code` OR
+ * `customer_approval_status_code`; both may be supplied together.
+ * The tool reads the row first: the reason is merged into the existing
+ * `metadata`, and a customer already in the target state is returned
+ * unchanged, so a retry keeps the original reason.
+ */
+export declare const farCustomerStatusSetTool: Tool;
+//# sourceMappingURL=far-customer-status-set.d.ts.map

package/dist/tools/far/far-customer-status-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"far-customer-status-set.d.ts","sourceRoot":"","sources":["../../../src/tools/far/far-customer-status-set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAoEtC,CAAC"}

package/dist/tools/far/far-customer-status-set.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { cap } from '../../capabilities/tool-capability.js';
+import { idempotencyKeySchema, reasonSchema } from '../_shared/finance-idempotency.js';
+import { softDeactivate } from '../_shared/soft-deactivate.js';
+/**
+ * Semantic tool for a customer lifecycle transition. Wrapping this as a
+ * dedicated tool (rather than exposing status columns on the generic
+ * update path) records a reason and gives the caller a single fact to
+ * reason about ("set status to A") rather than a bag of columns.
+ *
+ * Callers must supply a target `customer_status_code` OR
+ * `customer_approval_status_code`; both may be supplied together.
+ * The tool reads the row first: the reason is merged into the existing
+ * `metadata`, and a customer already in the target state is returned
+ * unchanged, so a retry keeps the original reason.
+ */
+export const farCustomerStatusSetTool = {
+    name: 'far_customer_status_set',
+    description: 'Transition an FAR customer lifecycle status. Accepts customer_status_code and/or ' +
+        'customer_approval_status_code; requires a `reason`, merged into the customer metadata. ' +
+        'A customer already in the target state is returned unchanged, so retries are safe.',
+    inputSchema: z
+        .object({
+        id: z.string().min(1).describe('UUID of the customer'),
+        customer_status_code: z
+            .string()
+            .max(64)
+            .optional()
+            .describe('Target status from the FAR_CUSTOMERS_CUSTOMER_STATUS lookup ' +
+            '(e.g. A = Active, I = Inactive, P = Pending)'),
+        customer_approval_status_code: z
+            .string()
+            .max(64)
+            .optional()
+            .describe('Target approval status from the FAR_CUSTOMERS_CUSTOMER_APPROVAL_STATUS lookup ' +
+            '(e.g. A = Approved, P = Pending, R = Rejected)'),
+        reason: reasonSchema.describe('Human-readable justification, stored in metadata'),
+        idempotency_key: idempotencyKeySchema,
+    })
+        .refine((v) => v.customer_status_code !== undefined ||
+        v.customer_approval_status_code !== undefined, {
+        message: 'supply customer_status_code and/or customer_approval_status_code — at least one is required.',
+    }),
+    capabilities: [cap('far_customers', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_provides_reason',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const target = {};
+        if (input.customer_status_code !== undefined) {
+            target.customer_status_code = input.customer_status_code;
+        }
+        if (input.customer_approval_status_code !== undefined) {
+            target.customer_approval_status_code = input.customer_approval_status_code;
+        }
+        return softDeactivate(ctx, {
+            table: 'far_customers',
+            id: input.id,
+            label: 'FAR customer',
+            verb: 'set status of',
+            isDone: (row) => Object.entries(target).every(([k, v]) => row[k] === v),
+            changes: () => target,
+            reasonKey: 'status_change_reason',
+            reason: input.reason,
+            idempotencyKey: input.idempotency_key,
+        });
+    },
+};
+//# sourceMappingURL=far-customer-status-set.js.map