@lerianstudio/matcher-mcp 5.0.0-beta.67 → 5.0.0-beta.69

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

@@ -1,22 +1,139 @@
 // Curated match-rule vertical (task 2.1.2): six typed tools over the matcher
 // match-rule resource — create, list, get, update, delete, reorder. All ops are
 // fully context-nested (/v1/contexts/{contextId}/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.
-import { registerMatchRuleCreateTool } from './create.js';
-import { registerMatchRuleDeleteTool } from './delete.js';
-import { registerMatchRuleGetTool } from './get.js';
+// 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.
+//
+// create, get, delete and reorder are nothing but a rule path, a method, a
+// body-from-args and a description, so they are declared as four rows and
+// registered by the one shared loop; list and update carry query builders or
+// partial-update composition and stay as files.
+import { z } from 'zod';
+import { registerCuratedTools } from '../curated-tool.js';
+import { contextRoutingId } from '../input-fields.js';
 import { registerMatchRuleListTool } from './list.js';
-import { registerMatchRuleReorderTool } from './reorder.js';
+import { contextRulePath, contextRulesPath, contextRulesReorderPath, MATCH_RULE_TYPES, RULE_CONFIG_DESC_BODY, } from './shared.js';
 import { registerMatchRuleUpdateTool } from './update.js';
+/**
+ * Zod raw shape for `match_rule_create` input — mirrors CreateMatchRuleRequest.
+ * Exported because `spec/schema-parity.ts` diffs it against the vendored spec's
+ * request body; the row below is its only other consumer.
+ */
+export const createMatchRuleInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) the rule belongs to. Routing path ' +
+        'param, not a tenant field — matcher validates the context is yours.'),
+    priority: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .describe('Execution priority (1–1000); lower numbers run first. Must be unique ' +
+        'within the context.'),
+    type: z
+        .enum(MATCH_RULE_TYPES)
+        .describe('Matching strategy. EXACT requires identical field values; TOLERANCE ' +
+        'allows configured numeric slack; DATE_LAG allows a configured date ' +
+        'offset between sides; FUZZY matches on normalized/similarity-scored ' +
+        'references (free-text memos, truncated refs) and ALWAYS proposes for ' +
+        'review — never auto-confirms.'),
+    config: z
+        .record(z.string(), z.unknown())
+        .describe('Rule-specific ' + RULE_CONFIG_DESC_BODY),
+};
+/**
+ * Zod raw shape for `match_rule_reorder` input — context (path) + ordered
+ * ruleIds. Exported for the same parity diff as the create shape.
+ */
+export const reorderMatchRulesInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose rules to reorder. Routing path ' +
+        'param, not a tenant field.'),
+    ruleIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(100)
+        .describe('Ordered list of match rule UUIDs (1–100). Each rule’s new priority is ' +
+        'its position in this list: the first id runs first. Include every rule ' +
+        'you intend to reorder.'),
+};
+/**
+ * The match-rule 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.
+ */
+const MATCH_RULE_TOOLS = [
+    {
+        name: 'match_rule_create',
+        description: 'Create a match rule within a reconciliation context. Provide contextId ' +
+            '(UUID path), priority (1–1000, unique within the context), type ' +
+            '(EXACT|TOLERANCE|DATE_LAG|FUZZY), and config (a type-specific object validated ' +
+            'server-side). No tenant field is accepted — the rule is created for your ' +
+            "token's tenant. Returns the created rule, or a structured RFC 9457 error.",
+        inputShape: createMatchRuleInputShape,
+        request: (args) => {
+            // contextId routes; every other validated field is the body.
+            const { contextId, ...body } = args;
+            return { method: 'POST', path: contextRulesPath(String(contextId)), body };
+        },
+    },
+    registerMatchRuleListTool,
+    {
+        name: 'match_rule_get',
+        description: 'Fetch a single match rule by id (UUID) within a context (UUID). Both ' +
+            'the rule and its context must belong to your token. Returns the rule, ' +
+            'or a structured RFC 9457 error (e.g. 404 if it does not exist or is not ' +
+            'yours).',
+        inputShape: {
+            contextId: contextRoutingId,
+            ruleId: z.string().min(1).describe('The match rule id (UUID) to fetch.'),
+        },
+        request: (args) => ({
+            method: 'GET',
+            path: contextRulePath(String(args.contextId), String(args.ruleId)),
+        }),
+    },
+    registerMatchRuleUpdateTool,
+    {
+        name: 'match_rule_delete',
+        description: 'Delete a match rule by id (UUID) within a context (UUID). The rule and ' +
+            "its context must belong to your token's tenant (no tenant field is " +
+            'accepted). Returns no content on success, or a structured RFC 9457 error.',
+        inputShape: {
+            contextId: contextRoutingId,
+            ruleId: z.string().min(1).describe('The match rule id (UUID) to delete.'),
+        },
+        request: (args) => ({
+            method: 'DELETE',
+            path: contextRulePath(String(args.contextId), String(args.ruleId)),
+        }),
+    },
+    {
+        name: 'match_rule_reorder',
+        description: 'Reorder the match rules of a reconciliation context. Provide contextId ' +
+            '(UUID path) and ruleIds, an ordered array of rule UUIDs whose position ' +
+            'becomes the new priority (first = runs first). No tenant field is ' +
+            'accepted. Returns no content on success, or a structured RFC 9457 error.',
+        inputShape: reorderMatchRulesInputShape,
+        request: (args) => ({
+            method: 'POST',
+            path: contextRulesReorderPath(String(args.contextId)),
+            body: { ruleIds: args.ruleIds },
+        }),
+    },
+];
 /** Register all six curated match-rule tools on the given server. */
 export function registerMatchRuleTools(server) {
-    registerMatchRuleCreateTool(server);
-    registerMatchRuleListTool(server);
-    registerMatchRuleGetTool(server);
-    registerMatchRuleUpdateTool(server);
-    registerMatchRuleDeleteTool(server);
-    registerMatchRuleReorderTool(server);
+    registerCuratedTools(server, MATCH_RULE_TOOLS);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/match-rule/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,sDAAsD;AAItD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,4BAA4B,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/match-rule/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/match-rule/list.js

@@ -10,8 +10,8 @@ import { z } from 'zod';
 import { nextCursor, pageLimit } from '../input-fields.js';
 import { queryHandler } from '../query-handler.js';
 import { pickQuery } from '../request-fields.js';
-import { MATCH_RULE_TYPES } from './create.js';
-import { contextRulesPath, dispatchMatchRule } from './shared.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { contextRulesPath, MATCH_RULE_TYPES } from './shared.js';
 /** Zod raw shape for `match_rule_list` input — context, optional type filter, pagination. */
 export const listMatchRulesInputShape = {
     contextId: z
@@ -43,6 +43,6 @@ export function registerMatchRuleListTool(server) {
             'response carries { items, nextCursor } — paginate by re-calling with the ' +
             'returned nextCursor. No tenant field is accepted.',
         inputSchema: listMatchRulesInputShape,
-    }, queryHandler(buildListQuery, (args) => contextRulesPath(args.contextId), dispatchMatchRule));
+    }, queryHandler(buildListQuery, (args) => contextRulesPath(args.contextId), dispatchToolRequest));
 }
 //# sourceMappingURL=list.js.map

package/dist/tools/match-rule/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/match-rule/list.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,6EAA6E;AAC7E,wEAAwE;AACxE,iFAAiF;AACjF,4BAA4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEjE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,4BAA4B,CAC/B;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF,CACnF;IACH,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;CACnB,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAyB;IAC/C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,uEAAuE;YACvE,2DAA2D;YAC3D,6EAA6E;YAC7E,2EAA2E;YAC3E,mDAAmD;QACrD,WAAW,EAAE,wBAAwB;KACtC,EACD,YAAY,CACV,cAAc,EACd,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAC1C,iBAAiB,CAClB,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/match-rule/list.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,6EAA6E;AAC7E,wEAAwE;AACxE,iFAAiF;AACjF,4BAA4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEhE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yEAAyE;QACvE,4BAA4B,CAC/B;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF,CACnF;IACH,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;CACnB,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAyB;IAC/C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,uEAAuE;YACvE,2DAA2D;YAC3D,6EAA6E;YAC7E,2EAA2E;YAC3E,mDAAmD;QACrD,WAAW,EAAE,wBAAwB;KACtC,EACD,YAAY,CACV,cAAc,EACd,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAC1C,mBAAmB,CACpB,CACF,CAAA;AACH,CAAC"}

package/dist/tools/match-rule/shared.js

@@ -3,14 +3,11 @@
 // Match rules are fully context-nested: every op lives under
 // /v1/contexts/{contextId}/rules (list/create), .../rules/{ruleId}
 // (get/update/delete), and .../rules/reorder (the custom reorder action). This
-// module factors the path construction and the relay/error-mapping boilerplate
-// exactly once so the six tools stay thin — they only "build the request".
-//
-// The relay shape is identical to the fee-schedule vertical (task 1.3.2): fail
-// closed via requireMatcherClient, dispatch one assembled MatcherRequest, then
-// return matcher's JSON on success or the SHARED toToolError on a
-// MatcherApiError. Curated and generic surfaces therefore map matcher errors
-// through the same path.
+// module holds the path construction and nothing else, factored exactly once so
+// the four table rows in index.ts and the two tools that keep their own file
+// address the same URLs. The relay itself lives in shared-dispatch.ts, so
+// curated and generic surfaces map matcher errors through the identical 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
@@ -18,7 +15,6 @@
 // tenant from the relayed JWT); no match-rule tool input carries one. The
 // `contextId` segment is a routing path param — matcher validates that the
 // context belongs to the token's tenant.
-import { dispatchToolRequest, } from '../shared-dispatch.js';
 /** Path for the match-rule collection under a context (list + create). */
 export function contextRulesPath(contextId) {
     return `/v1/contexts/${encodeURIComponent(contextId)}/rules`;
@@ -31,6 +27,17 @@ export function contextRulePath(contextId, ruleId) {
 export function contextRulesReorderPath(contextId) {
     return `${contextRulesPath(contextId)}/reorder`;
 }
+/**
+ * Matching strategy vocabulary. EXACT / TOLERANCE / DATE_LAG / FUZZY (spec
+ * oneof), centralized here because create's input shape, list's filter and
+ * update's optional type all enumerate the same four values.
+ */
+export const MATCH_RULE_TYPES = [
+    'EXACT',
+    'TOLERANCE',
+    'DATE_LAG',
+    'FUZZY',
+];
 /**
  * Shared body of the `config` field description, centralized so create and
  * update stay in lockstep as the rule vocabulary grows. Callers prepend the
@@ -54,15 +61,4 @@ export const RULE_CONFIG_DESC_BODY = 'configuration object; shape depends on `ty
     'tolerance? }]). Optional across types: timezone (IANA zone), calendar ' +
     '(US_FED|BR_ANBIMA), businessDayMode (DATE_LAG only), and signMode ' +
     '(same|opposite|ignore).';
-/**
- * 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 dispatchMatchRule(request, extra, clientFor) {
-    return dispatchToolRequest(request, extra, clientFor);
-}
 //# sourceMappingURL=shared.js.map

package/dist/tools/match-rule/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/match-rule/shared.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,kEAAkE;AAClE,6EAA6E;AAC7E,yBAAyB;AACzB,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,yCAAyC;AAMzC,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAA;AAE9B,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAA;AAC9D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc;IAC/D,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;AACvE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAA;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,uDAAuD;IACvD,yEAAyE;IACzE,iEAAiE;IACjE,sEAAsE;IACtE,wEAAwE;IACxE,yEAAyE;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,yEAAyE;IACzE,uEAAuE;IACvE,iEAAiE;IACjE,kEAAkE;IAClE,wEAAwE;IACxE,oEAAoE;IACpE,yBAAyB,CAAA;AAE3B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,KAAmC,EACnC,SAAgC;IAEhC,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;AACvD,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/match-rule/shared.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,iBAAiB;AACjB,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,yCAAyC;AAEzC,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAA;AAC9D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc;IAC/D,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;AACvE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;IACP,WAAW;IACX,UAAU;IACV,OAAO;CACC,CAAA;AAEV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,uDAAuD;IACvD,yEAAyE;IACzE,iEAAiE;IACjE,sEAAsE;IACtE,wEAAwE;IACxE,yEAAyE;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,yEAAyE;IACzE,uEAAuE;IACvE,iEAAiE;IACjE,kEAAkE;IAClE,wEAAwE;IACxE,oEAAoE;IACpE,yBAAyB,CAAA"}

package/dist/tools/match-rule/update.js

@@ -7,8 +7,8 @@
 import { z } from 'zod';
 import { contextRoutingId } from '../input-fields.js';
 import { bodyWithout } from '../request-fields.js';
-import { MATCH_RULE_TYPES } from './create.js';
-import { contextRulePath, dispatchMatchRule, RULE_CONFIG_DESC_BODY, } from './shared.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { contextRulePath, MATCH_RULE_TYPES, RULE_CONFIG_DESC_BODY, } from './shared.js';
 /** Zod raw shape for `match_rule_update` input — ids (path) + optional fields. */
 export const updateMatchRuleInputShape = {
     contextId: contextRoutingId,
@@ -54,7 +54,7 @@ export function registerMatchRuleUpdateTool(server) {
             'RFC 9457 error.',
         inputSchema: updateMatchRuleInputShape,
     }, async (args, extra) => {
-        return dispatchMatchRule({
+        return dispatchToolRequest({
             method: 'PATCH',
             path: contextRulePath(args.contextId, args.ruleId),
             body: buildUpdateBody(args),

package/dist/tools/match-rule/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/match-rule/update.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,kEAAkE;AAElE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACzE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,qBAAqB,CACxB;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,qEAAqE;QACrE,4EAA4E,CAC/E;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,GAAG,qBAAqB,CAAC;CAC1D,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA0B;IAE1B,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,2EAA2E;YAC3E,oDAAoD;YACpD,mFAAmF;YACnF,yEAAyE;YACzE,iBAAiB;QACnB,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YAClD,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/match-rule/update.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,kEAAkE;AAElE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACzE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,qBAAqB,CACxB;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,qEAAqE;QACrE,4EAA4E,CAC/E;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,GAAG,qBAAqB,CAAC;CAC1D,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA0B;IAE1B,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,2EAA2E;YAC3E,oDAAoD;YACpD,mFAAmF;YACnF,yEAAyE;YACzE,iBAAiB;QACnB,WAAW,EAAE,yBAAyB;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,mBAAmB,CACxB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YAClD,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/matching/get.js

@@ -17,8 +17,8 @@
 // the right context. `contextId` is a routing param matcher validates ownership
 // of, NOT a tenant field; no tenant field is accepted.
 import { z } from 'zod';
-import { requireMatcherClient } from '../../auth/request-token.js';
-import { dispatchMatching, runPath, stripRuleStatKeys } from './shared.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { runPath, stripRuleStatKeys } from './shared.js';
 /** Zod raw shape for `match_run_get` input — runId (path) + contextId (query, required). */
 export const getMatchRunInputShape = {
     runId: z
@@ -33,12 +33,12 @@ export const getMatchRunInputShape = {
 };
 /**
  * Fetch the run and return it with `stats` cleaned of the dynamic per-rule
- * keys (see `stripRuleStatKeys`). Delegates to the shared `dispatchMatching`
+ * keys (see `stripRuleStatKeys`). Delegates to the shared `dispatchToolRequest`
  * relay (fail-closed auth, RFC 9457 → tool-error mapping) and passes a
  * success-body transform — the one matching read that post-processes the body.
  */
-function fetchAndCleanRun(runId, contextId, extra, clientFor = requireMatcherClient) {
-    return dispatchMatching({ method: 'GET', path: runPath(runId), query: { contextId } }, extra, clientFor, (run) => run !== undefined && run !== null
+function fetchAndCleanRun(runId, contextId, extra) {
+    return dispatchToolRequest({ method: 'GET', path: runPath(runId), query: { contextId } }, extra, undefined, (run) => run !== undefined && run !== null
         ? {
             ...run,
             stats: stripRuleStatKeys(run.stats),

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

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/matching/get.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,kEAAkE;AAClE,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,2EAA2E;AAC3E,+CAA+C;AAC/C,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,uDAAuD;AAEvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE1E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mCAAmC,CAAC;IAChD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,uDAAuD,CAC1D;CACJ,CAAA;AAOD;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,KAAa,EACb,SAAiB,EACjB,KAAmC,EACnC,YAAyD,oBAAoB;IAE7E,OAAO,gBAAgB,CACrB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAC7D,KAAK,EACL,SAAS,EACT,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAC/B,CAAC,CAAC;YACE,GAAI,GAA+B;YACnC,KAAK,EAAE,iBAAiB,CAAE,GAA+B,CAAC,KAAgC,CAAC;SAC5F;QACH,CAAC,CAAC,GAAG,CACV,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,oEAAoE;YACpE,2EAA2E;YAC3E,0EAA0E;YAC1E,wEAAwE;YACxE,wEAAwE;YACxE,oEAAoE;YACpE,qEAAqE;YACrE,uDAAuD;QACzD,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC5D,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/matching/get.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,kEAAkE;AAClE,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,2EAA2E;AAC3E,+CAA+C;AAC/C,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,uDAAuD;AAEvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAExD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mCAAmC,CAAC;IAChD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,uDAAuD,CAC1D;CACJ,CAAA;AAOD;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,KAAa,EACb,SAAiB,EACjB,KAAmC;IAEnC,OAAO,mBAAmB,CACxB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAC7D,KAAK,EACL,SAAS,EACT,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAC/B,CAAC,CAAC;YACE,GAAI,GAA+B;YACnC,KAAK,EAAE,iBAAiB,CAAE,GAA+B,CAAC,KAAgC,CAAC;SAC5F;QACH,CAAC,CAAC,GAAG,CACV,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,oEAAoE;YACpE,2EAA2E;YAC3E,0EAA0E;YAC1E,wEAAwE;YACxE,wEAAwE;YACxE,oEAAoE;YACpE,qEAAqE;YACrE,uDAAuD;QACzD,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC5D,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/matching/groups.js

@@ -12,7 +12,8 @@
 import { z } from 'zod';
 import { nextCursor, pageLimit } from '../input-fields.js';
 import { SORT_ORDERS } from './list.js';
-import { dispatchMatching, runGroupsPath } from './shared.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { runGroupsPath } from './shared.js';
 /** Sort fields matcher accepts for the run-groups listing. */
 export const GROUP_SORT_FIELDS = ['id', 'created_at', 'status'];
 /**
@@ -79,7 +80,7 @@ export function registerMatchRunGroupsTool(server) {
             'field is accepted.',
         inputSchema: getMatchRunGroupsInputShape,
     }, async (args, extra) => {
-        return dispatchMatching({
+        return dispatchToolRequest({
             method: 'GET',
             path: runGroupsPath(args.runId),
             query: buildGroupsQuery(args),

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

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

package/dist/tools/matching/index.js

@@ -5,15 +5,87 @@
 // RFC 9457 → tool-error mapping (toToolError) with every other curated surface,
 // so they map matcher errors identically. No tool carries a tenant field;
 // contextId is a routing param matcher validates ownership of.
+//
+// start is nothing but the context run path, a POST, a body built from the
+// validated args and a description, so it is declared as one row; list, get and
+// groups carry query builders or a result transform and stay as files. All four
+// sit in ONE ordered list, because that list IS the order `tools/list` publishes.
+import { z } from 'zod';
+import { registerCuratedTools } from '../curated-tool.js';
 import { registerMatchRunGroupsTool } from './groups.js';
 import { registerMatchRunGetTool } from './get.js';
 import { registerMatchRunListTool } from './list.js';
-import { registerMatchRunStartTool } from './start.js';
+import { contextRunPath } from './shared.js';
+/**
+ * Execution modes for a matching run.
+ *   - DRY_RUN tests the context's rules and reports what WOULD match without
+ *     committing any results.
+ *   - COMMIT executes the rules and persists the resulting matches.
+ */
+const RUN_MODES = ['DRY_RUN', 'COMMIT'];
+/**
+ * Zod raw shape for `match_run_start` input — contextId (path) + required mode.
+ * Exported because `spec/schema-parity.ts` diffs it against the vendored spec's
+ * RunMatchRequest; the row below is its only other consumer.
+ */
+export const startMatchRunInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to run matching for. Routing param; ' +
+        'matcher validates it belongs to your tenant.'),
+    mode: z
+        .enum(RUN_MODES)
+        .describe('Execution mode. DRY_RUN tests the rules without committing any matches; ' +
+        'COMMIT executes the rules and persists the resulting matches.'),
+    async: z
+        .boolean()
+        .optional()
+        .describe('Submit path (optional, default false). Both return 202 with ' +
+        '{ runId, status }; the status distinguishes them. Omit (or false) to ' +
+        'run in-request: the 202 carries the TERMINAL run (status COMPLETED or ' +
+        'FAILED). Set true to enqueue: the run is created QUEUED and a background ' +
+        'worker executes it — the 202 status is QUEUED and you poll match_run_get ' +
+        'with the runId until it reaches COMPLETED/FAILED.'),
+};
+/**
+ * The family's four tools in published order: the one thin row, then the three
+ * that keep their own file. Every description string is the hand-tuned LLM
+ * guidance a client sees verbatim; the published-surface golden is what proves
+ * an edit here did not drop a character, or move a tool.
+ */
+const MATCHING_TOOLS = [
+    {
+        name: 'match_run_start',
+        description: 'Trigger a matching run for a reconciliation context. Both submit paths ' +
+            'return 202 with { runId, status }; the status distinguishes them. Omit ' +
+            'async (or set false) to run in-request: the 202 carries the TERMINAL run ' +
+            '(status COMPLETED or FAILED). Set async:true to enqueue: the run is ' +
+            'created QUEUED and a background worker executes it (202 status QUEUED) — ' +
+            'poll match_run_get with the runId to follow progress (this tool does not ' +
+            'auto-poll). mode is required: DRY_RUN tests rules without committing, ' +
+            'COMMIT persists the matches. contextId is a routing param scoped to your ' +
+            'token (no tenant field is accepted). Returns the acceptance body, or a ' +
+            'structured RFC 9457 error (e.g. 422 when the rule set is not ' +
+            'stream-bounded and cannot run at unbounded scale).',
+        inputShape: startMatchRunInputShape,
+        request: (args) => ({
+            method: 'POST',
+            path: contextRunPath(String(args.contextId)),
+            // `async` is omitted unless the caller set it — RunMatchRequest forbids
+            // unknown properties, so the body stays exactly what was asked for.
+            body: {
+                mode: args.mode,
+                ...(args.async === undefined ? {} : { async: args.async }),
+            },
+        }),
+    },
+    registerMatchRunListTool,
+    registerMatchRunGetTool,
+    registerMatchRunGroupsTool,
+];
 /** Register all four curated match-run tools on the given server. */
 export function registerMatchingTools(server) {
-    registerMatchRunStartTool(server);
-    registerMatchRunListTool(server);
-    registerMatchRunGetTool(server);
-    registerMatchRunGroupsTool(server);
+    registerCuratedTools(server, MATCHING_TOOLS);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/matching/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,0EAA0E;AAC1E,+DAA+D;AAI/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/matching/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,0EAA0E;AAC1E,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,kFAAkF;AAElF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,oBAAoB,EAAqB,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAA;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2EAA2E;QACzE,8CAA8C,CACjD;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,QAAQ,CACP,0EAA0E;QACxE,+DAA+D,CAClE;IACH,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,8DAA8D;QAC5D,uEAAuE;QACvE,wEAAwE;QACxE,2EAA2E;QAC3E,2EAA2E;QAC3E,mDAAmD,CACtD;CACJ,CAAA;AAED;;;;;GAKG;AACH,MAAM,cAAc,GAA4B;IAC9C;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,yEAAyE;YACzE,yEAAyE;YACzE,2EAA2E;YAC3E,sEAAsE;YACtE,2EAA2E;YAC3E,2EAA2E;YAC3E,wEAAwE;YACxE,2EAA2E;YAC3E,yEAAyE;YACzE,+DAA+D;YAC/D,oDAAoD;QACtD,UAAU,EAAE,uBAAuB;QACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,wEAAwE;YACxE,oEAAoE;YACpE,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;aAC3D;SACF,CAAC;KACH;IACD,wBAAwB;IACxB,uBAAuB;IACvB,0BAA0B;CAC3B,CAAA;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAC9C,CAAC"}

package/dist/tools/matching/list.js

@@ -11,7 +11,8 @@ import { z } from 'zod';
 import { nextCursor, pageLimit } from '../input-fields.js';
 import { queryHandler } from '../query-handler.js';
 import { pickQuery } from '../request-fields.js';
-import { contextRunsPath, dispatchMatching } from './shared.js';
+import { dispatchToolRequest } from '../shared-dispatch.js';
+import { contextRunsPath } from './shared.js';
 /** Sort orders matcher accepts for the run-history listing. */
 export const SORT_ORDERS = ['asc', 'desc'];
 /** Zod raw shape for `match_run_list` input — contextId (path) + pagination/sort. */
@@ -47,6 +48,6 @@ export function registerMatchRunListTool(server) {
             'contextId is a routing param scoped to your token; no tenant field is ' +
             'accepted.',
         inputSchema: listMatchRunsInputShape,
-    }, queryHandler(buildListQuery, (args) => contextRunsPath(args.contextId), dispatchMatching));
+    }, queryHandler(buildListQuery, (args) => contextRunsPath(args.contextId), dispatchToolRequest));
 }
 //# sourceMappingURL=list.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/matching/list.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,uCAAuC;AAEvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE/D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAA;AAEnD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,qDAAqD,CACxD;IACH,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,eAAe,CAClB;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAwB;IAC9C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,uEAAuE;YACvE,0EAA0E;YAC1E,mEAAmE;YACnE,sEAAsE;YACtE,wEAAwE;YACxE,WAAW;QACb,WAAW,EAAE,uBAAuB;KACrC,EACD,YAAY,CACV,cAAc,EACd,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EACzC,gBAAgB,CACjB,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/matching/list.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,uCAAuC;AAEvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAA;AAEnD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,qDAAqD,CACxD;IACH,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,eAAe,CAClB;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAwB;IAC9C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,uEAAuE;YACvE,0EAA0E;YAC1E,mEAAmE;YACnE,sEAAsE;YACtE,wEAAwE;YACxE,WAAW;QACb,WAAW,EAAE,uBAAuB;KACrC,EACD,YAAY,CACV,cAAc,EACd,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EACzC,mBAAmB,CACpB,CACF,CAAA;AACH,CAAC"}

package/dist/tools/matching/shared.js

@@ -3,12 +3,11 @@
 // Unlike the configuration resources (fee schedules, rules, contexts, sources),
 // the match-run family is NOT CRUD — it is a set of action/read verbs over the
 // matcher engine: start a run, list a context's runs, read one run's results,
-// and page its match groups. They share the same relay shape as every other
-// curated tool: fail-closed auth via requireMatcherClient, dispatch one
-// assembled MatcherRequest, then return matcher's JSON on success or the SHARED
-// toToolError on a MatcherApiError. This module factors that boilerplate once so
-// the four tools stay thin (just "build the request") and so curated + generic
-// surfaces map matcher errors through the identical path (toToolError).
+// and page its match groups. This module holds the path helpers and the run
+// stats projection, and nothing else, factored exactly once so the four tools
+// address the same URLs. The relay itself lives in shared-dispatch.ts, so
+// curated and generic surfaces map matcher errors through the identical path
+// (toToolError).
 //
 // Two path families exist (mirroring the spec): runs are triggered/listed under
 // the context (`/v1/matching/contexts/{contextId}/...`), while a run's detail and
@@ -20,7 +19,6 @@
 // provided. No tenant identifier is ever read or injected (matcher derives
 // tenant from the relayed JWT); no match-run tool input carries one. `contextId`
 // is a routing param matcher validates ownership of, not a tenant field.
-import { dispatchToolRequest, } from '../shared-dispatch.js';
 /** Trigger path for a context's matching run: POST starts a run. */
 export function contextRunPath(contextId) {
     return `/v1/matching/contexts/${encodeURIComponent(contextId)}/run`;
@@ -65,15 +63,4 @@ export function stripRuleStatKeys(stats) {
     }
     return cleaned;
 }
-/**
- * Run one assembled request through the relay: fail-closed auth, dispatch, and
- * RFC 9457 → tool-error mapping — identical to the generic invoke's dispatch so
- * both surfaces produce the same structured error shape.
- *
- * `clientFor` is injectable for tests; production callers pass nothing and get
- * the request-scoped, fail-closed `requireMatcherClient`.
- */
-export async function dispatchMatching(request, extra, clientFor, transform) {
-    return dispatchToolRequest(request, extra, clientFor, transform);
-}
 //# sourceMappingURL=shared.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/matching/shared.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,wEAAwE;AACxE,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,iFAAiF;AACjF,yEAAyE;AAMzE,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAA;AAE9B,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAA;AACrE,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAA;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAA;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,YAAY,CAAU,CAAA;AAEvE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiD;IAEjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,KAAmC,EACnC,SAAgC,EAChC,SAAwC;IAExC,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;AAClE,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/matching/shared.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,iBAAiB;AACjB,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,iFAAiF;AACjF,yEAAyE;AAEzE,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAA;AACrE,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAA;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAA;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,YAAY,CAAU,CAAA;AAEvE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiD;IAEjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/tools/query-handler.js

@@ -1,8 +1,9 @@
+import { withQuery } from './curated-tool.js';
 /** Assemble one curated GET, leaving auth, errors and output with its family relay. */
 export function queryHandler(buildQuery, path, dispatch) {
     return async (args, extra) => {
         const query = buildQuery(args);
-        return dispatch({ method: 'GET', path: path(args), ...(query !== undefined ? { query } : {}) }, extra);
+        return dispatch({ method: 'GET', path: path(args), ...withQuery(query) }, extra);
     };
 }
 //# sourceMappingURL=query-handler.js.map

package/dist/tools/query-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-handler.js","sourceRoot":"","sources":["../../src/tools/query-handler.ts"],"names":[],"mappings":"AASA,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAC1B,UAAmD,EACnD,IAA4B,EAC5B,QAAuB;IAEvB,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9B,OAAO,QAAQ,CACb,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAC9E,KAAK,CACN,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"query-handler.js","sourceRoot":"","sources":["../../src/tools/query-handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAO7C,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAC1B,UAAmD,EACnD,IAA4B,EAC5B,QAAuB;IAEvB,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9B,OAAO,QAAQ,CACb,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,EACxD,KAAK,CACN,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}