@lerianstudio/matcher-mcp 1.0.0-beta.5

package/dist/tools/exception/index.js

@@ -0,0 +1,39 @@
+// Curated exception vertical: thirteen typed tools over the matcher
+// reconciliation-exception resource — list/get, the history + comments
+// sub-resources (list/add/delete), the per-exception action verbs (dispatch,
+// open-dispute, force-match, adjust-entry), and the cross-exception bulk
+// actions (assign/resolve/dispatch). Every 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; the optional contextId on list is a routing
+// filter matcher validates against the relayed token's tenant.
+import { registerExceptionAddCommentTool } from './add-comment.js';
+import { registerExceptionAdjustEntryTool } from './adjust-entry.js';
+import { registerExceptionBulkAssignTool } from './bulk-assign.js';
+import { registerExceptionBulkDispatchTool } from './bulk-dispatch.js';
+import { registerExceptionBulkResolveTool } from './bulk-resolve.js';
+import { registerExceptionDeleteCommentTool } from './delete-comment.js';
+import { registerExceptionDispatchTool } from './dispatch.js';
+import { registerExceptionForceMatchTool } from './force-match.js';
+import { registerExceptionGetTool } from './get.js';
+import { registerExceptionHistoryTool } from './history.js';
+import { registerExceptionListTool } from './list.js';
+import { registerExceptionListCommentsTool } from './list-comments.js';
+import { registerExceptionOpenDisputeTool } from './open-dispute.js';
+/** Register all thirteen curated exception tools on the given server. */
+export function registerExceptionTools(server) {
+    registerExceptionListTool(server);
+    registerExceptionGetTool(server);
+    registerExceptionHistoryTool(server);
+    registerExceptionListCommentsTool(server);
+    registerExceptionAddCommentTool(server);
+    registerExceptionDeleteCommentTool(server);
+    registerExceptionDispatchTool(server);
+    registerExceptionOpenDisputeTool(server);
+    registerExceptionForceMatchTool(server);
+    registerExceptionAdjustEntryTool(server);
+    registerExceptionBulkAssignTool(server);
+    registerExceptionBulkResolveTool(server);
+    registerExceptionBulkDispatchTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/exception/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,uEAAuE;AACvE,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,+DAA+D;AAI/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAA;AAEpE,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,4BAA4B,CAAC,MAAM,CAAC,CAAA;IACpC,iCAAiC,CAAC,MAAM,CAAC,CAAA;IACzC,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,kCAAkC,CAAC,MAAM,CAAC,CAAA;IAC1C,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,iCAAiC,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC"}

package/dist/tools/exception/list-comments.js

@@ -0,0 +1,35 @@
+// `exception_list_comments` — curated GET /v1/exceptions/{exceptionId}/comments.
+//
+// Returns every discussion comment on one exception, ordered oldest-first. No
+// query params (matcher returns the full list). exceptionId is a path param;
+// the exception must belong to the relayed token's tenant, and no tenant field
+// is accepted.
+import { z } from 'zod';
+import { dispatchException, exceptionCommentsPath } from './shared.js';
+/** Zod raw shape for `exception_list_comments` input — the exception path id. */
+export const listCommentsInputShape = {
+    exceptionId: z
+        .string()
+        .min(1)
+        .describe('The exception id (UUID) whose comments to list.'),
+};
+/**
+ * Register `exception_list_comments`. Substitutes the id into the path and
+ * dispatches a GET through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError.
+ */
+export function registerExceptionListCommentsTool(server) {
+    server.registerTool('exception_list_comments', {
+        description: 'List the discussion comments on a reconciliation exception, ordered ' +
+            'oldest-first. Provide exceptionId (UUID). The exception must belong to ' +
+            "your token's tenant (no tenant field is accepted). Returns the comments, " +
+            'or a structured RFC 9457 error.',
+        inputSchema: listCommentsInputShape,
+    }, async (args, extra) => {
+        return dispatchException({
+            method: 'GET',
+            path: exceptionCommentsPath(args.exceptionId),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list-comments.js.map

package/dist/tools/exception/list-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-comments.js","sourceRoot":"","sources":["../../../src/tools/exception/list-comments.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,eAAe;AAEf,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEtE,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,sEAAsE;YACtE,yEAAyE;YACzE,2EAA2E;YAC3E,iCAAiC;QACnC,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC;SAC9C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/exception/list.js

@@ -0,0 +1,169 @@
+// `exception_list` — curated GET /v1/exceptions.
+//
+// Cursor-paginated list of the tenant's reconciliation exceptions, with the
+// spec's rich filter set (contextId, status, severity, reason, assigned_to,
+// external_system, date_from, date_to) plus sort/pagination knobs. Filters 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 filter, not a tenant field, and no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchException, EXCEPTIONS_PATH } from './shared.js';
+/** Lifecycle states an exception can be filtered by (matcher's queue states). */
+export const EXCEPTION_STATUSES = ['OPEN', 'ASSIGNED', 'RESOLVED'];
+/** Severity buckets an exception can be filtered by. */
+export const EXCEPTION_SEVERITIES = ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'];
+/** The reason an exception was raised (the matching defect that produced it). */
+export const EXCEPTION_REASONS = [
+    'UNMATCHED',
+    'FX_RATE_UNAVAILABLE',
+    'MISSING_BASE_AMOUNT',
+    'MISSING_BASE_CURRENCY',
+    'SPLIT_INCOMPLETE',
+    'VALIDATION_FAILED',
+    'SOURCE_MISMATCH',
+    'DUPLICATE_TRANSACTION',
+    'FEE_VARIANCE',
+    'FEE_DATA_MISSING',
+    'FEE_CURRENCY_MISMATCH',
+    'FX_RATE_VARIANCE',
+    'AGED_BREAK',
+    'OVER_SETTLED',
+];
+/** Sortable columns (default queue ordering applies when both sort knobs are omitted). */
+export const EXCEPTION_SORT_BY = [
+    'id',
+    'created_at',
+    'updated_at',
+    'severity',
+    'status',
+];
+/** Sort direction for the explicit single-column sort. */
+export const EXCEPTION_SORT_ORDER = ['asc', 'desc'];
+/** Zod raw shape for `exception_list` input — filters + sort + pagination. */
+export const listExceptionsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Filter by reconciliation context id (UUID), verified against your ' +
+        "token's tenant. Routing filter, not a tenant field."),
+    status: z
+        .enum(EXCEPTION_STATUSES)
+        .optional()
+        .describe('Filter by lifecycle status (OPEN|ASSIGNED|RESOLVED).'),
+    severity: z
+        .enum(EXCEPTION_SEVERITIES)
+        .optional()
+        .describe('Filter by severity (LOW|MEDIUM|HIGH|CRITICAL).'),
+    reason: z
+        .enum(EXCEPTION_REASONS)
+        .optional()
+        .describe('Filter by the reason the exception was raised (e.g. UNMATCHED, ' +
+        'FEE_VARIANCE, DUPLICATE_TRANSACTION).'),
+    assigned_to: z
+        .string()
+        .optional()
+        .describe('Filter by assigned user (e.g. "user@example.com").'),
+    external_system: z
+        .string()
+        .optional()
+        .describe('Filter by external system the exception was dispatched to (e.g. "JIRA").'),
+    date_from: z
+        .string()
+        .optional()
+        .describe('Inclusive lower bound as an RFC 3339 timestamp (e.g. "2025-01-01T00:00:00Z").'),
+    date_to: z
+        .string()
+        .optional()
+        .describe('Inclusive upper bound as an RFC 3339 timestamp (e.g. "2025-01-31T23:59:59Z").'),
+    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). ' +
+        'Cursors are bound to the ordering that minted them — do not switch ' +
+        'sort_by/sort_order mid-pagination.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of records to return (1–200, default 20).'),
+    sort_by: z
+        .enum(EXCEPTION_SORT_BY)
+        .optional()
+        .describe('Sort field (id|created_at|updated_at|severity|status). Omit both sort ' +
+        'knobs for the default queue ordering (status ASC, then created_at DESC).'),
+    sort_order: z
+        .enum(EXCEPTION_SORT_ORDER)
+        .optional()
+        .describe('Sort direction (asc|desc) for the explicit single-column sort.'),
+};
+/** Build the list query, omitting unset knobs so the request stays minimal. */
+export function buildListQuery(args) {
+    const query = {};
+    if (args.contextId !== undefined) {
+        query.contextId = args.contextId;
+    }
+    if (args.status !== undefined) {
+        query.status = args.status;
+    }
+    if (args.severity !== undefined) {
+        query.severity = args.severity;
+    }
+    if (args.reason !== undefined) {
+        query.reason = args.reason;
+    }
+    if (args.assigned_to !== undefined) {
+        query.assigned_to = args.assigned_to;
+    }
+    if (args.external_system !== undefined) {
+        query.external_system = args.external_system;
+    }
+    if (args.date_from !== undefined) {
+        query.date_from = args.date_from;
+    }
+    if (args.date_to !== undefined) {
+        query.date_to = args.date_to;
+    }
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.sort_by !== undefined) {
+        query.sort_by = args.sort_by;
+    }
+    if (args.sort_order !== undefined) {
+        query.sort_order = args.sort_order;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `exception_list`. Passes the filter/sort/pagination knobs through and
+ * returns matcher's pagination envelope verbatim; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerExceptionListTool(server) {
+    server.registerTool('exception_list', {
+        description: 'List reconciliation exceptions (cursor-paginated). Optional filters: ' +
+            'contextId (UUID — not a tenant field), status (OPEN|ASSIGNED|RESOLVED), ' +
+            'severity (LOW|MEDIUM|HIGH|CRITICAL), reason (e.g. UNMATCHED, ' +
+            'FEE_VARIANCE), assigned_to, external_system, date_from/date_to (RFC ' +
+            '3339), plus sort_by/sort_order and limit (1–200)/cursor. The response ' +
+            'carries { items, nextCursor } — paginate by re-calling with the returned ' +
+            'nextCursor (do not change sort mid-pagination). No tenant field is accepted.',
+        inputSchema: listExceptionsInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchException({
+            method: 'GET',
+            path: EXCEPTIONS_PATH,
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/exception/list.js.map

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

package/dist/tools/exception/open-dispute.js

@@ -0,0 +1,53 @@
+// `exception_open_dispute` — curated POST /v1/exceptions/{exceptionId}/disputes.
+//
+// Opens a formal dispute against one exception, used to challenge or investigate
+// a discrepancy with an external party. Mirrors the spec's OpenDisputeRequest —
+// category (1–255) and description (1–5000), both required. exceptionId is a
+// path param; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchException, exceptionDisputesPath } from './shared.js';
+/** Zod raw shape for `exception_open_dispute` input — path id + dispute body. */
+export const openDisputeInputShape = {
+    exceptionId: z
+        .string()
+        .min(1)
+        .describe('The exception id (UUID) to open a dispute against.'),
+    category: z
+        .string()
+        .min(1)
+        .max(255)
+        .describe('Category of the dispute (1–255 chars, e.g. "AMOUNT_MISMATCH").'),
+    description: z
+        .string()
+        .min(1)
+        .max(5000)
+        .describe('Detailed description of the dispute (1–5000 chars).'),
+};
+/**
+ * Build the POST body from the input minus the path-only `exceptionId`. Only the
+ * OpenDisputeRequest fields are sent; exceptionId travels in the path.
+ */
+export function buildOpenDisputeBody(args) {
+    return { category: args.category, description: args.description };
+}
+/**
+ * Register `exception_open_dispute`. Substitutes the id into the path, builds the
+ * body from the typed input, and dispatches a POST through the shared
+ * fail-closed relay; a matcher error surfaces via the shared toToolError.
+ */
+export function registerExceptionOpenDisputeTool(server) {
+    server.registerTool('exception_open_dispute', {
+        description: 'Open a formal dispute against a reconciliation exception. Provide ' +
+            'exceptionId (UUID path param), category (1–255), and description ' +
+            '(1–5000). No tenant field is accepted. Returns the created dispute, or a ' +
+            'structured RFC 9457 error.',
+        inputSchema: openDisputeInputShape,
+    }, async (args, extra) => {
+        return dispatchException({
+            method: 'POST',
+            path: exceptionDisputesPath(args.exceptionId),
+            body: buildOpenDisputeBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=open-dispute.js.map

package/dist/tools/exception/open-dispute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-dispute.js","sourceRoot":"","sources":["../../../src/tools/exception/open-dispute.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,6EAA6E;AAC7E,2CAA2C;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEtE,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oDAAoD,CAAC;IACjE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAA;AAOD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAsB;IAEtB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAA;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,oEAAoE;YACpE,mEAAmE;YACnE,2EAA2E;YAC3E,4BAA4B;QAC9B,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC;YAC7C,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;SACjC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/exception/shared.js

@@ -0,0 +1,98 @@
+// Shared plumbing for the curated exception tools.
+//
+// Exceptions are the flat top-level resource at /v1/exceptions, with a handful
+// of sub-resources (/{id}, /{id}/history, /{id}/comments[/{commentId}],
+// /{id}/disputes) and per-exception action verbs (/{id}/dispatch, /force-match,
+// /adjust-entry), plus the cross-exception bulk endpoints under /bulk/*. This
+// module factors every path helper plus the relay/error-mapping boilerplate
+// exactly once so the thirteen tools stay thin — they only "build the request".
+//
+// The relay shape is identical to the source / fee-schedule verticals: 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 exception tool input carries one.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Base path for the flat exceptions collection (list). */
+export const EXCEPTIONS_PATH = '/v1/exceptions';
+/** Single-exception sub-path (get / action verbs), id URL-encoded so reserved chars are safe. */
+export function exceptionPath(exceptionId) {
+    return `${EXCEPTIONS_PATH}/${encodeURIComponent(exceptionId)}`;
+}
+/** History sub-resource of one exception (audit trail, cursor-paginated). */
+export function exceptionHistoryPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/history`;
+}
+/** Comments collection of one exception (list / add). */
+export function exceptionCommentsPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/comments`;
+}
+/** A single comment under one exception (delete), both ids URL-encoded. */
+export function exceptionCommentPath(exceptionId, commentId) {
+    return `${exceptionCommentsPath(exceptionId)}/${encodeURIComponent(commentId)}`;
+}
+/** Dispatch action for one exception (push to an external ticketing system). */
+export function exceptionDispatchPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/dispatch`;
+}
+/** Disputes collection of one exception (open a dispute). */
+export function exceptionDisputesPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/disputes`;
+}
+/** Force-match action for one exception (resolve by overriding the match). */
+export function exceptionForceMatchPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/force-match`;
+}
+/** Adjust-entry action for one exception (resolve via a balancing adjustment). */
+export function exceptionAdjustEntryPath(exceptionId) {
+    return `${exceptionPath(exceptionId)}/adjust-entry`;
+}
+/** Bulk-assign action across many exceptions. */
+export const EXCEPTIONS_BULK_ASSIGN_PATH = `${EXCEPTIONS_PATH}/bulk/assign`;
+/** Bulk-resolve action across many exceptions. */
+export const EXCEPTIONS_BULK_RESOLVE_PATH = `${EXCEPTIONS_PATH}/bulk/resolve`;
+/** Bulk-dispatch action across many exceptions. */
+export const EXCEPTIONS_BULK_DISPATCH_PATH = `${EXCEPTIONS_PATH}/bulk/dispatch`;
+/**
+ * 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 dispatchException(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-comment).
+        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/exception/shared.js.map

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

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

@@ -0,0 +1,106 @@
+// `fee_rule_create` — curated POST /v1/contexts/{contextId}/fee-rules.
+//
+// A typed, richly-described front door to creating a fee rule, mirroring the
+// spec's CreateFeeRuleRequest. The rule binds a fee schedule to a reconciliation
+// context with a side + predicates that a transaction's metadata must satisfy.
+//
+// Path is context-nested: `contextId` is a REQUIRED path param (routing — matcher
+// validates the context belongs to the relayed token's tenant), NOT a tenant
+// field. The body is the input minus `contextId`.
+//
+// The predicate sub-object is modeled explicitly (the operator enum set is small
+// and known: EQUALS / IN / EXISTS), so an operator-driving LLM gets the exact
+// shape; `value`/`values` are optional because EXISTS needs neither.
+import { z } from 'zod';
+import { contextFeeRulesPath, dispatchFeeRule } from './shared.js';
+/** Side a fee rule applies to. LEFT/RIGHT target one side; ANY matches either. */
+export const FEE_RULE_SIDES = ['LEFT', 'RIGHT', 'ANY'];
+/** Predicate comparison operators matcher supports for fee-rule predicates. */
+export const PREDICATE_OPERATORS = ['EQUALS', 'IN', 'EXISTS'];
+/**
+ * One field predicate. ANDed with the rule's other predicates. `field` and
+ * `operator` are required; `value` is used by EQUALS, `values` by IN, and EXISTS
+ * needs neither — they are optional here and matcher is the authoritative
+ * validator of the operator/value pairing.
+ */
+export const feeRulePredicateShape = z
+    .object({
+    field: z
+        .string()
+        .describe('Transaction metadata field the predicate tests, e.g. "institution".'),
+    operator: z
+        .enum(PREDICATE_OPERATORS)
+        .describe('Comparison operator. EQUALS matches a single `value`; IN matches any ' +
+        'of `values`; EXISTS asserts the field is present (needs neither).'),
+    value: z
+        .string()
+        .optional()
+        .describe('Comparison value — required for the EQUALS operator.'),
+    values: z
+        .array(z.string())
+        .optional()
+        .describe('Candidate values — required for the IN operator.'),
+})
+    .describe('A single field predicate a transaction must satisfy for the rule to apply.');
+/** Zod raw shape for `fee_rule_create` input — mirrors CreateFeeRuleRequest. */
+export const createFeeRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the fee rule is created under. A ' +
+        'routing path param — matcher validates the context belongs to your ' +
+        "token's tenant. NOT a tenant field."),
+    side: z
+        .enum(FEE_RULE_SIDES)
+        .describe('Side the rule applies to. LEFT and RIGHT target one reconciliation side; ' +
+        'ANY matches transactions on either side.'),
+    feeScheduleId: z
+        .string()
+        .min(1)
+        .describe('UUID of the fee schedule this rule applies when its predicates match. You ' +
+        'must be allowed to read the referenced schedule.'),
+    name: z
+        .string()
+        .min(1)
+        .max(100)
+        .describe('Human-readable name of the fee rule (1–100 chars).'),
+    priority: z
+        .number()
+        .int()
+        .describe('Evaluation priority; lower numbers are evaluated first. Must be unique ' +
+        'within the context — LEFT, RIGHT, and ANY rules share one priority space.'),
+    predicates: z
+        .array(feeRulePredicateShape)
+        .describe('Predicates (ANDed together) a transaction\'s metadata must satisfy for ' +
+        'this rule to apply.'),
+};
+/** Build the POST body from the input minus the path-only `contextId`. */
+export function buildCreateBody(args) {
+    const { contextId: _contextId, ...body } = args;
+    void _contextId;
+    return body;
+}
+/**
+ * Register `fee_rule_create`. Substitutes `contextId` into the context-nested
+ * path and dispatches the body through the shared fail-closed relay; a matcher
+ * error surfaces via the shared toToolError (same shape as matcher_invoke).
+ */
+export function registerFeeRuleCreateTool(server) {
+    server.registerTool('fee_rule_create', {
+        description: 'Create a fee rule under a reconciliation context, binding a fee schedule ' +
+            'to transactions whose metadata satisfies the predicates. Provide ' +
+            'contextId (path), side (LEFT|RIGHT|ANY), feeScheduleId (UUID), name ' +
+            '(1–100), priority (unique within the context across all sides), and ' +
+            'predicates[] (each { field, operator EQUALS|IN|EXISTS, value?, values? }). ' +
+            'The rule is scoped to your token\'s tenant (no tenant field is accepted). ' +
+            'Returns the created rule, or a structured RFC 9457 error.',
+        inputSchema: createFeeRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeRule({
+            method: 'POST',
+            path: contextFeeRulesPath(args.contextId),
+            body: buildCreateBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,27 @@
+// `fee_rule_delete` — curated DELETE /v1/fee-rules/{feeRuleId}.
+//
+// Removes a fee rule by id via the FLAT path. A successful delete returns 204
+// (no content), which the relay renders as null. feeRuleId is a UUID path param;
+// no tenant field is accepted (matcher scopes to the relayed token's tenant).
+import { z } from 'zod';
+import { dispatchFeeRule, feeRulePath } from './shared.js';
+/** Zod raw shape for `fee_rule_delete` input — just the fee-rule id (flat path). */
+export const deleteFeeRuleInputShape = {
+    feeRuleId: z.string().min(1).describe('The fee rule id (UUID) to delete.'),
+};
+/**
+ * Register `fee_rule_delete`. Substitutes the id into the flat path and
+ * dispatches a DELETE through the shared fail-closed relay; any matcher error
+ * surfaces via the shared toToolError.
+ */
+export function registerFeeRuleDeleteTool(server) {
+    server.registerTool('fee_rule_delete', {
+        description: 'Delete a fee rule by id (UUID) via the flat path. The rule must belong ' +
+            "to your token's tenant (no tenant field is accepted). Returns no content " +
+            'on success, or a structured RFC 9457 error.',
+        inputSchema: deleteFeeRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeRule({ method: 'DELETE', path: feeRulePath(args.feeRuleId) }, extra);
+    });
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/delete.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAE9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE1D,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC3E,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,yEAAyE;YACzE,2EAA2E;YAC3E,6CAA6C;QAC/C,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EACvD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,27 @@
+// `fee_rule_get` — curated GET /v1/fee-rules/{feeRuleId}.
+//
+// Reads one fee rule by id via the FLAT path (no contextId). feeRuleId is the
+// only input (a UUID path param). The rule must belong to the relayed token's
+// tenant — matcher enforces that; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchFeeRule, feeRulePath } from './shared.js';
+/** Zod raw shape for `fee_rule_get` input — just the fee-rule id (flat path). */
+export const getFeeRuleInputShape = {
+    feeRuleId: z.string().min(1).describe('The fee rule id (UUID) to fetch.'),
+};
+/**
+ * Register `fee_rule_get`. Substitutes the id into the flat path and dispatches a
+ * GET through the shared fail-closed relay; a matcher error (e.g. 404) surfaces
+ * via the shared toToolError.
+ */
+export function registerFeeRuleGetTool(server) {
+    server.registerTool('fee_rule_get', {
+        description: 'Fetch a single fee rule by id (UUID). The rule must belong to your ' +
+            "token's tenant. Returns the rule, or a structured RFC 9457 error (e.g. " +
+            '404 if it does not exist or is not yours).',
+        inputSchema: getFeeRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeRule({ method: 'GET', path: feeRulePath(args.feeRuleId) }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/get.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,+DAA+D;AAE/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE1D,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC1E,CAAA;AAKD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,qEAAqE;YACrE,yEAAyE;YACzE,4CAA4C;QAC9C,WAAW,EAAE,oBAAoB;KAClC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EACpD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+// Curated fee-rule vertical (task 2.1.1): five typed tools over the matcher
+// fee-rule resource — create, list, get, update, delete. Fee rules use a HYBRID
+// path: create/list are context-nested (/v1/contexts/{contextId}/fee-rules) and
+// get/update/delete are flat (/v1/fee-rules/{feeRuleId}). 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 { registerFeeRuleCreateTool } from './create.js';
+import { registerFeeRuleDeleteTool } from './delete.js';
+import { registerFeeRuleGetTool } from './get.js';
+import { registerFeeRuleListTool } from './list.js';
+import { registerFeeRuleUpdateTool } from './update.js';
+/** Register all five curated fee-rule tools on the given server. */
+export function registerFeeRuleTools(server) {
+    registerFeeRuleCreateTool(server);
+    registerFeeRuleListTool(server);
+    registerFeeRuleGetTool(server);
+    registerFeeRuleUpdateTool(server);
+    registerFeeRuleDeleteTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,sEAAsE;AACtE,6EAA6E;AAC7E,sDAAsD;AAItD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAEvD,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,yBAAyB,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}