@lerianstudio/matcher-mcp 1.0.0 → 1.1.0

package/dist/tools/dashboard/shared.js

@@ -42,6 +42,13 @@ export function contextDashboardSlicePath(contextId, slice) {
  * verbatim and let matcher own that validation (a 90-day breach surfaces as a
  * structured RFC 9457 error). contextId and source_id are routing/data params,
  * NOT tenant fields.
+ *
+ * F4: the 30-day default is a silent clip, not a "no data" signal — a caller
+ * with no UI date-picker (an LLM operator) gets a real, well-formed payload
+ * back that simply excludes older data, with nothing in the response marking
+ * it as partial. The field descriptions below call this out explicitly so a
+ * model reads the warning before it reports a windowed number as the whole
+ * reconciliation result.
  */
 export const dashboardQueryInputShape = {
     contextId: z
@@ -52,13 +59,18 @@ export const dashboardQueryInputShape = {
     date_from: z
         .string()
         .optional()
-        .describe('Start date (YYYY-MM-DD), inclusive. Optional — matcher defaults to 30 ' +
-        'days before date_to. The window may not exceed 90 days.'),
+        .describe('Start date (YYYY-MM-DD), inclusive. Optional — if omitted (with ' +
+        'date_to), matcher defaults to the last ~30 days, SILENTLY EXCLUDING ' +
+        'everything older. A windowed result is NOT "the reconciliation ' +
+        'result" — for a complete picture, pass an explicit date_from/date_to ' +
+        '(max 90-day span).'),
     date_to: z
         .string()
         .optional()
-        .describe('End date (YYYY-MM-DD), inclusive. Optional — matcher defaults to ' +
-        'tomorrow (UTC). The window may not exceed 90 days.'),
+        .describe('End date (YYYY-MM-DD), inclusive. Optional — if omitted, matcher ' +
+        'defaults to tomorrow (UTC). Combined with an omitted date_from this ' +
+        'silently clips the window to the last ~30 days; pass an explicit ' +
+        'date_from/date_to (max 90-day span) for the full picture.'),
     source_id: z
         .string()
         .optional()

package/dist/tools/dashboard/shared.js.map

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

package/dist/tools/dashboard/sla.js

@@ -17,9 +17,10 @@ export function registerDashboardSlaTool(server) {
     server.registerTool('dashboard_sla', {
         description: 'Get the SLA compliance statistics for a reconciliation context. Pass ' +
             'contextId (UUID path param — not a tenant field), and optionally ' +
-            'date_from/date_to (YYYY-MM-DD; matcher defaults to the last 30 days and ' +
-            'caps the window at 90 days) and/or source_id (UUID data filter). No ' +
-            'tenant field is accepted.',
+            'date_from/date_to (YYYY-MM-DD; matcher defaults to the last ~30 days ' +
+            'and SILENTLY EXCLUDES older exceptions — for a full picture pass an ' +
+            'explicit date_from/date_to, max 90-day span) and/or source_id (UUID ' +
+            'data filter). No tenant field is accepted.',
         inputSchema: dashboardSlaInputShape,
     }, async (args, extra) => {
         const query = buildDashboardQuery(args);

package/dist/tools/dashboard/sla.js.map

@@ -1 +1 @@
-{"version":3,"file":"sla.js","sourceRoot":"","sources":["../../../src/tools/dashboard/sla.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,eAAe;AAIf,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,uEAAuE;YACvE,mEAAmE;YACnE,0EAA0E;YAC1E,sEAAsE;YACtE,2BAA2B;QAC7B,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;YACtD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"sla.js","sourceRoot":"","sources":["../../../src/tools/dashboard/sla.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,eAAe;AAIf,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,uEAAuE;YACvE,mEAAmE;YACnE,uEAAuE;YACvE,sEAAsE;YACtE,sEAAsE;YACtE,4CAA4C;QAC9C,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;YACtD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/dashboard/source-breakdown.js

@@ -20,9 +20,10 @@ export function registerDashboardSourceBreakdownTool(server) {
         description: 'Get the per-source reconciliation breakdown for a context (statistics ' +
             'grouped by source). Pass contextId (UUID path param — not a tenant ' +
             'field), and optionally date_from/date_to (YYYY-MM-DD; matcher defaults ' +
-            'to the last 30 days and caps the window at 90 days) and/or source_id ' +
-            '(UUID data filter, to narrow to a single source). No tenant field is ' +
-            'accepted.',
+            'to the last ~30 days and SILENTLY EXCLUDES older data — for a full ' +
+            'picture pass an explicit date_from/date_to, max 90-day span) and/or ' +
+            'source_id (UUID data filter, to narrow to a single source). No tenant ' +
+            'field is accepted.',
         inputSchema: dashboardSourceBreakdownInputShape,
     }, async (args, extra) => {
         const query = buildDashboardQuery(args);

package/dist/tools/dashboard/source-breakdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-breakdown.js","sourceRoot":"","sources":["../../../src/tools/dashboard/source-breakdown.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,+DAA+D;AAC/D,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,2EAA2E;AAC3E,+EAA+E;AAC/E,iDAAiD;AAIjD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,yFAAyF;AACzF,MAAM,CAAC,MAAM,kCAAkC,GAAG,wBAAwB,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAAC,MAAiB;IACpE,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,wEAAwE;YACxE,qEAAqE;YACrE,yEAAyE;YACzE,uEAAuE;YACvE,uEAAuE;YACvE,WAAW;QACb,WAAW,EAAE,kCAAkC;KAChD,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC;YACnE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"source-breakdown.js","sourceRoot":"","sources":["../../../src/tools/dashboard/source-breakdown.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,+DAA+D;AAC/D,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,2EAA2E;AAC3E,+EAA+E;AAC/E,iDAAiD;AAIjD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,yFAAyF;AACzF,MAAM,CAAC,MAAM,kCAAkC,GAAG,wBAAwB,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAAC,MAAiB;IACpE,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,wEAAwE;YACxE,qEAAqE;YACrE,yEAAyE;YACzE,qEAAqE;YACrE,sEAAsE;YACtE,wEAAwE;YACxE,oBAAoB;QACtB,WAAW,EAAE,kCAAkC;KAChD,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC;YACnE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/dashboard/volume.js

@@ -19,9 +19,11 @@ export function registerDashboardVolumeTool(server) {
     server.registerTool('dashboard_volume', {
         description: 'Get the transaction volume statistics for a reconciliation context. ' +
             'Pass contextId (UUID path param — not a tenant field), and optionally ' +
-            'date_from/date_to (YYYY-MM-DD; matcher defaults to the last 30 days and ' +
-            'caps the window at 90 days) and/or source_id (UUID data filter). No ' +
-            'tenant field is accepted.',
+            'date_from/date_to (YYYY-MM-DD; matcher defaults to the last ~30 days ' +
+            'and SILENTLY EXCLUDES older volume — for a full picture pass an ' +
+            'explicit date_from/date_to, max 90-day span). The response echoes the ' +
+            'resolved window in periodStart/periodEnd. Optionally also pass ' +
+            'source_id (UUID data filter). No tenant field is accepted.',
         inputSchema: dashboardVolumeInputShape,
     }, async (args, extra) => {
         const query = buildDashboardQuery(args);

package/dist/tools/dashboard/volume.js.map

@@ -1 +1 @@
-{"version":3,"file":"volume.js","sourceRoot":"","sources":["../../../src/tools/dashboard/volume.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,qDAAqD;AACrD,EAAE;AACF,kEAAkE;AAClE,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,mCAAmC;AAInC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,0EAA0E;YAC1E,sEAAsE;YACtE,2BAA2B;QAC7B,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;YACzD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"volume.js","sourceRoot":"","sources":["../../../src/tools/dashboard/volume.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,qDAAqD;AACrD,EAAE;AACF,kEAAkE;AAClE,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,mCAAmC;AAInC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,uEAAuE;YACvE,kEAAkE;YAClE,wEAAwE;YACxE,iEAAiE;YACjE,4DAA4D;QAC9D,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;YACzD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/fee-schedule/create.js

@@ -22,8 +22,13 @@ export const ROUNDING_MODES = [
     'CEIL',
     'TRUNCATE',
 ];
-/** Shape of a single fee item's structure (FLAT / PERCENTAGE / TIERED). */
-export const FEE_STRUCTURE_TYPES = ['FLAT', 'PERCENTAGE', 'TIERED'];
+/** Shape of a single fee item's structure (spec enum). */
+export const FEE_STRUCTURE_TYPES = [
+    'FLAT',
+    'PERCENTAGE',
+    'TIERED',
+    'EXPRESSION',
+];
 /**
  * One fee item. Typed-but-permissive: the named fields mirror the spec's
  * CreateFeeScheduleItemRequest, but `structure` is left as an open record
@@ -38,19 +43,25 @@ export const feeScheduleItemShape = z
     priority: z
         .number()
         .int()
-        .optional()
         .describe('Application order within the schedule (relevant for CASCADING ' +
-        'applicationOrder); lower runs first.'),
+        'applicationOrder); lower runs first. Required — the backend rejects ' +
+        'an item without it (422 "expected required property priority").'),
     structureType: z
         .enum(FEE_STRUCTURE_TYPES)
         .describe('Shape of the fee structure. FLAT is a fixed amount; PERCENTAGE is a ' +
-        'rate of the base; TIERED applies different rates per amount tier.'),
+        'rate of the base; TIERED applies different rates per amount tier; ' +
+        'EXPRESSION computes the fee from a bounded arithmetic formula over ' +
+        'transaction metadata.'),
     structure: z
         .record(z.string(), z.unknown())
         .describe('Type-specific structure object. FLAT: {"amount":"1.50"}. PERCENTAGE: ' +
         '{"rate":"0.029"} where rate is a 0..1 fraction (0.029 = 2.9%), not a ' +
         'percent value. TIERED: {"tiers":[{"rate":"0.01","upTo":"1000"},...]} ' +
-        'with the same 0..1 fraction semantics per tier rate.'),
+        'with the same 0..1 fraction semantics per tier rate. EXPRESSION: ' +
+        '{"expression":"gross - desconto + multa + juros_dia * ' +
+        'days_late(due_date, pay_date)"} — a bounded formula over metadata ' +
+        'fields (operators + - * /, parentheses, and functions days_late, ' +
+        'days_between, max, min, abs, clamp).'),
 })
     .describe('A single fee item making up the schedule.');
 /** Zod raw shape for `fee_schedule_create` input — mirrors CreateFeeScheduleRequest. */

package/dist/tools/fee-schedule/create.js.map

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

package/dist/tools/field-map/create.js

@@ -0,0 +1,62 @@
+// `field_map_create` — curated POST
+// /v1/contexts/{contextId}/sources/{sourceId}/field-maps.
+//
+// A typed front door to creating a field map for a source, mirroring the
+// spec's CreateFieldMapRequest. `mapping` is left an open record (per the
+// established pattern) — its KEYS form a closed vocabulary matcher validates
+// server-side — but its description teaches that vocabulary faithfully
+// (shared.ts MAPPING_DESCRIPTION) so an operator-driving LLM does not have to
+// discover it by triggering a 400.
+//
+// Both contextId and sourceId are path params; no tenant field is accepted
+// (matcher scopes to the relayed token's tenant).
+import { z } from 'zod';
+import { dispatchFieldMap, MAPPING_DESCRIPTION, sourceFieldMapPath } from './shared.js';
+/** Zod raw shape for `field_map_create` input — path ids + mapping body. */
+export const createFieldMapInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the source belongs to. Routing ' +
+        'path param, not a tenant field.'),
+    sourceId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation source id (UUID) this field map maps.'),
+    mapping: z.record(z.string(), z.unknown()).describe(MAPPING_DESCRIPTION),
+};
+/**
+ * Build the POST body from the input minus the path-only ids. Only the
+ * CreateFieldMapRequest field (`mapping`) is sent; contextId/sourceId travel
+ * in the path.
+ */
+export function buildCreateFieldMapBody(args) {
+    return { mapping: args.mapping };
+}
+/**
+ * Register `field_map_create`. Substitutes both ids into the path, builds the
+ * body from `mapping`, and dispatches a POST through the shared fail-closed
+ * relay; a matcher error (e.g. 400 on an invalid mapping) surfaces via the
+ * shared toToolError.
+ */
+export function registerFieldMapCreateTool(server) {
+    server.registerTool('field_map_create', {
+        description: 'Create a field map for a source within a context — binds the ' +
+            "source's raw column names to matcher's canonical reconciliation " +
+            'vocabulary. Provide contextId, sourceId (UUID path params — neither ' +
+            'is a tenant field), and mapping (see field description for the ' +
+            'required/optional keys and the critical external_id join-key rule). ' +
+            "A source must be mapped (or be self-mapping, e.g. camt053) before a " +
+            'context can be activated — see context_setup_progress to check ' +
+            'readiness. Returns the created field map, or a structured RFC 9457 ' +
+            'error naming every invalid/missing/unknown key.',
+        inputSchema: createFieldMapInputShape,
+    }, async (args, extra) => {
+        return dispatchFieldMap({
+            method: 'POST',
+            path: sourceFieldMapPath(args.contextId, args.sourceId),
+            body: buildCreateFieldMapBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/field-map/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/field-map/create.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,6EAA6E;AAC7E,uEAAuE;AACvE,8EAA8E;AAC9E,mCAAmC;AACnC,EAAE;AACF,2EAA2E;AAC3E,kDAAkD;AAElD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEvF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,sEAAsE;QACpE,iCAAiC,CACpC;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0DAA0D,CAAC;IACvE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACzE,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAyB;IAEzB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,+DAA+D;YAC/D,kEAAkE;YAClE,sEAAsE;YACtE,iEAAiE;YACjE,sEAAsE;YACtE,sEAAsE;YACtE,iEAAiE;YACjE,qEAAqE;YACrE,iDAAiD;QACnD,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC;YACvD,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;SACpC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/delete.js

@@ -0,0 +1,35 @@
+// `field_map_delete` — curated DELETE /v1/field-maps/{fieldMapId}.
+//
+// Removes a field map by id. fieldMapId is a flat path param (the spec does
+// not nest delete under context+source); no tenant field is accepted (matcher
+// scopes to the relayed token's tenant). A 204 response surfaces as `null`
+// (see dispatchFieldMap), matching the other curated families' delete
+// behavior. Deleting a source's only field map will reopen the
+// `field_maps` readiness gap reported by context_setup_progress.
+import { z } from 'zod';
+import { dispatchFieldMap, fieldMapPath } from './shared.js';
+/** Zod raw shape for `field_map_delete` input — just the flat id. */
+export const deleteFieldMapInputShape = {
+    fieldMapId: z
+        .string()
+        .min(1)
+        .describe('The field map id (UUID) to delete.'),
+};
+/**
+ * Register `field_map_delete`. Substitutes the id into the path and dispatches
+ * a DELETE through the shared fail-closed relay; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerFieldMapDeleteTool(server) {
+    server.registerTool('field_map_delete', {
+        description: 'Delete a field map by id (UUID path param, not a tenant field). ' +
+            "Removing a source's only field map reopens the field_maps " +
+            'activation-readiness gap (see context_setup_progress) and an ACTIVE ' +
+            "context's matching/ingestion against that source will be affected. " +
+            'Returns null on success (204), or a structured RFC 9457 error.',
+        inputSchema: deleteFieldMapInputShape,
+    }, async (args, extra) => {
+        return dispatchFieldMap({ method: 'DELETE', path: fieldMapPath(args.fieldMapId) }, extra);
+    });
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/field-map/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/field-map/delete.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,sEAAsE;AACtE,+DAA+D;AAC/D,iEAAiE;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,kEAAkE;YAClE,4DAA4D;YAC5D,sEAAsE;YACtE,qEAAqE;YACrE,gEAAgE;QAClE,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EACzD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/get.js

@@ -0,0 +1,43 @@
+// `field_map_get` — curated GET
+// /v1/contexts/{contextId}/sources/{sourceId}/field-maps.
+//
+// Reads the field map bound to one source (getFieldMapBySource in the spec —
+// a source has at most one field map, so this is a singular fetch, not a
+// list). Both contextId and sourceId are path params; the source must belong
+// to a context owned by the relayed token's tenant — matcher enforces that;
+// no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchFieldMap, sourceFieldMapPath } from './shared.js';
+/** Zod raw shape for `field_map_get` input — both path ids. */
+export const getFieldMapInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID). Routing path param, not a tenant ' +
+        'field.'),
+    sourceId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation source id (UUID) whose field map to fetch.'),
+};
+/**
+ * Register `field_map_get`. Substitutes both ids into the path and dispatches
+ * a GET through the shared fail-closed relay; a matcher error (e.g. 404 when
+ * the source has no field map yet) surfaces via the shared toToolError.
+ */
+export function registerFieldMapGetTool(server) {
+    server.registerTool('field_map_get', {
+        description: 'Fetch the field map bound to a source (a source has at most one). ' +
+            'Provide both contextId and sourceId (UUID path params; contextId is ' +
+            "not a tenant field). The source must belong to your token's tenant. " +
+            'Returns the field map, or a structured RFC 9457 error (e.g. 404 if ' +
+            'the source has no field map yet).',
+        inputSchema: getFieldMapInputShape,
+    }, async (args, extra) => {
+        return dispatchFieldMap({
+            method: 'GET',
+            path: sourceFieldMapPath(args.contextId, args.sourceId),
+        }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/field-map/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/field-map/get.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,0DAA0D;AAC1D,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,+BAA+B;AAE/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAElE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,QAAQ,CACX;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAA;AAKD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,oEAAoE;YACpE,sEAAsE;YACtE,sEAAsE;YACtE,qEAAqE;YACrE,mCAAmC;QACrC,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC;SACxD,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/index.js

@@ -0,0 +1,31 @@
+// Curated field-map vertical: five typed tools over the matcher field-map
+// resource — create, list, get, update, delete. Field maps bind a source's
+// raw column names to matcher's canonical reconciliation vocabulary and gate
+// context activation (the `field_maps` readiness slug — see
+// context_setup_progress). Closes findings N3 (field-map shape undiscoverable)
+// and N4/F6 (createFieldMap generic-only, ingestion read/write asymmetry):
+// before this family, all five operations were UNCOVERED (neither curated nor
+// generic-only).
+//
+// Path shape is mixed, unlike sources: create/get are source-nested
+// (/v1/contexts/{contextId}/sources/{sourceId}/field-maps), list is
+// context-nested (/v1/contexts/{contextId}/field-maps), and update/delete are
+// flat (/v1/field-maps/{fieldMapId}) — the spec does not nest them under
+// context+source. Each tool shares the fail-closed relay (shared.ts) and the
+// RFC 9457 → tool-error mapping (toToolError) with the generic surface, so
+// curated and generic map matcher errors identically. No tool carries a
+// tenant field.
+import { registerFieldMapCreateTool } from './create.js';
+import { registerFieldMapDeleteTool } from './delete.js';
+import { registerFieldMapGetTool } from './get.js';
+import { registerFieldMapListTool } from './list.js';
+import { registerFieldMapUpdateTool } from './update.js';
+/** Register all five curated field-map tools on the given server. */
+export function registerFieldMapTools(server) {
+    registerFieldMapCreateTool(server);
+    registerFieldMapListTool(server);
+    registerFieldMapGetTool(server);
+    registerFieldMapUpdateTool(server);
+    registerFieldMapDeleteTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/field-map/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/field-map/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,4DAA4D;AAC5D,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,iBAAiB;AACjB,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,8EAA8E;AAC9E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,wEAAwE;AACxE,gBAAgB;AAIhB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAExD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}

package/dist/tools/field-map/list.js

@@ -0,0 +1,64 @@
+// `field_map_list` — curated GET /v1/contexts/{contextId}/field-maps.
+//
+// Cursor-paginated list of every field map under a context (listContextFieldMaps
+// in the spec) — replaces per-source probing via field_map_get. limit/cursor
+// pass through untouched and matcher's { items, nextCursor, ... } envelope is
+// returned as-is — no auto-pagination (the model re-calls with the returned
+// cursor). contextId is a routing path param, not a tenant field; no tenant
+// field is accepted.
+import { z } from 'zod';
+import { contextFieldMapsPath, dispatchFieldMap } from './shared.js';
+/** Zod raw shape for `field_map_list` input — contextId path + pagination. */
+export const listFieldMapsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose field maps to list. Routing ' +
+        'path param, not a tenant field.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of records to return (1–200, default 20).'),
+    cursor: z
+        .string()
+        .optional()
+        .describe('Opaque pagination cursor from a prior response. Re-call with the ' +
+        'returned nextCursor to page forward (there is no auto-pagination).'),
+};
+/** Build the list query, omitting unset knobs so the request stays minimal. */
+function buildListQuery(args) {
+    const query = {};
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `field_map_list`. Passes limit/cursor through and returns matcher's
+ * pagination envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerFieldMapListTool(server) {
+    server.registerTool('field_map_list', {
+        description: 'List every field map under a context (cursor-paginated) — replaces ' +
+            'probing field_map_get per source. Pass contextId (UUID path param — ' +
+            'not a tenant field), and optionally limit (1–200) and/or cursor. The ' +
+            'response carries { items, nextCursor } — paginate by re-calling with ' +
+            'the returned nextCursor. No tenant field is accepted.',
+        inputSchema: listFieldMapsInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchFieldMap({
+            method: 'GET',
+            path: contextFieldMapsPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/field-map/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/field-map/list.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,qBAAqB;AAErB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEpE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,iCAAiC,CACpC;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mEAAmE;QACjE,oEAAoE,CACvE;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAwB;IAC9C,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,qEAAqE;YACrE,sEAAsE;YACtE,uEAAuE;YACvE,uEAAuE;YACvE,uDAAuD;QACzD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;YAC1C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/shared.js

@@ -0,0 +1,114 @@
+// Shared plumbing for the curated field-map tools.
+//
+// A field map binds a source's raw column names to matcher's canonical
+// reconciliation vocabulary. Like sources, field-map single-resource ops are
+// reached two different ways: create/get hang off
+// /v1/contexts/{contextId}/sources/{sourceId}/field-maps (source-nested),
+// list hangs off /v1/contexts/{contextId}/field-maps (context-nested), and
+// update/delete hang off /v1/field-maps/{fieldMapId} (flat — the spec does not
+// nest them under context+source). This module factors all three path
+// helpers plus the relay boilerplate exactly once so the five tools stay thin
+// and so curated + generic surfaces map matcher errors through the identical
+// path (toToolError).
+//
+// Security: the bearer token is never read here directly — requireMatcherClient
+// owns the request-scoped relay and fails closed when no usable credential was
+// provided. contextId/sourceId/fieldMapId are routing identifiers (matcher
+// validates ownership against the relayed token's tenant); no field-map tool
+// input carries a tenant field.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Build the context-scoped field-maps collection path (list). */
+export function contextFieldMapsPath(contextId) {
+    return `/v1/contexts/${encodeURIComponent(contextId)}/field-maps`;
+}
+/** Build the source-nested field-map path (create/get). */
+export function sourceFieldMapPath(contextId, sourceId) {
+    return `/v1/contexts/${encodeURIComponent(contextId)}/sources/${encodeURIComponent(sourceId)}/field-maps`;
+}
+/** Build the flat single-field-map path (update/delete). */
+export function fieldMapPath(fieldMapId) {
+    return `/v1/field-maps/${encodeURIComponent(fieldMapId)}`;
+}
+/**
+ * Run one assembled request through the relay: fail-closed auth, dispatch, and
+ * RFC 9457 → tool-error mapping — identical to the generic invoke's dispatch so
+ * both surfaces produce the same structured error shape.
+ *
+ * `clientFor` is injectable for tests; production callers pass nothing and get
+ * the request-scoped, fail-closed `requireMatcherClient`.
+ */
+export async function dispatchFieldMap(request, extra, clientFor = requireMatcherClient) {
+    let client;
+    try {
+        // Fail-closed on a missing / empty / non-Bearer credential.
+        client = clientFor(extra);
+    }
+    catch (err) {
+        if (err instanceof UnauthenticatedError) {
+            return { isError: true, content: [{ type: 'text', text: err.message }] };
+        }
+        throw err;
+    }
+    try {
+        const result = await client.request(request);
+        // Success → matcher's JSON returned as-is (incl. pagination envelopes and
+        // 204 → null for delete).
+        return { content: [{ type: 'text', text: JSON.stringify(result ?? null) }] };
+    }
+    catch (err) {
+        // RFC 9457 problem → the SHARED structured tool error (status/title/detail/
+        // code preserved). A non-matcher error is a bug, not a matcher failure, and
+        // is re-thrown rather than masqueraded as one.
+        if (isMatcherApiError(err)) {
+            return toToolError(err);
+        }
+        throw err;
+    }
+}
+/**
+ * Canonical field-map mapping vocabulary — mirrors the matcher backend's
+ * single authority (internal/shared/domain/field_map.go:42-52), shared there
+ * by the Configuration and Ingestion contexts so the two never drift. The key
+ * space is CLOSED: mapping VALUES name arbitrary source columns, but KEYS are
+ * fixed to this list.
+ */
+export const REQUIRED_MAPPING_KEYS = [
+    'external_id',
+    'amount',
+    'currency',
+    'date',
+];
+/** Optional canonical keys a field map MAY declare, in addition to the required ones. */
+export const OPTIONAL_MAPPING_KEYS = [
+    'description',
+    'fee_amount',
+    'fee_currency',
+];
+/**
+ * The mapping description shared by `field_map_create` and `field_map_update`
+ * so the canonical shape — and its single most common failure mode — is
+ * taught identically wherever a mapping body is accepted.
+ *
+ * `external_id` is called out explicitly: the matching engine joins the two
+ * sides of a reconciliation by comparing `external_id` across LEFT and RIGHT.
+ * It MUST carry the cross-side join key (e.g. the bank reference / ledger
+ * transaction id that BOTH sides agree on) — never a side-local primary key.
+ * Mapping a side-local id into `external_id` silently imports rows that can
+ * never match anything on the other side; this is the single most common
+ * setup mistake and produces no error, just permanent unmatched exceptions.
+ */
+export const MAPPING_DESCRIPTION = 'Field-to-column mapping (open object; keys form a CLOSED canonical ' +
+    'vocabulary, values are this source\'s raw column names as non-empty ' +
+    'strings). Required keys: external_id, amount, currency, date. Optional ' +
+    'keys: description, fee_amount, fee_currency (fee_amount/fee_currency feed ' +
+    "fee verification when this source's column carries a per-row fee). " +
+    'CRITICAL: external_id MUST be the CROSS-SIDE JOIN KEY — the matching ' +
+    "engine compares external_id across LEFT and RIGHT sources, so it has to " +
+    'be a value BOTH sides agree on (e.g. a shared bank reference or ledger ' +
+    'transaction id), never a side-local row id / primary key. Mapping a ' +
+    'side-local id into external_id imports rows that can never match the ' +
+    'other side — no error is raised, the rows just sit as permanent unmatched ' +
+    'exceptions. Any key outside the vocabulary, a missing required key, or a ' +
+    'non-string/empty value is rejected by matcher with every offender named.';
+//# sourceMappingURL=shared.js.map

package/dist/tools/field-map/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/field-map/shared.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,kDAAkD;AAClD,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,sEAAsE;AACtE,8EAA8E;AAC9E,6EAA6E;AAC7E,sBAAsB;AACtB,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,gCAAgC;AAIhC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,aAAa,CAAA;AACnE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IACpE,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,QAAQ,CAAC,aAAa,CAAA;AAC3G,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,kBAAkB,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,KAAmC,EACnC,YAAyD,oBAAoB;IAE7E,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;QAC1E,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,0EAA0E;QAC1E,0BAA0B;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,4EAA4E;QAC5E,+CAA+C;QAC/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa;IACb,QAAQ;IACR,UAAU;IACV,MAAM;CACE,CAAA;AAEV,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa;IACb,YAAY;IACZ,cAAc;CACN,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,qEAAqE;IACrE,sEAAsE;IACtE,yEAAyE;IACzE,4EAA4E;IAC5E,qEAAqE;IACrE,uEAAuE;IACvE,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,uEAAuE;IACvE,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E,CAAA"}

package/dist/tools/field-map/update.js

@@ -0,0 +1,46 @@
+// `field_map_update` — curated PATCH /v1/field-maps/{fieldMapId}.
+//
+// Replaces a field map's mapping by id, mirroring the spec's
+// UpdateFieldMapRequest. Unlike context/source updates, the spec's
+// UpdateFieldMapRequest carries only `mapping` (no other field is
+// independently patchable), so this tool's body is not optional-everything —
+// `mapping` is required, same vocabulary as create. fieldMapId is a flat path
+// param (the spec does not nest update under context+source); no tenant field
+// is accepted (matcher scopes to the relayed token's tenant).
+import { z } from 'zod';
+import { dispatchFieldMap, fieldMapPath, MAPPING_DESCRIPTION } from './shared.js';
+/** Zod raw shape for `field_map_update` input — flat id + mapping body. */
+export const updateFieldMapInputShape = {
+    fieldMapId: z
+        .string()
+        .min(1)
+        .describe('The field map id (UUID) to update.'),
+    mapping: z.record(z.string(), z.unknown()).describe(MAPPING_DESCRIPTION),
+};
+/** Build the PATCH body from the input minus the path-only `fieldMapId`. */
+export function buildUpdateFieldMapBody(args) {
+    return { mapping: args.mapping };
+}
+/**
+ * Register `field_map_update`. Substitutes the id into the path and dispatches
+ * a PATCH through the shared fail-closed relay; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerFieldMapUpdateTool(server) {
+    server.registerTool('field_map_update', {
+        description: 'Replace the mapping of a field map by id (UUID path param, not a ' +
+            'tenant field). mapping is required (see field description for the ' +
+            'required/optional keys and the critical external_id join-key rule) ' +
+            '— this REPLACES the existing mapping, it is not a partial merge. ' +
+            'Returns the updated field map, or a structured RFC 9457 error naming ' +
+            'every invalid/missing/unknown key.',
+        inputSchema: updateFieldMapInputShape,
+    }, async (args, extra) => {
+        return dispatchFieldMap({
+            method: 'PATCH',
+            path: fieldMapPath(args.fieldMapId),
+            body: buildUpdateFieldMapBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/tools/field-map/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/field-map/update.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,kEAAkE;AAClE,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oCAAoC,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACzE,CAAA;AAOD,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CACrC,IAAyB;IAEzB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,mEAAmE;YACnE,oEAAoE;YACpE,qEAAqE;YACrE,mEAAmE;YACnE,uEAAuE;YACvE,oCAAoC;QACtC,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;YACnC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;SACpC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}