@raytio/mcp-server 9.3.0 → 9.4.0

package/dist/tools/fap/fap-supplier-bill-create.js

@@ -0,0 +1,90 @@
+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 FAP supplier bill / invoice
+ * (transaction header). `transaction_status` is read-only per the
+ * pinned contract — new bills land in the persist-assigned default
+ * state. Approval status is excluded from this generic path (use
+ * status/approval-specific tools once backend endpoints exist).
+ *
+ * Unique key: `t_fap_supp_tx_hdrs_invoice_uk` (bill_from_supplier_id,
+ * invoice_number, tenant_id), so a retry with the same invoice_number
+ * fails with a duplicate-key error.
+ */
+export const fapSupplierBillCreateTool = {
+    name: 'fap_supplier_bill_create',
+    description: 'Record a supplier bill (fap_supplier_transaction_headers). transaction_status ' +
+        'is assigned by persist. invoice_number is unique per supplier: a retry with the same ' +
+        'invoice_number fails with a duplicate-key error instead of recording a second bill.',
+    inputSchema: z.object({
+        bill_from_supplier_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the supplier issuing the bill'),
+        bill_from_supplier_site_id: z.string().min(1).optional(),
+        bill_from_supplier_contact_point_id: z.string().min(1).optional(),
+        invoice_number: z
+            .string()
+            .min(1)
+            .max(64)
+            .describe('Supplier invoice number (natural key column)'),
+        transaction_date: z.string().min(1).describe('ISO 8601 invoice date'),
+        transaction_currency_code: currencyCodeSchema,
+        transaction_type: z
+            .string()
+            .max(32)
+            .optional()
+            .describe('Transaction type from the FAP_SUPPLIER_TRANSACTION_HEADERS_TRANSACTION_TYPE lookup ' +
+            '(e.g. INVOICE, CREDIT_MEMO, DEBIT_MEMO, PREPAYMENT)'),
+        our_po_number: z.string().max(64).optional(),
+        supplier_reference: z.string().max(255).optional(),
+        payment_term_id: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('UUID of the payment term. Required when the supplier (or supplier site use) has no ' +
+            'default payment term; Persist rejects the bill with PAYMENT_TERM_REQUIRED otherwise.'),
+        ship_from_party_id: z.string().min(1).optional(),
+        ship_from_party_site_id: z.string().min(1).optional(),
+        ship_from_party_contact_point_id: z.string().min(1).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('fap_supplier_transaction_headers', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            bill_from_supplier_id: input.bill_from_supplier_id,
+            invoice_number: input.invoice_number,
+            transaction_date: input.transaction_date,
+            transaction_currency_code: input.transaction_currency_code,
+        };
+        for (const field of [
+            'bill_from_supplier_site_id',
+            'bill_from_supplier_contact_point_id',
+            'transaction_type',
+            'our_po_number',
+            'supplier_reference',
+            'payment_term_id',
+            'ship_from_party_id',
+            'ship_from_party_site_id',
+            'ship_from_party_contact_point_id',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/fap_supplier_transaction_headers?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create FAP supplier bill: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=fap-supplier-bill-create.js.map

package/dist/tools/fap/fap-supplier-bill-create.js.map

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

package/dist/tools/fap/fap-supplier-bill-line-add.d.ts

@@ -0,0 +1,8 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema tool for appending a line to an FAP supplier bill.
+ * Amount and qty are validated at the MCP boundary. Retry-safe via
+ * (supplier_transaction_header_id, supplier_transaction_line_number).
+ */
+export declare const fapSupplierBillLineAddTool: Tool;
+//# sourceMappingURL=fap-supplier-bill-line-add.d.ts.map

package/dist/tools/fap/fap-supplier-bill-line-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-bill-line-add.d.ts","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-bill-line-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,IA2ExC,CAAC"}

package/dist/tools/fap/fap-supplier-bill-line-add.js

@@ -0,0 +1,75 @@
+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 appending a line to an FAP supplier bill.
+ * Amount and qty are validated at the MCP boundary. Retry-safe via
+ * (supplier_transaction_header_id, supplier_transaction_line_number).
+ */
+export const fapSupplierBillLineAddTool = {
+    name: 'fap_supplier_bill_line_add',
+    description: 'Append a line to an existing supplier bill. Amount/qty validated at the MCP ' +
+        'boundary. Natural key: (supplier_transaction_header_id, supplier_transaction_line_number). ' +
+        'Retry-safe.',
+    inputSchema: z.object({
+        supplier_transaction_header_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the bill header this line belongs to'),
+        bill_from_supplier_id: z
+            .string()
+            .min(1)
+            .describe('UUID of the supplier (must match the header)'),
+        supplier_transaction_line_number: z
+            .number()
+            .int()
+            .positive()
+            .describe('1-based line number, unique within the header'),
+        supplier_transaction_line_qty: signedMoneySchema.describe('Line quantity — signed to permit debit-memo 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 bill currency — must be > 0'),
+        unit_list_price: positiveMoneySchema.optional(),
+        extended_list_price: positiveMoneySchema.optional(),
+        supplier_transaction_line_item_id: z.string().min(1).optional(),
+        supplier_transaction_line_item_description: z.string().max(255).optional(),
+        supplier_transaction_line_uom: z.string().max(32).optional(),
+        supplier_transaction_line_reference: z.string().max(255).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('fap_supplier_transaction_lines', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = {
+            supplier_transaction_header_id: input.supplier_transaction_header_id,
+            bill_from_supplier_id: input.bill_from_supplier_id,
+            supplier_transaction_line_number: input.supplier_transaction_line_number,
+            supplier_transaction_line_qty: input.supplier_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',
+            'supplier_transaction_line_item_id',
+            'supplier_transaction_line_item_description',
+            'supplier_transaction_line_uom',
+            'supplier_transaction_line_reference',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/fap_supplier_transaction_lines?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to add FAP supplier bill line: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=fap-supplier-bill-line-add.js.map

package/dist/tools/fap/fap-supplier-bill-line-add.js.map

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

package/dist/tools/fap/fap-supplier-create.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from '../registry.js';
+/**
+ * Explicit-schema create for `fap_suppliers`. Approval and status
+ * columns are DELIBERATELY excluded — the persist layer assigns the
+ * initial lifecycle state so a caller cannot bootstrap an already-
+ * approved supplier via MCP.
+ */
+export declare const fapSupplierCreateTool: Tool;
+//# sourceMappingURL=fap-supplier-create.d.ts.map

package/dist/tools/fap/fap-supplier-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-create.d.ts","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,IA2CnC,CAAC"}

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

@@ -0,0 +1,53 @@
+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 `fap_suppliers`. Approval and status
+ * columns are DELIBERATELY excluded — the persist layer assigns the
+ * initial lifecycle state so a caller cannot bootstrap an already-
+ * approved supplier via MCP.
+ */
+export const fapSupplierCreateTool = {
+    name: 'fap_supplier_create',
+    description: 'Create a new FAP supplier with an explicit safe field set. Approval/status ' +
+        'columns are excluded — persist assigns the initial lifecycle state. ' +
+        'One supplier per party, and supplier_code is unique, within the tenant: a retry ' +
+        'fails with a duplicate-key error instead of creating a second supplier.',
+    inputSchema: z.object({
+        party_id: z.string().min(1).describe('UUID of the PRM party this supplier represents'),
+        supplier_code: z.string().min(1).max(64).optional(),
+        supplier_class_code: z.string().max(64).optional(),
+        supplier_type_code: z.string().max(64).optional(),
+        invoice_currency_code: currencyCodeSchema.optional(),
+        payment_term_id: z.string().min(1).optional(),
+        idempotency_key: idempotencyKeySchema,
+    }),
+    capabilities: [cap('fap_suppliers', 'INSERT')],
+    sideEffect: 'state_change',
+    confirmation: 'none',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const body = { party_id: input.party_id };
+        for (const field of [
+            'supplier_code',
+            'supplier_class_code',
+            'supplier_type_code',
+            'invoice_currency_code',
+            'payment_term_id',
+        ]) {
+            if (input[field] !== undefined)
+                body[field] = input[field];
+        }
+        try {
+            const rows = await ctx.apiClient.post(`${ctx.apiClient.dbBasePath}/fap_suppliers?select=*`, body, { headers: financeWriteHeaders(input.idempotency_key) });
+            return successResponse(rows[0]);
+        }
+        catch (error) {
+            return errorResponse(API_ERROR, `Failed to create FAP supplier: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=fap-supplier-create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-create.js","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-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,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,6EAA6E;QAC7E,sEAAsE;QACtE,kFAAkF;QAClF,yEAAyE;IAC3E,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;QACnD,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,qBAAqB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACpD,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,KAAK,MAAM,KAAK,IAAI;YAClB,eAAe;YACf,qBAAqB;YACrB,oBAAoB;YACpB,uBAAuB;YACvB,iBAAiB;SAClB,EAAE,CAAC;YACF,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC;YACH,MAAM,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/fap/fap-supplier-status-set.d.ts

@@ -0,0 +1,8 @@
+import { Tool } from '../registry.js';
+/**
+ * Semantic supplier lifecycle transition — mirrors far_customer_status_set.
+ * Reads the row first: the reason is merged into the existing `metadata`,
+ * and a supplier already in the target state is returned unchanged.
+ */
+export declare const fapSupplierStatusSetTool: Tool;
+//# sourceMappingURL=fap-supplier-status-set.d.ts.map

package/dist/tools/fap/fap-supplier-status-set.d.ts.map

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

package/dist/tools/fap/fap-supplier-status-set.js

@@ -0,0 +1,62 @@
+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 supplier lifecycle transition — mirrors far_customer_status_set.
+ * Reads the row first: the reason is merged into the existing `metadata`,
+ * and a supplier already in the target state is returned unchanged.
+ */
+export const fapSupplierStatusSetTool = {
+    name: 'fap_supplier_status_set',
+    description: 'Transition a FAP supplier lifecycle status. Accepts supplier_status_code and/or ' +
+        'supplier_approval_status_code; requires a `reason`, merged into the supplier metadata. ' +
+        'A supplier already in the target state is returned unchanged, so retries are safe.',
+    inputSchema: z
+        .object({
+        id: z.string().min(1).describe('UUID of the supplier'),
+        supplier_status_code: z
+            .string()
+            .max(64)
+            .optional()
+            .describe('Target status from the FAP_SUPPLIERS_SUPPLIER_STATUS lookup (e.g. A = Active, I = Inactive)'),
+        supplier_approval_status_code: z
+            .string()
+            .max(64)
+            .optional()
+            .describe('Target approval status from the FAP_SUPPLIERS_SUPPLIER_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.supplier_status_code !== undefined ||
+        v.supplier_approval_status_code !== undefined, {
+        message: 'supply supplier_status_code and/or supplier_approval_status_code — at least one is required.',
+    }),
+    capabilities: [cap('fap_suppliers', 'UPDATE')],
+    sideEffect: 'state_change',
+    confirmation: 'caller_provides_reason',
+    idempotency: 'natural_key',
+    handler: async (args, ctx) => {
+        const input = args;
+        const target = {};
+        if (input.supplier_status_code !== undefined) {
+            target.supplier_status_code = input.supplier_status_code;
+        }
+        if (input.supplier_approval_status_code !== undefined) {
+            target.supplier_approval_status_code = input.supplier_approval_status_code;
+        }
+        return softDeactivate(ctx, {
+            table: 'fap_suppliers',
+            id: input.id,
+            label: 'FAP supplier',
+            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=fap-supplier-status-set.js.map

package/dist/tools/fap/fap-supplier-status-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-status-set.js","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-status-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,kFAAkF;QAClF,yFAAyF;QACzF,oFAAoF;IACtF,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACtD,oBAAoB,EAAE,CAAC;aACpB,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,6FAA6F,CAC9F;QACH,6BAA6B,EAAE,CAAC;aAC7B,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,gFAAgF;YAC9E,gDAAgD,CACnD;QACH,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACjF,eAAe,EAAE,oBAAoB;KACtC,CAAC;SACD,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,oBAAoB,KAAK,SAAS;QACpC,CAAC,CAAC,6BAA6B,KAAK,SAAS,EAC/C;QACE,OAAO,EACL,8FAA8F;KACjG,CACF;IACH,YAAY,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC9C,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAMb,CAAC;QACF,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC;QAC3D,CAAC;QACD,IAAI,KAAK,CAAC,6BAA6B,KAAK,SAAS,EAAE,CAAC;YACtD,MAAM,CAAC,6BAA6B,GAAG,KAAK,CAAC,6BAA6B,CAAC;QAC7E,CAAC;QACD,OAAO,cAAc,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,eAAe;YACtB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,cAAc;YACrB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM;YACrB,SAAS,EAAE,sBAAsB;YACjC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/fap/fap-supplier-update.d.ts

@@ -0,0 +1,8 @@
+import { Tool } from '../registry.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 declare const fapSupplierUpdateTool: Tool;
+//# sourceMappingURL=fap-supplier-update.d.ts.map

package/dist/tools/fap/fap-supplier-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fap-supplier-update.d.ts","sourceRoot":"","sources":["../../../src/tools/fap/fap-supplier-update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAgDnC,CAAC"}

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,27 @@
+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_pk`), 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.
+ *
+ * This follows dev and the resource contract. The Persist repo SQL
+ * differs: its view exposes `receipt_code` and it has no unique key on
+ * that column, so a database built from the repo would not match
+ * until that is resolved (WI-0009298, WI-0009313).
+ *
+ * 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAiFtC,CAAC"}

package/dist/tools/far/far-cash-receipt-record.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 { 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_pk`), 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.
+ *
+ * This follows dev and the resource contract. The Persist repo SQL
+ * differs: its view exposes `receipt_code` and it has no unique key on
+ * that column, so a database built from the repo would not match
+ * until that is resolved (WI-0009298, WI-0009313).
+ *
+ * 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_number: 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