@lerianstudio/matcher-mcp 1.0.0-beta.5

package/dist/tools/matching/get.js

@@ -0,0 +1,48 @@
+// `match_run_get` — curated GET /v1/matching/runs/{runId}?contextId=<id>.
+//
+// Reads one match run's detail by id: status, timing, aggregate stats, and the
+// per-rule matched-group counts (ruleStats). The matcher payload is returned
+// verbatim — this is how an operator polls a run started by `match_run_start`.
+//
+// Path/query split (per the spec): `runId` is the PATH param, but `contextId` is
+// a REQUIRED QUERY param (not part of the path), so matcher can scope the run to
+// the right context. `contextId` is a routing param matcher validates ownership
+// of, NOT a tenant field; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchMatching, runPath } from './shared.js';
+/** Zod raw shape for `match_run_get` input — runId (path) + contextId (query, required). */
+export const getMatchRunInputShape = {
+    runId: z
+        .string()
+        .min(1)
+        .describe('The match run id (UUID) to fetch.'),
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the run belongs to. Sent as a query ' +
+        'param (required); routing param scoped to your token.'),
+};
+/**
+ * Register `match_run_get`. Substitutes runId into the path and sends contextId
+ * as a query param; dispatches a GET through the shared fail-closed relay. The
+ * run payload (status/stats/ruleStats) is returned verbatim; a matcher error
+ * (e.g. 404) surfaces via the shared toToolError.
+ */
+export function registerMatchRunGetTool(server) {
+    server.registerTool('match_run_get', {
+        description: 'Fetch a single match run by id, including status, timing, aggregate ' +
+            'statistics, and per-rule matched-group counts. Use this to poll a run ' +
+            'started by match_run_start. Requires runId and contextId (contextId is ' +
+            'sent as a query param). Both are routing params scoped to your token; no ' +
+            'tenant field is accepted. Returns the run detail, or a structured RFC ' +
+            '9457 error (e.g. 404).',
+        inputSchema: getMatchRunInputShape,
+    }, async (args, extra) => {
+        return dispatchMatching({
+            method: 'GET',
+            path: runPath(args.runId),
+            query: { contextId: args.contextId },
+        }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/matching/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/matching/get.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,uDAAuD;AAEvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAEvD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mCAAmC,CAAC;IAChD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,uDAAuD,CAC1D;CACJ,CAAA;AAOD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,yEAAyE;YACzE,2EAA2E;YAC3E,wEAAwE;YACxE,wBAAwB;QAC1B,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YACzB,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;SACrC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/matching/groups.js

@@ -0,0 +1,98 @@
+// `match_run_groups` — curated GET /v1/matching/runs/{runId}/groups?contextId=<id>.
+//
+// Cursor-paginated list of the match groups produced by a run: each group holds
+// the matched transaction pairs and a confidence score. limit/cursor/sort_order/
+// sort_by pass through untouched and matcher's pagination envelope is returned
+// as-is — no auto-pagination (a run can produce unbounded groups; the model
+// pages by re-calling with the returned cursor).
+//
+// Path/query split (per the spec): `runId` is the PATH param, while `contextId`
+// is a REQUIRED QUERY param. `contextId` is a routing param matcher validates
+// ownership of, NOT a tenant field; no tenant field is accepted.
+import { z } from 'zod';
+import { SORT_ORDERS } from './list.js';
+import { dispatchMatching, runGroupsPath } from './shared.js';
+/** Sort fields matcher accepts for the run-groups listing. */
+export const GROUP_SORT_FIELDS = ['id', 'created_at', 'status'];
+/**
+ * Zod raw shape for `match_run_groups` input — runId (path) + contextId (query,
+ * required) + pagination/sort knobs.
+ */
+export const getMatchRunGroupsInputShape = {
+    runId: z
+        .string()
+        .min(1)
+        .describe('The match run id (UUID) whose groups to list.'),
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the run belongs to. Sent as a query ' +
+        'param (required); routing param scoped to your token.'),
+    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).'),
+    sort_order: z
+        .enum(SORT_ORDERS)
+        .optional()
+        .describe('Sort order: asc (oldest first) or desc (newest first).'),
+    sort_by: z
+        .enum(GROUP_SORT_FIELDS)
+        .optional()
+        .describe('Sort field: id, created_at, or status.'),
+};
+/**
+ * Build the groups query. contextId is always present (required); the pagination
+ * and sort knobs are added only when the caller set them.
+ */
+function buildGroupsQuery(args) {
+    const query = {
+        contextId: args.contextId,
+    };
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    if (args.sort_order !== undefined) {
+        query.sort_order = args.sort_order;
+    }
+    if (args.sort_by !== undefined) {
+        query.sort_by = args.sort_by;
+    }
+    return query;
+}
+/**
+ * Register `match_run_groups`. Substitutes runId into the path, sends contextId
+ * (plus any pagination/sort knobs) as query params, and returns matcher's
+ * pagination envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerMatchRunGroupsTool(server) {
+    server.registerTool('match_run_groups', {
+        description: "List a match run's result groups (cursor-paginated). Each group holds " +
+            'the matched transaction pairs and a confidence score. Requires runId and ' +
+            'contextId (contextId is sent as a query param); optionally limit (1–200), ' +
+            'cursor, sort_order (asc|desc), and sort_by (id|created_at|status). The ' +
+            'response carries { items, nextCursor } — paginate by re-calling with the ' +
+            'returned nextCursor. Routing params are scoped to your token; no tenant ' +
+            'field is accepted.',
+        inputSchema: getMatchRunGroupsInputShape,
+    }, async (args, extra) => {
+        return dispatchMatching({
+            method: 'GET',
+            path: runGroupsPath(args.runId),
+            query: buildGroupsQuery(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=groups.js.map

package/dist/tools/matching/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../../src/tools/matching/groups.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,4EAA4E;AAC5E,iDAAiD;AACjD,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,iEAAiE;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE7D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAA;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,uDAAuD,CAC1D;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;IACH,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,iBAAiB,CAAC;SACvB,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAA;AAOD;;;GAGG;AACH,SAAS,gBAAgB,CACvB,IAA4B;IAE5B,MAAM,KAAK,GAAoC;QAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAA;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,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;IAC9B,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,wEAAwE;YACxE,2EAA2E;YAC3E,4EAA4E;YAC5E,yEAAyE;YACzE,2EAA2E;YAC3E,0EAA0E;YAC1E,oBAAoB;QACtB,WAAW,EAAE,2BAA2B;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/B,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC;SAC9B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/matching/index.js

@@ -0,0 +1,19 @@
+// Curated match-run vertical (task 2.2.3): four typed action/read tools over the
+// matcher matching engine — start a run, list a context's runs, read one run's
+// detail, and page its result groups. These are NOT CRUD: they are verbs over
+// `/v1/matching/...`. Each tool shares the fail-closed relay (shared.ts) and the
+// RFC 9457 → tool-error mapping (toToolError) with every other curated surface,
+// so they map matcher errors identically. No tool carries a tenant field;
+// contextId is a routing param matcher validates ownership of.
+import { registerMatchRunGroupsTool } from './groups.js';
+import { registerMatchRunGetTool } from './get.js';
+import { registerMatchRunListTool } from './list.js';
+import { registerMatchRunStartTool } from './start.js';
+/** Register all four curated match-run tools on the given server. */
+export function registerMatchingTools(server) {
+    registerMatchRunStartTool(server);
+    registerMatchRunListTool(server);
+    registerMatchRunGetTool(server);
+    registerMatchRunGroupsTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/matching/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,0EAA0E;AAC1E,+DAA+D;AAI/D,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,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}

package/dist/tools/matching/list.js

@@ -0,0 +1,76 @@
+// `match_run_list` — curated GET /v1/matching/contexts/{contextId}/runs.
+//
+// Cursor-paginated history of a context's match runs, sorted by creation time
+// (descending by default; `sort_order` flips it). limit/cursor/sort_order 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 matcher scopes to the relayed token's
+// tenant; no tenant field is accepted.
+import { z } from 'zod';
+import { contextRunsPath, dispatchMatching } from './shared.js';
+/** Sort orders matcher accepts for the run-history listing. */
+export const SORT_ORDERS = ['asc', 'desc'];
+/** Zod raw shape for `match_run_list` input — contextId (path) + pagination/sort. */
+export const listMatchRunsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose run history to list. Routing ' +
+        'param; matcher validates it belongs to your tenant.'),
+    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).'),
+    sort_order: z
+        .enum(SORT_ORDERS)
+        .optional()
+        .describe('Sort order by creation time. desc (default) lists newest first; asc lists ' +
+        'oldest first.'),
+};
+/** 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;
+    }
+    if (args.sort_order !== undefined) {
+        query.sort_order = args.sort_order;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `match_run_list`. Passes limit/cursor/sort_order through and returns
+ * matcher's pagination envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerMatchRunListTool(server) {
+    server.registerTool('match_run_list', {
+        description: "List a reconciliation context's match-run history (cursor-paginated, " +
+            'newest first). Pass contextId (required), and optionally limit (1–200), ' +
+            'cursor, and sort_order (asc|desc). The response carries { items, ' +
+            'nextCursor } — paginate by re-calling with the returned nextCursor. ' +
+            'contextId is a routing param scoped to your token; no tenant field is ' +
+            'accepted.',
+        inputSchema: listMatchRunsInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchMatching({
+            method: 'GET',
+            path: contextRunsPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/matching/list.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,uCAAuC;AAEvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE/D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAA;AAEnD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,qDAAqD,CACxD;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;IACH,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,eAAe,CAClB;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,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;IACpC,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,uEAAuE;YACvE,0EAA0E;YAC1E,mEAAmE;YACnE,sEAAsE;YACtE,wEAAwE;YACxE,WAAW;QACb,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,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;YACrC,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/matching/shared.js

@@ -0,0 +1,77 @@
+// Shared plumbing for the curated match-run tools.
+//
+// Unlike the configuration resources (fee schedules, rules, contexts, sources),
+// the match-run family is NOT CRUD — it is a set of action/read verbs over the
+// matcher engine: start a run, list a context's runs, read one run's results,
+// and page its match groups. They share the same relay shape as every other
+// curated tool: fail-closed auth via requireMatcherClient, dispatch one
+// assembled MatcherRequest, then return matcher's JSON on success or the SHARED
+// toToolError on a MatcherApiError. This module factors that boilerplate once so
+// the four tools stay thin (just "build the request") and so curated + generic
+// surfaces map matcher errors through the identical path (toToolError).
+//
+// Two path families exist (mirroring the spec): runs are triggered/listed under
+// the context (`/v1/matching/contexts/{contextId}/...`), while a run's detail and
+// groups are read by run id (`/v1/matching/runs/{runId}/...`) — and on those
+// detail reads `contextId` is carried as a REQUIRED QUERY param, not in the 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-run tool input carries one. `contextId`
+// is a routing param matcher validates ownership of, not a tenant field.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Trigger path for a context's matching run: POST starts a run. */
+export function contextRunPath(contextId) {
+    return `/v1/matching/contexts/${encodeURIComponent(contextId)}/run`;
+}
+/** List path for a context's match-run history. */
+export function contextRunsPath(contextId) {
+    return `/v1/matching/contexts/${encodeURIComponent(contextId)}/runs`;
+}
+/** Detail path for a single run by id (contextId travels as a query param). */
+export function runPath(runId) {
+    return `/v1/matching/runs/${encodeURIComponent(runId)}`;
+}
+/** Groups path for a run's results (contextId travels as a query param). */
+export function runGroupsPath(runId) {
+    return `/v1/matching/runs/${encodeURIComponent(runId)}/groups`;
+}
+/**
+ * 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 dispatchMatching(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 run payload returned as-is (202 { runId, status },
+        // run detail status/stats/ruleStats, or the group pagination envelope).
+        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/matching/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/matching/shared.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,wEAAwE;AACxE,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,iFAAiF;AACjF,yEAAyE;AAIzE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAA;AACrE,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAA;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAA;AAChE,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,yEAAyE;QACzE,wEAAwE;QACxE,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/matching/start.js

@@ -0,0 +1,55 @@
+// `match_run_start` — curated POST /v1/matching/contexts/{contextId}/run.
+//
+// Triggers a matching run for a reconciliation context. This is an async action:
+// matcher responds 202 with { runId, status } and processes in the background —
+// the operator polls `match_run_get` with the returned runId to follow progress.
+// This tool does NOT auto-poll; it returns the 202 acceptance body verbatim.
+//
+// `contextId` is a routing path param (matcher validates it belongs to the
+// relayed token's tenant), NOT a tenant field. No tenant field is accepted.
+import { z } from 'zod';
+import { contextRunPath, dispatchMatching } from './shared.js';
+/**
+ * Execution modes for a matching run.
+ *   - DRY_RUN tests the context's rules and reports what WOULD match without
+ *     committing any results.
+ *   - COMMIT executes the rules and persists the resulting matches.
+ */
+export const RUN_MODES = ['DRY_RUN', 'COMMIT'];
+/** Zod raw shape for `match_run_start` input — contextId (path) + required mode. */
+export const startMatchRunInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to run matching for. Routing param; ' +
+        'matcher validates it belongs to your tenant.'),
+    mode: z
+        .enum(RUN_MODES)
+        .describe('Execution mode. DRY_RUN tests the rules without committing any matches; ' +
+        'COMMIT executes the rules and persists the resulting matches.'),
+};
+/**
+ * Register `match_run_start`. Substitutes contextId into the path and sends only
+ * `{ mode }` as the body (per RunMatchRequest, which forbids extra properties).
+ * Dispatches through the shared fail-closed relay; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerMatchRunStartTool(server) {
+    server.registerTool('match_run_start', {
+        description: 'Trigger a matching run for a reconciliation context. Async: returns 202 ' +
+            'with { runId, status } and processes in the background — poll ' +
+            'match_run_get with the runId to follow progress (this tool does not ' +
+            'auto-poll). mode is required: DRY_RUN tests rules without committing, ' +
+            'COMMIT persists the matches. contextId is a routing param scoped to your ' +
+            'token (no tenant field is accepted). Returns the acceptance body, or a ' +
+            'structured RFC 9457 error.',
+        inputSchema: startMatchRunInputShape,
+    }, async (args, extra) => {
+        return dispatchMatching({
+            method: 'POST',
+            path: contextRunPath(args.contextId),
+            body: { mode: args.mode },
+        }, extra);
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/tools/matching/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/tools/matching/start.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAA;AAEvD,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,8CAA8C,CACjD;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,QAAQ,CACP,0EAA0E;QACxE,+DAA+D,CAClE;CACJ,CAAA;AAOD;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,0EAA0E;YAC1E,gEAAgE;YAChE,sEAAsE;YACtE,wEAAwE;YACxE,2EAA2E;YAC3E,yEAAyE;YACzE,4BAA4B;QAC9B,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;YACpC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;SAC1B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/report/count-exceptions.js

@@ -0,0 +1,45 @@
+// `report_count_exceptions` — curated GET
+// /v1/reports/contexts/{contextId}/exceptions/count.
+//
+// Returns the total count of exceptions for the given filters — used to decide
+// between a sync download (<1000 rows) and an async export job. Here the date
+// filter applies to the exception's created_at (not the underlying transaction
+// date). Takes only the common date filter and returns matcher's
+// ExportCountResponse as-is. The count is implicitly tenant-scoped by the
+// relayed token; contextId is a routing path param, not a tenant field, and no
+// tenant field is accepted.
+import { z } from 'zod';
+import { buildReportFilterQuery, contextReportPath, dispatchReport, reportFilterInputShape, } from './shared.js';
+/** Zod raw shape for `report_count_exceptions` input — contextId path + date filter. */
+export const countExceptionsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose exceptions to count. Routing ' +
+        'path param, not a tenant field.'),
+    ...reportFilterInputShape,
+};
+/**
+ * Register `report_count_exceptions`. Passes the date filter through and returns
+ * matcher's count envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerReportCountExceptionsTool(server) {
+    server.registerTool('report_count_exceptions', {
+        description: 'Count exceptions for a context within a date window — use it to decide ' +
+            'between a sync download (<1000 rows) and an async export. The date ' +
+            "filter applies to each exception's created_at. Pass contextId (UUID " +
+            'path param — not a tenant field), and optionally date_from/date_to ' +
+            '(YYYY-MM-DD, window ≤ 90 days) and source_id. No tenant field is ' +
+            'accepted.',
+        inputSchema: countExceptionsInputShape,
+    }, async (args, extra) => {
+        const query = buildReportFilterQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'exceptions/count'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=count-exceptions.js.map

package/dist/tools/report/count-exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-exceptions.js","sourceRoot":"","sources":["../../../src/tools/report/count-exceptions.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,qDAAqD;AACrD,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,iEAAiE;AACjE,0EAA0E;AAC1E,+EAA+E;AAC/E,4BAA4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,iCAAiC,CACpC;IACH,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,yEAAyE;YACzE,qEAAqE;YACrE,sEAAsE;YACtE,qEAAqE;YACrE,mEAAmE;YACnE,WAAW;QACb,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC;YAC3D,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/report/count-matched.js

@@ -0,0 +1,46 @@
+// `report_count_matched` — curated GET
+// /v1/reports/contexts/{contextId}/matches/count.
+//
+// Returns the total count of matched records for the given filters — used to
+// decide between a sync download (<1000 rows) and an async export job. NOTE the
+// spec path is `matches/count` (plural "matches"), distinct from the report
+// path `matched` — that asymmetry is encoded in the suffix below. The date
+// filter applies to the transaction date. Takes only the common date filter and
+// returns matcher's ExportCountResponse as-is. The count is implicitly
+// tenant-scoped by the relayed token; contextId is a routing path param, not a
+// tenant field, and no tenant field is accepted.
+import { z } from 'zod';
+import { buildReportFilterQuery, contextReportPath, dispatchReport, reportFilterInputShape, } from './shared.js';
+/** Zod raw shape for `report_count_matched` input — contextId path + date filter. */
+export const countMatchedInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose matched records to count. ' +
+        'Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+};
+/**
+ * Register `report_count_matched`. Passes the date filter through and returns
+ * matcher's count envelope verbatim; a matcher error surfaces via the shared
+ * toToolError. The path suffix is `matches/count` (plural), per the spec.
+ */
+export function registerReportCountMatchedTool(server) {
+    server.registerTool('report_count_matched', {
+        description: 'Count matched records for a context within a date window — use it to ' +
+            'decide between a sync download (<1000 rows) and an async export. The ' +
+            'date filter applies to the transaction date. Pass contextId (UUID path ' +
+            'param — not a tenant field), and optionally date_from/date_to ' +
+            '(YYYY-MM-DD, window ≤ 90 days) and source_id. No tenant field is ' +
+            'accepted.',
+        inputSchema: countMatchedInputShape,
+    }, async (args, extra) => {
+        const query = buildReportFilterQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'matches/count'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=count-matched.js.map

package/dist/tools/report/count-matched.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-matched.js","sourceRoot":"","sources":["../../../src/tools/report/count-matched.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAC5E,2EAA2E;AAC3E,gFAAgF;AAChF,uEAAuE;AACvE,+EAA+E;AAC/E,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,uEAAuE;QACrE,yCAAyC,CAC5C;IACH,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,uEAAuE;YACvE,uEAAuE;YACvE,yEAAyE;YACzE,gEAAgE;YAChE,mEAAmE;YACnE,WAAW;QACb,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC;YACxD,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/report/count-transactions.js

@@ -0,0 +1,44 @@
+// `report_count_transactions` — curated GET
+// /v1/reports/contexts/{contextId}/transactions/count.
+//
+// Returns the total count of ALL transactions for the given filters — used to
+// decide between a sync download (<1000 rows) and an async export job. The date
+// filter applies to the transaction date. Takes only the common date filter and
+// returns matcher's ExportCountResponse as-is. The count is implicitly
+// tenant-scoped by the relayed token; contextId is a routing path param, not a
+// tenant field, and no tenant field is accepted.
+import { z } from 'zod';
+import { buildReportFilterQuery, contextReportPath, dispatchReport, reportFilterInputShape, } from './shared.js';
+/** Zod raw shape for `report_count_transactions` input — contextId path + date filter. */
+export const countTransactionsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose transactions to count. ' +
+        'Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+};
+/**
+ * Register `report_count_transactions`. Passes the date filter through and
+ * returns matcher's count envelope verbatim; a matcher error surfaces via the
+ * shared toToolError.
+ */
+export function registerReportCountTransactionsTool(server) {
+    server.registerTool('report_count_transactions', {
+        description: 'Count all transactions for a context within a date window — use it to ' +
+            'decide between a sync download (<1000 rows) and an async export. The ' +
+            'date filter applies to the transaction date. Pass contextId (UUID path ' +
+            'param — not a tenant field), and optionally date_from/date_to ' +
+            '(YYYY-MM-DD, window ≤ 90 days) and source_id. No tenant field is ' +
+            'accepted.',
+        inputSchema: countTransactionsInputShape,
+    }, async (args, extra) => {
+        const query = buildReportFilterQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'transactions/count'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=count-transactions.js.map

package/dist/tools/report/count-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-transactions.js","sourceRoot":"","sources":["../../../src/tools/report/count-transactions.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,uDAAuD;AACvD,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,uEAAuE;AACvE,+EAA+E;AAC/E,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,0FAA0F;AAC1F,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,oEAAoE;QAClE,yCAAyC,CAC5C;IACH,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CAAC,MAAiB;IACnE,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,WAAW,EACT,wEAAwE;YACxE,uEAAuE;YACvE,yEAAyE;YACzE,gEAAgE;YAChE,mEAAmE;YACnE,WAAW;QACb,WAAW,EAAE,2BAA2B;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC;YAC7D,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/report/count-unmatched.js

@@ -0,0 +1,44 @@
+// `report_count_unmatched` — curated GET
+// /v1/reports/contexts/{contextId}/unmatched/count.
+//
+// Returns the total count of unmatched records for the given filters — used to
+// decide between a sync download (<1000 rows) and an async export job. The date
+// filter applies to the transaction date. Takes only the common date filter and
+// returns matcher's ExportCountResponse as-is. The count is implicitly
+// tenant-scoped by the relayed token; contextId is a routing path param, not a
+// tenant field, and no tenant field is accepted.
+import { z } from 'zod';
+import { buildReportFilterQuery, contextReportPath, dispatchReport, reportFilterInputShape, } from './shared.js';
+/** Zod raw shape for `report_count_unmatched` input — contextId path + date filter. */
+export const countUnmatchedInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose unmatched records to count. ' +
+        'Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+};
+/**
+ * Register `report_count_unmatched`. Passes the date filter through and returns
+ * matcher's count envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerReportCountUnmatchedTool(server) {
+    server.registerTool('report_count_unmatched', {
+        description: 'Count unmatched records for a context within a date window — use it to ' +
+            'decide between a sync download (<1000 rows) and an async export. The ' +
+            'date filter applies to the transaction date. Pass contextId (UUID path ' +
+            'param — not a tenant field), and optionally date_from/date_to ' +
+            '(YYYY-MM-DD, window ≤ 90 days) and source_id. No tenant field is ' +
+            'accepted.',
+        inputSchema: countUnmatchedInputShape,
+    }, async (args, extra) => {
+        const query = buildReportFilterQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'unmatched/count'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=count-unmatched.js.map

package/dist/tools/report/count-unmatched.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-unmatched.js","sourceRoot":"","sources":["../../../src/tools/report/count-unmatched.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oDAAoD;AACpD,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,uEAAuE;AACvE,+EAA+E;AAC/E,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,uFAAuF;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,yCAAyC,CAC5C;IACH,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,yEAAyE;YACzE,uEAAuE;YACvE,yEAAyE;YACzE,gEAAgE;YAChE,mEAAmE;YACnE,WAAW;QACb,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC;YAC1D,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"}