@lerianstudio/matcher-mcp 1.0.0-beta.5

package/dist/tools/ingestion/transactions-search.js

@@ -0,0 +1,143 @@
+// `ingestion_transactions_search` — curated GET
+// /v1/imports/contexts/{contextId}/transactions/search.
+//
+// Searches a context's transactions by free text, amount range, date range,
+// reference, currency, source, and status. Unlike the cursor-paginated job/
+// transaction lists, this endpoint is OFFSET-paginated (limit + offset) and the
+// response carries a total count — re-call with a bumped offset to page. Amounts
+// are decimal STRINGS to preserve precision. Every knob is optional; only
+// contextId (path) is required. No tenant field is accepted — matcher scopes the
+// search to the relayed token's tenant.
+import { z } from 'zod';
+import { contextTransactionsSearchPath, dispatchIngestion } from './shared.js';
+/** Transaction statuses the search filter accepts (spec enum). */
+export const TRANSACTION_STATUSES = [
+    'UNMATCHED',
+    'MATCHED',
+    'IGNORED',
+    'PENDING_REVIEW',
+];
+/** Zod raw shape for `ingestion_transactions_search` input — contextId path + filters + offset pagination. */
+export const searchTransactionsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to search within. Routing path ' +
+        'param, not a tenant field.'),
+    q: z
+        .string()
+        .optional()
+        .describe('Free text search across external ID and description.'),
+    amount_min: z
+        .string()
+        .optional()
+        .describe('Minimum transaction amount, as a decimal STRING, e.g. "100.00" (a ' +
+        'string, not a number, to preserve precision).'),
+    amount_max: z
+        .string()
+        .optional()
+        .describe('Maximum transaction amount, as a decimal STRING, e.g. "5000.00" (a ' +
+        'string, not a number, to preserve precision).'),
+    date_from: z
+        .string()
+        .optional()
+        .describe('Start date filter (RFC 3339), e.g. "2025-01-01T00:00:00Z".'),
+    date_to: z
+        .string()
+        .optional()
+        .describe('End date filter (RFC 3339), e.g. "2025-01-31T23:59:59Z".'),
+    reference: z
+        .string()
+        .optional()
+        .describe('Exact external ID match.'),
+    currency: z
+        .string()
+        .optional()
+        .describe('Currency code filter (ISO 4217), e.g. "USD".'),
+    source_id: z
+        .string()
+        .optional()
+        .describe('Filter to a single source by id (UUID).'),
+    status: z
+        .enum(TRANSACTION_STATUSES)
+        .optional()
+        .describe('Transaction status filter (UNMATCHED|MATCHED|IGNORED|PENDING_REVIEW).'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe('Maximum number of records to return (1–50, default 20).'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Number of records to skip (>= 0, default 0). This endpoint is ' +
+        'OFFSET-paginated — re-call with a bumped offset to page forward.'),
+};
+/** Build the search query, omitting unset knobs so the request stays minimal. */
+function buildSearchQuery(args) {
+    const query = {};
+    if (args.q !== undefined) {
+        query.q = args.q;
+    }
+    if (args.amount_min !== undefined) {
+        query.amount_min = args.amount_min;
+    }
+    if (args.amount_max !== undefined) {
+        query.amount_max = args.amount_max;
+    }
+    if (args.date_from !== undefined) {
+        query.date_from = args.date_from;
+    }
+    if (args.date_to !== undefined) {
+        query.date_to = args.date_to;
+    }
+    if (args.reference !== undefined) {
+        query.reference = args.reference;
+    }
+    if (args.currency !== undefined) {
+        query.currency = args.currency;
+    }
+    if (args.source_id !== undefined) {
+        query.source_id = args.source_id;
+    }
+    if (args.status !== undefined) {
+        query.status = args.status;
+    }
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.offset !== undefined) {
+        query.offset = args.offset;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `ingestion_transactions_search`. Passes every filter plus limit/
+ * offset through and returns matcher's { items, total, ... } envelope verbatim;
+ * a matcher error surfaces via the shared toToolError.
+ */
+export function registerIngestionTransactionsSearchTool(server) {
+    server.registerTool('ingestion_transactions_search', {
+        description: "Search a context's transactions (OFFSET-paginated, with a total " +
+            'count). Provide contextId (UUID path param — not a tenant field) and ' +
+            'any of: q (free text), amount_min/amount_max (decimal strings), ' +
+            'date_from/date_to (RFC 3339), reference (exact external ID), currency ' +
+            '(ISO 4217), source_id (UUID), status ' +
+            '(UNMATCHED|MATCHED|IGNORED|PENDING_REVIEW), limit (1–50), and offset ' +
+            '(>= 0). Paginate by re-calling with a bumped offset. No tenant field is ' +
+            'accepted.',
+        inputSchema: searchTransactionsInputShape,
+    }, async (args, extra) => {
+        const query = buildSearchQuery(args);
+        return dispatchIngestion({
+            method: 'GET',
+            path: contextTransactionsSearchPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=transactions-search.js.map

package/dist/tools/ingestion/transactions-search.js.map

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

package/dist/tools/match-rule/create.js

@@ -0,0 +1,64 @@
+// `match_rule_create` — curated POST /v1/contexts/{contextId}/rules.
+//
+// A typed, richly-described front door to defining a match rule within a
+// reconciliation context, mirroring the spec's CreateMatchRuleRequest. The Zod
+// schema models the required scalars (priority, type) and the documented type
+// enum so an operator-driving LLM gets the shape and the semantics up front; the
+// `config` object is type-specific and is modeled as a permissive open record
+// (per the established pattern) — matcher's server-side validation + the returned
+// RFC 9457 problem are the authoritative per-type check, so we do not duplicate
+// it here.
+//
+// `contextId` is a routing path param, not a tenant field. No tenant field
+// exists in the schema: the rule is created for the tenant of the relayed bearer
+// token, and matcher validates that the context belongs to that tenant.
+import { z } from 'zod';
+import { contextRulesPath, dispatchMatchRule } from './shared.js';
+/** Matching strategy. EXACT / TOLERANCE / DATE_LAG — there is no FUZZY. */
+export const MATCH_RULE_TYPES = ['EXACT', 'TOLERANCE', 'DATE_LAG'];
+/** Zod raw shape for `match_rule_create` input — mirrors CreateMatchRuleRequest. */
+export const createMatchRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the rule belongs to. Routing path ' +
+        'param, not a tenant field — matcher validates the context is yours.'),
+    priority: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .describe('Execution priority (1–1000); lower numbers run first. Must be unique ' +
+        'within the context.'),
+    type: z
+        .enum(MATCH_RULE_TYPES)
+        .describe('Matching strategy. EXACT requires identical field values; TOLERANCE ' +
+        'allows configured numeric slack; DATE_LAG allows a configured date ' +
+        'offset between sides.'),
+    config: z
+        .record(z.string(), z.unknown())
+        .describe('Rule-specific configuration object (matched fields and tolerance/lag ' +
+        'parameters). Its shape depends on `type` and is validated server-side. ' +
+        'EXACT: {"fields":["amount","reference"]}. TOLERANCE: ' +
+        '{"fields":["amount"],"toleranceAbs":"0.01"} or "tolerancePct". ' +
+        'DATE_LAG: {"fields":["date"],"maxLagDays":2}.'),
+};
+/**
+ * Register `match_rule_create`. Splits the routing `contextId` (path) from the
+ * body fields and dispatches the POST through the shared fail-closed relay; a
+ * matcher error surfaces via the shared toToolError (same shape as matcher_invoke).
+ */
+export function registerMatchRuleCreateTool(server) {
+    server.registerTool('match_rule_create', {
+        description: 'Create a match rule within a reconciliation context. Provide contextId ' +
+            '(UUID path), priority (1–1000, unique within the context), type ' +
+            '(EXACT|TOLERANCE|DATE_LAG), and config (a type-specific object validated ' +
+            'server-side). No tenant field is accepted — the rule is created for your ' +
+            "token's tenant. Returns the created rule, or a structured RFC 9457 error.",
+        inputSchema: createMatchRuleInputShape,
+    }, async (args, extra) => {
+        const { contextId, ...body } = args;
+        return dispatchMatchRule({ method: 'POST', path: contextRulesPath(contextId), body }, extra);
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/match-rule/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/match-rule/create.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAClF,gFAAgF;AAChF,WAAW;AACX,EAAE;AACF,2EAA2E;AAC3E,iFAAiF;AACjF,wEAAwE;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEjE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAU,CAAA;AAE3E,oFAAoF;AACpF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,qEAAqE,CACxE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,uEAAuE;QACrE,qBAAqB,CACxB;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,CACP,sEAAsE;QACpE,qEAAqE;QACrE,uBAAuB,CAC1B;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CACP,uEAAuE;QACrE,yEAAyE;QACzE,uDAAuD;QACvD,iEAAiE;QACjE,+CAA+C,CAClD;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,yEAAyE;YACzE,kEAAkE;YAClE,2EAA2E;YAC3E,2EAA2E;YAC3E,2EAA2E;QAC7E,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;QACnC,OAAO,iBAAiB,CACtB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAC3D,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/match-rule/delete.js

@@ -0,0 +1,35 @@
+// `match_rule_delete` — curated DELETE /v1/contexts/{contextId}/rules/{ruleId}.
+//
+// Removes a match rule by id within a context. A successful delete returns 204
+// (no content), which the relay renders as null. Both contextId and ruleId are
+// UUID path params; no tenant field is accepted (matcher scopes to the relayed
+// token's tenant via the context).
+import { z } from 'zod';
+import { contextRulePath, dispatchMatchRule } from './shared.js';
+/** Zod raw shape for `match_rule_delete` input — context id + rule id (both path). */
+export const deleteMatchRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID). Routing path param, not a tenant field.'),
+    ruleId: z.string().min(1).describe('The match rule id (UUID) to delete.'),
+};
+/**
+ * Register `match_rule_delete`. Substitutes both ids into the path and dispatches
+ * a DELETE through the shared fail-closed relay; any matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerMatchRuleDeleteTool(server) {
+    server.registerTool('match_rule_delete', {
+        description: 'Delete a match rule by id (UUID) within a context (UUID). The rule and ' +
+            "its context must belong to your token's tenant (no tenant field is " +
+            'accepted). Returns no content on success, or a structured RFC 9457 error.',
+        inputSchema: deleteMatchRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchMatchRule({
+            method: 'DELETE',
+            path: contextRulePath(args.contextId, args.ruleId),
+        }, extra);
+    });
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/match-rule/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/match-rule/delete.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,mCAAmC;AAEnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEhE,sFAAsF;AACtF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+EAA+E,CAChF;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC1E,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,yEAAyE;YACzE,qEAAqE;YACrE,2EAA2E;QAC7E,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;SACnD,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/match-rule/get.js

@@ -0,0 +1,32 @@
+// `match_rule_get` — curated GET /v1/contexts/{contextId}/rules/{ruleId}.
+//
+// Reads one match rule by id within a context. Both contextId and ruleId are
+// path params (UUIDs). The rule 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 { contextRulePath, dispatchMatchRule } from './shared.js';
+/** Zod raw shape for `match_rule_get` input — context id + rule id (both path). */
+export const getMatchRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID). Routing path param, not a tenant field.'),
+    ruleId: z.string().min(1).describe('The match rule id (UUID) to fetch.'),
+};
+/**
+ * Register `match_rule_get`. Substitutes both ids into the path and dispatches a
+ * GET through the shared fail-closed relay; a matcher error (e.g. 404) surfaces
+ * via the shared toToolError.
+ */
+export function registerMatchRuleGetTool(server) {
+    server.registerTool('match_rule_get', {
+        description: 'Fetch a single match rule by id (UUID) within a context (UUID). Both ' +
+            'the rule and its context must belong to your token. Returns the rule, ' +
+            'or a structured RFC 9457 error (e.g. 404 if it does not exist or is not ' +
+            'yours).',
+        inputSchema: getMatchRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchMatchRule({ method: 'GET', path: contextRulePath(args.contextId, args.ruleId) }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/match-rule/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/match-rule/get.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AAEvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEhE,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+EAA+E,CAChF;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACzE,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,SAAS;QACX,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EACrE,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/match-rule/index.js

@@ -0,0 +1,22 @@
+// Curated match-rule vertical (task 2.1.2): six typed tools over the matcher
+// match-rule resource — create, list, get, update, delete, reorder. All ops are
+// fully context-nested (/v1/contexts/{contextId}/rules[...]). 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 { registerMatchRuleCreateTool } from './create.js';
+import { registerMatchRuleDeleteTool } from './delete.js';
+import { registerMatchRuleGetTool } from './get.js';
+import { registerMatchRuleListTool } from './list.js';
+import { registerMatchRuleReorderTool } from './reorder.js';
+import { registerMatchRuleUpdateTool } from './update.js';
+/** Register all six curated match-rule tools on the given server. */
+export function registerMatchRuleTools(server) {
+    registerMatchRuleCreateTool(server);
+    registerMatchRuleListTool(server);
+    registerMatchRuleGetTool(server);
+    registerMatchRuleUpdateTool(server);
+    registerMatchRuleDeleteTool(server);
+    registerMatchRuleReorderTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/match-rule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/match-rule/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,sDAAsD;AAItD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,4BAA4B,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC"}

package/dist/tools/match-rule/list.js

@@ -0,0 +1,72 @@
+// `match_rule_list` — curated GET /v1/contexts/{contextId}/rules.
+//
+// Cursor-paginated list of a context's match rules, with an optional `type`
+// filter. limit/cursor/type pass through untouched and matcher's
+// { items, nextCursor, ... } envelope is returned as-is — no auto-pagination
+// (the model re-calls with the returned cursor). The list is implicitly
+// tenant-scoped by the relayed token; `contextId` is a routing path param and no
+// tenant field is accepted.
+import { z } from 'zod';
+import { MATCH_RULE_TYPES } from './create.js';
+import { contextRulesPath, dispatchMatchRule } from './shared.js';
+/** Zod raw shape for `match_rule_list` input — context, optional type filter, pagination. */
+export const listMatchRulesInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose rules to list. Routing path ' +
+        'param, not a tenant field.'),
+    type: z
+        .enum(MATCH_RULE_TYPES)
+        .optional()
+        .describe('Optional filter by rule type (EXACT|TOLERANCE|DATE_LAG). Omit to list all.'),
+    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.type !== undefined) {
+        query.type = args.type;
+    }
+    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 `match_rule_list`. Passes type/limit/cursor through and returns
+ * matcher's pagination envelope verbatim; a matcher error surfaces via the
+ * shared toToolError.
+ */
+export function registerMatchRuleListTool(server) {
+    server.registerTool('match_rule_list', {
+        description: 'List the match rules of a reconciliation context (cursor-paginated). ' +
+            'Provide contextId (UUID path); optionally filter by type ' +
+            '(EXACT|TOLERANCE|DATE_LAG) and pass 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: listMatchRulesInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchMatchRule({
+            method: 'GET',
+            path: contextRulesPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/match-rule/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/match-rule/list.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,6EAA6E;AAC7E,wEAAwE;AACxE,iFAAiF;AACjF,4BAA4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEjE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,4BAA4B,CAC/B;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E,CAC7E;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,IAAyB;IAC/C,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACxB,CAAC;IACD,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,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,uEAAuE;YACvE,2DAA2D;YAC3D,uEAAuE;YACvE,2EAA2E;YAC3E,mDAAmD;QACrD,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;YACtC,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/match-rule/reorder.js

@@ -0,0 +1,45 @@
+// `match_rule_reorder` — curated POST /v1/contexts/{contextId}/rules/reorder.
+//
+// A custom action (not CRUD): re-prioritizes a context's match rules in one
+// shot. The body carries an ordered `ruleIds` array — each rule's new priority
+// is its position in that list (first = highest priority / runs first). Returns
+// 204 (no content), which the relay renders as null. `contextId` is a routing
+// path param; no tenant field is accepted.
+import { z } from 'zod';
+import { contextRulesReorderPath, dispatchMatchRule } from './shared.js';
+/** Zod raw shape for `match_rule_reorder` input — context (path) + ordered ruleIds. */
+export const reorderMatchRulesInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose rules to reorder. Routing path ' +
+        'param, not a tenant field.'),
+    ruleIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(100)
+        .describe('Ordered list of match rule UUIDs (1–100). Each rule’s new priority is ' +
+        'its position in this list: the first id runs first. Include every rule ' +
+        'you intend to reorder.'),
+};
+/**
+ * Register `match_rule_reorder`. Splits the routing `contextId` (path) from the
+ * `ruleIds` body and dispatches the POST through the shared fail-closed relay; a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerMatchRuleReorderTool(server) {
+    server.registerTool('match_rule_reorder', {
+        description: 'Reorder the match rules of a reconciliation context. Provide contextId ' +
+            '(UUID path) and ruleIds, an ordered array of rule UUIDs whose position ' +
+            'becomes the new priority (first = runs first). No tenant field is ' +
+            'accepted. Returns no content on success, or a structured RFC 9457 error.',
+        inputSchema: reorderMatchRulesInputShape,
+    }, async (args, extra) => {
+        return dispatchMatchRule({
+            method: 'POST',
+            path: contextRulesReorderPath(args.contextId),
+            body: { ruleIds: args.ruleIds },
+        }, extra);
+    });
+}
+//# sourceMappingURL=reorder.js.map

package/dist/tools/match-rule/reorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.js","sourceRoot":"","sources":["../../../src/tools/match-rule/reorder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,2CAA2C;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAExE,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,4EAA4E;QAC1E,4BAA4B,CAC/B;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,wEAAwE;QACtE,yEAAyE;QACzE,wBAAwB,CAC3B;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,yEAAyE;YACzE,yEAAyE;YACzE,oEAAoE;YACpE,0EAA0E;QAC5E,WAAW,EAAE,2BAA2B;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SAChC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/match-rule/shared.js

@@ -0,0 +1,71 @@
+// Shared plumbing for the curated match-rule tools.
+//
+// Match rules are fully context-nested: every op lives under
+// /v1/contexts/{contextId}/rules (list/create), .../rules/{ruleId}
+// (get/update/delete), and .../rules/reorder (the custom reorder action). This
+// module factors the path construction and the relay/error-mapping boilerplate
+// exactly once so the six tools stay thin — they only "build the request".
+//
+// The relay shape is identical to the fee-schedule vertical (task 1.3.2): fail
+// closed via requireMatcherClient, dispatch one assembled MatcherRequest, then
+// return matcher's JSON on success or the SHARED toToolError on a
+// MatcherApiError. Curated and generic surfaces therefore map matcher errors
+// through the same path.
+//
+// Security: the bearer token is never read here directly — requireMatcherClient
+// owns the request-scoped relay and fails closed when no usable credential was
+// provided. No tenant identifier is ever read or injected (matcher derives
+// tenant from the relayed JWT); no match-rule tool input carries one. The
+// `contextId` segment is a routing path param — matcher validates that the
+// context belongs to the token's tenant.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Path for the match-rule collection under a context (list + create). */
+export function contextRulesPath(contextId) {
+    return `/v1/contexts/${encodeURIComponent(contextId)}/rules`;
+}
+/** Path for a single match rule under a context (get + update + delete). */
+export function contextRulePath(contextId, ruleId) {
+    return `${contextRulesPath(contextId)}/${encodeURIComponent(ruleId)}`;
+}
+/** Path for the reorder action under a context's match rules. */
+export function contextRulesReorderPath(contextId) {
+    return `${contextRulesPath(contextId)}/reorder`;
+}
+/**
+ * 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 dispatchMatchRule(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 / reorder).
+        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;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/match-rule/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/match-rule/shared.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,kEAAkE;AAClE,6EAA6E;AAC7E,yBAAyB;AACzB,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,yCAAyC;AAIzC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAA;AAC9D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc;IAC/D,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;AACvE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,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,oCAAoC;QACpC,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"}

package/dist/tools/match-rule/update.js

@@ -0,0 +1,68 @@
+// `match_rule_update` — curated PATCH /v1/contexts/{contextId}/rules/{ruleId}.
+//
+// Partial update of a match rule, mirroring the spec's UpdateMatchRuleRequest.
+// All body fields are optional (PATCH semantics): priority, type, config. Both
+// contextId and ruleId are UUID path params; no tenant field is accepted
+// (matcher scopes to the relayed token's tenant via the context).
+import { z } from 'zod';
+import { MATCH_RULE_TYPES } from './create.js';
+import { contextRulePath, dispatchMatchRule } from './shared.js';
+/** Zod raw shape for `match_rule_update` input — ids (path) + optional fields. */
+export const updateMatchRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID). Routing path param, not a tenant field.'),
+    ruleId: z.string().min(1).describe('The match rule id (UUID) to update.'),
+    priority: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe('New execution priority (1–1000); lower runs first. Must remain unique ' +
+        'within the context.'),
+    type: z
+        .enum(MATCH_RULE_TYPES)
+        .optional()
+        .describe('New matching strategy (EXACT|TOLERANCE|DATE_LAG). Changing type usually ' +
+        'requires a matching `config` change.'),
+    config: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('New rule-specific configuration object (matched fields and tolerance/lag ' +
+        'parameters). Shape depends on `type`; validated server-side.'),
+};
+/**
+ * Build the PATCH body from the input minus the path-only `contextId`/`ruleId`.
+ * Only the fields the caller actually set are sent — matcher treats absent
+ * fields as unchanged.
+ */
+export function buildUpdateBody(args) {
+    const { contextId: _contextId, ruleId: _ruleId, ...body } = args;
+    void _contextId;
+    void _ruleId;
+    return body;
+}
+/**
+ * Register `match_rule_update`. Splits the ids (path) from the body fields and
+ * dispatches a PATCH through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError.
+ */
+export function registerMatchRuleUpdateTool(server) {
+    server.registerTool('match_rule_update', {
+        description: 'Update a match rule by id (UUID) within a context (UUID). All fields are ' +
+            'optional (PATCH): priority (1–1000, unique), type ' +
+            '(EXACT|TOLERANCE|DATE_LAG), config (type-specific, validated server-side). ' +
+            'No tenant field is accepted. Returns the updated rule, or a structured ' +
+            'RFC 9457 error.',
+        inputSchema: updateMatchRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchMatchRule({
+            method: 'PATCH',
+            path: contextRulePath(args.contextId, args.ruleId),
+            body: buildUpdateBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/tools/match-rule/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/match-rule/update.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,kEAAkE;AAElE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEhE,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+EAA+E,CAChF;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACzE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,qBAAqB,CACxB;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E;QACxE,sCAAsC,CACzC;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,8DAA8D,CACjE;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA0B;IAE1B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAChE,KAAK,UAAU,CAAA;IACf,KAAK,OAAO,CAAA;IACZ,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,2EAA2E;YAC3E,oDAAoD;YACpD,6EAA6E;YAC7E,yEAAyE;YACzE,iBAAiB;QACnB,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YAClD,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}