@lerianstudio/matcher-mcp 1.2.0 → 1.3.0

package/dist/spec/schema-parity.js

@@ -0,0 +1,393 @@
+// Curated-tool ⇄ OpenAPI request-body parity — the client-side sibling of the Go
+// `check-huma-spec` gate.
+//
+// WHY THIS EXISTS
+// A curated Zod tool (src/tools/<family>/*.ts) hand-writes its input shape and
+// dispatches a fixed method+path. `curated-operations.test.ts` already pins that
+// each tool's operation still EXISTS in the spec (structural drift). This file
+// goes one layer deeper: it diffs each curated tool's declared Zod request shape
+// against the spec's request-body JSON Schema and fails when the TOOL IS BEHIND —
+// a body property the spec added that the tool never exposes, or a closed Zod
+// enum that lags the spec's enum values. Either way an operator driving the tool
+// blind (the .describe() text is the whole product) would be unable to send a
+// field the backend accepts, or would be rejected client-side for a value the
+// backend allows. The enum-policy allow-lists (enum-policy.ts) carve out the two
+// sanctioned divergences (spec-enum→free-string, and deliberately-omitted field).
+//
+// SCOPE — A DECISION, NOT AN OVERSIGHT
+// This gate covers REQUEST-BODY parity only. Query- and path-parameter drift is
+// deliberately OUT OF SCOPE here: path params ride URL builders (a rename there
+// breaks the dispatched path, which `curated-operations.test.ts`'s method+path
+// reconciliation already guards), and the query surface is thin and mostly
+// pagination. Body shape is where a curated tool silently rots against a growing
+// backend contract, so that is what we pin.
+//
+// TOOL-AHEAD IS NOT A FAILURE
+// Extra tool properties the spec lacks (or a tool enum with MORE values than the
+// spec) are not flagged — a curated tool may intentionally lead the spec. Only
+// the tool falling BEHIND the spec bites.
+//
+// ZOD 4 INTROSPECTION
+// Dependency-free (no zod-to-json-schema). Zod 4 exposes `schema._def.type` as
+// the discriminator and `_def.innerType` for the single-child wrappers
+// (optional / default / nullable / readonly / catch / nonoptional); ZodPipe
+// (transform/refine-with-effect) carries `_def.in`; ZodEnum carries
+// `_def.entries`; ZodArray carries `_def.element`; ZodObject exposes `.shape`.
+// The self-test fixtures in schema-parity.test.ts are the correctness proof for
+// these unwrap wrinkles.
+// --- Zod side --------------------------------------------------------------
+/** Access the Zod 4 internal def, tolerating either accessor. */
+function defOf(schema) {
+    if (schema === null || typeof schema !== 'object') {
+        return undefined;
+    }
+    const s = schema;
+    const d = s._def ?? s.def;
+    return d !== null && typeof d === 'object'
+        ? d
+        : undefined;
+}
+/**
+ * Peel the transparent single-child wrappers (optional / default / nullable /
+ * readonly / catch / nonoptional via `innerType`; transform/pipe via `in`) until
+ * a "core" schema (object / array / enum / scalar / record) is reached.
+ */
+function unwrap(schema) {
+    let current = schema;
+    for (let hops = 0; hops < 50; hops += 1) {
+        const d = defOf(current);
+        if (d === undefined) {
+            return current;
+        }
+        if (d['type'] === 'pipe' && d['in'] !== undefined) {
+            current = d['in'];
+            continue;
+        }
+        if (d['innerType'] !== undefined) {
+            current = d['innerType'];
+            continue;
+        }
+        return current;
+    }
+    return current;
+}
+/**
+ * Whether a Zod field is GUARANTEED to appear in the parsed payload.
+ * Peels wrappers outermost-first: the first wrapper that decides presence wins.
+ * `optional` → 'optional' (may be absent); `default`/`catch`/`prefault` →
+ * 'guaranteed' (a value is filled when the caller omits it); `nonoptional` →
+ * 'guaranteed' (explicitly strips optionality); `nullable`/`readonly`/`pipe`
+ * are transparent for presence and are peeled through. A bare scalar/object/
+ * array with no wrapper is required.
+ */
+function presenceOf(schema) {
+    let current = schema;
+    for (let hops = 0; hops < 50; hops += 1) {
+        const d = defOf(current);
+        if (d === undefined) {
+            return 'guaranteed';
+        }
+        const type = d['type'];
+        if (type === 'optional') {
+            return 'optional';
+        }
+        if (type === 'default' || type === 'catch' || type === 'prefault') {
+            return 'guaranteed';
+        }
+        if (type === 'nonoptional') {
+            return 'guaranteed';
+        }
+        if (type === 'pipe' && d['in'] !== undefined) {
+            current = d['in'];
+            continue;
+        }
+        if (d['innerType'] !== undefined) {
+            current = d['innerType'];
+            continue;
+        }
+        return 'guaranteed';
+    }
+    return 'guaranteed';
+}
+/** Recurse a Zod schema, appending property paths and closed enums to `out`. */
+function walkZod(schema, path, out) {
+    const core = unwrap(schema);
+    const d = defOf(core);
+    const type = d?.['type'];
+    if (type === 'object') {
+        const shape = core.shape ?? {};
+        for (const [key, child] of Object.entries(shape)) {
+            const childPath = path ? `${path}.${key}` : key;
+            out.propertyPaths.add(childPath);
+            if (presenceOf(child) === 'guaranteed') {
+                out.requiredPaths.add(childPath);
+            }
+            walkZod(child, childPath, out);
+        }
+        return;
+    }
+    if (type === 'array') {
+        const element = core.element ?? d?.['element'];
+        if (element !== undefined) {
+            walkZod(element, `${path}[]`, out);
+        }
+        return;
+    }
+    if (type === 'enum' && path) {
+        const entries = d?.['entries'];
+        if (entries !== null && typeof entries === 'object') {
+            out.closedEnums.set(path, new Set(Object.values(entries).map(String)));
+        }
+        return;
+    }
+    // record / string / number / boolean / unknown → leaf; nothing to add.
+}
+/**
+ * Introspect a curated tool's `ZodRawShape` into its property paths and closed
+ * enums. Wrapper types are unwrapped; arrays recurse into their element under a
+ * `[]` segment; enums surface their `.options`.
+ */
+export function introspectShape(shape) {
+    const out = {
+        propertyPaths: new Set(),
+        closedEnums: new Map(),
+        requiredPaths: new Set(),
+    };
+    for (const [key, schema] of Object.entries(shape)) {
+        out.propertyPaths.add(key);
+        if (presenceOf(schema) === 'guaranteed') {
+            out.requiredPaths.add(key);
+        }
+        walkZod(schema, key, out);
+    }
+    return out;
+}
+// --- Spec side -------------------------------------------------------------
+/**
+ * Recurse an (already-dereferenced) JSON Schema fragment into `out`.
+ *
+ * FLAT-SCHEMA-ONLY (invariant, not a bug): traverses `properties`/`items`/`enum`
+ * only. Composition keywords (allOf/oneOf/anyOf) are NOT descended into — Huma
+ * emits flat schemas and the shipped spec has zero of them (a schema-parity.test
+ * canary asserts this stays true). If the generator ever emits a composed body,
+ * a property/enum under the composition would be invisible here (fail-OPEN), so
+ * the canary trips RED first, forcing composition traversal to be added.
+ */
+function walkSpec(node, path, out) {
+    if (node === null || typeof node !== 'object') {
+        return;
+    }
+    const obj = node;
+    const enumVals = obj['enum'];
+    if (Array.isArray(enumVals) && path) {
+        out.closedEnums.set(path, new Set(enumVals.map(String)));
+    }
+    // `required` lists property NAMES required at THIS object level; project each
+    // onto the same dot/bracket path notation as its property entry below.
+    const required = obj['required'];
+    if (Array.isArray(required)) {
+        for (const name of required) {
+            if (typeof name === 'string') {
+                out.requiredPaths.add(path ? `${path}.${name}` : name);
+            }
+        }
+    }
+    const properties = obj['properties'];
+    if (properties !== null && typeof properties === 'object') {
+        for (const [key, child] of Object.entries(properties)) {
+            const childPath = path ? `${path}.${key}` : key;
+            out.propertyPaths.add(childPath);
+            walkSpec(child, childPath, out);
+        }
+    }
+    const items = obj['items'];
+    if (items !== undefined) {
+        walkSpec(items, `${path}[]`, out);
+    }
+}
+/**
+ * Introspect a spec request-body JSON Schema (as produced by the loader, refs
+ * already inlined) into its property paths and enums — same path notation as
+ * {@link introspectShape} so the two are directly comparable.
+ */
+export function introspectSpecSchema(schema) {
+    const out = {
+        propertyPaths: new Set(),
+        closedEnums: new Map(),
+        requiredPaths: new Set(),
+    };
+    walkSpec(schema, '', out);
+    return out;
+}
+/**
+ * Diff a curated tool's Zod shape against a spec request-body schema, honoring
+ * the per-op allow-lists. Returns every gap where the TOOL IS BEHIND the spec.
+ * Pure — the gate and the self-test both drive it.
+ */
+export function compareShapeToSpec(shape, specSchema, allow) {
+    const tool = introspectShape(shape);
+    const spec = introspectSpecSchema(specSchema);
+    const findings = [];
+    // (1) Spec property the tool never exposes → missing, unless omitted-allow-listed.
+    for (const fieldPath of spec.propertyPaths) {
+        if (tool.propertyPaths.has(fieldPath)) {
+            continue;
+        }
+        if (allow.omittedFields.has(fieldPath)) {
+            continue;
+        }
+        findings.push({ kind: 'missing-property', fieldPath });
+    }
+    // (2)/(3) Spec enums vs the tool's modeling of the same field.
+    for (const [fieldPath, specValues] of spec.closedEnums) {
+        if (!tool.propertyPaths.has(fieldPath)) {
+            // Absent entirely — already reported (or allow-listed) by pass (1).
+            continue;
+        }
+        const toolValues = tool.closedEnums.get(fieldPath);
+        if (toolValues !== undefined) {
+            // (2) Closed tool enum must be a superset of the spec's values.
+            const missing = [...specValues].filter((v) => !toolValues.has(v));
+            if (missing.length > 0) {
+                findings.push({ kind: 'enum-missing-values', fieldPath, missing });
+            }
+            continue;
+        }
+        // (3) Spec enum, but the tool types it as a free string — only OK if declared.
+        if (!allow.openFields.has(fieldPath)) {
+            findings.push({ kind: 'enum-modeled-as-string', fieldPath });
+        }
+    }
+    return findings;
+}
+/** A required path is unconditional only at the top level (no parent container). */
+function isTopLevel(fieldPath) {
+    return !fieldPath.includes('.') && !fieldPath.includes('[');
+}
+/**
+ * Diff the required-ness of a curated tool's fields against a spec request body.
+ * Returns every gap, its `kind` carrying the severity the gate applies:
+ * `spec-required-*` FAIL, `tool-required-spec-optional` WARN. Pure — the gate
+ * and the self-test both drive it.
+ */
+export function compareRequiredArrays(shape, specSchema, allow) {
+    const tool = introspectShape(shape);
+    const spec = introspectSpecSchema(specSchema);
+    const findings = [];
+    // FAIL direction: every spec-required field must be guaranteed by the tool.
+    for (const fieldPath of spec.requiredPaths) {
+        if (tool.requiredPaths.has(fieldPath)) {
+            continue; // tool guarantees it (non-optional or has a default)
+        }
+        if (allow.injectedFields.has(fieldPath)) {
+            continue; // tool code fills it before dispatch — invisible but accounted for
+        }
+        if (tool.propertyPaths.has(fieldPath)) {
+            // Exposed but optional → caller can omit a required field.
+            findings.push({ kind: 'spec-required-tool-optional', fieldPath });
+            continue;
+        }
+        // Not exposed at all. Absence of a NON-allow-listed field is coverage's job
+        // (compareShapeToSpec's missing-property). We only add value for the case
+        // coverage can't see: a TOP-LEVEL required field suppressed by the omitted
+        // allow-list — an unconditional 422 on every call. Nested paths under an
+        // optional/opaque container are conditional and passed through, so skip them.
+        if (isTopLevel(fieldPath) && allow.omittedFields.has(fieldPath)) {
+            findings.push({ kind: 'spec-required-tool-omitted', fieldPath });
+        }
+    }
+    // WARN direction: a tool-required field the spec exposes but marks optional.
+    for (const fieldPath of tool.requiredPaths) {
+        if (!spec.propertyPaths.has(fieldPath)) {
+            continue; // tool-ahead extra the spec lacks — not an over-constraint of it
+        }
+        if (!spec.requiredPaths.has(fieldPath)) {
+            findings.push({ kind: 'tool-required-spec-optional', fieldPath });
+        }
+    }
+    return findings;
+}
+// --- The shape table -------------------------------------------------------
+//
+// Each curated operation whose spec entry declares an application/json request
+// body maps here to the tool's exported input shape. The completeness guard in
+// the test derives the required key set from CURATED_OPERATION_IDS ∩ (spec ops
+// with a JSON body). So for any op ALREADY in CURATED_OPERATION_IDS, adding or
+// retargeting its curated body-tool without wiring the shape here fails the gate
+// (missing on one side, extra on the other).
+//
+// SCOPE LIMIT (do not overstate this): because the required set is filtered
+// through the hand-maintained CURATED_OPERATION_IDS, this parity gate does NOT
+// see an op that has a JSON body but is left in GENERIC_ONLY_OPERATION_IDS —
+// hand-curate a Zod body-tool for such an op without promoting it into
+// CURATED_OPERATION_IDS (and without wiring it here) and no field-parity test
+// runs for it. That promotion/triage is guarded separately by
+// curated-operations.test.ts (curated⇄generic disjointness + frozen counts +
+// inverse spec coverage), not by field parity here. GET/list/delete ops (no
+// body) and uploadFile (multipart, no application/json body) are absent by design.
+import { addCommentInputShape } from '../tools/exception/add-comment.js';
+import { adjustEntryInputShape } from '../tools/exception/adjust-entry.js';
+import { bulkAssignInputShape } from '../tools/exception/bulk-assign.js';
+import { bulkDispatchInputShape } from '../tools/exception/bulk-dispatch.js';
+import { bulkResolveInputShape } from '../tools/exception/bulk-resolve.js';
+import { closeDisputeInputShape } from '../tools/dispute/close.js';
+import { createContextInputShape } from '../tools/context/create.js';
+import { createFeeRuleInputShape } from '../tools/fee-rule/create.js';
+import { createFeeScheduleInputShape } from '../tools/fee-schedule/create.js';
+import { createFieldMapInputShape } from '../tools/field-map/create.js';
+import { createMatchRuleInputShape } from '../tools/match-rule/create.js';
+import { createSourceInputShape } from '../tools/source/create.js';
+import { dispatchExceptionInputShape } from '../tools/exception/dispatch.js';
+import { forceMatchInputShape } from '../tools/exception/force-match.js';
+import { ignoreTransactionInputShape } from '../tools/ingestion/transaction-ignore.js';
+import { openDisputeInputShape } from '../tools/exception/open-dispute.js';
+import { reorderMatchRulesInputShape } from '../tools/match-rule/reorder.js';
+import { simulateFeeScheduleInputShape } from '../tools/fee-schedule/simulate.js';
+import { startMatchRunInputShape } from '../tools/matching/start.js';
+import { submitEvidenceInputShape } from '../tools/dispute/submit-evidence.js';
+import { updateContextInputShape } from '../tools/context/update.js';
+import { updateFeeRuleInputShape } from '../tools/fee-rule/update.js';
+import { updateFeeScheduleInputShape } from '../tools/fee-schedule/update.js';
+import { updateFieldMapInputShape } from '../tools/field-map/update.js';
+import { updateMatchRuleInputShape } from '../tools/match-rule/update.js';
+import { updateSourceInputShape } from '../tools/source/update.js';
+/** operationId → the curated tool's request-body input shape. */
+export const TOOL_SHAPE_BY_OPERATION_ID = {
+    // fee-schedule
+    createFeeSchedule: createFeeScheduleInputShape,
+    simulateFeeSchedule: simulateFeeScheduleInputShape,
+    updateFeeSchedule: updateFeeScheduleInputShape,
+    // fee-rule
+    createFeeRule: createFeeRuleInputShape,
+    updateFeeRule: updateFeeRuleInputShape,
+    // match-rule
+    createMatchRule: createMatchRuleInputShape,
+    reorderMatchRules: reorderMatchRulesInputShape,
+    updateMatchRule: updateMatchRuleInputShape,
+    // context
+    createContext: createContextInputShape,
+    updateContext: updateContextInputShape,
+    // source
+    createSource: createSourceInputShape,
+    updateSource: updateSourceInputShape,
+    // field-map
+    createFieldMap: createFieldMapInputShape,
+    updateFieldMap: updateFieldMapInputShape,
+    // matching
+    runMatch: startMatchRunInputShape,
+    // exception
+    addComment: addCommentInputShape,
+    adjustEntryException: adjustEntryInputShape,
+    bulkAssignExceptions: bulkAssignInputShape,
+    bulkDispatchExceptions: bulkDispatchInputShape,
+    bulkResolveExceptions: bulkResolveInputShape,
+    dispatchException: dispatchExceptionInputShape,
+    forceMatchException: forceMatchInputShape,
+    openDispute: openDisputeInputShape,
+    // dispute
+    closeDispute: closeDisputeInputShape,
+    submitEvidence: submitEvidenceInputShape,
+    // ingestion
+    ignoreTransaction: ignoreTransactionInputShape,
+};
+//# sourceMappingURL=schema-parity.js.map

package/dist/spec/schema-parity.js.map

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

package/dist/tools/context/create.js

@@ -62,6 +62,19 @@ export const createContextInputShape = {
         .string()
         .optional()
         .describe('Percentage fee tolerance as a decimal STRING (0.5 means 0.5%), e.g. "0.5".'),
+    agedBreakThresholdDays: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Open-item aging SLA in business days. An open-item residual older than ' +
+        'this surfaces as an AGED_BREAK exception during the match run. Omit to ' +
+        'disable aging for the context.'),
+    agedBreakCalendar: z
+        .string()
+        .optional()
+        .describe('Business-day calendar the aging threshold is measured against (e.g. ' +
+        'US_FED, BR_ANBIMA). Omit/empty measures the age in raw calendar days.'),
     rules: z
         .array(z.record(z.string(), z.unknown()))
         .max(MAX_INLINE_RULES)
@@ -89,9 +102,11 @@ export function registerContextCreateTool(server) {
             "your token's tenant (no tenant field is accepted). Required: name " +
             '(1–100), type ("1:1"|"1:N"|"N:M", with colons), interval (label, e.g. ' +
             '"daily"). Optional: autoMatchOnUpload (bool), feeNormalization ' +
-            '(NET|GROSS), feeToleranceAbs/feeTolerancePct (decimal strings), and ' +
-            'inline rules[] (≤50) / sources[] (≤10). Returns the created context, or ' +
-            'a structured RFC 9457 error.',
+            '(NET|GROSS), feeToleranceAbs/feeTolerancePct (decimal strings), ' +
+            'open-item aging (agedBreakThresholdDays business-day SLA + ' +
+            'agedBreakCalendar, e.g. BR_ANBIMA), and inline rules[] (≤50) / ' +
+            'sources[] (≤10). Returns the created context, or a structured RFC 9457 ' +
+            'error.',
         inputSchema: createContextInputShape,
     }, async (args, extra) => {
         return dispatchContext({ method: 'POST', path: CONTEXTS_PATH, body: args }, extra);

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

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

package/dist/tools/context/update.js

@@ -55,10 +55,11 @@ export const updateContextInputShape = {
         .describe('When true, a match run is triggered automatically after a file upload ' +
         'completes.'),
     feeNormalization: z
-        .enum(FEE_NORMALIZATIONS)
+        .enum([...FEE_NORMALIZATIONS, ''])
         .optional()
         .describe('Fee normalization mode. NET compares amounts after fees are deducted; ' +
-        'GROSS compares amounts before fees.'),
+        'GROSS compares amounts before fees. Send an empty string ("") to clear ' +
+        'the mode; omit to leave it unchanged.'),
     feeToleranceAbs: z
         .string()
         .optional()
@@ -68,6 +69,18 @@ export const updateContextInputShape = {
         .string()
         .optional()
         .describe('Percentage fee tolerance as a decimal STRING (0.5 means 0.5%), e.g. "0.5".'),
+    agedBreakThresholdDays: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Open-item aging SLA in business days. A positive value enables/changes ' +
+        'aging; 0 disables it (clears the threshold); omit to leave it unchanged.'),
+    agedBreakCalendar: z
+        .string()
+        .optional()
+        .describe('Business-day calendar the aging threshold is measured against. Empty ' +
+        'string clears it (raw calendar days); omit to leave it unchanged.'),
 };
 /**
  * Build the PATCH body from the input minus the path-only `contextId`. Only the
@@ -90,9 +103,11 @@ export function registerContextUpdateTool(server) {
             'optional (PATCH): name, type ("1:1"|"1:N"|"N:M"), interval, status ' +
             '(ACTIVE|PAUSED|ARCHIVED — transitioning to ACTIVE is gated on activation ' +
             'readiness and may return 409), autoMatchOnUpload, feeNormalization ' +
-            '(NET|GROSS), feeToleranceAbs/feeTolerancePct (decimal strings). No tenant ' +
-            'field is accepted. Returns the updated context, or a structured RFC 9457 ' +
-            'error.',
+            '(NET|GROSS, or "" to clear), feeToleranceAbs/feeTolerancePct ' +
+            '(decimal strings), ' +
+            'open-item aging (agedBreakThresholdDays — 0 disables — + ' +
+            'agedBreakCalendar). No tenant field is accepted. Returns the updated ' +
+            'context, or a structured RFC 9457 error.',
         inputSchema: updateContextInputShape,
     }, async (args, extra) => {
         return dispatchContext({

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

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

package/dist/tools/exception/bulk-dispatch.js

@@ -2,13 +2,13 @@
 //
 // A cross-exception action: dispatches many exceptions to a target external
 // system in one call. Mirrors the spec's BulkDispatchRequest — exceptionIds
-// (1–100 UUIDs) and targetSystem are required; queue (≤255) is optional. NOTE:
-// unlike the single-exception dispatch (DispatchRequest, a closed enum), the
-// bulk variant's targetSystem is a FREE STRING (≤255) per the spec — we honor
-// that and do NOT constrain it to an enum here. Partial success is supported
-// server-side. No path param and no tenant field; matcher scopes to the relayed
-// token's tenant.
+// (1–100 UUIDs) and targetSystem are required; queue (≤255) is optional. The
+// targetSystem is a CLOSED enum (JIRA|SERVICENOW|WEBHOOK|MANUAL), the same as
+// the single-exception dispatch (DispatchRequest) — the bulk spec now constrains
+// it identically. Partial success is supported server-side. No path param and no
+// tenant field; matcher scopes to the relayed token's tenant.
 import { z } from 'zod';
+import { DISPATCH_TARGET_SYSTEMS } from './dispatch.js';
 import { dispatchException, EXCEPTIONS_BULK_DISPATCH_PATH } from './shared.js';
 /** Zod raw shape for `exception_bulk_dispatch` input — ids + target + optional queue. */
 export const bulkDispatchInputShape = {
@@ -18,11 +18,9 @@ export const bulkDispatchInputShape = {
         .max(100)
         .describe('Exception ids (UUIDs) to dispatch (1–100).'),
     targetSystem: z
-        .string()
-        .min(1)
-        .max(255)
-        .describe('Target system to dispatch all of them to (1–255). A free string here ' +
-        '(the bulk endpoint does not constrain it to an enum), e.g. "JIRA".'),
+        .enum(DISPATCH_TARGET_SYSTEMS)
+        .describe('Target system to dispatch all of them to ' +
+        '(JIRA|SERVICENOW|WEBHOOK|MANUAL).'),
     queue: z
         .string()
         .max(255)
@@ -52,8 +50,8 @@ export function buildBulkDispatchBody(args) {
 export function registerExceptionBulkDispatchTool(server) {
     server.registerTool('exception_bulk_dispatch', {
         description: 'Dispatch many reconciliation exceptions to a target external system in a ' +
-            'single call. Provide exceptionIds (1–100 UUIDs) and targetSystem (free ' +
-            'string, 1–255 — not constrained to an enum here), and optionally a ' +
+            'single call. Provide exceptionIds (1–100 UUIDs) and targetSystem ' +
+            '(JIRA|SERVICENOW|WEBHOOK|MANUAL), and optionally a ' +
             'queue/team (≤255). Partial success is supported — the response reports ' +
             'per-exception successes and failures. No tenant field is accepted. Errors ' +
             'surface as structured RFC 9457 problems.',

package/dist/tools/exception/bulk-dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-dispatch.js","sourceRoot":"","sources":["../../../src/tools/exception/bulk-dispatch.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,kBAAkB;AAElB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE9E,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,4CAA4C,CAAC;IACzD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,uEAAuE;QACrE,oEAAoE,CACvE;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAA;AAOD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB;IAEvB,MAAM,IAAI,GAA4B;QACpC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAA;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,2EAA2E;YAC3E,yEAAyE;YACzE,qEAAqE;YACrE,yEAAyE;YACzE,4EAA4E;YAC5E,0CAA0C;QAC5C,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,6BAA6B;YACnC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;SAClC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"bulk-dispatch.js","sourceRoot":"","sources":["../../../src/tools/exception/bulk-dispatch.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,iFAAiF;AACjF,iFAAiF;AACjF,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE9E,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,4CAA4C,CAAC;IACzD,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,uBAAuB,CAAC;SAC7B,QAAQ,CACP,2CAA2C;QACzC,mCAAmC,CACtC;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAA;AAOD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB;IAEvB,MAAM,IAAI,GAA4B;QACpC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAA;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,2EAA2E;YAC3E,mEAAmE;YACnE,qDAAqD;YACrD,yEAAyE;YACzE,4EAA4E;YAC5E,0CAA0C;QAC5C,WAAW,EAAE,sBAAsB;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,iBAAiB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,6BAA6B;YACnC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;SAClC,EACD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/exception/list.js

@@ -57,10 +57,19 @@ export const listExceptionsInputShape = {
         .optional()
         .describe('Filter by severity (LOW|MEDIUM|HIGH|CRITICAL).'),
     reason: z
-        .enum(EXCEPTION_REASONS)
+        // Free-form string, not a closed enum: reason codes are a GROWING taxonomy —
+        // every new engine capability mints one (AGED_BREAK / OVER_SETTLED /
+        // FX_RATE_VARIANCE were recent additions). A closed enum here would lag the
+        // backend and reject a valid, newly-minted reason at the client. The backend
+        // validates; the description carries the current known vocabulary as a hint.
+        // See docs/enum-policy.md (registered in INTENTIONALLY_OPEN_FIELDS).
+        .string()
         .optional()
-        .describe('Filter by the reason the exception was raised (e.g. UNMATCHED, ' +
-        'FEE_VARIANCE, DUPLICATE_TRANSACTION).'),
+        .describe('Filter by the reason the exception was raised. Free-form string — the ' +
+        'backend validates and this vocabulary grows as the engine gains new ' +
+        'capabilities. Current known reason codes: ' +
+        EXCEPTION_REASONS.join(', ') +
+        '.'),
     assigned_to: z
         .string()
         .optional()

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

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