@lerianstudio/matcher-mcp 1.0.0-beta.5

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

@@ -0,0 +1,64 @@
+// `fee_rule_list` — curated GET /v1/contexts/{contextId}/fee-rules.
+//
+// Cursor-paginated list of a context's fee rules. `contextId` is a required path
+// param (routing, not a tenant field). limit/cursor pass through untouched and
+// matcher's { items, nextCursor, ... } envelope is returned as-is — no
+// auto-pagination (the model re-calls with the returned cursor). The list is
+// implicitly tenant-scoped by the relayed token; no tenant field is accepted.
+import { z } from 'zod';
+import { contextFeeRulesPath, dispatchFeeRule } from './shared.js';
+/** Zod raw shape for `fee_rule_list` input — contextId path + pagination knobs. */
+export const listFeeRulesInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) whose fee rules to list. A routing ' +
+        "path param matcher validates against your token's tenant. NOT a tenant " +
+        'field.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of records to return (1–200, default 20).'),
+    cursor: z
+        .string()
+        .optional()
+        .describe('Opaque pagination cursor from a prior response. Re-call with the ' +
+        'returned nextCursor to page forward (there is no auto-pagination).'),
+};
+/** Build the list query, omitting unset knobs so the request stays minimal. */
+function buildListQuery(args) {
+    const query = {};
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `fee_rule_list`. Substitutes `contextId` into the context-nested path,
+ * passes limit/cursor through, and returns matcher's pagination envelope
+ * verbatim; a matcher error surfaces via the shared toToolError.
+ */
+export function registerFeeRuleListTool(server) {
+    server.registerTool('fee_rule_list', {
+        description: 'List the fee rules for a reconciliation context (cursor-paginated). ' +
+            'Provide contextId (path); optionally limit (1–200) and/or cursor. The ' +
+            'response carries { items, nextCursor } — paginate by re-calling with the ' +
+            'returned nextCursor. No tenant field is accepted; the tenant is derived ' +
+            'from your bearer token.',
+        inputSchema: listFeeRulesInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchFeeRule({
+            method: 'GET',
+            path: contextFeeRulesPath(args.contextId),
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/list.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,uEAAuE;AACvE,6EAA6E;AAC7E,8EAA8E;AAE9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0EAA0E;QACxE,yEAAyE;QACzE,QAAQ,CACX;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mEAAmE;QACjE,oEAAoE,CACvE;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAAuB;IAC7C,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,2EAA2E;YAC3E,0EAA0E;YAC1E,yBAAyB;QAC3B,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,eAAe,CACpB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;YACzC,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/fee-rule/shared.js

@@ -0,0 +1,67 @@
+// Shared plumbing for the curated fee-rule tools.
+//
+// Fee rules use a HYBRID path shape (verified against docs/openapi/openapi.yaml):
+//   - create + list are CONTEXT-NESTED: POST/GET /v1/contexts/{contextId}/fee-rules
+//   - get + update(PATCH) + delete are FLAT: GET/PATCH/DELETE /v1/fee-rules/{feeRuleId}
+// This module exports both path helpers plus the single dispatch that every
+// fee-rule tool funnels through.
+//
+// Every fee-rule tool follows the same relay shape: fail-closed auth via
+// requireMatcherClient, dispatch one assembled MatcherRequest, then return
+// matcher's JSON on success or the SHARED toToolError on a MatcherApiError. This
+// factors that boilerplate exactly once so the five tools stay thin (just "build
+// the request") and so curated + generic surfaces map matcher errors through the
+// identical path (toToolError).
+//
+// 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 fee-rule tool input carries one. `contextId`
+// is a routing path param matcher validates ownership of, NOT a tenant field.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Context-nested collection path for fee rules (create + list). */
+export function contextFeeRulesPath(contextId) {
+    return `/v1/contexts/${encodeURIComponent(contextId)}/fee-rules`;
+}
+/** Flat single-rule path (get + update + delete), URL-encoding the id. */
+export function feeRulePath(feeRuleId) {
+    return `/v1/fee-rules/${encodeURIComponent(feeRuleId)}`;
+}
+/**
+ * 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 dispatchFeeRule(request, extra, clientFor = requireMatcherClient) {
+    let client;
+    try {
+        // Fail-closed on a missing / empty / non-Bearer credential.
+        client = clientFor(extra);
+    }
+    catch (err) {
+        if (err instanceof UnauthenticatedError) {
+            return { isError: true, content: [{ type: 'text', text: err.message }] };
+        }
+        throw err;
+    }
+    try {
+        const result = await client.request(request);
+        // Success → matcher's JSON returned as-is (incl. pagination envelopes and
+        // 204 → null for delete).
+        return { content: [{ type: 'text', text: JSON.stringify(result ?? null) }] };
+    }
+    catch (err) {
+        // RFC 9457 problem → the SHARED structured tool error (status/title/detail/
+        // code preserved). A non-matcher error is a bug, not a matcher failure, and
+        // is re-thrown rather than masqueraded as one.
+        if (isMatcherApiError(err)) {
+            return toToolError(err);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/shared.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,kFAAkF;AAClF,oFAAoF;AACpF,wFAAwF;AACxF,4EAA4E;AAC5E,iCAAiC;AACjC,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,gCAAgC;AAChC,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,gFAAgF;AAChF,8EAA8E;AAI9E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,YAAY,CAAA;AAClE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,iBAAiB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAA;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,KAAmC,EACnC,YAAyD,oBAAoB;IAE7E,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;QAC1E,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,0EAA0E;QAC1E,0BAA0B;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,4EAA4E;QAC5E,+CAA+C;QAC/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,70 @@
+// `fee_rule_update` — curated PATCH /v1/fee-rules/{feeRuleId}.
+//
+// Partial update of a fee rule's fields via the FLAT path, mirroring the spec's
+// UpdateFeeRuleRequest. All body fields are optional (PATCH semantics). The flat
+// update path takes no contextId — feeRuleId alone identifies the rule. The spec
+// DOES allow re-pointing the rule at a different fee schedule via feeScheduleId,
+// so it is a settable field here; providing `predicates` replaces the existing
+// predicate set. No tenant field is accepted (matcher scopes to the relayed
+// token's tenant).
+import { z } from 'zod';
+import { FEE_RULE_SIDES, feeRulePredicateShape } from './create.js';
+import { dispatchFeeRule, feeRulePath } from './shared.js';
+/** Zod raw shape for `fee_rule_update` input — id (path) + optional fields. */
+export const updateFeeRuleInputShape = {
+    feeRuleId: z.string().min(1).describe('The fee rule id (UUID) to update.'),
+    side: z
+        .enum(FEE_RULE_SIDES)
+        .optional()
+        .describe('Side the rule applies to. LEFT and RIGHT target one reconciliation side; ' +
+        'ANY matches transactions on either side.'),
+    feeScheduleId: z
+        .string()
+        .optional()
+        .describe('UUID of the fee schedule this rule applies when its predicates match. ' +
+        'Changing it requires read access to the new schedule.'),
+    name: z.string().optional().describe('New human-readable name of the fee rule.'),
+    priority: z
+        .number()
+        .int()
+        .optional()
+        .describe('Evaluation priority; lower numbers are evaluated first. Must remain ' +
+        'unique within the context (LEFT, RIGHT, and ANY share one priority space).'),
+    predicates: z
+        .array(feeRulePredicateShape)
+        .optional()
+        .describe('Predicates (ANDed together) a transaction must satisfy. When provided, ' +
+        'replaces the existing predicate set entirely.'),
+};
+/**
+ * Build the PATCH body from the input minus the path-only `feeRuleId`. Only the
+ * fields the caller actually set are sent — matcher treats absent fields as
+ * unchanged.
+ */
+export function buildUpdateBody(args) {
+    const { feeRuleId: _feeRuleId, ...body } = args;
+    void _feeRuleId;
+    return body;
+}
+/**
+ * Register `fee_rule_update`. Splits the id (path) from the body fields and
+ * dispatches a PATCH through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError.
+ */
+export function registerFeeRuleUpdateTool(server) {
+    server.registerTool('fee_rule_update', {
+        description: 'Update fields of a fee rule by id (UUID) via the flat path. All fields ' +
+            'are optional (PATCH): side (LEFT|RIGHT|ANY), feeScheduleId (UUID), name, ' +
+            'priority (unique within the context), predicates[] (replaces the set ' +
+            'when provided). No tenant field is accepted. Returns the updated rule, ' +
+            'or a structured RFC 9457 error.',
+        inputSchema: updateFeeRuleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeRule({
+            method: 'PATCH',
+            path: feeRulePath(args.feeRuleId),
+            body: buildUpdateBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/fee-rule/update.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,+EAA+E;AAC/E,4EAA4E;AAC5E,mBAAmB;AAEnB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE1D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1E,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,0CAA0C,CAC7C;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE;QACtE,uDAAuD,CAC1D;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAChF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,4EAA4E,CAC/E;IACH,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,qBAAqB,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CACP,yEAAyE;QACvE,+CAA+C,CAClD;CACJ,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,UAAU,CAAA;IACf,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,yEAAyE;YACzE,2EAA2E;YAC3E,uEAAuE;YACvE,yEAAyE;YACzE,iCAAiC;QACnC,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;SAC5B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/fee-schedule/create.js

@@ -0,0 +1,105 @@
+// `fee_schedule_create` — curated POST /v1/fee-schedules.
+//
+// A typed, richly-described front door to creating a fee schedule, mirroring the
+// spec's CreateFeeScheduleRequest. The Zod schema models the required scalars
+// and the documented enums (applicationOrder, roundingMode) so an operator-
+// driving LLM gets the shape and the units up front; the `items[]` array is
+// modeled as a typed-but-permissive structure (per task 1.3.2) — matcher's
+// server-side validation + the returned RFC 9457 problem are the authoritative
+// check, so we do not duplicate the full item validation here.
+//
+// No tenant field exists in the schema: the schedule is created for the tenant
+// of the relayed bearer token, never a tenant supplied as input.
+import { z } from 'zod';
+import { dispatchFeeSchedule, FEE_SCHEDULES_PATH } from './shared.js';
+/** How fee items combine when applied to a base amount. */
+export const APPLICATION_ORDERS = ['PARALLEL', 'CASCADING'];
+/** Rounding strategies matcher supports for fee amounts. */
+export const ROUNDING_MODES = [
+    'HALF_UP',
+    'BANKERS',
+    'FLOOR',
+    'CEIL',
+    'TRUNCATE',
+];
+/** Shape of a single fee item's structure (FLAT / PERCENTAGE / TIERED). */
+export const FEE_STRUCTURE_TYPES = ['FLAT', 'PERCENTAGE', 'TIERED'];
+/**
+ * One fee item. Typed-but-permissive: the named fields mirror the spec's
+ * CreateFeeScheduleItemRequest, but `structure` is left as an open record
+ * (its shape depends on structureType) and unknown keys are allowed so matcher
+ * remains the authoritative validator.
+ */
+export const feeScheduleItemShape = z
+    .object({
+    name: z
+        .string()
+        .describe('Human-readable name of the fee item, e.g. "interchange".'),
+    priority: z
+        .number()
+        .int()
+        .optional()
+        .describe('Application order within the schedule (relevant for CASCADING ' +
+        'applicationOrder); lower runs first.'),
+    structureType: z
+        .enum(FEE_STRUCTURE_TYPES)
+        .describe('Shape of the fee structure. FLAT is a fixed amount; PERCENTAGE is a ' +
+        'rate of the base; TIERED applies different rates per amount tier.'),
+    structure: z
+        .record(z.string(), z.unknown())
+        .describe('Type-specific structure object. FLAT: {"amount":"1.50"}. PERCENTAGE: ' +
+        '{"rate":"0.029"} where rate is a 0..1 fraction (0.029 = 2.9%), not a ' +
+        'percent value. TIERED: {"tiers":[{"rate":"0.01","upTo":"1000"},...]} ' +
+        'with the same 0..1 fraction semantics per tier rate.'),
+})
+    .describe('A single fee item making up the schedule.');
+/** Zod raw shape for `fee_schedule_create` input — mirrors CreateFeeScheduleRequest. */
+export const createFeeScheduleInputShape = {
+    name: z
+        .string()
+        .min(1)
+        .max(100)
+        .describe('Human-readable name of the fee schedule (1–100 chars).'),
+    currency: z
+        .string()
+        .describe("ISO 4217 currency code the schedule's amounts are denominated in, e.g. " +
+        '"USD". Validated server-side.'),
+    applicationOrder: z
+        .enum(APPLICATION_ORDERS)
+        .describe('How items combine. PARALLEL applies every item to the same gross base; ' +
+        'CASCADING applies each item to the net remaining after prior items.'),
+    roundingScale: z
+        .number()
+        .int()
+        .describe('Number of decimal places fee amounts are rounded to, e.g. 2.'),
+    roundingMode: z
+        .enum(ROUNDING_MODES)
+        .describe('Rounding strategy. HALF_UP rounds halves away from zero; BANKERS rounds ' +
+        'halves to the nearest even digit; FLOOR rounds down; CEIL rounds up; ' +
+        'TRUNCATE drops extra digits.'),
+    items: z
+        .array(feeScheduleItemShape)
+        .min(1)
+        .max(100)
+        .describe('Fee items that make up the schedule; at least one is required (max 100). ' +
+        "Each item's structure is validated server-side against its structureType."),
+};
+/**
+ * Register `fee_schedule_create`. Builds the POST request body from the typed
+ * input and dispatches it through the shared fail-closed relay; a matcher error
+ * surfaces via the shared toToolError (same shape as matcher_invoke).
+ */
+export function registerFeeScheduleCreateTool(server) {
+    server.registerTool('fee_schedule_create', {
+        description: 'Create a fee schedule for transaction fee calculation. The schedule is ' +
+            "created for your token's tenant (no tenant field is accepted). Provide " +
+            'name, currency (ISO 4217), applicationOrder (PARALLEL|CASCADING), ' +
+            'roundingScale (decimal places), roundingMode (HALF_UP|BANKERS|FLOOR|' +
+            'CEIL|TRUNCATE), and items[] (≥1). Returns the created schedule, or a ' +
+            'structured RFC 9457 error.',
+        inputSchema: createFeeScheduleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeSchedule({ method: 'POST', path: FEE_SCHEDULES_PATH, body: args }, extra);
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/fee-schedule/create.js.map

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

package/dist/tools/fee-schedule/delete.js

@@ -0,0 +1,32 @@
+// `fee_schedule_delete` — curated DELETE /v1/fee-schedules/{scheduleId}.
+//
+// Removes a fee schedule by id. Matcher rejects with 409 while fee rules still
+// reference the schedule — that problem surfaces verbatim through the shared
+// toToolError. A successful delete returns 204 (no content), which the relay
+// renders as null. scheduleId is a UUID path param; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchFeeSchedule, feeSchedulePath } from './shared.js';
+/** Zod raw shape for `fee_schedule_delete` input — just the schedule id. */
+export const deleteFeeScheduleInputShape = {
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The fee schedule id (UUID) to delete.'),
+};
+/**
+ * Register `fee_schedule_delete`. Substitutes the id into the path and dispatches
+ * a DELETE through the shared fail-closed relay; a 409 (still referenced) or any
+ * other matcher error surfaces via the shared toToolError.
+ */
+export function registerFeeScheduleDeleteTool(server) {
+    server.registerTool('fee_schedule_delete', {
+        description: 'Delete a fee schedule by id (UUID). Rejected with 409 while fee rules ' +
+            'still reference it — detach those first. The schedule must belong to ' +
+            "your token's tenant (no tenant field is accepted). Returns no content on " +
+            'success, or a structured RFC 9457 error.',
+        inputSchema: deleteFeeScheduleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeSchedule({ method: 'DELETE', path: feeSchedulePath(args.scheduleId) }, extra);
+    });
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/fee-schedule/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/delete.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,wEAAwE;YACxE,uEAAuE;YACvE,2EAA2E;YAC3E,0CAA0C;QAC5C,WAAW,EAAE,2BAA2B;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,mBAAmB,CACxB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAC5D,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/fee-schedule/get.js

@@ -0,0 +1,30 @@
+// `fee_schedule_get` — curated GET /v1/fee-schedules/{scheduleId}.
+//
+// Reads one fee schedule by id. scheduleId is the only input (a UUID path
+// param). The schedule must belong to the relayed token's tenant — matcher
+// enforces that; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchFeeSchedule, feeSchedulePath } from './shared.js';
+/** Zod raw shape for `fee_schedule_get` input — just the schedule id. */
+export const getFeeScheduleInputShape = {
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The fee schedule id (UUID) to fetch.'),
+};
+/**
+ * Register `fee_schedule_get`. Substitutes the id into the path and dispatches a
+ * GET through the shared fail-closed relay; a matcher error (e.g. 404) surfaces
+ * via the shared toToolError.
+ */
+export function registerFeeScheduleGetTool(server) {
+    server.registerTool('fee_schedule_get', {
+        description: 'Fetch a single fee schedule by id (UUID). The schedule must belong to ' +
+            "your token's tenant. Returns the schedule, or a structured RFC 9457 " +
+            'error (e.g. 404 if it does not exist or is not yours).',
+        inputSchema: getFeeScheduleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeSchedule({ method: 'GET', path: feeSchedulePath(args.scheduleId) }, extra);
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/fee-schedule/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/get.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,8CAA8C;AAE9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,wEAAwE;YACxE,sEAAsE;YACtE,wDAAwD;QAC1D,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,mBAAmB,CACxB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EACzD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/fee-schedule/index.js

@@ -0,0 +1,22 @@
+// Curated fee-schedule vertical (task 1.3.2): six typed tools over the matcher
+// fee-schedule resource — create, list, get, update, delete, simulate — proving
+// the typed pattern coexists with the generic invoke on one client + one token
+// relay. 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 { registerFeeScheduleCreateTool } from './create.js';
+import { registerFeeScheduleDeleteTool } from './delete.js';
+import { registerFeeScheduleGetTool } from './get.js';
+import { registerFeeScheduleListTool } from './list.js';
+import { registerFeeScheduleSimulateTool } from './simulate.js';
+import { registerFeeScheduleUpdateTool } from './update.js';
+/** Register all six curated fee-schedule tools on the given server. */
+export function registerFeeScheduleTools(server) {
+    registerFeeScheduleCreateTool(server);
+    registerFeeScheduleListTool(server);
+    registerFeeScheduleGetTool(server);
+    registerFeeScheduleUpdateTool(server);
+    registerFeeScheduleDeleteTool(server);
+    registerFeeScheduleSimulateTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/fee-schedule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAI1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE3D,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAA;AACzC,CAAC"}

package/dist/tools/fee-schedule/list.js

@@ -0,0 +1,56 @@
+// `fee_schedule_list` — curated GET /v1/fee-schedules.
+//
+// Cursor-paginated list of the tenant's fee schedules. limit/cursor pass through
+// untouched and matcher's { items, nextCursor, ... } envelope is returned as-is
+// — no auto-pagination (the model re-calls with the returned cursor). The list
+// is implicitly tenant-scoped by the relayed token; no tenant field is accepted.
+import { z } from 'zod';
+import { dispatchFeeSchedule, FEE_SCHEDULES_PATH } from './shared.js';
+/** Zod raw shape for `fee_schedule_list` input — pagination knobs only. */
+export const listFeeSchedulesInputShape = {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of records to return (1–200, default 20).'),
+    cursor: z
+        .string()
+        .optional()
+        .describe('Opaque pagination cursor from a prior response. Re-call with the ' +
+        "returned nextCursor to page forward (there is no auto-pagination)."),
+};
+/** Build the list query, omitting unset knobs so the request stays minimal. */
+function buildListQuery(args) {
+    const query = {};
+    if (args.limit !== undefined) {
+        query.limit = args.limit;
+    }
+    if (args.cursor !== undefined) {
+        query.cursor = args.cursor;
+    }
+    return Object.keys(query).length > 0 ? query : undefined;
+}
+/**
+ * Register `fee_schedule_list`. Passes limit/cursor through and returns matcher's
+ * pagination envelope verbatim; a matcher error surfaces via the shared
+ * toToolError.
+ */
+export function registerFeeScheduleListTool(server) {
+    server.registerTool('fee_schedule_list', {
+        description: "List the fee schedules for your token's tenant (cursor-paginated). Pass " +
+            'limit (1–200) and/or cursor; the response carries { items, nextCursor } ' +
+            '— paginate by re-calling with the returned nextCursor. No tenant field ' +
+            'is accepted; the tenant is derived from your bearer token.',
+        inputSchema: listFeeSchedulesInputShape,
+    }, async (args, extra) => {
+        const query = buildListQuery(args);
+        return dispatchFeeSchedule({
+            method: 'GET',
+            path: FEE_SCHEDULES_PATH,
+            ...(query !== undefined ? { query } : {}),
+        }, extra);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/fee-schedule/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/list.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mEAAmE;QACjE,oEAAoE,CACvE;CACJ,CAAA;AAOD,+EAA+E;AAC/E,SAAS,cAAc,CAAC,IAA2B;IACjD,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,0EAA0E;YAC1E,0EAA0E;YAC1E,yEAAyE;YACzE,4DAA4D;QAC9D,WAAW,EAAE,0BAA0B;KACxC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,mBAAmB,CACxB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB;YACxB,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/fee-schedule/shared.js

@@ -0,0 +1,58 @@
+// Shared plumbing for the curated fee-schedule tools.
+//
+// Every fee-schedule tool follows the same relay shape: fail-closed auth via
+// requireMatcherClient, dispatch one assembled MatcherRequest, then return
+// matcher's JSON on success or the SHARED toToolError on a MatcherApiError. This
+// module factors that boilerplate exactly once so the six tools stay thin (just
+// "build the request") and so curated + generic surfaces map matcher errors
+// through the identical path (toToolError) — the whole point of task 1.3.2.
+//
+// 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 fee-schedule tool input carries one.
+import { requireMatcherClient, UnauthenticatedError, } from '../../auth/request-token.js';
+import { isMatcherApiError, toToolError } from '../tool-error.js';
+/** Base path for the fee-schedule resource (tenant-scoped; tenant from the token). */
+export const FEE_SCHEDULES_PATH = '/v1/fee-schedules';
+/** Build the single-schedule sub-path, URL-encoding the id so reserved chars are safe. */
+export function feeSchedulePath(scheduleId) {
+    return `${FEE_SCHEDULES_PATH}/${encodeURIComponent(scheduleId)}`;
+}
+/**
+ * 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 dispatchFeeSchedule(request, extra, clientFor = requireMatcherClient) {
+    let client;
+    try {
+        // Fail-closed on a missing / empty / non-Bearer credential.
+        client = clientFor(extra);
+    }
+    catch (err) {
+        if (err instanceof UnauthenticatedError) {
+            return { isError: true, content: [{ type: 'text', text: err.message }] };
+        }
+        throw err;
+    }
+    try {
+        const result = await client.request(request);
+        // Success → matcher's JSON returned as-is (incl. pagination envelopes and
+        // 204 → null for delete).
+        return { content: [{ type: 'text', text: JSON.stringify(result ?? null) }] };
+    }
+    catch (err) {
+        // RFC 9457 problem → the SHARED structured tool error (status/title/detail/
+        // code preserved). A non-matcher error is a bug, not a matcher failure, and
+        // is re-thrown rather than masqueraded as one.
+        if (isMatcherApiError(err)) {
+            return toToolError(err);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/fee-schedule/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/shared.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,iFAAiF;AACjF,gFAAgF;AAChF,4EAA4E;AAC5E,4EAA4E;AAC5E,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,wEAAwE;AAIxE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjE,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAErD,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,GAAG,kBAAkB,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAA;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuB,EACvB,KAAmC,EACnC,YAAyD,oBAAoB;IAE7E,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;QAC1E,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,0EAA0E;QAC1E,0BAA0B;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,4EAA4E;QAC5E,+CAA+C;QAC/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/tools/fee-schedule/simulate.js

@@ -0,0 +1,54 @@
+// `fee_schedule_simulate` — curated POST /v1/fee-schedules/{scheduleId}/simulate.
+//
+// Calculates the fees a given gross amount would incur under a specific fee
+// schedule, without persisting anything. Mirrors the spec's SimulateFeeRequest
+// (grossAmount + currency, both required). Amounts are decimal STRINGS to avoid
+// float precision loss. scheduleId is a UUID path param; no tenant field is
+// accepted (matcher scopes to the relayed token's tenant).
+import { z } from 'zod';
+import { dispatchFeeSchedule, feeSchedulePath } from './shared.js';
+/** Zod raw shape for `fee_schedule_simulate` input — id (path) + body fields. */
+export const simulateFeeScheduleInputShape = {
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The fee schedule id (UUID) to simulate against.'),
+    grossAmount: z
+        .string()
+        .describe('Gross amount to simulate fees against, as a decimal STRING in the given ' +
+        'currency, e.g. "100.00" (a string, not a number, to preserve precision).'),
+    currency: z
+        .string()
+        .describe('ISO 4217 currency code of the gross amount, e.g. "USD".'),
+};
+/**
+ * Build the simulate POST body from the input minus the path-only `scheduleId`.
+ */
+export function buildSimulateBody(args) {
+    const { scheduleId: _scheduleId, ...body } = args;
+    void _scheduleId;
+    return body;
+}
+/**
+ * Register `fee_schedule_simulate`. Splits the id (path) from the body, dispatches
+ * a POST to the schedule's /simulate sub-path through the shared fail-closed
+ * relay, and returns the { grossAmount, netAmount, totalFee, currency, items }
+ * breakdown; a matcher error surfaces via the shared toToolError.
+ */
+export function registerFeeScheduleSimulateTool(server) {
+    server.registerTool('fee_schedule_simulate', {
+        description: 'Simulate fee calculation for a gross amount under a specific fee ' +
+            'schedule (by id, UUID) — a dry run, nothing is persisted. Provide ' +
+            'grossAmount (decimal string, e.g. "100.00") and currency (ISO 4217). ' +
+            'Returns the per-item breakdown plus totalFee and netAmount. No tenant ' +
+            'field is accepted. Errors surface as structured RFC 9457 problems.',
+        inputSchema: simulateFeeScheduleInputShape,
+    }, async (args, extra) => {
+        return dispatchFeeSchedule({
+            method: 'POST',
+            path: `${feeSchedulePath(args.scheduleId)}/simulate`,
+            body: buildSimulateBody(args),
+        }, extra);
+    });
+}
+//# sourceMappingURL=simulate.js.map

package/dist/tools/fee-schedule/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../src/tools/fee-schedule/simulate.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,2DAA2D;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,iFAAiF;AACjF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CACP,0EAA0E;QACxE,0EAA0E,CAC7E;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAA;AAOD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA8B;IAE9B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACjD,KAAK,WAAW,CAAA;IAChB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,mEAAmE;YACnE,oEAAoE;YACpE,uEAAuE;YACvE,wEAAwE;YACxE,oEAAoE;QACtE,WAAW,EAAE,6BAA6B;KAC3C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,mBAAmB,CACxB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW;YACpD,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;SAC9B,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}