@lerianstudio/matcher-mcp 6.0.0-beta.2 → 6.0.0-beta.20

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@lerianstudio/matcher-mcp",
-  "version": "6.0.0-beta.2",
+  "version": "6.0.0-beta.20",
   "type": "module",
   "description": "Model Context Protocol server for the Matcher reconciliation engine",
-  "license": "Apache-2.0",
+  "license": "LicenseRef-Lerian-Proprietary",
   "author": "Lerian Studio",
   "keywords": [
     "model-context-protocol",
@@ -24,10 +24,10 @@
   "files": [
     "dist"
   ],
-  "packageManager": "pnpm@11.5.2",
+  "packageManager": "pnpm@11.28.6",
   "engines": {
     "node": ">=22",
-    "pnpm": ">=11.5.2 <12"
+    "pnpm": ">=11.28.6 <12"
   },
   "bin": {
     "matcher-mcp": "./dist/server.js"

package/dist/tools/workspace/usage.js

@@ -1,111 +0,0 @@
-// `workspace_usage` — curated GET /v1/workspace/billing, the ONE tenant-usage
-// surface, plus the single derived number the answer needs.
-//
-// "How much of my free tier is left?" is the question the copilot is expected to
-// answer (and to raise proactively), and until now it could only be reached by
-// the generic trio — which requires the model to already know the operationId
-// `workspace-billing`. Cost of curating it: one tool, no input, read-only.
-//
-// The backend is the authority on the verdict: `trialExpired` / `expiryReason` /
-// `daysRemaining` / `linesRemaining` are all derived by the TrialExpiry oracle
-// server-side and are relayed VERBATIM here — this tool never re-decides whether
-// a trial is over. It adds exactly one field, `usedPercent`, because that is
-// presentation (the shape of the answer), not enforcement.
-//
-// There is no input at all: the tenant comes from the relayed token's claims, so
-// there is nothing for a caller to pass — and nothing that could be spoofed.
-import { dispatchToolRequest } from '../shared-dispatch.js';
-/** The billing read path (tenant-scoped; tenant resolved from the token, not the path). */
-const WORKSPACE_BILLING_PATH = '/v1/workspace/billing';
-/**
- * Free-tier consumption as an already-scaled percent, rounded to one decimal, or
- * `null` when no honest percentage exists.
- *
- * Normally 0..100, but NOT clamped there: the matched-line counter is monotonic
- * and uncapped and the quota gate only refuses the next request, so a run already
- * in flight overshoots the cap. Clamping would hide the overshoot; the true
- * number is the honest answer, and the tool description says it can exceed 100.
- *
- * `null` off-trial is the point, not a fallback: the backend reads the
- * matched-line counter ONLY for a trialing workspace, so a converted/paid tenant
- * comes back with `matchedLines: 0` against a non-zero limit. Reporting that as
- * "0% consumed" would tell the model a paid plan has a full free allotment
- * waiting — it has no free-tier cap at all. Same for a non-positive limit or a
- * missing figure: no denominator, no percentage.
- */
-export function usedPercent(body) {
-    if (body?.billingStatus !== 'trialing') {
-        return null;
-    }
-    const { matchedLines, matchedLineLimit } = body;
-    if (typeof matchedLines !== 'number' || typeof matchedLineLimit !== 'number') {
-        return null;
-    }
-    if (!(matchedLineLimit > 0)) {
-        return null;
-    }
-    // One decimal is all a spoken answer needs, and it keeps float noise
-    // (82.00000000000001) out of the model's context.
-    return Math.round((matchedLines / matchedLineLimit) * 1000) / 10;
-}
-/**
- * Register `workspace_usage`. Reads the caller's own commercial state through the
- * SHARED fail-closed relay — the additive percent rides its success-body
- * transform, so the credential refusal and the RFC 9457 mapping are the shared
- * ones rather than a local copy (that copy was BUG-06) — and returns the body
- * verbatim plus `usedPercent`. A matcher error
- * (404 for a tenant with no self-serve workspace, 403 MTCH-0021 for a
- * billing-suspended one) surfaces via the shared toToolError, so the model can
- * branch on `status`/`code` exactly as it does on every other tool.
- */
-export function registerWorkspaceUsageTool(server) {
-    server.registerTool('workspace_usage', {
-        description: "Report how much of the free tier is left for the caller's own " +
-            'workspace. Takes NO arguments — the workspace is resolved from your ' +
-            'relayed credential, so there is no tenant to pass. Returns the ' +
-            'commercial state as the backend derives it: plan; billingStatus ' +
-            '(trialing, active, past_due, suspended); the TIME axis (trialEndsAt, ' +
-            'daysRemaining); the VOLUME axis (matchedLines consumed, ' +
-            'matchedLineLimit, linesRemaining); the unified verdict (trialExpired, ' +
-            'and expiryReason — "", "time", "volume", or "time_and_volume"); plus ' +
-            'usedPercent, the volume axis as a percentage — normally 0..100, but it ' +
-            'can exceed 100 when a match run already in flight walks past the cap ' +
-            '(the counter is uncapped and the quota gate only refuses the NEXT ' +
-            'request), and it is reported unclamped so the overshoot stays visible. ' +
-            'usedPercent is ' +
-            'null when the workspace is NOT trialing: a paid plan has no free-tier ' +
-            'cap, so its zeroed volume figures mean "not measured", not "nothing ' +
-            'consumed" — say the plan has no free-tier limit rather than quoting ' +
-            '0%. Never re-derive whether the trial is over; trialExpired and ' +
-            'expiryReason are the authority. Returns a structured RFC 9457 error on ' +
-            'failure (404 when the caller has no self-serve workspace, 403 ' +
-            'MTCH-0021 when billing has suspended it). Also returns the money in ' +
-            'both directions, in integer BRL cents: overageCreditBalanceCents ' +
-            '(prepaid credit left) and overageUncoveredCents (overage already ' +
-            'incurred that the credit did not cover — what the workspace OWES). ' +
-            'The second is a receivable, not a negative balance: a new billing ' +
-            'period does not clear it, so never tell a customer a rollover settled ' +
-            'it, and never report it as a credit. ' +
-            'When a commercial ACTION on this workspace is refused, the refusal ' +
-            'carries a code from onboarding\'s own MTCH-08xx family and the code is ' +
-            'the answer, not the sentence: 0801 no payment processor is configured ' +
-            '(retrying never clears it) vs 0802 the processor could not be asked ' +
-            '(retry) — both arrive as a 503 whose detail is scrubbed to "internal ' +
-            'error"; 0803 a subscription the processor can still bill; 0804 only ' +
-            'the enterprise plan is operator-assigned; 0805 the billing status ' +
-            'forbids the change; 0806 the plan is set by contract, so nothing ' +
-            'self-serve applies; 0807 already subscribed; 0808 a checkout is open ' +
-            'for a different plan or interval; 0809 a checkout is being opened ' +
-            'right now; 0810 no billing account yet; 0811 a billing event id was ' +
-            'replayed with different content; 0812 the workspace exists and may be ' +
-            'the caller\'s own; 0813 the name belongs to another account; 0814 the ' +
-            'plan is not sold self-serve; 0815 the credit amount is out of range.',
-    }, async (extra) => dispatchToolRequest({ method: 'GET', path: WORKSPACE_BILLING_PATH }, extra, undefined, 
-    // Spread, don't rebuild: the backend's fields are relayed unchanged and
-    // the derived percent is purely additive.
-    (billing) => ({
-        ...billing,
-        usedPercent: usedPercent(billing),
-    })));
-}
-//# sourceMappingURL=usage.js.map

package/dist/tools/workspace/usage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/tools/workspace/usage.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,6EAA6E;AAC7E,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAI7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,2FAA2F;AAC3F,MAAM,sBAAsB,GAAG,uBAAuB,CAAA;AAatD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsC;IAEtC,IAAI,IAAI,EAAE,aAAa,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qEAAqE;IACrE,kDAAkD;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,gBAAgB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,gEAAgE;YAChE,sEAAsE;YACtE,iEAAiE;YACjE,kEAAkE;YAClE,uEAAuE;YACvE,0DAA0D;YAC1D,wEAAwE;YACxE,uEAAuE;YACvE,yEAAyE;YACzE,uEAAuE;YACvE,oEAAoE;YACpE,yEAAyE;YACzE,iBAAiB;YACjB,wEAAwE;YACxE,sEAAsE;YACtE,sEAAsE;YACtE,kEAAkE;YAClE,yEAAyE;YACzE,gEAAgE;YAChE,sEAAsE;YACtE,mEAAmE;YACnE,mEAAmE;YACnE,qEAAqE;YACrE,oEAAoE;YACpE,wEAAwE;YACxE,uCAAuC;YACvC,qEAAqE;YACrE,yEAAyE;YACzE,wEAAwE;YACxE,sEAAsE;YACtE,uEAAuE;YACvE,sEAAsE;YACtE,oEAAoE;YACpE,mEAAmE;YACnE,uEAAuE;YACvE,oEAAoE;YACpE,sEAAsE;YACtE,wEAAwE;YACxE,wEAAwE;YACxE,sEAAsE;KACzE,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,CACd,mBAAmB,CACjB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAC/C,KAAK,EACL,SAAS;IACT,wEAAwE;IACxE,0CAA0C;IAC1C,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACZ,GAAI,OAA4C;QAChD,WAAW,EAAE,WAAW,CAAC,OAA2C,CAAC;KACtE,CAAC,CACH,CACJ,CAAA;AACH,CAAC"}