@lerianstudio/matcher-mcp 5.0.0-beta.13 → 5.0.0-beta.131

package/dist/tools/report/shared.js

@@ -11,11 +11,13 @@
 //   - 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).
+// This module factors the path builder, the contextId field builder and the
+// three reusable query builders exactly once so each of the thirteen tools is
+// one table row in index.ts (just "name the suffix + pick the query builder").
+// The relay itself lives in shared-dispatch.ts, reached through the shared
+// registration loop and shared with 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
@@ -31,8 +33,8 @@
 // out explicitly so a model reads the warning before it reports a windowed
 // number as the whole reconciliation result.
 import { z } from 'zod';
-import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
-import { isMatcherApiError, toToolError } from '../tool-error.js';
+import { pageLimit, reportDateFrom, reportDateTo } from '../input-fields.js';
+import { pickQuery } from '../request-fields.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). */
@@ -47,27 +49,22 @@ export const REPORT_EXPORT_FORMATS = ['csv', 'pdf'];
 export function contextReportPath(contextId, suffix) {
     return `/v1/reports/contexts/${encodeURIComponent(contextId)}/${suffix}`;
 }
+/**
+ * Build a row's `contextId` path field. Every report op declares the same
+ * validation and differs only in the sentence naming what it reports on, so the
+ * description is supplied verbatim per row and nothing else is repeated.
+ */
+export function contextIdField(description) {
+    return z.string().min(1).describe(description);
+}
 /**
  * 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 — if omitted (with ' +
-        'date_to), matcher defaults to the last ~30 days, SILENTLY EXCLUDING ' +
-        'everything older. A windowed result is NOT "the reconciliation ' +
-        'result" — for a complete picture, pass an explicit date_from/date_to ' +
-        '(max 90-day span).'),
-    date_to: z
-        .string()
-        .optional()
-        .describe('End date (YYYY-MM-DD), inclusive. Optional — if omitted, matcher ' +
-        'defaults to tomorrow (UTC). Combined with an omitted date_from this ' +
-        'silently clips the window to the last ~30 days; pass an explicit ' +
-        'date_from/date_to (max 90-day span) for the full picture.'),
+    date_from: reportDateFrom,
+    date_to: reportDateTo,
     source_id: z
         .string()
         .optional()
@@ -80,13 +77,7 @@ export const reportPaginationInputShape = {
         .optional()
         .describe('Opaque pagination cursor from a prior response. Re-call with the ' +
         'returned pagination.next 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).'),
+    limit: pageLimit,
     sort_order: z
         .enum(REPORT_SORT_ORDERS)
         .optional()
@@ -99,91 +90,26 @@ export const reportFormatInputShape = {
         .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;
-    }
-}
+const REPORT_FILTER_KEYS = ['date_from', 'date_to', '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;
+    return pickQuery(args, REPORT_FILTER_KEYS);
 }
 /**
  * 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;
+    return pickQuery(args, [...REPORT_FILTER_KEYS, 'cursor', 'limit', 'sort_order']);
 }
 /**
  * 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;
-    }
+    return pickQuery(args, [...REPORT_FILTER_KEYS, 'format']);
 }
 //# sourceMappingURL=shared.js.map

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

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

package/dist/tools/request-fields.js

@@ -0,0 +1,17 @@
+/** Omit only unset knobs; keep zero and empty strings for Matcher to validate. */
+export function optionalQuery(fields) {
+    const entries = Object.entries(fields).filter(([, value]) => value !== undefined);
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+/** Explicit allowlist: routing ids and other input fields never leak into queries. */
+export function pickQuery(args, keys) {
+    return optionalQuery(Object.fromEntries(keys.map((key) => [key, args[key]])));
+}
+/** Preserve object-rest body semantics, including explicit undefined and null. */
+export function bodyWithout(args, keys) {
+    const body = { ...args };
+    for (const key of keys)
+        delete body[key];
+    return body;
+}
+//# sourceMappingURL=request-fields.js.map

package/dist/tools/request-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-fields.js","sourceRoot":"","sources":["../../src/tools/request-fields.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAC3B,MAAkC;IAElC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IACjF,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,SAAS,CACvB,IAAsC,EACtC,IAAoB;IAEpB,OAAO,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CACzB,IAAU,EACV,IAAoB;IAEpB,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/tools/shared-dispatch.js

@@ -0,0 +1,38 @@
+// Shared execution for curated tool families and the generic invoker.
+//
+// Curated families and the generic invoker all use the same relay contract:
+// resolve the request-scoped client, fail closed without a bearer credential,
+// return JSON on success, and preserve MatcherApiError details as structured
+// tool output. A caller may provide a result transform for tools whose product
+// contract projects the Matcher response (for example, matching rule stats).
+import { requireMatcherClient, UnauthenticatedError, } from '../auth/request-token.js';
+import { isMatcherApiError, toToolError } from './tool-error.js';
+/**
+ * Run one assembled request through the fail-closed relay and common tool
+ * result mapping. The optional transform is applied only after a successful
+ * Matcher response; errors always retain the shared structured shape.
+ */
+export async function dispatchToolRequest(request, extra, clientFor = requireMatcherClient, transform) {
+    let client;
+    try {
+        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);
+        const output = transform ? transform(result) : result;
+        return { content: [{ type: 'text', text: JSON.stringify(output ?? null) }] };
+    }
+    catch (err) {
+        if (isMatcherApiError(err)) {
+            return toToolError(err);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=shared-dispatch.js.map

package/dist/tools/shared-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-dispatch.js","sourceRoot":"","sources":["../../src/tools/shared-dispatch.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAG7E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAQhE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuB,EACvB,KAAmC,EACnC,YAAkC,oBAAoB,EACtD,SAA+B;IAE/B,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,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,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QACrD,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,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/source/create.js

@@ -11,7 +11,9 @@
 // relayed token's tenant), NOT a tenant field. No tenant field exists in the
 // schema: the source is created for the tenant of the relayed bearer token.
 import { z } from 'zod';
-import { contextSourcesPath, dispatchSource } from './shared.js';
+import { bodyWithout } from '../request-fields.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { contextSourcesPath } from './shared.js';
 /** Origin of the source data (LEDGER ledger / BANK feed / GATEWAY / CUSTOM / FETCHER pull). */
 export const SOURCE_TYPES = [
     'LEDGER',
@@ -22,6 +24,142 @@ export const SOURCE_TYPES = [
 ];
 /** Matching side this source feeds — the two sides reconciled against each other. */
 export const SOURCE_SIDES = ['LEFT', 'RIGHT'];
+// --- Reserved `config` vocabularies -----------------------------------------
+//
+// CLOSED, SLOW-MOVING ALGEBRAS, so they are modeled as closed Zod enums per the
+// enum policy (docs/enum-policy.md): a file encoding, a CSV delimiter, an ISO
+// 20022 element choice and a duplicate-collision strategy do not grow with the
+// connector roadmap. Each set is the one the OpenAPI contract publishes, which
+// the Go domain builds from its own vocabulary slices — so the parity gate keeps
+// these honest rather than a comment promising it.
+/** File character encoding. Default utf-8. */
+export const DIALECT_ENCODINGS = [
+    'utf-8',
+    'utf-8-sig',
+    'cp1252',
+    'iso-8859-1',
+];
+/** CSV field separator. Default comma. */
+export const DIALECT_DELIMITERS = ['comma', 'semicolon', 'tab', 'pipe'];
+/** Amount decimal convention: dot is 1234.56, comma is 1.234,56. Default dot. */
+export const DIALECT_DECIMAL_STYLES = ['dot', 'comma'];
+/** Date convention. Default iso. */
+export const DIALECT_DATE_STYLES = ['iso', 'iso_offset', 'dmy', 'mdy'];
+/**
+ * What happens to a row repeating the duplicate key. The default first, and all
+ * three offered with EQUAL WEIGHT: the tool adds no confirmation field, no second
+ * step and no extra permission around KEEP_FIRST. Describing what each one does
+ * is the tool's whole product; the enum's only job is refusing a fourth value
+ * before it costs a round trip.
+ */
+export const DUPLICATE_POLICIES = [
+    'FLAG_AS_EXCEPTION',
+    'KEEP_FIRST',
+    'REJECT',
+];
+/** The canonical field-map names a duplicate key may be built from. */
+export const DUPLICATE_KEY_FIELDS = [
+    'external_id',
+    'amount',
+    'currency',
+    'date',
+    'description',
+    'fee_amount',
+    'fee_currency',
+];
+/** What happens to a row whose mapped external id is blank. Default REJECT. */
+export const BLANK_EXTERNAL_ID_POLICIES = ['REJECT', 'NEEDS_REVIEW'];
+/** camt.053 entry-date element. Default booking. */
+export const CAMT053_DATE_BASES = ['booking', 'valuation'];
+/** camt.053 entry-reference element. Default ntry_ref. */
+export const CAMT053_EXTERNAL_ID_SOURCES = [
+    'ntry_ref',
+    'end_to_end_id',
+    'tx_id',
+];
+/**
+ * The source `config` object.
+ *
+ * `.passthrough()` is load-bearing, not laziness: the object stays OPEN because a
+ * source pulling from an aggregator or a fetcher carries connector keys nobody
+ * enumerates here (connection_config_name above all), and the contract keeps it
+ * open too. What the seven reserved keys buy is a local refusal — an operator
+ * driving this tool blind is told "DISCARD is not a duplicate policy" here rather
+ * than after a round trip.
+ *
+ * duplicate_key_changed_at is DELIBERATELY ABSENT from the seven, and the open
+ * object still accepts it. Not offering it is the whole signal: matcher stamps the
+ * key itself and discards a client-sent value, so nothing is gained by refusing it
+ * here — and something is lost. The key is published on RESPONSES, so an assistant
+ * that reads a source and sends the object back carries the stamp it was handed,
+ * and a local refusal would fail a payload the server accepts over a value the
+ * assistant never authored.
+ */
+export const sourceConfigSchema = z
+    .object({
+    dialect: z
+        .object({
+        encoding: z.enum(DIALECT_ENCODINGS).optional(),
+        delimiter: z.enum(DIALECT_DELIMITERS).optional(),
+        decimal_style: z.enum(DIALECT_DECIMAL_STYLES).optional(),
+        date_style: z.enum(DIALECT_DATE_STYLES).optional(),
+    })
+        .optional()
+        .describe("How this source's delimited files are encoded and formatted. " +
+        'Declaration-driven only — there is no auto-detection. An absent object, ' +
+        'or an absent sub-key, keeps the defaults (utf-8, comma, dot, iso).'),
+    duplicate_policy: z
+        .enum(DUPLICATE_POLICIES)
+        .optional()
+        .describe("What happens to a row that repeats this source's duplicate key. " +
+        'FLAG_AS_EXCEPTION (the default when the key is absent) keeps the repeat ' +
+        'out of the import and raises a duplicate exception on the row it ' +
+        'repeated. KEEP_FIRST drops the repeat and raises nothing, so the ' +
+        'collision leaves no trace anyone can act on. REJECT counts the repeat ' +
+        'as an import error.'),
+    duplicate_key: z
+        .array(z.enum(DUPLICATE_KEY_FIELDS))
+        .min(1)
+        .optional()
+        .describe('The ordered list of mapped fields that make two rows the same row. Omit ' +
+        'it and rows are deduplicated on external_id alone. A component this ' +
+        "source's field map does not fill is refused, because a key over an " +
+        'always-empty field makes every row a duplicate of every other. A source ' +
+        'bound to an aggregator connection (reserved key connection_config_name) ' +
+        'cannot carry a key of its own — the aggregator retracts a movement by ' +
+        'naming its external id, so that id has to stay the row identity, and a ' +
+        'config holding both is refused in either direction. Editing this list ' +
+        'governs later imports only: rows already imported keep the key they were ' +
+        'deduplicated under.'),
+    blank_external_id: z
+        .enum(BLANK_EXTERNAL_ID_POLICIES)
+        .optional()
+        .describe('What happens to a row whose mapped external id is blank. REJECT (the ' +
+        'default) fails the row. NEEDS_REVIEW imports it under a synthetic ' +
+        'reference with status PENDING_REVIEW, so a blank reference becomes a ' +
+        'reviewable import instead of an import failure.'),
+    camt053: z
+        .object({
+        date_basis: z.enum(CAMT053_DATE_BASES).optional(),
+        external_id_source: z.enum(CAMT053_EXTERNAL_ID_SOURCES).optional(),
+    })
+        .optional()
+        .describe("How this source's camt.053 files map onto the canonical fields; every " +
+        'other field is fixed by ISO 20022 itself. date_basis picks the entry ' +
+        'date (booking = BookgDt/Dt, valuation = ValDt/Dt); external_id_source ' +
+        'picks the reference (ntry_ref = NtryRef, end_to_end_id and tx_id read ' +
+        'NtryDtls/TxDtls/Refs). Absent keeps the ISO defaults (booking, ntry_ref).'),
+    fail_on_error_rate_percent: z
+        .number()
+        .int()
+        .min(1)
+        .max(99)
+        .optional()
+        .describe('Fail the whole import when the percentage of failed rows exceeds this ' +
+        'whole number. Absent means never auto-fail. The ceiling is 99, not 100: ' +
+        'the comparison is strict, so 100 could never fire.'),
+})
+    .passthrough();
 /** Zod raw shape for `source_create` input — mirrors CreateSourceRequest. */
 export const createSourceInputShape = {
     contextId: z
@@ -44,35 +182,20 @@ export const createSourceInputShape = {
         .enum(SOURCE_SIDES)
         .describe('Matching side this source feeds. LEFT and RIGHT are the two sides ' +
         'reconciled against each other.'),
-    config: z
-        .record(z.string(), z.unknown())
+    config: sourceConfigSchema
         .optional()
         .describe('Source-specific configuration object (connection and parsing settings). ' +
-        'Optional; defaults to an empty object server-side when omitted. Its ' +
-        'shape depends on the source type and is validated server-side. ' +
-        'Reserved key duplicate_key: the ordered list of mapped fields that ' +
-        'make two rows the same row (any of external_id, amount, currency, ' +
-        'date, description, fee_amount, fee_currency); omit it and rows are ' +
-        'deduplicated on external_id alone. A field the field map of this ' +
-        'source does not fill is refused. A source bound to an aggregator ' +
-        'connection (reserved key connection_config_name) cannot carry a ' +
-        'duplicate key of its own — the aggregator retracts a movement by ' +
-        'naming its external id, so that id has to stay the row identity; a ' +
-        'config holding both is refused, so drop duplicate_key or disconnect ' +
-        'the aggregator first. Reserved key duplicate_policy: what ' +
-        'happens to a row repeating that key — FLAG_AS_EXCEPTION (the default: ' +
-        'the repeat is kept out of the import and raised as a duplicate ' +
-        'exception on the row it repeated), KEEP_FIRST (dropped, nothing ' +
-        'raised) or REJECT (counted as an import error).'),
+        'Optional; defaults to an empty object server-side when omitted. The seven ' +
+        'reserved keys below are validated here AND server-side; any other key ' +
+        '(connector settings, connection_config_name for an aggregator-backed ' +
+        'source) is passed through untouched.'),
 };
 /**
  * Build the POST body from the input minus the path-only `contextId`. Only the
  * CreateSourceRequest fields are sent; contextId travels in the path.
  */
 export function buildCreateBody(args) {
-    const { contextId: _contextId, ...body } = args;
-    void _contextId;
-    return body;
+    return bodyWithout(args, ['contextId']);
 }
 /**
  * Register `source_create`. Substitutes contextId into the path, builds the body
@@ -93,7 +216,7 @@ export function registerSourceCreateTool(server) {
             'that contextId and perform the action it names, repeating until ready.',
         inputSchema: createSourceInputShape,
     }, async (args, extra) => {
-        return dispatchSource({
+        return dispatchToolRequest({
             method: 'POST',
             path: contextSourcesPath(args.contextId),
             body: buildCreateBody(args),

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

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/source/create.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,6EAA6E;AAC7E,gFAAgF;AAChF,mBAAmB;AACnB,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,+FAA+F;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,MAAM;IACN,SAAS;IACT,QAAQ;IACR,SAAS;CACD,CAAA;AAEV,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,OAAO,CAAU,CAAA;AAEtD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,wEAAwE;QACtE,yEAAyE;QACzE,iCAAiC,CACpC;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,QAAQ,CACP,2EAA2E;QACzE,0EAA0E;QAC1E,qCAAqC,CACxC;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,QAAQ,CACP,oEAAoE;QAClE,gCAAgC,CACnC;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E;QACxE,sEAAsE;QACtE,iEAAiE;QACjE,qEAAqE;QACrE,oEAAoE;QACpE,qEAAqE;QACrE,mEAAmE;QACnE,mEAAmE;QACnE,kEAAkE;QAClE,mEAAmE;QACnE,qEAAqE;QACrE,sEAAsE;QACtE,4DAA4D;QAC5D,wEAAwE;QACxE,iEAAiE;QACjE,kEAAkE;QAClE,iDAAiD,CACpD;CACJ,CAAA;AAOD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,UAAU,CAAA;IACf,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,oEAAoE;YACpE,4DAA4D;YAC5D,kEAAkE;YAClE,wEAAwE;YACxE,kDAAkD;YAClD,yEAAyE;YACzE,sEAAsE;YACtE,yEAAyE;YACzE,wEAAwE;QAC1E,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;YACxC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/source/create.ts"],"names":[],"mappings":"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"}

package/dist/tools/source/index.js

@@ -5,23 +5,111 @@
 // explicit that archiving reserves the source name until restore, a trap the
 // generic invoke surface left implicit.) Sources are fully context-nested on
 // every op (single-resource ops keep contextId, unlike fee-rules). Each tool
-// shares the fail-closed relay (shared.ts) and the RFC 9457 → tool-error mapping
-// (toToolError) with the generic surface, so curated and generic map matcher
-// errors identically. No tool carries a tenant field; contextId is a routing
-// path param matcher validates against the relayed token's tenant.
-import { registerSourceArchiveTool } from './archive.js';
+// shares the fail-closed relay (shared-dispatch.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.
+//
+// The three id-only tools (get, archive, restore) differ only in their name,
+// their method, their path suffix and their description, so they are declared
+// as three rows and registered by the one shared loop; create, list and update
+// carry request bodies or query builders and stay as files.
+import { z } from 'zod';
+import { registerCuratedTools } from '../curated-tool.js';
+import { contextRoutingId } from '../input-fields.js';
 import { registerSourceCreateTool } from './create.js';
-import { registerSourceGetTool } from './get.js';
 import { registerSourceListTool } from './list.js';
-import { registerSourceRestoreTool } from './restore.js';
+import { contextSourcePath } from './shared.js';
 import { registerSourceUpdateTool } from './update.js';
+/**
+ * The source registration list, IN PUBLISHED ORDER: thin tools inline as data
+ * rows, the tools that still need their own file by their register function.
+ * This list is the order `tools/list` returns, so moving an entry moves what a
+ * client renders and what an agent prompt built from it reads first.
+ *
+ * Every description string is the hand-tuned LLM guidance a client sees
+ * verbatim; the published-surface golden is what proves an edit here dropped no
+ * character and moved no tool.
+ *
+ * `source_get`'s text is where an operator reads the duplicate-key
+ * declaration back.
+ */
+const SOURCE_TOOLS = [
+    registerSourceCreateTool,
+    registerSourceListTool,
+    {
+        name: 'source_get',
+        description: 'Fetch a single reconciliation source by id (UUID) within a context. ' +
+            'Provide both contextId and sourceId (path params; contextId is not a ' +
+            "tenant field). The source must belong to your token's tenant. Returns " +
+            'the source, or a structured RFC 9457 error (e.g. 404 if it does not ' +
+            'exist or is not yours). In the returned config, duplicate_key is the ' +
+            'ordered list of mapped fields that make two rows the same row — absent ' +
+            'means rows are deduplicated on external_id alone — and ' +
+            'duplicate_key_changed_at is the server-set RFC 3339 moment ' +
+            'duplicate-key detection last changed meaning on this source: either ' +
+            'that list changing, or the field map remapping the column a declared ' +
+            'field reads. Rows imported before it keep the key they were ' +
+            'deduplicated under, so a duplicate straddling that moment is not ' +
+            'detected. duplicate_policy is what happens to a repeat: ' +
+            'FLAG_AS_EXCEPTION (the default), KEEP_FIRST or REJECT.',
+        inputShape: {
+            contextId: contextRoutingId,
+            sourceId: z
+                .string()
+                .min(1)
+                .describe('The reconciliation source id (UUID) to fetch.'),
+        },
+        request: (args) => ({
+            method: 'GET',
+            path: contextSourcePath(String(args.contextId), String(args.sourceId)),
+        }),
+    },
+    registerSourceUpdateTool,
+    {
+        name: 'source_archive',
+        description: 'Archive (soft-delete) a reconciliation source by id (UUID) within a ' +
+            "context. Archiving never erases the source's imported transactions " +
+            'or field map — the source is simply excluded from listings, readiness ' +
+            'counts, clone reads, and the matching working set. The archived name ' +
+            'stays reserved until you restore it, so you cannot create a new source ' +
+            'reusing that name in the context. Provide contextId and sourceId (path ' +
+            'params; contextId is not a tenant field). Returns no content (204), or ' +
+            'a structured RFC 9457 error.',
+        inputShape: {
+            contextId: contextRoutingId,
+            sourceId: z
+                .string()
+                .min(1)
+                .describe('The reconciliation source id (UUID) to archive.'),
+        },
+        request: (args) => ({
+            method: 'POST',
+            path: `${contextSourcePath(String(args.contextId), String(args.sourceId))}/archive`,
+        }),
+    },
+    {
+        name: 'source_restore',
+        description: 'Restore an archived reconciliation source by id (UUID) back into the ' +
+            'live working set, so it counts toward readiness and feeds matching ' +
+            'again. Provide contextId and sourceId (path params; contextId is not a ' +
+            'tenant field). Returns no content (204), or a structured RFC 9457 error.',
+        inputShape: {
+            contextId: contextRoutingId,
+            sourceId: z
+                .string()
+                .min(1)
+                .describe('The archived reconciliation source id (UUID) to restore.'),
+        },
+        request: (args) => ({
+            method: 'POST',
+            path: `${contextSourcePath(String(args.contextId), String(args.sourceId))}/restore`,
+        }),
+    },
+];
 /** Register all curated source tools on the given server. */
 export function registerSourceTools(server) {
-    registerSourceCreateTool(server);
-    registerSourceListTool(server);
-    registerSourceGetTool(server);
-    registerSourceUpdateTool(server);
-    registerSourceArchiveTool(server);
-    registerSourceRestoreTool(server);
+    registerCuratedTools(server, SOURCE_TOOLS);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/source/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,mEAAmE;AAInE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAC7B,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,yBAAyB,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/source/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,4DAA4D;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,oBAAoB,EAAqB,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,YAAY,GAA4B;IAC5C,wBAAwB;IACxB,sBAAsB;IACtB;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,sEAAsE;YACtE,uEAAuE;YACvE,wEAAwE;YACxE,sEAAsE;YACtE,uEAAuE;YACvE,yEAAyE;YACzE,yDAAyD;YACzD,6DAA6D;YAC7D,sEAAsE;YACtE,uEAAuE;YACvE,8DAA8D;YAC9D,mEAAmE;YACnE,0DAA0D;YAC1D,wDAAwD;QAC1D,UAAU,EAAE;YACV,SAAS,EAAE,gBAAgB;YAC3B,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,+CAA+C,CAAC;SAC7D;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACvE,CAAC;KACH;IACD,wBAAwB;IACxB;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,sEAAsE;YACtE,qEAAqE;YACrE,wEAAwE;YACxE,uEAAuE;YACvE,yEAAyE;YACzE,yEAAyE;YACzE,yEAAyE;YACzE,8BAA8B;QAChC,UAAU,EAAE;YACV,SAAS,EAAE,gBAAgB;YAC3B,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG,iBAAiB,CACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CACtB,UAAU;SACZ,CAAC;KACH;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,uEAAuE;YACvE,qEAAqE;YACrE,yEAAyE;YACzE,0EAA0E;QAC5E,UAAU,EAAE;YACV,SAAS,EAAE,gBAAgB;YAC3B,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,0DAA0D,CAAC;SACxE;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG,iBAAiB,CACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CACtB,UAAU;SACZ,CAAC;KACH;CACF,CAAA;AAED,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAC5C,CAAC"}