@lerianstudio/matcher-mcp 1.2.0 → 1.3.0

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

@@ -8,20 +8,35 @@
 // validates the context belongs to the relayed token's tenant), NOT a tenant
 // field. The body is the input minus `contextId`.
 //
-// The predicate sub-object is modeled explicitly (the operator enum set is small
-// and known: EQUALS / IN / EXISTS), so an operator-driving LLM gets the exact
-// shape; `value`/`values` are optional because EXISTS needs neither.
+// The predicate sub-object is modeled explicitly (the operator algebra is a
+// closed, known set of nine: EQUALS/IN/EXISTS plus GT/GTE/LT/LTE/BETWEEN/NEQ),
+// so an operator-driving LLM gets the exact shape; `value`/`values` are optional
+// because operators like EXISTS consume neither.
 import { z } from 'zod';
 import { contextFeeRulesPath, dispatchFeeRule } from './shared.js';
 /** Side a fee rule applies to. LEFT/RIGHT target one side; ANY matches either. */
 export const FEE_RULE_SIDES = ['LEFT', 'RIGHT', 'ANY'];
-/** Predicate comparison operators matcher supports for fee-rule predicates. */
-export const PREDICATE_OPERATORS = ['EQUALS', 'IN', 'EXISTS'];
+/**
+ * Predicate comparison operators matcher supports for fee-rule predicates.
+ * A closed, stable algebra — kept in spec order (FieldPredicateRequest.operator).
+ */
+export const PREDICATE_OPERATORS = [
+    'EQUALS',
+    'IN',
+    'EXISTS',
+    'GT',
+    'GTE',
+    'LT',
+    'LTE',
+    'BETWEEN',
+    'NEQ',
+];
 /**
  * One field predicate. ANDed with the rule's other predicates. `field` and
- * `operator` are required; `value` is used by EQUALS, `values` by IN, and EXISTS
- * needs neither — they are optional here and matcher is the authoritative
- * validator of the operator/value pairing.
+ * `operator` are required. `value` is consumed by EQUALS/NEQ and the numeric
+ * comparisons GT/GTE/LT/LTE; `values` by IN and BETWEEN; EXISTS needs neither —
+ * both are optional here and matcher is the authoritative validator of the
+ * operator/value pairing.
  */
 export const feeRulePredicateShape = z
     .object({
@@ -30,16 +45,23 @@ export const feeRulePredicateShape = z
         .describe('Transaction metadata field the predicate tests, e.g. "institution".'),
     operator: z
         .enum(PREDICATE_OPERATORS)
-        .describe('Comparison operator. EQUALS matches a single `value`; IN matches any ' +
-        'of `values`; EXISTS asserts the field is present (needs neither).'),
+        .describe('Comparison operator. EQUALS matches a single `value`; NEQ is its ' +
+        'negation (numeric when both sides parse as decimals, else ' +
+        'case-insensitive string) and consumes `value`. IN matches any of ' +
+        '`values`. EXISTS asserts the field is present (needs neither `value` ' +
+        'nor `values`). GT/GTE/LT/LTE compare the field numerically against a ' +
+        'single decimal `value`. BETWEEN tests inclusive numeric membership in ' +
+        '`values`=[lo, hi] (lo<=hi).'),
     value: z
         .string()
         .optional()
-        .describe('Comparison value — required for the EQUALS operator.'),
+        .describe('Single comparison value. Required by EQUALS and NEQ, and by the ' +
+        'numeric comparisons GT/GTE/LT/LTE.'),
     values: z
         .array(z.string())
         .optional()
-        .describe('Candidate values — required for the IN operator.'),
+        .describe('List of comparison values. Required by IN (membership) and BETWEEN ' +
+        '(exactly [lo, hi], inclusive).'),
 })
     .describe('A single field predicate a transaction must satisfy for the rule to apply.');
 /** Zod raw shape for `fee_rule_create` input — mirrors CreateFeeRuleRequest. */
@@ -91,7 +113,8 @@ export function registerFeeRuleCreateTool(server) {
             'to transactions whose metadata satisfies the predicates. Provide ' +
             'contextId (path), side (LEFT|RIGHT|ANY), feeScheduleId (UUID), name ' +
             '(1–100), priority (unique within the context across all sides), and ' +
-            'predicates[] (each { field, operator EQUALS|IN|EXISTS, value?, values? }). ' +
+            'predicates[] (each { field, operator ' +
+            'EQUALS|IN|EXISTS|GT|GTE|LT|LTE|BETWEEN|NEQ, value?, values? }). ' +
             'The rule is scoped to your token\'s tenant (no tenant field is accepted). ' +
             'Returns the created rule, or a structured RFC 9457 error.',
         inputSchema: createFeeRuleInputShape,

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

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

package/dist/tools/generic/describe-operation.js

@@ -32,8 +32,9 @@ const MAX_SUGGESTIONS = 5;
 const NON_JSON_BODY_GUIDANCE = {
     uploadFile: 'uploadFile takes a multipart/form-data body, which this JSON relay ' +
         'cannot construct. Use the curated ingestion_upload tool instead — it ' +
-        'accepts the file as contentBase64 (small files) or fileUrl (the relay ' +
-        'fetches the bytes server-side) and rebuilds the multipart request for you.',
+        'accepts the file as contentBase64 (small files) and rebuilds the ' +
+        'multipart request for you. For a real LOCAL file use ingestion_upload_begin ' +
+        'to broker a direct client→matcher upload.',
     extractDocument: 'extractDocument takes the document as a raw application/pdf body, not ' +
         'JSON, which this relay cannot construct. There is no MCP path for this ' +
         'operation today — it needs a direct multipart/document upload to the ' +

package/dist/tools/generic/describe-operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe-operation.js","sourceRoot":"","sources":["../../../src/tools/generic/describe-operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describe-operation.js","sourceRoot":"","sources":["../../../src/tools/generic/describe-operation.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,eAAe;AACf,EAAE;AACF,gFAAgF;AAChF,2BAA2B;AAC3B,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,mDAAmD;AAEnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiCvB,6DAA6D;AAC7D,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,sBAAsB,GAAqC;IAC/D,UAAU,EACR,qEAAqE;QACrE,uEAAuE;QACvE,mEAAmE;QACnE,8EAA8E;QAC9E,2CAA2C;IAC7C,eAAe,EACb,wEAAwE;QACxE,yEAAyE;QACzE,uEAAuE;QACvE,uCAAuC;CAC1C,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,CACL,sBAAsB,CAAC,WAAW,CAAC;QACnC,IAAI,WAAW,4DAA4D;YACzE,yEAAyE;YACzE,0EAA0E;YAC1E,+CAA+C,CAClD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,WAAW,CAAQ;IACnB,WAAW,CAAmB;IAEvC,YAAY,WAAmB,EAAE,WAA8B;QAC7D,KAAK,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAChC,CAAC;CACF;AAED,mFAAmF;AACnF,SAAS,mBAAmB,CAC1B,WAAmB,EACnB,WAA8B;IAE9B,MAAM,IAAI,GAAG,wBAAwB,WAAW,IAAI,CAAA;IACpD,MAAM,OAAO,GACX,WAAW,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7C,CAAC,CAAC,EAAE,CAAA;IACR,OAAO,CACL,IAAI;QACJ,OAAO;QACP,mEAAmE,CACpE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,CAAA;IACV,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,MAAM,CAAA;IACjB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,MAAM,CAAA;IACjB,CAAC;IAED,IAAI,IAAI,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACtE,IAAI,IAAI,GAAa,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACX,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/C,gEAAgE;YAChE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAClB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACtB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAC1B,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAA;QACjB,IAAI,GAAG,IAAI,CAAA;QACX,IAAI,GAAG,IAAI,CAAA;IACb,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,KAAa;IAEb,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjE,EAAE;QACF,QAAQ;QACR,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;KACjD,CAAC,CAAC,CAAA;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAC9E,CAAA;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED,oEAAoE;AACpE,SAAS,YAAY,CAAC,EAAoB;IACxC,OAAO;QACL,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,GAAG,CAAC,EAAE,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,EAAE,CAAC,qBAAqB;YAC1B,CAAC,CAAC,EAAE,YAAY,EAAE,mBAAmB,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE;YACvD,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,KAA6B;IAE7B,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAClD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAC7B,KAAK,CAAC,WAAW,EACjB,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAC9C,CAAA;IACH,CAAC;IACD,OAAO,YAAY,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,mEAAmE;QACjE,sBAAsB,CACzB;CACJ,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAiB,EACjB,KAAqB;IAErB,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,+DAA+D;YAC/D,sDAAsD;YACtD,qEAAqE;YACrE,6DAA6D;YAC7D,8DAA8D;YAC9D,gCAAgC;QAClC,WAAW,EAAE,2BAA2B;KACzC,EACD,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE;gBAC1C,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAA;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;aAC9D,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;iBAC/C,CAAA;YACH,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/ingestion/index.js

@@ -1,12 +1,15 @@
-// Curated ingestion vertical: seven typed tools over the matcher import
+// Curated ingestion vertical: eight typed tools over the matcher import
 // lifecycle of a reconciliation context — list jobs, get a job, list a job's
 // per-row errors, list a job's transactions, search transactions, ignore a
-// transaction, and upload a file. Every op is fully context-nested under
-// /v1/imports/contexts/{contextId}/... Each tool shares the fail-closed relay
-// (shared.ts) and the RFC 9457 → tool-error mapping (toToolError) with the
-// generic surface, so curated and generic map matcher errors identically. No
-// tool carries a tenant field; contextId is a routing path param matcher
-// validates against the relayed token's tenant.
+// transaction, upload a file, and broker a direct local-file upload. Every
+// backend-dispatching op is fully context-nested under
+// /v1/imports/contexts/{contextId}/... Each dispatching 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. ingestion_upload_begin is MCP-native (no backend
+// dispatch — it computes an upload target locally). No tool carries a tenant
+// field; contextId is a routing path param matcher validates against the
+// relayed token's tenant.
 //
 // NOTE: uploadFile is now curated as ingestion_upload (base64-in-JSON, relay
 // rebuilds the multipart request — see upload.ts). extractDocument stays
@@ -17,8 +20,9 @@ import { registerIngestionJobTransactionsListTool } from './job-transactions-lis
 import { registerIngestionJobsListTool } from './jobs-list.js';
 import { registerIngestionTransactionIgnoreTool } from './transaction-ignore.js';
 import { registerIngestionTransactionsSearchTool } from './transactions-search.js';
+import { registerIngestionUploadBeginTool } from './upload-begin.js';
 import { registerIngestionUploadTool } from './upload.js';
-/** Register all seven curated ingestion tools on the given server. */
+/** Register all eight curated ingestion tools on the given server. */
 export function registerIngestionTools(server) {
     registerIngestionJobsListTool(server);
     registerIngestionJobGetTool(server);
@@ -27,5 +31,6 @@ export function registerIngestionTools(server) {
     registerIngestionTransactionsSearchTool(server);
     registerIngestionTransactionIgnoreTool(server);
     registerIngestionUploadTool(server);
+    registerIngestionUploadBeginTool(server);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/ingestion/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,8EAA8E;AAC9E,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAI7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,wCAAwC,EAAE,MAAM,4BAA4B,CAAA;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,kCAAkC,CAAC,MAAM,CAAC,CAAA;IAC1C,wCAAwC,CAAC,MAAM,CAAC,CAAA;IAChD,uCAAuC,CAAC,MAAM,CAAC,CAAA;IAC/C,sCAAsC,CAAC,MAAM,CAAC,CAAA;IAC9C,2BAA2B,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/ingestion/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,uDAAuD;AACvD,wEAAwE;AACxE,sEAAsE;AACtE,6EAA6E;AAC7E,uEAAuE;AACvE,6EAA6E;AAC7E,yEAAyE;AACzE,0BAA0B;AAC1B,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAI7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,wCAAwC,EAAE,MAAM,4BAA4B,CAAA;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,kCAAkC,CAAC,MAAM,CAAC,CAAA;IAC1C,wCAAwC,CAAC,MAAM,CAAC,CAAA;IAChD,uCAAuC,CAAC,MAAM,CAAC,CAAA;IAC/C,sCAAsC,CAAC,MAAM,CAAC,CAAA;IAC9C,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACnC,gCAAgC,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC"}

package/dist/tools/ingestion/upload-begin.js

@@ -0,0 +1,116 @@
+// `ingestion_upload_begin` — MCP-native broker for uploading a LOCAL file.
+//
+// MCP-over-HTTP cannot stream file bytes through the relay, and base64-in-JSON
+// (ingestion_upload's contentBase64) burns the client's output tokens and hits
+// the relay's ~750 KB practical ceiling. For a real LOCAL file the bytes must
+// go AROUND the relay: this tool brokers the upload TARGET, and the client's
+// own Claude POSTs the multipart file DIRECTLY to matcher's public streaming
+// endpoint using the same bearer it sends this relay. The relay never sees the
+// bytes — there is nothing to dispatch server-side, so the handler is a pure
+// local computation (no backend call, no operationId → invisible to the
+// coverage/parity gates).
+//
+// The returned uploadUrl reuses contextSourceUploadPath so the path encoding
+// matches the real endpoint /v1/imports/contexts/{contextId}/sources/{sourceId}
+// /upload byte-for-byte, built from config.matcherApiUrl. That URL MUST be
+// client-reachable: in cluster deployments where the relay talks to matcher
+// over an internal service DNS name, the operator must point MATCHER_API_URL at
+// the public host so the client's own Claude can POST to it directly.
+import { z } from 'zod';
+import { loadConfig } from '../../config.js';
+import { contextSourceUploadPath } from './shared.js';
+/** Zod raw shape for `ingestion_upload_begin` input. */
+export const ingestionUploadBeginInputShape = {
+    contextId: z
+        .string()
+        .min(1)
+        .describe('The reconciliation context id (UUID) to upload into. The context MUST ' +
+        'already exist and be ACTIVE — uploading to a DRAFT context is rejected ' +
+        'with 403. Create it first with context_create if needed.'),
+    sourceId: z
+        .string()
+        .min(1)
+        .describe('The source id (UUID) within that context to upload into. Must already ' +
+        'exist — create it first with source_create if needed.'),
+    format: z
+        .string()
+        .optional()
+        .describe('The ingestion format you will send (e.g. csv | json | xml | camt053). ' +
+        'Used to build a concrete example in the returned instructions; the ' +
+        'actual value you send is the `format` multipart field.'),
+};
+/**
+ * Register `ingestion_upload_begin`. Pure local computation: builds the client-
+ * reachable upload URL + the multipart contract and returns them as a JSON
+ * text block. No relay dispatch, no auth material in the output.
+ */
+export function registerIngestionUploadBeginTool(server) {
+    server.registerTool('ingestion_upload_begin', {
+        description: 'Broker a DIRECT, client-to-matcher upload of a LOCAL file. MCP-over-' +
+            'HTTP cannot stream file bytes through this relay, so instead of ' +
+            'sending the bytes here, call this tool to get the upload TARGET, then ' +
+            'have YOUR OWN Claude POST the multipart file straight to matcher using ' +
+            'the same bearer you send this relay — the relay never touches the ' +
+            'bytes. Returns { uploadUrl, method, fileField, formatField, ' +
+            'fieldOrder, contextId, sourceId, baseUrlUsed, instructions }. Use this ' +
+            'for real local files; for tiny inline payloads use ingestion_upload ' +
+            'with contentBase64. No tenant field, no auth material is returned.',
+        inputSchema: ingestionUploadBeginInputShape,
+    }, async (args) => {
+        const cfg = loadConfig();
+        const baseUrl = cfg.matcherApiUrl;
+        const uploadUrl = baseUrl + contextSourceUploadPath(args.contextId, args.sourceId);
+        const formatExample = args.format ?? 'csv';
+        const instructions = [
+            'Upload a LOCAL file directly to matcher (the relay never sees the ' +
+                'bytes). Steps for a blind operator:',
+            '1. PREREQUISITES: the context (' +
+                args.contextId +
+                ') must EXIST and be ACTIVE, and the source (' +
+                args.sourceId +
+                ') must EXIST. Create them first with context_create + source_create ' +
+                'if needed, and ACTIVATE the context — uploading to a DRAFT context ' +
+                'returns 403.',
+            '2. POST a multipart/form-data request to uploadUrl (' +
+                uploadUrl +
+                ') reusing YOUR OWN bearer token — send the SAME Authorization header ' +
+                'you send this relay. The relay is not in this path; you talk to ' +
+                'matcher directly.',
+            '3. FIELD ORDER IS LOAD-BEARING: append the `format` field BEFORE the ' +
+                '`file` part. If the `file` part arrives first, matcher falls back to ' +
+                'inferring the format from the filename extension, which CANNOT ' +
+                'detect camt053 (and mis-resolves ambiguous .xml). Example fields in ' +
+                'order: format="' +
+                formatExample +
+                '" then file=@<your-local-file>.',
+            '4. On success matcher returns 202 with a jobId. POLL ingestion_job_get ' +
+                '(with this contextId and that jobId) to watch status. COMPLETED and ' +
+                'FAILED are terminal; on FAILED read the `diagnosis` field for the ' +
+                'reason.',
+            '5. SIZE CAP: the streaming route is governed by the operator-' +
+                'configured runtime key ingestion.max_upload_bytes (default ~1 GiB; ' +
+                'range 1 MiB–8 GiB). It counts the TOTAL request body — every part, ' +
+                'header, and boundary, not just the file. A body over the limit ' +
+                'returns 413 (an over-limit upload detected mid-stream also fails the ' +
+                'job with a diagnosis). This cap is independent of the relay body ' +
+                'cap, which does not apply since the bytes bypass the relay.',
+            'baseUrlUsed came from MATCHER_API_URL, which MUST be a client-' +
+                'reachable (public) address. If this URL is an internal/cluster ' +
+                'address your local Claude cannot reach, the operator must point ' +
+                'MATCHER_API_URL at the public matcher host.',
+        ].join('\n');
+        const contract = {
+            uploadUrl,
+            method: 'POST',
+            fileField: 'file',
+            formatField: 'format',
+            fieldOrder: ['format', 'file'],
+            contextId: args.contextId,
+            sourceId: args.sourceId,
+            baseUrlUsed: baseUrl,
+            instructions,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(contract) }] };
+    });
+}
+//# sourceMappingURL=upload-begin.js.map

package/dist/tools/ingestion/upload-begin.js.map

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

package/dist/tools/ingestion/upload.js

@@ -2,28 +2,23 @@
 // /v1/imports/contexts/{contextId}/sources/{sourceId}/upload.
 //
 // The backend endpoint is multipart/form-data, which a JSON MCP tool can't
-// carry directly. This tool accepts the file body one of two ways and the
-// relay rebuilds the real multipart request either way: wrap the bytes in a
-// `FormData` and let `matcher/client.ts`'s FormData branch hand it to `fetch`
-// untouched (no JSON.stringify, no content-type override — the runtime sets
-// the multipart boundary itself).
+// carry directly. This tool accepts the file body inline as base64 and the
+// relay rebuilds the real multipart request: wrap the bytes in a `FormData`
+// and let `matcher/client.ts`'s FormData branch hand it to `fetch` untouched
+// (no JSON.stringify, no content-type override — the runtime sets the
+// multipart boundary itself).
 //
-//   - `contentBase64`: the file inline, base64-encoded. Fine for small files,
-//     but base64-in-a-tool-call does NOT scale — an LLM client must emit the
+//   - `contentBase64`: the file inline, base64-encoded. This is the path for
+//     SMALL, programmatically-generated payloads — an LLM client must emit the
 //     whole encoded string in its OUTPUT tokens, and base64 inflates bytes by
 //     ~33% on top of that (a 1000-row file is easily ~150k tokens). Practical
 //     ceiling: the relay's inbound JSON body cap (1 MiB default,
 //     MAX_BODY_BYTES override) means raw files up to ~750 KB upload cleanly.
-//   - `fileUrl`: a URL to the file. The RELAY fetches the bytes server-side
-//     (see fetch-source.ts) — the client only ever emits a short URL, so this
-//     is the path for real files. The fetch is SSRF-guarded: only hostnames
-//     in MCP_UPLOAD_ALLOWED_HOSTS (exact match, empty by default) are
-//     reachable, redirects are rejected, and the response is size-capped by
-//     MCP_UPLOAD_MAX_FETCH_BYTES.
 //
-// Exactly one of the two must be provided — validated in the handler (Huma's
-// inputSchema is a raw Zod shape, not a refinable ZodObject, so cross-field
-// "exactly one of" can't live in the schema itself).
+// For a real LOCAL file (bytes on the operator's disk), use
+// ingestion_upload_begin (upload-begin.ts) instead, which brokers a direct
+// client→matcher upload so the bytes never traverse the relay or the token
+// budget.
 //
 // Field order matters: `format` MUST be appended BEFORE `file`. The backend's
 // streaming multipart parser binds the declared format from whichever field
@@ -36,10 +31,13 @@
 // validates both against the relayed token's tenant. No tenant field is
 // accepted here either.
 import { z } from 'zod';
-import { loadConfig } from '../../config.js';
-import { fetchSourceFile } from './fetch-source.js';
 import { contextSourceUploadPath, dispatchIngestion } from './shared.js';
-/** Declared parse formats the backend accepts for an ingestion upload. */
+/** Current known parse formats the backend accepts for an ingestion upload.
+ *  Not a closed enum on the input schema: ingestion formats are a GROWING set
+ *  (the connector-parity roadmap adds parsers), so the field is typed as a free
+ *  string and this list only feeds the description as a hint — a closed enum
+ *  would lag the backend and reject a valid new format at the client. See
+ *  docs/enum-policy.md (registered in INTENTIONALLY_OPEN_FIELDS). */
 const UPLOAD_FORMATS = ['csv', 'json', 'xml', 'camt053'];
 /** Zod raw shape for `ingestion_upload` input — path ids + format + file. */
 export const ingestionUploadInputShape = {
@@ -55,103 +53,55 @@ export const ingestionUploadInputShape = {
         .describe('The source id (UUID) within the context to upload into. Must already ' +
         'exist (create it first with source_create).'),
     format: z
-        .enum(UPLOAD_FORMATS)
-        .describe('The declared parse format of the file: csv | json | xml | camt053. ' +
-        'Sent as the first multipart field — matcher binds the format from it ' +
-        'before reading the file, so always pass the true format rather than ' +
-        'relying on filename-extension inference.'),
+        .string()
+        .min(1)
+        .describe('The declared parse format of the file. Free-form string — the backend ' +
+        'validates and the accepted set grows as new parsers are added. ' +
+        'Current known formats: ' +
+        UPLOAD_FORMATS.join(' | ') +
+        '. Sent as the first multipart field — matcher binds the format from ' +
+        'it before reading the file, so always pass the true format rather ' +
+        'than relying on filename-extension inference.'),
     filename: z
         .string()
         .min(1)
         .describe('The original file name (e.g. "transactions.csv"), sent as the ' +
         'multipart filename for the file part.'),
     contentBase64: z
-        .string()
-        .base64()
-        .optional()
-        .describe('The file bytes, base64-encoded. For SMALL files only — base64 inflates ' +
-        'bytes by ~33% and the LLM client must emit the whole encoded string ' +
-        'as output tokens. The relay\'s inbound JSON body is capped (1 MiB by ' +
-        'default, MAX_BODY_BYTES env override), so raw files up to ~750 KB ' +
-        'upload cleanly under the default. Exactly one of contentBase64 / ' +
-        'fileUrl is required; for real files prefer fileUrl.'),
-    fileUrl: z
         .string()
         .min(1)
-        .optional()
-        .describe('A URL the RELAY fetches the file from server-side — the client sends ' +
-        'only this short URL, not the file bytes, so this is the path for ' +
-        'real files (no output-token inflation). The fetch is SSRF-guarded: ' +
-        'only hostnames listed in MCP_UPLOAD_ALLOWED_HOSTS are reachable ' +
-        '(empty allowlist by default — every host is rejected until an ' +
-        'operator opts one in), redirects are rejected, and the response is ' +
-        'capped at MCP_UPLOAD_MAX_FETCH_BYTES (50 MiB default). Exactly one ' +
-        'of contentBase64 / fileUrl is required.'),
+        .base64()
+        .describe('The file bytes, base64-encoded (required). For SMALL, programmatically-' +
+        'generated payloads only — base64 inflates bytes by ~33% and the LLM ' +
+        'client must emit the whole encoded string as output tokens. The ' +
+        'relay\'s inbound JSON body is capped (1 MiB by default, MAX_BODY_BYTES ' +
+        'env override), so raw files up to ~750 KB upload cleanly under the ' +
+        'default. For a real LOCAL file use ingestion_upload_begin instead (it ' +
+        'brokers a direct upload that bypasses this token/body cap).'),
 };
 /**
- * Register `ingestion_upload`. Resolves the file bytes from exactly one of
- * `contentBase64` (decode) or `fileUrl` (SSRF-guarded server-side fetch — see
- * fetch-source.ts), then rebuilds a `FormData` with `format` appended before
- * `file` (order is load-bearing — see module comment) and dispatches the POST
- * through the shared fail-closed relay; a matcher error (e.g. 403 inactive
- * context, 400 malformed file) surfaces via the shared toToolError.
+ * Register `ingestion_upload`. Decodes the file bytes from `contentBase64`,
+ * then rebuilds a `FormData` with `format` appended before `file` (order is
+ * load-bearing — see module comment) and dispatches the POST through the shared
+ * fail-closed relay; a matcher error (e.g. 403 inactive context, 400 malformed
+ * file) surfaces via the shared toToolError.
  */
 export function registerIngestionUploadTool(server) {
     server.registerTool('ingestion_upload', {
-        description: 'Upload a file into a source for ingestion. Provide the file body ' +
-            'via EXACTLY ONE of two ways: (1) contentBase64 — the file inline as ' +
-            'base64 in JSON, for SMALL files only (raw files up to ~750 KB; ' +
-            'larger payloads burn the calling LLM\'s output tokens and risk the ' +
-            'relay\'s inbound body cap). (2) fileUrl — a URL the relay fetches ' +
-            'server-side, so the client sends only the short URL; this is the ' +
-            'path for real files. fileUrl fetches are restricted to an explicit ' +
-            'hostname allowlist (MCP_UPLOAD_ALLOWED_HOSTS, empty by default) and ' +
-            'size-capped (MCP_UPLOAD_MAX_FETCH_BYTES); a non-allowlisted host is ' +
-            'rejected before any network call. Either way the relay rebuilds the ' +
-            'multipart/form-data upload the matcher backend expects. ' +
+        description: 'Upload a file into a source for ingestion by passing the file body ' +
+            'inline as contentBase64 — base64 in JSON, for SMALL programmatic ' +
+            'payloads only (raw files up to ~750 KB; larger payloads burn the ' +
+            'calling LLM\'s output tokens and risk the relay\'s inbound body cap). ' +
+            'For a real LOCAL file use ingestion_upload_begin instead (a direct ' +
+            'client→matcher upload that bypasses this relay entirely). The relay ' +
+            'rebuilds the multipart/form-data upload the matcher backend expects. ' +
             'Prerequisites: the context must be ACTIVE and the sourceId must ' +
             'already exist. No tenant field is accepted. Returns the 202 job ' +
             'response, or a structured RFC 9457 error (e.g. 403 if the context ' +
             'is not ACTIVE).',
         inputSchema: ingestionUploadInputShape,
     }, async (args, extra) => {
-        const hasBase64 = args.contentBase64 !== undefined;
-        const hasFileUrl = args.fileUrl !== undefined;
-        if (hasBase64 === hasFileUrl) {
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: 'text',
-                        text: 'ingestion_upload requires exactly one of contentBase64 or ' +
-                            `fileUrl, got ${hasBase64 ? 'both' : 'neither'}.`,
-                    },
-                ],
-            };
-        }
-        let bytes;
-        if (hasBase64) {
-            bytes = Buffer.from(args.contentBase64, 'base64');
-        }
-        else {
-            const cfg = loadConfig();
-            try {
-                bytes = await fetchSourceFile(args.fileUrl, {
-                    allowedHosts: cfg.uploadAllowedHosts,
-                    maxBytes: cfg.uploadMaxFetchBytes,
-                    timeoutMs: cfg.timeoutMs,
-                });
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : 'unknown error';
-                return {
-                    isError: true,
-                    content: [
-                        { type: 'text', text: `failed to fetch fileUrl: ${message}` },
-                    ],
-                };
-            }
-        }
+        const bytes = Buffer.from(args.contentBase64, 'base64');
         const form = new FormData();
         // 'format' MUST precede 'file' — see module comment.
         form.append('format', args.format);

package/dist/tools/ingestion/upload.js.map

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

package/dist/tools/source/create.js

@@ -46,8 +46,10 @@ export const createSourceInputShape = {
         'reconciled against each other.'),
     config: z
         .record(z.string(), z.unknown())
+        .optional()
         .describe('Source-specific configuration object (connection and parsing settings). ' +
-        'Its shape depends on the source type and is validated server-side.'),
+        'Optional; defaults to an empty object server-side when omitted. Its ' +
+        'shape depends on the source type and is validated server-side.'),
 };
 /**
  * Build the POST body from the input minus the path-only `contextId`. Only the
@@ -68,8 +70,9 @@ export function registerSourceCreateTool(server) {
     server.registerTool('source_create', {
         description: 'Create a reconciliation source under a context. Provide contextId ' +
             '(UUID path param — not a tenant field), name (1–50), type ' +
-            '(LEDGER|BANK|GATEWAY|CUSTOM|FETCHER), side (LEFT|RIGHT), and a ' +
-            'type-specific config object (validated server-side). The source is ' +
+            '(LEDGER|BANK|GATEWAY|CUSTOM|FETCHER), side (LEFT|RIGHT), and an ' +
+            'optional type-specific config object (validated server-side; defaults ' +
+            'to an empty object when omitted). The source is ' +
             "created for your token's tenant (no tenant field is accepted). Returns " +
             'the created source, or a structured RFC 9457 error.',
         inputSchema: createSourceInputShape,

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerianstudio/matcher-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "description": "Model Context Protocol server for the Matcher reconciliation engine",
   "license": "Apache-2.0",