@lerianstudio/matcher-mcp 1.0.0-beta.5

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

@@ -0,0 +1,46 @@
+// `report_export_exceptions` — curated GET
+// /v1/reports/contexts/{contextId}/exceptions/export.
+//
+// Synchronously exports the exceptions report as a single base64-encoded file
+// (CSV or PDF) for the given date window. This is an HTTP GET — the date filter
+// and the csv|pdf format are query params, not a POST body. matcher returns the
+// file as a base64 STRING inline in the JSON response; the dispatch passes it
+// through verbatim (it is NOT decoded here — the caller decodes it). The export
+// 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 { buildReportExportQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportFormatInputShape, } from './shared.js';
+/** Zod raw shape for `report_export_exceptions` input — contextId path + filter + format. */
+export const exportExceptionsInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose exceptions to export. ' +
+        'Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportFormatInputShape,
+};
+/**
+ * Register `report_export_exceptions`. Passes the date filter + format through
+ * and returns matcher's base64 file string verbatim (the caller decodes it); a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerReportExportExceptionsTool(server) {
+    server.registerTool('report_export_exceptions', {
+        description: 'Export the exceptions report for a context within a date window as a ' +
+            'CSV or PDF file. Pass contextId (UUID path param — not a tenant field), ' +
+            'and optionally date_from/date_to (YYYY-MM-DD, window ≤ 90 days), ' +
+            'source_id, and format (csv|pdf, default csv). The result is a ' +
+            'base64-encoded string — decode it to recover the file bytes. No tenant ' +
+            'field is accepted.',
+        inputSchema: exportExceptionsInputShape,
+    }, async (args, extra) => {
+        const query = buildReportExportQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'exceptions/export'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=export-exceptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-exceptions.js","sourceRoot":"","sources":["../../../src/tools/report/export-exceptions.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,6FAA6F;AAC7F,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,mEAAmE;QACjE,yCAAyC,CAC5C;IACH,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,MAAiB;IAClE,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,WAAW,EACT,uEAAuE;YACvE,0EAA0E;YAC1E,mEAAmE;YACnE,gEAAgE;YAChE,yEAAyE;YACzE,oBAAoB;QACtB,WAAW,EAAE,0BAA0B;KACxC,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,mBAAmB,CAAC;YAC5D,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/export-matched.js

@@ -0,0 +1,47 @@
+// `report_export_matched` — curated GET
+// /v1/reports/contexts/{contextId}/matched/export.
+//
+// Synchronously exports the matched-transactions report as a single
+// base64-encoded file (CSV or PDF) for the given date window. This is an HTTP
+// GET — the date filter and the csv|pdf format are query params, not a POST
+// body. matcher returns the file as a base64 STRING inline in the JSON
+// response; the dispatch passes it through verbatim (it is NOT decoded here —
+// the caller decodes it). The export 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 { buildReportExportQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportFormatInputShape, } from './shared.js';
+/** Zod raw shape for `report_export_matched` input — contextId path + filter + format. */
+export const exportMatchedInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose matched transactions to ' +
+        'export. Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportFormatInputShape,
+};
+/**
+ * Register `report_export_matched`. Passes the date filter + format through and
+ * returns matcher's base64 file string verbatim (the caller decodes it); a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerReportExportMatchedTool(server) {
+    server.registerTool('report_export_matched', {
+        description: 'Export the matched-transactions report for a context within a date ' +
+            'window as a CSV or PDF file. Pass contextId (UUID path param — not a ' +
+            'tenant field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ ' +
+            '90 days), source_id, and format (csv|pdf, default csv). The result is a ' +
+            'base64-encoded string — decode it to recover the file bytes. No tenant ' +
+            'field is accepted.',
+        inputSchema: exportMatchedInputShape,
+    }, async (args, extra) => {
+        const query = buildReportExportQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'matched/export'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=export-matched.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-matched.js","sourceRoot":"","sources":["../../../src/tools/report/export-matched.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,qBAAqB;AAErB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,qEAAqE;QACnE,iDAAiD,CACpD;IACH,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,yEAAyE;YACzE,oBAAoB;QACtB,WAAW,EAAE,uBAAuB;KACrC,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,gBAAgB,CAAC;YACzD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/report/export-summary.js

@@ -0,0 +1,47 @@
+// `report_export_summary` — curated GET
+// /v1/reports/contexts/{contextId}/summary/export.
+//
+// Synchronously exports the reconciliation summary report as a single
+// base64-encoded file (CSV or PDF) for the given date window. This is an HTTP
+// GET — the date filter and the csv|pdf format are query params, not a POST
+// body. matcher returns the file as a base64 STRING inline in the JSON
+// response; the dispatch passes it through verbatim (it is NOT decoded here —
+// the caller decodes it). The export 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 { buildReportExportQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportFormatInputShape, } from './shared.js';
+/** Zod raw shape for `report_export_summary` input — contextId path + filter + format. */
+export const exportSummaryInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to export the summary for. Routing ' +
+        'path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportFormatInputShape,
+};
+/**
+ * Register `report_export_summary`. Passes the date filter + format through and
+ * returns matcher's base64 file string verbatim (the caller decodes it); a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerReportExportSummaryTool(server) {
+    server.registerTool('report_export_summary', {
+        description: 'Export the reconciliation summary report for a context within a date ' +
+            'window as a CSV or PDF file. Pass contextId (UUID path param — not a ' +
+            'tenant field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ ' +
+            '90 days), source_id, and format (csv|pdf, default csv). The result is a ' +
+            'base64-encoded string — decode it to recover the file bytes. No tenant ' +
+            'field is accepted.',
+        inputSchema: exportSummaryInputShape,
+    }, async (args, extra) => {
+        const query = buildReportExportQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'summary/export'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=export-summary.js.map

package/dist/tools/report/export-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-summary.js","sourceRoot":"","sources":["../../../src/tools/report/export-summary.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,mDAAmD;AACnD,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,qBAAqB;AAErB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,iCAAiC,CACpC;IACH,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,uEAAuE;YACvE,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,yEAAyE;YACzE,oBAAoB;QACtB,WAAW,EAAE,uBAAuB;KACrC,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,gBAAgB,CAAC;YACzD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/report/export-unmatched.js

@@ -0,0 +1,47 @@
+// `report_export_unmatched` — curated GET
+// /v1/reports/contexts/{contextId}/unmatched/export.
+//
+// Synchronously exports the unmatched-transactions report as a single
+// base64-encoded file (CSV or PDF) for the given date window. This is an HTTP
+// GET — the date filter and the csv|pdf format are query params, not a POST
+// body. matcher returns the file as a base64 STRING inline in the JSON
+// response; the dispatch passes it through verbatim (it is NOT decoded here —
+// the caller decodes it). The export 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 { buildReportExportQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportFormatInputShape, } from './shared.js';
+/** Zod raw shape for `report_export_unmatched` input — contextId path + filter + format. */
+export const exportUnmatchedInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose unmatched transactions to ' +
+        'export. Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportFormatInputShape,
+};
+/**
+ * Register `report_export_unmatched`. Passes the date filter + format through
+ * and returns matcher's base64 file string verbatim (the caller decodes it); a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerReportExportUnmatchedTool(server) {
+    server.registerTool('report_export_unmatched', {
+        description: 'Export the unmatched-transactions report for a context within a date ' +
+            'window as a CSV or PDF file. Pass contextId (UUID path param — not a ' +
+            'tenant field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ ' +
+            '90 days), source_id, and format (csv|pdf, default csv). The result is a ' +
+            'base64-encoded string — decode it to recover the file bytes. No tenant ' +
+            'field is accepted.',
+        inputSchema: exportUnmatchedInputShape,
+    }, async (args, extra) => {
+        const query = buildReportExportQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'unmatched/export'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=export-unmatched.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-unmatched.js","sourceRoot":"","sources":["../../../src/tools/report/export-unmatched.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,qBAAqB;AAErB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,4FAA4F;AAC5F,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,uEAAuE;QACrE,iDAAiD,CACpD;IACH,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,uEAAuE;YACvE,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,yEAAyE;YACzE,oBAAoB;QACtB,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/export-variance.js

@@ -0,0 +1,46 @@
+// `report_export_variance` — curated GET
+// /v1/reports/contexts/{contextId}/variance/export.
+//
+// Synchronously exports the variance analysis report as a single base64-encoded
+// file (CSV or PDF) for the given date window. This is an HTTP GET — the date
+// filter and the csv|pdf format are query params, not a POST body. matcher
+// returns the file as a base64 STRING inline in the JSON response; the dispatch
+// passes it through verbatim (it is NOT decoded here — the caller decodes it).
+// The export 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 { buildReportExportQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportFormatInputShape, } from './shared.js';
+/** Zod raw shape for `report_export_variance` input — contextId path + filter + format. */
+export const exportVarianceInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose variance rows to export. ' +
+        'Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportFormatInputShape,
+};
+/**
+ * Register `report_export_variance`. Passes the date filter + format through and
+ * returns matcher's base64 file string verbatim (the caller decodes it); a
+ * matcher error surfaces via the shared toToolError.
+ */
+export function registerReportExportVarianceTool(server) {
+    server.registerTool('report_export_variance', {
+        description: 'Export the variance analysis report for a context within a date ' +
+            'window as a CSV or PDF file. Pass contextId (UUID path param — not a ' +
+            'tenant field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ ' +
+            '90 days), source_id, and format (csv|pdf, default csv). The result is a ' +
+            'base64-encoded string — decode it to recover the file bytes. No tenant ' +
+            'field is accepted.',
+        inputSchema: exportVarianceInputShape,
+    }, async (args, extra) => {
+        const query = buildReportExportQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'variance/export'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=export-variance.js.map

package/dist/tools/report/export-variance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-variance.js","sourceRoot":"","sources":["../../../src/tools/report/export-variance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oDAAoD;AACpD,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB,2FAA2F;AAC3F,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,sEAAsE;QACpE,yCAAyC,CAC5C;IACH,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,kEAAkE;YAClE,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,yEAAyE;YACzE,oBAAoB;QACtB,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"}

package/dist/tools/report/index.js

@@ -0,0 +1,40 @@
+// Curated report vertical: thirteen typed tools over the matcher synchronous
+// reporting surface — the three paginated reads (matched/unmatched/variance),
+// the summary read, the four counts (exceptions/matched/unmatched/transactions),
+// and the five base64 exports (exceptions/matched/summary/unmatched/variance).
+// Every op is a context-nested HTTP GET under /v1/reports/contexts/{contextId}.
+// 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;
+// contextId is a routing path param matcher validates against the relayed
+// token's tenant.
+import { registerReportCountExceptionsTool } from './count-exceptions.js';
+import { registerReportCountMatchedTool } from './count-matched.js';
+import { registerReportCountTransactionsTool } from './count-transactions.js';
+import { registerReportCountUnmatchedTool } from './count-unmatched.js';
+import { registerReportExportExceptionsTool } from './export-exceptions.js';
+import { registerReportExportMatchedTool } from './export-matched.js';
+import { registerReportExportSummaryTool } from './export-summary.js';
+import { registerReportExportUnmatchedTool } from './export-unmatched.js';
+import { registerReportExportVarianceTool } from './export-variance.js';
+import { registerReportMatchedTool } from './matched.js';
+import { registerReportSummaryTool } from './summary.js';
+import { registerReportUnmatchedTool } from './unmatched.js';
+import { registerReportVarianceTool } from './variance.js';
+/** Register all thirteen curated report tools on the given server. */
+export function registerReportTools(server) {
+    registerReportMatchedTool(server);
+    registerReportUnmatchedTool(server);
+    registerReportVarianceTool(server);
+    registerReportSummaryTool(server);
+    registerReportCountExceptionsTool(server);
+    registerReportCountMatchedTool(server);
+    registerReportCountUnmatchedTool(server);
+    registerReportCountTransactionsTool(server);
+    registerReportExportExceptionsTool(server);
+    registerReportExportMatchedTool(server);
+    registerReportExportSummaryTool(server);
+    registerReportExportUnmatchedTool(server);
+    registerReportExportVarianceTool(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/report/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,kBAAkB;AAIlB,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAE1D,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,iCAAiC,CAAC,MAAM,CAAC,CAAA;IACzC,8BAA8B,CAAC,MAAM,CAAC,CAAA;IACtC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,mCAAmC,CAAC,MAAM,CAAC,CAAA;IAC3C,kCAAkC,CAAC,MAAM,CAAC,CAAA;IAC1C,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,+BAA+B,CAAC,MAAM,CAAC,CAAA;IACvC,iCAAiC,CAAC,MAAM,CAAC,CAAA;IACzC,gCAAgC,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC"}

package/dist/tools/report/matched.js

@@ -0,0 +1,44 @@
+// `report_matched` — curated GET /v1/reports/contexts/{contextId}/matched.
+//
+// Cursor-paginated matched transactions for a context within a date window.
+// date_from/date_to/source_id filter and cursor/limit/sort_order page; matcher's
+// { items, nextCursor } envelope is returned as-is — no auto-pagination (the
+// model re-calls with the returned cursor). The report 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 { buildReportPaginatedQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportPaginationInputShape, } from './shared.js';
+/** Zod raw shape for `report_matched` input — contextId path + filter + pagination. */
+export const matchedReportInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose matched transactions to ' +
+        'report. Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportPaginationInputShape,
+};
+/**
+ * Register `report_matched`. Passes the date filter + pagination through and
+ * returns matcher's pagination envelope verbatim; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerReportMatchedTool(server) {
+    server.registerTool('report_matched', {
+        description: 'List matched transactions for a context within a date window ' +
+            '(cursor-paginated). Pass contextId (UUID path param — not a tenant ' +
+            'field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ 90 ' +
+            'days), source_id, limit (1–200), sort_order (asc|desc), and/or cursor. ' +
+            'The response carries { items, nextCursor } — paginate by re-calling ' +
+            'with the returned nextCursor. No tenant field is accepted.',
+        inputSchema: matchedReportInputShape,
+    }, async (args, extra) => {
+        const query = buildReportPaginatedQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'matched'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=matched.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matched.js","sourceRoot":"","sources":["../../../src/tools/report/matched.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,iFAAiF;AACjF,6EAA6E;AAC7E,qEAAqE;AACrE,+EAA+E;AAC/E,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AAEpB,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,qEAAqE;QACnE,iDAAiD,CACpD;IACH,GAAG,sBAAsB;IACzB,GAAG,0BAA0B;CAC9B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,+DAA+D;YAC/D,qEAAqE;YACrE,oEAAoE;YACpE,yEAAyE;YACzE,sEAAsE;YACtE,4DAA4D;QAC9D,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAA;QAC7C,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;YAClD,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/shared.js

@@ -0,0 +1,176 @@
+// Shared plumbing for the curated report tools.
+//
+// Reports are synchronous, read-only analytics over a reconciliation context.
+// EVERY report op is fully context-nested under /v1/reports/contexts/{contextId}
+// and is an HTTP GET — including the exports, which take their knobs as query
+// params (not a POST body). The thirteen ops fall into three response shapes:
+//   - paginated lists (matched/unmatched/variance): the common date filter plus
+//     cursor/limit/sort_order, returning a { items, nextCursor } envelope;
+//   - the summary read and the four count ops: the common date filter only;
+//   - the five exports: the common date filter plus a csv|pdf format, returning
+//     a base64 STRING the caller must decode.
+//
+// This module factors the path builder, the three reusable query builders, and
+// the relay/error-mapping boilerplate exactly once so the thirteen tools stay
+// thin (just "name the suffix + pick the query builder"). The relay shape is
+// identical to the source / fee-schedule / match-rule verticals so curated and
+// generic surfaces map matcher errors through the same path (toToolError).
+//
+// Security: the bearer token is never read here directly — requireMatcherClient
+// owns the request-scoped relay and fails closed when no usable credential was
+// provided. No tenant identifier is ever read or injected (matcher derives
+// tenant from the relayed JWT); no report tool input carries one. The
+// `contextId` segment is a routing path param — matcher validates that the
+// context belongs to the token's tenant.
+import { z } from 'zod';
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Sort-order enum shared by the paginated report ops (created_at asc|desc). */
+export const REPORT_SORT_ORDERS = ['asc', 'desc'];
+/** Export-format enum shared by the five export ops (csv|pdf). */
+export const REPORT_EXPORT_FORMATS = ['csv', 'pdf'];
+/**
+ * Build a report path under a context, e.g.
+ * `/v1/reports/contexts/<id>/matched` or `.../matches/count`. The caller passes
+ * the suffix verbatim (the spec's count path for matched is `matches/count`, not
+ * `matched/count` — that asymmetry is encoded by each op, not hidden here). Only
+ * the contextId is URL-encoded; the suffix is a fixed literal owned by the op.
+ */
+export function contextReportPath(contextId, suffix) {
+    return `/v1/reports/contexts/${encodeURIComponent(contextId)}/${suffix}`;
+}
+/**
+ * The common date-window + source filter every report op accepts. Factored as a
+ * raw-shape fragment so each op's inputSchema spreads it in and stays focused on
+ * what is unique to that op. No tenant field — matcher scopes to the token.
+ */
+export const reportFilterInputShape = {
+    date_from: z
+        .string()
+        .optional()
+        .describe('Start date (YYYY-MM-DD), inclusive. Optional: defaults to 30 days before ' +
+        'date_to. The window may not exceed 90 days.'),
+    date_to: z
+        .string()
+        .optional()
+        .describe('End date (YYYY-MM-DD), inclusive. Optional: defaults to tomorrow (UTC). ' +
+        'The window may not exceed 90 days.'),
+    source_id: z
+        .string()
+        .optional()
+        .describe('Optional source id (UUID) filter.'),
+};
+/** The pagination + sort knobs the three "get report" list ops add on top. */
+export const reportPaginationInputShape = {
+    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).'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of records to return (1–200, default 20).'),
+    sort_order: z
+        .enum(REPORT_SORT_ORDERS)
+        .optional()
+        .describe('Sort order for created_at (asc|desc, default desc).'),
+};
+/** The export-format knob the five export ops add on top of the date filter. */
+export const reportFormatInputShape = {
+    format: z
+        .enum(REPORT_EXPORT_FORMATS)
+        .optional()
+        .describe('Export format (csv|pdf, default csv).'),
+};
+/** Append the date-window + source filter, omitting unset knobs. */
+function appendReportFilter(query, args) {
+    if (args.date_from !== undefined) {
+        query.date_from = args.date_from;
+    }
+    if (args.date_to !== undefined) {
+        query.date_to = args.date_to;
+    }
+    if (args.source_id !== undefined) {
+        query.source_id = args.source_id;
+    }
+}
+/**
+ * Build the query for a count or summary op: the date filter only. Returns
+ * undefined when nothing is set so the request URL stays bare.
+ */
+export function buildReportFilterQuery(args) {
+    const query = {};
+    appendReportFilter(query, args);
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Build the query for a paginated "get report" op: the date filter plus
+ * cursor/limit/sort_order. Returns undefined when nothing is set.
+ */
+export function buildReportPaginatedQuery(args) {
+    const query = {};
+    appendReportFilter(query, args);
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.sort_order !== undefined) {
+        query.sort_order = args.sort_order;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Build the query for an export op: the date filter plus the csv|pdf format.
+ * Returns undefined when nothing is set.
+ */
+export function buildReportExportQuery(args) {
+    const query = {};
+    appendReportFilter(query, args);
+    if (args.format !== undefined) {
+        query.format = args.format;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * 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 dispatchReport(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. Exports return a base64 STRING
+        // here verbatim (the caller decodes it); a 204/empty body → null.
+        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/report/shared.js.map

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

package/dist/tools/report/summary.js

@@ -0,0 +1,41 @@
+// `report_summary` — curated GET /v1/reports/contexts/{contextId}/summary.
+//
+// Aggregated summary statistics for a context within a date window. Takes only
+// the common date filter (date_from/date_to/source_id) — no pagination — and
+// returns matcher's SummaryReportResponse as-is. The report 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_summary` input — contextId path + date filter. */
+export const summaryReportInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to summarize. Routing path param, ' +
+        'not a tenant field.'),
+    ...reportFilterInputShape,
+};
+/**
+ * Register `report_summary`. Passes the date filter through and returns
+ * matcher's aggregated summary verbatim; a matcher error surfaces via the
+ * shared toToolError.
+ */
+export function registerReportSummaryTool(server) {
+    server.registerTool('report_summary', {
+        description: 'Get aggregated reconciliation summary statistics for a context within ' +
+            'a date window. Pass contextId (UUID path param — not a tenant field), ' +
+            'and optionally date_from/date_to (YYYY-MM-DD, window ≤ 90 days) and ' +
+            'source_id. Returns the summary totals, or a structured RFC 9457 error. ' +
+            'No tenant field is accepted.',
+        inputSchema: summaryReportInputShape,
+    }, async (args, extra) => {
+        const query = buildReportFilterQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'summary'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=summary.js.map

package/dist/tools/report/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/tools/report/summary.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,+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,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,qBAAqB,CACxB;IACH,GAAG,sBAAsB;CAC1B,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,wEAAwE;YACxE,wEAAwE;YACxE,sEAAsE;YACtE,yEAAyE;YACzE,8BAA8B;QAChC,WAAW,EAAE,uBAAuB;KACrC,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,SAAS,CAAC;YAClD,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/unmatched.js

@@ -0,0 +1,44 @@
+// `report_unmatched` — curated GET /v1/reports/contexts/{contextId}/unmatched.
+//
+// Cursor-paginated unmatched transactions for a context within a date window.
+// date_from/date_to/source_id filter and cursor/limit/sort_order page; matcher's
+// { items, nextCursor } envelope is returned as-is — no auto-pagination (the
+// model re-calls with the returned cursor). The report 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 { buildReportPaginatedQuery, contextReportPath, dispatchReport, reportFilterInputShape, reportPaginationInputShape, } from './shared.js';
+/** Zod raw shape for `report_unmatched` input — contextId path + filter + pagination. */
+export const unmatchedReportInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose unmatched transactions to ' +
+        'report. Routing path param, not a tenant field.'),
+    ...reportFilterInputShape,
+    ...reportPaginationInputShape,
+};
+/**
+ * Register `report_unmatched`. Passes the date filter + pagination through and
+ * returns matcher's pagination envelope verbatim; a matcher error surfaces via
+ * the shared toToolError.
+ */
+export function registerReportUnmatchedTool(server) {
+    server.registerTool('report_unmatched', {
+        description: 'List unmatched transactions for a context within a date window ' +
+            '(cursor-paginated). Pass contextId (UUID path param — not a tenant ' +
+            'field), and optionally date_from/date_to (YYYY-MM-DD, window ≤ 90 ' +
+            'days), source_id, limit (1–200), sort_order (asc|desc), and/or cursor. ' +
+            'The response carries { items, nextCursor } — paginate by re-calling ' +
+            'with the returned nextCursor. No tenant field is accepted.',
+        inputSchema: unmatchedReportInputShape,
+    }, async (args, extra) => {
+        const query = buildReportPaginatedQuery(args);
+        return dispatchReport({
+            method: 'GET',
+            path: contextReportPath(args.contextId, 'unmatched'),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=unmatched.js.map