@one-source/api-mcp 5.4.6 → 5.5.0

package/dist/mpp.d.ts

@@ -0,0 +1,40 @@
+export type MppMode = 'charge' | 'session';
+export interface MppSessionHandle {
+    /** Payment-aware fetch that drives the voucher-channel lifecycle. */
+    fetch: typeof globalThis.fetch;
+    /** Whether the session manager initialised and can be selected. */
+    available: boolean;
+}
+export interface MppSetupResult {
+    enabled: boolean;
+    address?: string;
+    /** Per-call charge fetch, present whenever MPP is enabled. */
+    chargeFetch?: typeof globalThis.fetch;
+    /** Voucher-channel session handle. */
+    session?: MppSessionHandle;
+}
+export declare function setupMpp(): MppSetupResult;
+/** Whether MPP payment is active (MPP_PRIVATE_KEY set). */
+export declare function isMppEnabled(): boolean;
+/** Payer wallet address, when enabled. */
+export declare function getMppAddress(): string | undefined;
+/** Whether the session channel scheme initialised and can be selected. */
+export declare function isMppSessionAvailable(): boolean;
+/**
+ * Cooperatively close the active MPP voucher channel, settling the latest
+ * authorized spend on-chain and reclaiming the unspent deposit to the payer
+ * wallet. Safe to call when no channel was ever opened (no-op) and idempotent.
+ * Swallows errors so a stuck settle can't hang shutdown.
+ *
+ * We do NOT use `manager.close()`: mppx's legacy manager signs the close at its
+ * locally-tracked `spent`, which it derives from the receipt `spent` field. The
+ * gateway (mpp-go) reports `spent` as the per-call delta and the running total
+ * in `acceptedCumulative`, so mppx's `spent` never advances past the first
+ * voucher and the close is rejected ("close cumulativeAmount … below the last
+ * accepted voucher"). Instead we sign our own close credential at the manager's
+ * `cumulative` (the total we authorized and the gateway accepted) and POST it —
+ * validated end-to-end against the live gateway. Track the upstream fix at
+ * wevm/mppx; switch back to `manager.close()` once it uses `acceptedCumulative`.
+ */
+export declare function closeMppSession(): Promise<void>;
+//# sourceMappingURL=mpp.d.ts.map

package/dist/mpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.d.ts","sourceRoot":"","sources":["../src/mpp.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACtC,sCAAsC;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AA4BD,wBAAgB,QAAQ,IAAI,cAAc,CAmGzC;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BrD"}

package/dist/mpp.js

@@ -0,0 +1,217 @@
+/**
+ * MPP (Tempo Machine Payments Protocol) payment setup.
+ *
+ * When MPP_PRIVATE_KEY is set, builds payment-aware fetch wrappers that handle
+ * HTTP 402 `WWW-Authenticate: Payment` challenges from the gateway by signing
+ * Tempo payments (USDC.e / pathUSD) via the `mppx` SDK.
+ *
+ * Two sub-modes, both using the same MPP_PRIVATE_KEY wallet:
+ *  - `charge`  — one signed Tempo payment per call (the default). Local accounts
+ *                sign in `pull` mode (server broadcasts), so no Tempo RPC is
+ *                needed — the network/currency/recipient come from the gateway
+ *                challenge, exactly like x402 `exact`.
+ *  - `session` — a TIP-1034 voucher channel: the first call opens a channel
+ *                on-chain (capped by MPP_MAX_DEPOSIT), subsequent calls are
+ *                signed off-chain as cumulative vouchers, and the unspent
+ *                deposit is reclaimed by `closeMppSession()` on shutdown.
+ *
+ * Like x402.ts, this returns the wrapped fetches instead of patching
+ * globalThis.fetch (Mppx.create polyfills global by default — we pass
+ * polyfill:false), so only the OneSourceClient pays; analytics and other HTTP
+ * consumers are unaffected. The unified `payment.ts` orchestrator selects
+ * between the charge fetch and the session fetch based on the active mode.
+ */
+import { Mppx, tempo, sessionLegacyManager, sessionLegacy } from 'mppx/client';
+import { privateKeyToAccount } from 'viem/accounts';
+import { createPublicClient, http } from 'viem';
+import { tempo as tempoChain } from 'viem/chains';
+// Human-readable cap (in token units) on a session channel's on-chain deposit.
+// Bounds the worst-case locked balance if the process dies before close.
+const DEFAULT_MAX_DEPOSIT = '1';
+let _applied = false;
+let _cachedResult;
+let _enabled = false;
+let _address;
+let _sessionAvailable = false;
+// The mppx session manager, retained so `closeMppSession` can cooperatively
+// settle and reclaim the unspent deposit on shutdown.
+let _sessionManager;
+// The legacy session method + the strip-x402 fetch + the last session request's
+// URL and challenge — used by closeMppSession to sign and POST our own close
+// credential at the locally-authorized cumulative (see closeMppSession).
+let _sessionMethod;
+let _sessionFetchImpl;
+let _lastSessionUrl;
+let _lastSessionChallenge;
+let _sessionClosed = false;
+function maxDeposit() {
+    return process.env.MPP_MAX_DEPOSIT?.trim() || DEFAULT_MAX_DEPOSIT;
+}
+export function setupMpp() {
+    const rawKey = process.env.MPP_PRIVATE_KEY;
+    if (!rawKey)
+        return { enabled: false };
+    if (_applied && _cachedResult)
+        return _cachedResult;
+    // Auto-prepend 0x — viem requires it but private keys are not typically stored with it
+    const privateKey = rawKey.startsWith('0x')
+        ? rawKey
+        : `0x${rawKey}`;
+    const account = privateKeyToAccount(privateKey);
+    // The gateway advertises BOTH x402 (Payment-Required header) and MPP
+    // (WWW-Authenticate: Payment) on every 402. mppx's HTTP transport eagerly
+    // parses the x402 header too, and its x402 decoder can't read the gateway's
+    // (coinbase-style) Payment-Required header — it throws before the MPP
+    // challenge is ever used. Strip Payment-Required from 402s so mppx only sees
+    // the MPP challenge; the x402 rail is handled separately by x402.ts.
+    const stripX402Fetch = async (input, init) => {
+        const res = await fetch(input, init);
+        if (res.status === 402 && res.headers.has('payment-required')) {
+            const headers = new Headers(res.headers);
+            headers.delete('payment-required');
+            return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
+        }
+        return res;
+    };
+    // --- charge method (per-call payment) ---
+    // Register only the `charge` intent so this fetch always pays per-call (the
+    // bare `tempo()` factory would also register the session intent). polyfill:
+    // false keeps globalThis.fetch untouched.
+    const chargeClient = Mppx.create({
+        methods: [tempo.charge({ account })],
+        polyfill: false,
+        fetch: stripX402Fetch,
+    });
+    const chargeFetch = (input, init) => chargeClient.fetch(input, init);
+    // --- session method (voucher channel) ---
+    // Built eagerly but lazily funded: no on-chain channel opens until the first
+    // paid request is made while in session mode. The manager needs a viem client
+    // (Tempo chain + RPC) to open/settle the channel. If construction fails, fall
+    // back to charge-only rather than crashing the MCP.
+    //
+    // We use the LEGACY session manager: the gateway (tempoxyz/mpp-go) emits v1
+    // session challenges (no `sessionProtocol` marker), which mppx's current
+    // `tempo.session.manager` rejects (it requires sessionProtocol v2). The
+    // legacy manager accepts `sessionProtocol` undefined|v1. Switch to the v2
+    // manager once the gateway advertises sessionProtocol v2.
+    let session;
+    try {
+        const sessionClient = createPublicClient({
+            chain: tempoChain,
+            transport: http(process.env.MPP_RPC_URL?.trim() || undefined),
+        });
+        _sessionManager = sessionLegacyManager({
+            account,
+            client: sessionClient,
+            maxDeposit: maxDeposit(),
+            fetch: stripX402Fetch,
+        });
+        // A standalone legacy session method (same account/client) used by
+        // closeMppSession to sign our own close credential — see there for why.
+        // The method factory takes `getClient` (the `client` shorthand is
+        // manager-only).
+        _sessionMethod = sessionLegacy({ account, getClient: () => sessionClient });
+        _sessionFetchImpl = stripX402Fetch;
+        const mgr = _sessionManager;
+        // Capture the last session request's URL + parsed challenge so the shutdown
+        // close can target the right endpoint and bind to a valid challenge.
+        const sessionFetch = async (input, init) => {
+            const res = await mgr.fetch(input, init);
+            _lastSessionUrl = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+            const challenge = res.challenge;
+            if (challenge)
+                _lastSessionChallenge = challenge;
+            return res;
+        };
+        _sessionAvailable = true;
+        session = { fetch: sessionFetch, available: true };
+    }
+    catch (err) {
+        _sessionAvailable = false;
+        _sessionManager = undefined;
+        console.error(`[onesource-api] warning: MPP session channel unavailable (${err instanceof Error ? err.message : String(err)}); falling back to charge-only`);
+    }
+    _enabled = true;
+    _address = account.address;
+    _applied = true;
+    _cachedResult = {
+        enabled: true,
+        address: account.address,
+        chargeFetch,
+        ...(session ? { session } : {}),
+    };
+    return _cachedResult;
+}
+/** Whether MPP payment is active (MPP_PRIVATE_KEY set). */
+export function isMppEnabled() {
+    return _enabled;
+}
+/** Payer wallet address, when enabled. */
+export function getMppAddress() {
+    return _address;
+}
+/** Whether the session channel scheme initialised and can be selected. */
+export function isMppSessionAvailable() {
+    return _sessionAvailable;
+}
+/**
+ * Cooperatively close the active MPP voucher channel, settling the latest
+ * authorized spend on-chain and reclaiming the unspent deposit to the payer
+ * wallet. Safe to call when no channel was ever opened (no-op) and idempotent.
+ * Swallows errors so a stuck settle can't hang shutdown.
+ *
+ * We do NOT use `manager.close()`: mppx's legacy manager signs the close at its
+ * locally-tracked `spent`, which it derives from the receipt `spent` field. The
+ * gateway (mpp-go) reports `spent` as the per-call delta and the running total
+ * in `acceptedCumulative`, so mppx's `spent` never advances past the first
+ * voucher and the close is rejected ("close cumulativeAmount … below the last
+ * accepted voucher"). Instead we sign our own close credential at the manager's
+ * `cumulative` (the total we authorized and the gateway accepted) and POST it —
+ * validated end-to-end against the live gateway. Track the upstream fix at
+ * wevm/mppx; switch back to `manager.close()` once it uses `acceptedCumulative`.
+ */
+export async function closeMppSession() {
+    if (_sessionClosed)
+        return;
+    _sessionClosed = true;
+    const mgr = _sessionManager;
+    if (!mgr?.opened || !_sessionMethod || !_sessionFetchImpl || !_lastSessionUrl || !_lastSessionChallenge) {
+        return;
+    }
+    try {
+        const credential = await _sessionMethod.createCredential({
+            challenge: _lastSessionChallenge,
+            context: {
+                action: 'close',
+                channelId: mgr.channelId,
+                cumulativeAmountRaw: mgr.cumulative.toString(),
+            },
+        });
+        const res = await _sessionFetchImpl(_lastSessionUrl, {
+            method: 'POST',
+            headers: { Authorization: credential },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`gateway returned ${res.status}${body ? `: ${body.slice(0, 160)}` : ''}`);
+        }
+    }
+    catch (err) {
+        console.error(`[onesource-api] warning: MPP session close failed (${err instanceof Error ? err.message : String(err)}); unspent deposit is reclaimable later on-chain`);
+    }
+}
+/** @internal -- for test teardown only */
+export function resetMpp() {
+    _applied = false;
+    _cachedResult = undefined;
+    _enabled = false;
+    _address = undefined;
+    _sessionAvailable = false;
+    _sessionManager = undefined;
+    _sessionMethod = undefined;
+    _sessionFetchImpl = undefined;
+    _lastSessionUrl = undefined;
+    _lastSessionChallenge = undefined;
+    _sessionClosed = false;
+}
+//# sourceMappingURL=mpp.js.map

package/dist/mpp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.js","sourceRoot":"","sources":["../src/mpp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBlD,+EAA+E;AAC/E,yEAAyE;AACzE,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,IAAI,QAAQ,GAAG,KAAK,CAAC;AACrB,IAAI,aAAyC,CAAC;AAE9C,IAAI,QAAQ,GAAG,KAAK,CAAC;AACrB,IAAI,QAA4B,CAAC;AACjC,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAC9B,4EAA4E;AAC5E,sDAAsD;AACtD,IAAI,eAAoE,CAAC;AACzE,gFAAgF;AAChF,6EAA6E;AAC7E,yEAAyE;AACzE,IAAI,cAA4D,CAAC;AACjE,IAAI,iBAAsD,CAAC;AAC3D,IAAI,eAAmC,CAAC;AACxC,IAAI,qBAA8B,CAAC;AACnC,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvC,IAAI,QAAQ,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAEpD,uFAAuF;IACvF,MAAM,UAAU,GAAkB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACvD,CAAC,CAAE,MAAwB;QAC3B,CAAC,CAAE,KAAK,MAAM,EAAoB,CAAC;IAErC,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,qEAAqE;IACrE,0EAA0E;IAC1E,4EAA4E;IAC5E,sEAAsE;IACtE,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,cAAc,GAA4B,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACnC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,2CAA2C;IAC3C,4EAA4E;IAC5E,4EAA4E;IAC5E,0CAA0C;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACpC,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IACH,MAAM,WAAW,GAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC3D,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAElC,2CAA2C;IAC3C,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,oDAAoD;IACpD,EAAE;IACF,4EAA4E;IAC5E,yEAAyE;IACzE,wEAAwE;IACxE,0EAA0E;IAC1E,0DAA0D;IAC1D,IAAI,OAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,kBAAkB,CAAC;YACvC,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;SAC9D,CAAC,CAAC;QACH,eAAe,GAAG,oBAAoB,CAAC;YACrC,OAAO;YACP,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,UAAU,EAAE;YACxB,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QACH,mEAAmE;QACnE,wEAAwE;QACxE,kEAAkE;QAClE,iBAAiB;QACjB,cAAc,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAC5E,iBAAiB,GAAG,cAAc,CAAC;QACnC,MAAM,GAAG,GAAG,eAAe,CAAC;QAC5B,4EAA4E;QAC5E,qEAAqE;QACrE,MAAM,YAAY,GAA4B,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,KAA0B,EAAE,IAAI,CAAC,CAAC;YAC9D,eAAe,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAAiB,CAAC,GAAG,CAAC;YACjH,MAAM,SAAS,GAAI,GAA0C,CAAC,SAAS,CAAC;YACxE,IAAI,SAAS;gBAAE,qBAAqB,GAAG,SAAS,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QACF,iBAAiB,GAAG,IAAI,CAAC;QACzB,OAAO,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,GAAG,KAAK,CAAC;QAC1B,eAAe,GAAG,SAAS,CAAC;QAC5B,OAAO,CAAC,KAAK,CACX,6DAA6D,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAC9I,CAAC;IACJ,CAAC;IAED,QAAQ,GAAG,IAAI,CAAC;IAChB,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAC3B,QAAQ,GAAG,IAAI,CAAC;IAChB,aAAa,GAAG;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW;QACX,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;IACF,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY;IAC1B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,aAAa;IAC3B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB;IACnC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,cAAc;QAAE,OAAO;IAC3B,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,GAAG,GAAG,eAAe,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,cAAc,IAAI,CAAC,iBAAiB,IAAI,CAAC,eAAe,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxG,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC;YACvD,SAAS,EAAE,qBAAqB;YAChC,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,mBAAmB,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE;aAC/C;SACuD,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,eAAe,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE;SACvC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,sDAAsD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,CACzJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,QAAQ;IACtB,QAAQ,GAAG,KAAK,CAAC;IACjB,aAAa,GAAG,SAAS,CAAC;IAC1B,QAAQ,GAAG,KAAK,CAAC;IACjB,QAAQ,GAAG,SAAS,CAAC;IACrB,iBAAiB,GAAG,KAAK,CAAC;IAC1B,eAAe,GAAG,SAAS,CAAC;IAC5B,cAAc,GAAG,SAAS,CAAC;IAC3B,iBAAiB,GAAG,SAAS,CAAC;IAC9B,eAAe,GAAG,SAAS,CAAC;IAC5B,qBAAqB,GAAG,SAAS,CAAC;IAClC,cAAc,GAAG,KAAK,CAAC;AACzB,CAAC"}

package/dist/payment.d.ts

@@ -0,0 +1,48 @@
+export type PaymentRailMode = 'x402-exact' | 'x402-batch' | 'mpp-charge' | 'mpp-session';
+export type AuthMethod = 'x402' | 'mpp' | 'none';
+export interface PaymentSetupResult {
+    /** Whether any payment rail is active (a wallet key is set). */
+    enabled: boolean;
+    /** Primary rail, for analytics / wallet-id reporting. */
+    authMethod: AuthMethod;
+    x402Address?: string;
+    mppAddress?: string;
+    /** Unified dispatch fetch, present when a rail is enabled. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface PaymentModeInfo {
+    /** Whether any payment rail is active. */
+    enabled: boolean;
+    /** Current active rail+mode. */
+    mode: PaymentRailMode;
+    x402: {
+        enabled: boolean;
+        address?: string;
+        batchAvailable: boolean;
+    };
+    mpp: {
+        enabled: boolean;
+        address?: string;
+        sessionAvailable: boolean;
+    };
+    /** Modes that can be switched to right now (their rail is enabled/available). */
+    availableModes: PaymentRailMode[];
+}
+export declare function setupPayments(): PaymentSetupResult;
+/** Current active rail+mode. */
+export declare function getPaymentMode(): PaymentRailMode;
+/**
+ * Switch the active rail+mode for subsequent calls. No-op (returns the unchanged
+ * mode) when the target rail's key isn't set or its sub-mode is unavailable
+ * (x402 batch scheme failed to init, or MPP session channel failed to init).
+ */
+export declare function setPaymentMode(mode: PaymentRailMode): PaymentRailMode;
+/** Snapshot of unified payment state for the 1s_payment_mode tool. */
+export declare function getPaymentModeInfo(): PaymentModeInfo;
+/**
+ * Settle and reclaim any open MPP voucher channel. Called on shutdown; no-op
+ * for the x402 rail (its batch residual is reclaimed via 1s_refund or the
+ * gateway's idle auto-refund). Idempotent.
+ */
+export declare function closePaymentSession(): Promise<void>;
+//# sourceMappingURL=payment.d.ts.map

package/dist/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;IACvE,iFAAiF;IACjF,cAAc,EAAE,eAAe,EAAE,CAAC;CACnC;AA6BD,wBAAgB,aAAa,IAAI,kBAAkB,CA0ClD;AAED,gCAAgC;AAChC,wBAAgB,cAAc,IAAI,eAAe,CAEhD;AAgBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CAwBrE;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,eAAe,CASpD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD"}

package/dist/payment.js

@@ -0,0 +1,166 @@
+/**
+ * Unified payment orchestrator.
+ *
+ * The MCP can pay the gateway over two rails, each with two sub-modes:
+ *  - x402 (USDC on Base):   `x402-exact`  | `x402-batch`
+ *  - MPP  (Tempo USDC.e /pathUSD): `mpp-charge` | `mpp-session`
+ *
+ * This module owns the single active mode and returns ONE dispatch fetch that
+ * routes each request to the matching rail's payment-aware fetch. The
+ * `1s_payment_mode` tool flips the mode in-session via {@link setPaymentMode}.
+ *
+ * The per-rail wiring lives in x402.ts and mpp.ts; this file only composes them
+ * and holds the unified selector, so the money-critical x402 path stays
+ * isolated and unchanged.
+ */
+import { setupX402, setPaymentMode as setX402Mode, getPaymentModeInfo as getX402Info, } from './x402.js';
+import { setupMpp, isMppEnabled, getMppAddress, isMppSessionAvailable, closeMppSession, } from './mpp.js';
+let _applied = false;
+let _cachedResult;
+let _mode = 'x402-exact';
+let _x402Fetch;
+let _mppChargeFetch;
+let _mppSessionFetch;
+// Resolve the initial unified mode. Precedence: ONESOURCE_PAYMENT_MODE (if its
+// rail is enabled) > x402 (key present, X402_PAYMENT_MODE picks the sub-mode) >
+// mpp (MPP_PAYMENT_MODE picks the sub-mode). When both keys are set, x402 is the
+// initial primary — both rails stay switchable via setPaymentMode.
+function initialMode(x402Enabled, mppEnabled) {
+    const all = ['x402-exact', 'x402-batch', 'mpp-charge', 'mpp-session'];
+    const requested = process.env.ONESOURCE_PAYMENT_MODE?.trim().toLowerCase();
+    if (requested && all.includes(requested)) {
+        if (requested.startsWith('x402-') && x402Enabled)
+            return requested;
+        if (requested.startsWith('mpp-') && mppEnabled)
+            return requested;
+    }
+    if (x402Enabled) {
+        return process.env.X402_PAYMENT_MODE?.trim().toLowerCase() === 'batch' ? 'x402-batch' : 'x402-exact';
+    }
+    if (mppEnabled) {
+        return process.env.MPP_PAYMENT_MODE?.trim().toLowerCase() === 'session' ? 'mpp-session' : 'mpp-charge';
+    }
+    return 'x402-exact';
+}
+export function setupPayments() {
+    if (_applied && _cachedResult)
+        return _cachedResult;
+    const x402 = setupX402();
+    const mpp = setupMpp();
+    _x402Fetch = x402.enabled ? x402.fetch : undefined;
+    _mppChargeFetch = mpp.enabled ? mpp.chargeFetch : undefined;
+    _mppSessionFetch = mpp.enabled ? mpp.session?.fetch : undefined;
+    const enabled = Boolean(x402.enabled || mpp.enabled);
+    const authMethod = x402.enabled ? 'x402' : mpp.enabled ? 'mpp' : 'none';
+    _mode = initialMode(x402.enabled, mpp.enabled);
+    // Keep x402's internal scheme in sync with the unified mode at startup.
+    if (_mode === 'x402-batch')
+        setX402Mode('batch');
+    else if (_mode === 'x402-exact')
+        setX402Mode('exact');
+    // Dispatcher: route each request through the active rail's fetch. Reads
+    // `_mode` live so in-session switches take effect immediately. Falls back to
+    // any enabled fetch if the active one is somehow missing (defensive).
+    const dispatchFetch = (input, init) => {
+        const active = _mode === 'mpp-charge'
+            ? _mppChargeFetch
+            : _mode === 'mpp-session'
+                ? _mppSessionFetch
+                : _x402Fetch;
+        const f = active ?? _x402Fetch ?? _mppChargeFetch ?? _mppSessionFetch;
+        if (!f)
+            return fetch(input, init);
+        return f(input, init);
+    };
+    _applied = true;
+    _cachedResult = {
+        enabled,
+        authMethod,
+        ...(x402.address ? { x402Address: x402.address } : {}),
+        ...(mpp.address ? { mppAddress: mpp.address } : {}),
+        ...(enabled ? { fetch: dispatchFetch } : {}),
+    };
+    return _cachedResult;
+}
+/** Current active rail+mode. */
+export function getPaymentMode() {
+    return _mode;
+}
+function availableModes() {
+    const modes = [];
+    const x = getX402Info();
+    if (x.enabled) {
+        modes.push('x402-exact');
+        if (x.batchAvailable)
+            modes.push('x402-batch');
+    }
+    if (isMppEnabled()) {
+        modes.push('mpp-charge');
+        if (isMppSessionAvailable())
+            modes.push('mpp-session');
+    }
+    return modes;
+}
+/**
+ * Switch the active rail+mode for subsequent calls. No-op (returns the unchanged
+ * mode) when the target rail's key isn't set or its sub-mode is unavailable
+ * (x402 batch scheme failed to init, or MPP session channel failed to init).
+ */
+export function setPaymentMode(mode) {
+    const x = getX402Info();
+    switch (mode) {
+        case 'x402-exact':
+            if (!x.enabled)
+                return _mode;
+            setX402Mode('exact');
+            _mode = 'x402-exact';
+            return _mode;
+        case 'x402-batch':
+            if (!x.enabled || !x.batchAvailable)
+                return _mode;
+            setX402Mode('batch');
+            _mode = 'x402-batch';
+            return _mode;
+        case 'mpp-charge':
+            if (!isMppEnabled())
+                return _mode;
+            _mode = 'mpp-charge';
+            return _mode;
+        case 'mpp-session':
+            if (!isMppEnabled() || !isMppSessionAvailable())
+                return _mode;
+            _mode = 'mpp-session';
+            return _mode;
+        default:
+            return _mode;
+    }
+}
+/** Snapshot of unified payment state for the 1s_payment_mode tool. */
+export function getPaymentModeInfo() {
+    const x = getX402Info();
+    return {
+        enabled: x.enabled || isMppEnabled(),
+        mode: _mode,
+        x402: { enabled: x.enabled, address: x.address, batchAvailable: x.batchAvailable },
+        mpp: { enabled: isMppEnabled(), address: getMppAddress(), sessionAvailable: isMppSessionAvailable() },
+        availableModes: availableModes(),
+    };
+}
+/**
+ * Settle and reclaim any open MPP voucher channel. Called on shutdown; no-op
+ * for the x402 rail (its batch residual is reclaimed via 1s_refund or the
+ * gateway's idle auto-refund). Idempotent.
+ */
+export async function closePaymentSession() {
+    await closeMppSession();
+}
+/** @internal -- for test teardown only */
+export function resetPayments() {
+    _applied = false;
+    _cachedResult = undefined;
+    _mode = 'x402-exact';
+    _x402Fetch = undefined;
+    _mppChargeFetch = undefined;
+    _mppSessionFetch = undefined;
+}
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

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

package/dist/tools/chain/payment-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-mode.d.ts","sourceRoot":"","sources":["../../../src/tools/chain/payment-mode.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoB9C,eAAO,MAAM,IAAI,EAAE,OA2ClB,CAAC"}
+{"version":3,"file":"payment-mode.d.ts","sourceRoot":"","sources":["../../../src/tools/chain/payment-mode.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoC9C,eAAO,MAAM,IAAI,EAAE,OAuElB,CAAC"}

package/dist/tools/chain/payment-mode.js

@@ -1,54 +1,91 @@
 /**
- * 1s_payment_mode — view or switch the x402 payment scheme for this session.
+ * 1s_payment_mode — view or switch the payment rail + mode for this session.
+ *
+ * Two rails, each with two modes:
+ *  - x402 (USDC on Base):          x402-exact | x402-batch
+ *  - MPP  (Tempo USDC.e / pathUSD): mpp-charge | mpp-session
  */
 import { z } from 'zod';
-import { getPaymentModeInfo, setPaymentMode } from '../../x402.js';
+import { getPaymentModeInfo, setPaymentMode } from '../../payment.js';
 function describe(mode, address) {
     const wallet = address ? ` Paying wallet: ${address}.` : '';
-    if (mode === 'batch') {
-        return (`Payment mode: batch (payment channel).${wallet} ` +
-            'The first paid call opens a channel with one on-chain deposit (price × deposit multiplier); ' +
-            'subsequent calls are signed off-chain as cumulative vouchers and settled together with a single claim. ' +
-            'Best for a burst of calls. Switching back to exact leaves any unspent channel balance locked until the on-chain withdraw delay (~1 day on mainnet).');
+    switch (mode) {
+        case 'x402-batch':
+            return (`Payment mode: x402-batch (payment channel on Base).${wallet} ` +
+                'The first paid call opens a channel with one on-chain USDC deposit (price × deposit multiplier); ' +
+                'subsequent calls are signed off-chain as cumulative vouchers and settled with a single claim. ' +
+                'Best for a burst of calls. Switching away leaves any unspent channel balance locked until the on-chain withdraw delay (~1 day on mainnet) — use 1s_refund to reclaim it sooner.');
+        case 'mpp-charge':
+            return (`Payment mode: mpp-charge (per-call on Tempo).${wallet} ` +
+                'Each paid call signs and settles one Tempo payment (USDC.e or pathUSD, per the gateway challenge). ' +
+                'Switch to mpp-session for a voucher channel that is cheaper across many calls.');
+        case 'mpp-session':
+            return (`Payment mode: mpp-session (voucher channel on Tempo).${wallet} ` +
+                'The first paid call opens a TIP-1034 channel on-chain (capped by MPP_MAX_DEPOSIT); ' +
+                'subsequent calls are signed off-chain as cumulative vouchers. ' +
+                'The unspent deposit is settled and reclaimed automatically when the server shuts down cleanly; ' +
+                'a hard kill leaves it locked until reclaimed on-chain later.');
+        default:
+            return (`Payment mode: x402-exact (per-call on Base).${wallet} ` +
+                'Each paid call signs and settles one USDC payment on Base. ' +
+                'Switch to x402-batch (Base channel) or mpp-charge / mpp-session (Tempo) for cheaper bursts.');
     }
-    return (`Payment mode: exact (per-call).${wallet} ` +
-        'Each paid call signs and settles one USDC payment on Base. ' +
-        'Switch to batch with { "mode": "batch" } to open a payment channel — cheaper for many calls in a session.');
 }
 export const tool = {
     name: '1s_payment_mode',
-    description: 'View or switch how this session pays for x402 calls. ' +
-        'Two schemes: "exact" (default) signs one USDC payment per call; ' +
-        '"batch" opens a payment channel — one on-chain deposit funds many off-chain calls, settled with a single claim (cheaper for a burst of calls, but locks the deposit residual until an on-chain withdraw delay). ' +
-        'Both use the same wallet. Call with no arguments to see the current mode. ' +
-        'Only applies when paying via x402 (X402_PRIVATE_KEY set); with an API key, calls are covered by your plan.',
+    description: 'View or switch how this session pays for metered calls. ' +
+        'Two rails, each with two modes: x402-exact (per-call USDC on Base, default), ' +
+        'x402-batch (Base payment channel — one deposit funds many off-chain calls), ' +
+        'mpp-charge (per-call on Tempo, USDC.e/pathUSD), and mpp-session (Tempo voucher channel). ' +
+        'Channel modes are cheaper for a burst of calls but lock a deposit until the channel is closed/refunded. ' +
+        'Each rail uses its own wallet (X402_PRIVATE_KEY on Base / MPP_PRIVATE_KEY on Tempo). ' +
+        'Call with no arguments to see the current mode and which modes are available. ' +
+        'Only applies when paying via a wallet; with an API key, calls are covered by your plan.',
     category: 'chain',
     schema: {
         mode: z
-            .enum(['exact', 'batch'])
+            .enum(['x402-exact', 'x402-batch', 'mpp-charge', 'mpp-session'])
             .optional()
-            .describe('Payment scheme to switch to. Omit to report the current mode without changing it.'),
+            .describe('Payment rail + mode to switch to. Omit to report the current mode without changing it.'),
     },
     handler: async (input) => {
         const requested = input.mode;
         const before = getPaymentModeInfo();
         if (!before.enabled) {
-            return ('x402 payment is not active in this session, so there is no payment scheme to switch. ' +
-                'Payment mode (exact vs batch) only applies when paying per-call via x402 — set X402_PRIVATE_KEY to a funded Base wallet. ' +
-                'With an API key (ONESOURCE_API_KEY), calls are covered by your plan and no x402 payment is made.');
+            return ('No payment wallet is active in this session, so there is no payment mode to switch. ' +
+                'Set X402_PRIVATE_KEY (a funded Base wallet) to pay via x402, or MPP_PRIVATE_KEY (a funded Tempo wallet) to pay via MPP. ' +
+                'With an API key (ONESOURCE_API_KEY), calls are covered by your plan and no wallet payment is made.');
         }
         if (requested) {
-            const applied = setPaymentMode(requested);
-            if (requested === 'batch' && !before.batchAvailable) {
-                return (`Batch mode is unavailable in this session — the channel scheme failed to initialise — so the mode stays "${applied}". ` +
-                    'Check X402_RPC_URL, then restart the server.');
+            // Rail not enabled (its wallet key isn't set).
+            const railEnabled = requested.startsWith('x402-') ? before.x402.enabled : before.mpp.enabled;
+            if (!railEnabled) {
+                const envVar = requested.startsWith('x402-') ? 'X402_PRIVATE_KEY (funded Base wallet)' : 'MPP_PRIVATE_KEY (funded Tempo wallet)';
+                return (`Cannot switch to ${requested} — that rail is not active in this session. Set ${envVar} and restart. ` +
+                    `Available modes right now: ${before.availableModes.join(', ')}.`);
             }
-            if (applied === requested) {
-                return `Switched to ${applied} mode. ${describe(applied, before.address)}`;
+            const applied = setPaymentMode(requested);
+            // Sub-mode unavailable (channel scheme failed to initialise).
+            if (applied !== requested) {
+                if (requested === 'x402-batch' && !before.x402.batchAvailable) {
+                    return (`x402-batch is unavailable in this session — the channel scheme failed to initialise — so the mode stays "${applied}". ` +
+                        'Check X402_RPC_URL, then restart the server.');
+                }
+                if (requested === 'mpp-session' && !before.mpp.sessionAvailable) {
+                    return (`mpp-session is unavailable in this session — the Tempo channel failed to initialise — so the mode stays "${applied}". ` +
+                        'Check MPP_RPC_URL, then restart the server.');
+                }
+                return `Could not switch to ${requested}; mode stays "${applied}". Available modes: ${before.availableModes.join(', ')}.`;
             }
+            const address = applied.startsWith('x402-') ? before.x402.address : before.mpp.address;
+            return `Switched to ${applied}. ${describe(applied, address)}`;
         }
         const info = getPaymentModeInfo();
-        return describe(info.mode, info.address);
+        const address = info.mode.startsWith('x402-') ? info.x402.address : info.mpp.address;
+        return (`${describe(info.mode, address)} ` +
+            `Available modes: ${info.availableModes.join(', ')}.` +
+            (info.x402.enabled ? ` x402 wallet: ${info.x402.address}.` : '') +
+            (info.mpp.enabled ? ` MPP wallet: ${info.mpp.address}.` : ''));
     },
 };
 //# sourceMappingURL=payment-mode.js.map