@lerianstudio/matcher-mcp 1.0.0-beta.5

package/dist/tools/context/create.js

@@ -0,0 +1,100 @@
+// `context_create` — curated POST /v1/contexts.
+//
+// A typed, richly-described front door to creating a reconciliation context,
+// mirroring the spec's CreateContextRequest. The Zod schema models the required
+// scalars (name, type, interval) and the documented enums (type, feeNormalization)
+// so an operator-driving LLM gets the shape and the units up front; the inline
+// `rules[]` and `sources[]` arrays are modeled as typed-but-permissive records
+// (per the Phase 1 pattern) — matcher's server-side validation + the returned
+// RFC 9457 problem are the authoritative check, so we do not duplicate the full
+// rule/source validation here.
+//
+// No tenant field exists in the schema: the context is created for the tenant of
+// the relayed bearer token, never a tenant supplied as input.
+import { z } from 'zod';
+import { CONTEXTS_PATH, dispatchContext } from './shared.js';
+/**
+ * Reconciliation topology. The values are literal strings that contain colons:
+ * 1:1 matches one left transaction to one right; 1:N matches one against many;
+ * N:M matches groups on both sides.
+ */
+export const CONTEXT_TYPES = ['1:1', '1:N', 'N:M'];
+/** Fee normalization mode applied before amount comparison. */
+export const FEE_NORMALIZATIONS = ['NET', 'GROSS'];
+/** Maximum inline match rules a context may be created with. */
+export const MAX_INLINE_RULES = 50;
+/** Maximum inline sources a context may be created with. */
+export const MAX_INLINE_SOURCES = 10;
+/** Zod raw shape for `context_create` input — mirrors CreateContextRequest. */
+export const createContextInputShape = {
+    name: z
+        .string()
+        .min(1)
+        .max(100)
+        .describe('Human-readable name of the reconciliation context (1–100 chars).'),
+    type: z
+        .enum(CONTEXT_TYPES)
+        .describe('Reconciliation topology. "1:1" matches one left transaction to one ' +
+        'right; "1:N" matches one transaction against many on the other side; ' +
+        '"N:M" matches groups on both sides. The values contain colons.'),
+    interval: z
+        .string()
+        .min(1)
+        .max(100)
+        .describe('Execution interval label for the context, e.g. "daily" or "weekly" ' +
+        '(1–100 chars).'),
+    autoMatchOnUpload: z
+        .boolean()
+        .optional()
+        .describe('When true, a match run is triggered automatically after a file upload ' +
+        'completes.'),
+    feeNormalization: z
+        .enum(FEE_NORMALIZATIONS)
+        .optional()
+        .describe('Fee normalization mode. NET compares amounts after fees are deducted; ' +
+        'GROSS compares amounts before fees.'),
+    feeToleranceAbs: z
+        .string()
+        .optional()
+        .describe('Absolute fee tolerance as a decimal STRING in the context currency, ' +
+        'e.g. "0.01".'),
+    feeTolerancePct: z
+        .string()
+        .optional()
+        .describe('Percentage fee tolerance as a decimal STRING (0.5 means 0.5%), e.g. "0.5".'),
+    rules: z
+        .array(z.record(z.string(), z.unknown()))
+        .max(MAX_INLINE_RULES)
+        .optional()
+        .describe('Match rules to create inline with the context (max 50). Each rule is ' +
+        'validated server-side; prefer context_create with no rules then ' +
+        'match_rule_create for richer control.'),
+    sources: z
+        .array(z.record(z.string(), z.unknown()))
+        .max(MAX_INLINE_SOURCES)
+        .optional()
+        .describe('Sources to create inline with the context (max 10). Each source is ' +
+        'validated server-side; prefer context_create with no sources then ' +
+        'source_create for richer control.'),
+};
+/**
+ * Register `context_create`. Builds the POST request body from the typed input
+ * and dispatches it through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError (same shape as matcher_invoke).
+ */
+export function registerContextCreateTool(server) {
+    server.registerTool('context_create', {
+        description: 'Create a reconciliation context — the top of the configuration ' +
+            "hierarchy that rules, sources, and fee schedules hang off. Created for " +
+            "your token's tenant (no tenant field is accepted). Required: name " +
+            '(1–100), type ("1:1"|"1:N"|"N:M", with colons), interval (label, e.g. ' +
+            '"daily"). Optional: autoMatchOnUpload (bool), feeNormalization ' +
+            '(NET|GROSS), feeToleranceAbs/feeTolerancePct (decimal strings), and ' +
+            'inline rules[] (≤50) / sources[] (≤10). Returns the created context, or ' +
+            'a structured RFC 9457 error.',
+        inputSchema: createContextInputShape,
+    }, async (args, extra) => {
+        return dispatchContext({ method: 'POST', path: CONTEXTS_PATH, body: args }, extra);
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/context/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/context/create.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,mFAAmF;AACnF,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,+BAA+B;AAC/B,EAAE;AACF,iFAAiF;AACjF,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AAE3D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAU,CAAA;AAE3D,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEpC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,CACP,qEAAqE;QACnE,uEAAuE;QACvE,gEAAgE,CACnE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,qEAAqE;QACnE,gBAAgB,CACnB;IACH,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,YAAY,CACf;IACH,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,kBAAkB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,qCAAqC,CACxC;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,cAAc,CACjB;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E,CAC7E;IACH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxC,GAAG,CAAC,gBAAgB,CAAC;SACrB,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE;QACrE,kEAAkE;QAClE,uCAAuC,CAC1C;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxC,GAAG,CAAC,kBAAkB,CAAC;SACvB,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE;QACnE,oEAAoE;QACpE,mCAAmC,CACtC;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,iEAAiE;YACjE,yEAAyE;YACzE,oEAAoE;YACpE,wEAAwE;YACxE,iEAAiE;YACjE,sEAAsE;YACtE,0EAA0E;YAC1E,8BAA8B;QAChC,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,EACnD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/context/get.js

@@ -0,0 +1,31 @@
+// `context_get` — curated GET /v1/contexts/{contextId}.
+//
+// Reads one reconciliation context by id. contextId is the only input (a UUID
+// path param). The context must belong to the relayed token's tenant — matcher
+// enforces that; no tenant field is accepted (contextId is a routing param, not
+// a tenant identifier).
+import { z } from 'zod';
+import { contextPath, dispatchContext } from './shared.js';
+/** Zod raw shape for `context_get` input — just the context id. */
+export const getContextInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to fetch.'),
+};
+/**
+ * Register `context_get`. Substitutes the id 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 registerContextGetTool(server) {
+    server.registerTool('context_get', {
+        description: 'Fetch a single reconciliation context by id (UUID). The context must ' +
+            "belong to your token's tenant. Returns the context, or a structured " +
+            'RFC 9457 error (e.g. 404 if it does not exist or is not yours).',
+        inputSchema: getContextInputShape,
+    }, async (args, extra) => {
+        return dispatchContext({ method: 'GET', path: contextPath(args.contextId) }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/context/get.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,wBAAwB;AAExB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE1D,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAA;AAKD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,uEAAuE;YACvE,sEAAsE;YACtE,iEAAiE;QACnE,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/context/index.js

@@ -0,0 +1,21 @@
+// Curated context vertical (task 2.2.1): four typed tools over the matcher
+// reconciliation-context resource — create, list, get, update. (Delete was
+// removed when the matcher app replaced context hard-delete with the
+// archive/restore lifecycle; archive/restore remain reachable via the generic
+// invoke surface.) Contexts are the top of the configuration hierarchy that
+// rules, sources, and fee schedules hang off. 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 { registerContextCreateTool } from './create.js';
+import { registerContextGetTool } from './get.js';
+import { registerContextListTool } from './list.js';
+import { registerContextUpdateTool } from './update.js';
+/** Register all four curated context tools on the given server. */
+export function registerContextTools(server) {
+    registerContextCreateTool(server);
+    registerContextListTool(server);
+    registerContextGetTool(server);
+    registerContextUpdateTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/context/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,qEAAqE;AACrE,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,iFAAiF;AACjF,6EAA6E;AAC7E,+BAA+B;AAI/B,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,mEAAmE;AACnE,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;AACnC,CAAC"}

package/dist/tools/context/list.js

@@ -0,0 +1,78 @@
+// `context_list` — curated GET /v1/contexts.
+//
+// Cursor-paginated list of the tenant's reconciliation contexts, with optional
+// `type` and `status` filters the spec exposes. limit/cursor/type/status 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; no tenant field is
+// accepted.
+import { z } from 'zod';
+import { CONTEXT_TYPES } from './create.js';
+import { CONTEXTS_PATH, dispatchContext } from './shared.js';
+/** Lifecycle statuses a context can be filtered by on the list endpoint. */
+export const CONTEXT_STATUSES = ['DRAFT', 'ACTIVE', 'PAUSED', 'ARCHIVED'];
+/** Zod raw shape for `context_list` input — pagination knobs + optional filters. */
+export const listContextsInputShape = {
+    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).'),
+    type: z
+        .enum(CONTEXT_TYPES)
+        .optional()
+        .describe('Optional filter by reconciliation topology ("1:1"|"1:N"|"N:M", with colons).'),
+    status: z
+        .enum(CONTEXT_STATUSES)
+        .optional()
+        .describe('Optional filter by lifecycle status. DRAFT is unactivated; ACTIVE runs; ' +
+        'PAUSED is suspended; ARCHIVED is retired.'),
+};
+/** 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.type !== undefined) {
+        query.type = args.type;
+    }
+    if (args.status !== undefined) {
+        query.status = args.status;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `context_list`. Passes limit/cursor/type/status through and returns
+ * matcher's pagination envelope verbatim; a matcher error surfaces via the
+ * shared toToolError.
+ */
+export function registerContextListTool(server) {
+    server.registerTool('context_list', {
+        description: "List the reconciliation contexts for your token's tenant " +
+            '(cursor-paginated). Pass limit (1–200) and/or cursor; optionally filter ' +
+            'by type ("1:1"|"1:N"|"N:M") and/or status (DRAFT|ACTIVE|PAUSED|ARCHIVED). ' +
+            'The response carries { items, nextCursor } — paginate by re-calling with ' +
+            'the returned nextCursor. No tenant field is accepted; the tenant is ' +
+            'derived from your bearer token.',
+        inputSchema: listContextsInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchContext({
+            method: 'GET',
+            path: CONTEXTS_PATH,
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/context/list.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,kFAAkF;AAClF,gFAAgF;AAChF,4EAA4E;AAC5E,YAAY;AAEZ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAElF,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,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,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,8EAA8E,CAC/E;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E;QACxE,2CAA2C,CAC9C;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAuB;IAC7C,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,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACxB,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,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,2DAA2D;YAC3D,0EAA0E;YAC1E,4EAA4E;YAC5E,2EAA2E;YAC3E,sEAAsE;YACtE,iCAAiC;QACnC,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,eAAe,CACpB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,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/context/shared.js

@@ -0,0 +1,61 @@
+// Shared plumbing for the curated context tools.
+//
+// Every context tool follows the same relay shape: 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 exactly once so the five tools stay thin (just
+// "build the request") and so curated + generic surfaces map matcher errors
+// through the identical path (toToolError) — the whole point of the curated
+// pattern established in Phase 1.
+//
+// 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 context tool input carries one. The
+// `contextId` forwarded into the path 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';
+/** Base path for the reconciliation-context resource (tenant-scoped; tenant from the token). */
+export const CONTEXTS_PATH = '/v1/contexts';
+/** Build the single-context sub-path, URL-encoding the id so reserved chars are safe. */
+export function contextPath(contextId) {
+    return `${CONTEXTS_PATH}/${encodeURIComponent(contextId)}`;
+}
+/**
+ * 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 dispatchContext(request, extra, clientFor = requireMatcherClient) {
+    let client;
+    try {
+        // Fail-closed on a missing / empty / non-Bearer credential.
+        client = clientFor(extra);
+    }
+    catch (err) {
+        if (err instanceof UnauthenticatedError) {
+            return { isError: true, content: [{ type: 'text', text: err.message }] };
+        }
+        throw err;
+    }
+    try {
+        const result = await client.request(request);
+        // Success → matcher's JSON returned as-is (incl. pagination envelopes and
+        // 204 → null for delete).
+        return { content: [{ type: 'text', text: JSON.stringify(result ?? null) }] };
+    }
+    catch (err) {
+        // RFC 9457 problem → the SHARED structured tool error (status/title/detail/
+        // code preserved). A non-matcher error is a bug, not a matcher failure, and
+        // is re-thrown rather than masqueraded as one.
+        if (isMatcherApiError(err)) {
+            return toToolError(err);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/context/shared.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,wEAAwE;AACxE,2EAA2E;AAC3E,iFAAiF;AACjF,iFAAiF;AACjF,4EAA4E;AAC5E,4EAA4E;AAC5E,kCAAkC;AAClC,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,oCAAoC;AAIpC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAA;AAE3C,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,GAAG,aAAa,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,KAAmC,EACnC,YAAyD,oBAAoB;IAE7E,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;QAC1E,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,0EAA0E;QAC1E,0BAA0B;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,4EAA4E;QAC5E,+CAA+C;QAC/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/tools/context/update.js

@@ -0,0 +1,105 @@
+// `context_update` — curated PATCH /v1/contexts/{contextId}.
+//
+// Partial update of a reconciliation context's fields, mirroring the spec's
+// UpdateContextRequest. All body fields are optional (PATCH semantics). The
+// status enum here is the set of *transition targets* (ACTIVE|PAUSED|ARCHIVED) —
+// narrower than the list filter (which also allows DRAFT) because you cannot
+// transition a context back to DRAFT. Transitions to ACTIVE are gated on
+// server-side activation readiness; an unready context is rejected with a 409
+// that surfaces verbatim through the shared toToolError. contextId is a UUID
+// path param; no tenant field is accepted (matcher scopes to the relayed token's
+// tenant).
+import { z } from 'zod';
+import { CONTEXT_TYPES, FEE_NORMALIZATIONS } from './create.js';
+import { contextPath, dispatchContext } from './shared.js';
+/**
+ * Lifecycle statuses an update may transition a context to. Narrower than the
+ * list filter's CONTEXT_STATUSES: DRAFT is the unactivated initial state and is
+ * not a valid transition target.
+ */
+export const CONTEXT_STATUS_TRANSITIONS = ['ACTIVE', 'PAUSED', 'ARCHIVED'];
+/** Zod raw shape for `context_update` input — id (path) + optional fields. */
+export const updateContextInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to update.'),
+    name: z
+        .string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('New human-readable name of the context (1–100 chars).'),
+    type: z
+        .enum(CONTEXT_TYPES)
+        .optional()
+        .describe('Reconciliation topology. "1:1" matches one left transaction to one ' +
+        'right; "1:N" matches one against many; "N:M" matches groups on both ' +
+        'sides. The values contain colons.'),
+    interval: z
+        .string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('New execution interval label, e.g. "weekly" (1–100 chars).'),
+    status: z
+        .enum(CONTEXT_STATUS_TRANSITIONS)
+        .optional()
+        .describe('Lifecycle status to transition to. ACTIVE runs the context (gated on ' +
+        'server-side activation readiness — an unready context is rejected with ' +
+        'a 409); PAUSED suspends scheduling; ARCHIVED retires it. You cannot ' +
+        'transition back to DRAFT.'),
+    autoMatchOnUpload: z
+        .boolean()
+        .optional()
+        .describe('When true, a match run is triggered automatically after a file upload ' +
+        'completes.'),
+    feeNormalization: z
+        .enum(FEE_NORMALIZATIONS)
+        .optional()
+        .describe('Fee normalization mode. NET compares amounts after fees are deducted; ' +
+        'GROSS compares amounts before fees.'),
+    feeToleranceAbs: z
+        .string()
+        .optional()
+        .describe('Absolute fee tolerance as a decimal STRING in the context currency, ' +
+        'e.g. "0.01".'),
+    feeTolerancePct: z
+        .string()
+        .optional()
+        .describe('Percentage fee tolerance as a decimal STRING (0.5 means 0.5%), e.g. "0.5".'),
+};
+/**
+ * Build the PATCH body from the input minus the path-only `contextId`. Only the
+ * fields the caller actually set are sent — matcher treats absent fields as
+ * unchanged.
+ */
+export function buildUpdateBody(args) {
+    const { contextId: _contextId, ...body } = args;
+    void _contextId;
+    return body;
+}
+/**
+ * Register `context_update`. Splits the id (path) from the body fields,
+ * dispatches a PATCH through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError.
+ */
+export function registerContextUpdateTool(server) {
+    server.registerTool('context_update', {
+        description: 'Update fields of a reconciliation context by id (UUID). All fields are ' +
+            'optional (PATCH): name, type ("1:1"|"1:N"|"N:M"), interval, status ' +
+            '(ACTIVE|PAUSED|ARCHIVED — transitioning to ACTIVE is gated on activation ' +
+            'readiness and may return 409), autoMatchOnUpload, feeNormalization ' +
+            '(NET|GROSS), feeToleranceAbs/feeTolerancePct (decimal strings). No tenant ' +
+            'field is accepted. Returns the updated context, or a structured RFC 9457 ' +
+            'error.',
+        inputSchema: updateContextInputShape,
+    }, async (args, extra) => {
+        return dispatchContext({
+            method: 'PATCH',
+            path: contextPath(args.contextId),
+            body: buildUpdateBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/tools/context/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/context/update.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,iFAAiF;AACjF,6EAA6E;AAC7E,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,iFAAiF;AACjF,WAAW;AAEX,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAEnF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE;QACnE,sEAAsE;QACtE,mCAAmC,CACtC;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,0BAA0B,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE;QACrE,yEAAyE;QACzE,sEAAsE;QACtE,2BAA2B,CAC9B;IACH,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,YAAY,CACf;IACH,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,kBAAkB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,qCAAqC,CACxC;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,cAAc,CACjB;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E,CAC7E;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,UAAU,CAAA;IACf,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,yEAAyE;YACzE,qEAAqE;YACrE,2EAA2E;YAC3E,qEAAqE;YACrE,4EAA4E;YAC5E,2EAA2E;YAC3E,QAAQ;QACV,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/dashboard/aggregates.js

@@ -0,0 +1,34 @@
+// `dashboard_aggregates` — curated GET /v1/reports/contexts/{contextId}/dashboard.
+//
+// The combined dashboard read: volume, match-rate, and SLA aggregates in one
+// payload (spec operationId getDashboardAggregates). Shares the family input
+// shape (contextId path + optional date_from/date_to/source_id query) and the
+// fail-closed relay. The report is implicitly tenant-scoped by the relayed
+// token; contextId is a routing path param and source_id a data filter — neither
+// is a tenant field, and no tenant field is accepted.
+import { buildDashboardQuery, contextDashboardPath, dashboardQueryInputShape, dispatchDashboard, } from './shared.js';
+/** Zod raw shape for `dashboard_aggregates` input — the shared dashboard shape. */
+export const dashboardAggregatesInputShape = dashboardQueryInputShape;
+/**
+ * Register `dashboard_aggregates`. Dispatches a GET to the context's dashboard
+ * base path with the optional date/source query and returns matcher's combined
+ * aggregates verbatim; a matcher error surfaces via the shared toToolError.
+ */
+export function registerDashboardAggregatesTool(server) {
+    server.registerTool('dashboard_aggregates', {
+        description: 'Get the combined dashboard aggregates (volume, match rate, and SLA) ' +
+            'for a reconciliation context. Pass contextId (UUID path param — not a ' +
+            'tenant field), and optionally date_from/date_to (YYYY-MM-DD; matcher ' +
+            'defaults to the last 30 days and caps the window at 90 days) and/or ' +
+            'source_id (UUID data filter). No tenant field is accepted.',
+        inputSchema: dashboardAggregatesInputShape,
+    }, async (args, extra) => {
+        const query = buildDashboardQuery(args);
+        return dispatchDashboard({
+            method: 'GET',
+            path: contextDashboardPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=aggregates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.js","sourceRoot":"","sources":["../../../src/tools/dashboard/aggregates.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,iFAAiF;AACjF,sDAAsD;AAItD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAA;AAErE;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,uEAAuE;YACvE,sEAAsE;YACtE,4DAA4D;QAC9D,WAAW,EAAE,6BAA6B;KAC3C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;YAC1C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/dashboard/cash-impact.js

@@ -0,0 +1,36 @@
+// `dashboard_cash_impact` — curated GET
+// /v1/reports/contexts/{contextId}/dashboard/cash-impact.
+//
+// Unreconciled financial exposure with currency and age breakdowns (spec
+// operationId getCashImpactSummary). Shares the family input shape (contextId
+// path + optional date_from/date_to/source_id query) and the fail-closed relay.
+// contextId is a routing path param and source_id a data filter — neither is a
+// tenant field, and no tenant field is accepted.
+import { buildDashboardQuery, contextDashboardSlicePath, dashboardQueryInputShape, dispatchDashboard, } from './shared.js';
+/** Zod raw shape for `dashboard_cash_impact` input — the shared dashboard shape. */
+export const dashboardCashImpactInputShape = dashboardQueryInputShape;
+/**
+ * Register `dashboard_cash_impact`. Dispatches a GET to the context's
+ * /dashboard/cash-impact slice with the optional date/source query and returns
+ * matcher's exposure summary verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerDashboardCashImpactTool(server) {
+    server.registerTool('dashboard_cash_impact', {
+        description: 'Get the cash-impact summary (unreconciled financial exposure, with ' +
+            'currency and age breakdowns) for a reconciliation context. Pass ' +
+            'contextId (UUID path param — not a tenant field), and optionally ' +
+            'date_from/date_to (YYYY-MM-DD; matcher defaults to the last 30 days and ' +
+            'caps the window at 90 days) and/or source_id (UUID data filter). No ' +
+            'tenant field is accepted.',
+        inputSchema: dashboardCashImpactInputShape,
+    }, async (args, extra) => {
+        const query = buildDashboardQuery(args);
+        return dispatchDashboard({
+            method: 'GET',
+            path: contextDashboardSlicePath(args.contextId, 'cash-impact'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=cash-impact.js.map

package/dist/tools/dashboard/cash-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cash-impact.js","sourceRoot":"","sources":["../../../src/tools/dashboard/cash-impact.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,iDAAiD;AAIjD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,oFAAoF;AACpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAA;AAErE;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,qEAAqE;YACrE,kEAAkE;YAClE,mEAAmE;YACnE,0EAA0E;YAC1E,sEAAsE;YACtE,2BAA2B;QAC7B,WAAW,EAAE,6BAA6B;KAC3C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC;YAC9D,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/dashboard/index.js

@@ -0,0 +1,27 @@
+// Curated dashboard vertical: seven typed reads over the matcher reporting
+// dashboard surface — the combined aggregates plus six focused slices
+// (cash-impact, match-rate, metrics, sla, source-breakdown, volume). Every op is
+// a context-nested GET sharing one input shape (contextId path + optional
+// date_from/date_to/source_id query) and 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; contextId is a routing path param matcher validates against the relayed
+// token's tenant, and source_id is a data filter.
+import { registerDashboardAggregatesTool } from './aggregates.js';
+import { registerDashboardCashImpactTool } from './cash-impact.js';
+import { registerDashboardMatchRateTool } from './match-rate.js';
+import { registerDashboardMetricsTool } from './metrics.js';
+import { registerDashboardSlaTool } from './sla.js';
+import { registerDashboardSourceBreakdownTool } from './source-breakdown.js';
+import { registerDashboardVolumeTool } from './volume.js';
+/** Register all seven curated dashboard tools on the given server. */
+export function registerDashboardTools(server) {
+    registerDashboardAggregatesTool(server);
+    registerDashboardCashImpactTool(server);
+    registerDashboardMatchRateTool(server);
+    registerDashboardMetricsTool(server);
+    registerDashboardSlaTool(server);
+    registerDashboardSourceBreakdownTool(server);
+    registerDashboardVolumeTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/dashboard/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sEAAsE;AACtE,iFAAiF;AACjF,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,iFAAiF;AACjF,kDAAkD;AAIlD,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,8BAA8B,CAAC,MAAM,CAAC,CAAA;IACtC,4BAA4B,CAAC,MAAM,CAAC,CAAA;IACpC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,oCAAoC,CAAC,MAAM,CAAC,CAAA;IAC5C,2BAA2B,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC"}

package/dist/tools/dashboard/match-rate.js

@@ -0,0 +1,35 @@
+// `dashboard_match_rate` — curated GET
+// /v1/reports/contexts/{contextId}/dashboard/match-rate.
+//
+// Match-rate percentage and trend data over the window (spec operationId
+// getMatchRateStats). Shares the family input shape (contextId path + optional
+// date_from/date_to/source_id query) and the fail-closed relay. contextId is a
+// routing path param and source_id a data filter — neither is a tenant field,
+// and no tenant field is accepted.
+import { buildDashboardQuery, contextDashboardSlicePath, dashboardQueryInputShape, dispatchDashboard, } from './shared.js';
+/** Zod raw shape for `dashboard_match_rate` input — the shared dashboard shape. */
+export const dashboardMatchRateInputShape = dashboardQueryInputShape;
+/**
+ * Register `dashboard_match_rate`. Dispatches a GET to the context's
+ * /dashboard/match-rate slice with the optional date/source query and returns
+ * matcher's match-rate stats verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerDashboardMatchRateTool(server) {
+    server.registerTool('dashboard_match_rate', {
+        description: 'Get the match-rate statistics (percentage plus trend) for a ' +
+            'reconciliation context. Pass contextId (UUID path param — not a tenant ' +
+            'field), and optionally date_from/date_to (YYYY-MM-DD; matcher defaults ' +
+            'to the last 30 days and caps the window at 90 days) and/or source_id ' +
+            '(UUID data filter). No tenant field is accepted.',
+        inputSchema: dashboardMatchRateInputShape,
+    }, async (args, extra) => {
+        const query = buildDashboardQuery(args);
+        return dispatchDashboard({
+            method: 'GET',
+            path: contextDashboardSlicePath(args.contextId, 'match-rate'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=match-rate.js.map

package/dist/tools/dashboard/match-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-rate.js","sourceRoot":"","sources":["../../../src/tools/dashboard/match-rate.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,yDAAyD;AACzD,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,mCAAmC;AAInC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,mFAAmF;AACnF,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,8DAA8D;YAC9D,yEAAyE;YACzE,yEAAyE;YACzE,uEAAuE;YACvE,kDAAkD;QACpD,WAAW,EAAE,4BAA4B;KAC1C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,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/dashboard/metrics.js

@@ -0,0 +1,36 @@
+// `dashboard_metrics` — curated GET
+// /v1/reports/contexts/{contextId}/dashboard/metrics.
+//
+// The complete Command Center metrics: summary, trends, and breakdowns in one
+// payload (spec operationId getMatcherDashboardMetrics). Shares the family input
+// shape (contextId path + optional date_from/date_to/source_id query) and the
+// fail-closed relay. contextId is a routing path param and source_id a data
+// filter — neither is a tenant field, and no tenant field is accepted.
+import { buildDashboardQuery, contextDashboardSlicePath, dashboardQueryInputShape, dispatchDashboard, } from './shared.js';
+/** Zod raw shape for `dashboard_metrics` input — the shared dashboard shape. */
+export const dashboardMetricsInputShape = dashboardQueryInputShape;
+/**
+ * Register `dashboard_metrics`. Dispatches a GET to the context's
+ * /dashboard/metrics slice with the optional date/source query and returns
+ * matcher's comprehensive metrics verbatim; a matcher error surfaces via the
+ * shared toToolError.
+ */
+export function registerDashboardMetricsTool(server) {
+    server.registerTool('dashboard_metrics', {
+        description: 'Get the comprehensive Command Center dashboard metrics (summary, ' +
+            'trends, and breakdowns) for a reconciliation context. Pass contextId ' +
+            '(UUID path param — not a tenant field), and optionally date_from/' +
+            'date_to (YYYY-MM-DD; matcher defaults to the last 30 days and caps the ' +
+            'window at 90 days) and/or source_id (UUID data filter). No tenant field ' +
+            'is accepted.',
+        inputSchema: dashboardMetricsInputShape,
+    }, async (args, extra) => {
+        const query = buildDashboardQuery(args);
+        return dispatchDashboard({
+            method: 'GET',
+            path: contextDashboardSlicePath(args.contextId, 'metrics'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/tools/dashboard/metrics.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AAIvE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAA;AAElE;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,mEAAmE;YACnE,uEAAuE;YACvE,mEAAmE;YACnE,yEAAyE;YACzE,0EAA0E;YAC1E,cAAc;QAChB,WAAW,EAAE,0BAA0B;KACxC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,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"}