@nookplot/runtime 0.5.144 → 0.5.145

package/dist/__tests__/runtimeConstructor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConstructor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtimeConstructor.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/runtimeConstructor.test.js

@@ -0,0 +1,57 @@
+/**
+ * Constructor-time config validation for `NookplotRuntime`.
+ *
+ * The surplus guard mirrors the CLI's `validateConfig` startup check: surplus
+ * inference signs each x402 payment with the agent's OWN key, so an
+ * API-key-only agent would construct fine but throw a keyless `SurplusError`
+ * on the FIRST inference call — deep in the autonomous loop, easily mistaken
+ * for an outage. Failing fast at construction turns that into an actionable
+ * startup error.
+ *
+ * Note: the call-time keyless behavior is covered separately in
+ * economy.surplusBranch.test.ts (which constructs ConnectionManager/
+ * EconomyManager directly, BELOW this top-level guard — so a per-call
+ * `inferenceSource: "surplus"` override on a platform-default runtime still
+ * validates at call time, unaffected by this constructor check).
+ */
+import { describe, it, expect } from "vitest";
+import { NookplotRuntime } from "../index.js";
+const GATEWAY = "https://gateway.example.com";
+const API_KEY = "nk_test";
+const PK = "0x" + "1".repeat(64);
+describe("NookplotRuntime constructor — required config", () => {
+    it("throws when gatewayUrl is missing", () => {
+        expect(() => new NookplotRuntime({ gatewayUrl: "", apiKey: API_KEY })).toThrow(/gatewayUrl is required/);
+    });
+    it("throws when apiKey is missing", () => {
+        expect(() => new NookplotRuntime({ gatewayUrl: GATEWAY, apiKey: "" })).toThrow(/apiKey is required/);
+    });
+});
+describe("NookplotRuntime constructor — surplus fail-fast (mirrors CLI validateConfig)", () => {
+    it("throws when inferenceSource='surplus' and no privateKey", () => {
+        expect(() => new NookplotRuntime({
+            gatewayUrl: GATEWAY,
+            apiKey: API_KEY,
+            inferenceSource: "surplus",
+        })).toThrow(/inferenceSource is 'surplus' but no privateKey/);
+    });
+    it("constructs when inferenceSource='surplus' WITH a privateKey", () => {
+        expect(() => new NookplotRuntime({
+            gatewayUrl: GATEWAY,
+            apiKey: API_KEY,
+            inferenceSource: "surplus",
+            privateKey: PK,
+        })).not.toThrow();
+    });
+    it("constructs with inferenceSource='platform' and no privateKey (gateway-metered agent)", () => {
+        expect(() => new NookplotRuntime({
+            gatewayUrl: GATEWAY,
+            apiKey: API_KEY,
+            inferenceSource: "platform",
+        })).not.toThrow();
+    });
+    it("constructs with no inferenceSource set (defaults to platform)", () => {
+        expect(() => new NookplotRuntime({ gatewayUrl: GATEWAY, apiKey: API_KEY })).not.toThrow();
+    });
+});
+//# sourceMappingURL=runtimeConstructor.test.js.map

package/dist/__tests__/runtimeConstructor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConstructor.test.js","sourceRoot":"","sources":["../../src/__tests__/runtimeConstructor.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAC9C,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,MAAM,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjC,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5E,wBAAwB,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5E,oBAAoB,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8EAA8E,EAAE,GAAG,EAAE;IAC5F,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,GAAG,EAAE,CACH,IAAI,eAAe,CAAC;YAClB,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;SAC3B,CAAC,CACL,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CACJ,GAAG,EAAE,CACH,IAAI,eAAe,CAAC;YAClB,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,UAAU,EAAE,EAAE;SACf,CAAC,CACL,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,CACJ,GAAG,EAAE,CACH,IAAI,eAAe,CAAC;YAClB,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,UAAU;SAC5B,CAAC,CACL,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/sandbox.test.js

@@ -299,30 +299,30 @@ describe("DockerSandbox lifecycle (via fake docker shim)", () => {
         //   `exec id sh -c CMD` -> exec sh -c CMD
         //   `cp SRC DST`  -> cp SRC DST
         //   `rm -f id`    -> exit 0
-        const script = `#!/bin/sh
-case "$1" in
-  run) echo "fake-container-abc123"; exit 0 ;;
-  port) echo "0.0.0.0:54321"; exit 0 ;;
-  inspect) echo "true"; exit 0 ;;
-  rm) exit 0 ;;
-  exec)
-    # Skip "exec", any flags (-i, -w X, -e K=V), and the container id.
-    shift
-    while [ "$1" = "-i" ] || [ "$1" = "-w" ] || [ "$1" = "-e" ]; do
-      if [ "$1" = "-w" ] || [ "$1" = "-e" ]; then shift; fi
-      shift
-    done
-    shift  # container id
-    exec "$@"
-    ;;
-  cp)
-    shift
-    src=\${1#*:}
-    dst=\${2#*:}
-    cp "$src" "$dst"
-    ;;
-  *) echo "shim: unknown $1" 1>&2; exit 2 ;;
-esac
+        const script = `#!/bin/sh
+case "$1" in
+  run) echo "fake-container-abc123"; exit 0 ;;
+  port) echo "0.0.0.0:54321"; exit 0 ;;
+  inspect) echo "true"; exit 0 ;;
+  rm) exit 0 ;;
+  exec)
+    # Skip "exec", any flags (-i, -w X, -e K=V), and the container id.
+    shift
+    while [ "$1" = "-i" ] || [ "$1" = "-w" ] || [ "$1" = "-e" ]; do
+      if [ "$1" = "-w" ] || [ "$1" = "-e" ]; then shift; fi
+      shift
+    done
+    shift  # container id
+    exec "$@"
+    ;;
+  cp)
+    shift
+    src=\${1#*:}
+    dst=\${2#*:}
+    cp "$src" "$dst"
+    ;;
+  *) echo "shim: unknown $1" 1>&2; exit 2 ;;
+esac
 `;
         await fs.writeFile(shimBin, script, { mode: 0o755 });
     });

package/dist/__tests__/signalActionMap.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SignalActionMap — unit tests for getAvailableActionsFromMap + TS↔Py parity.
+ *
+ * Asserts (post-§4.3 collapse):
+ *   - api_listings appears for buyer-side "I have work to do" signals
+ *     (task_assigned, bounty_claimed, mining_opportunity) without browse_tools.
+ *   - api_listings does NOT leak into unrelated signals (e.g. xmtp_message).
+ *   - Provider-only api actions (api_endpoint, api_usage) stay category-gated —
+ *     only reachable via browse_tools("marketplace").
+ *
+ * Cross-language parity (Phase 6.0):
+ *   Parses SIGNAL_CONTEXT_ACTIONS from runtime-py/.../signal_action_map.py and
+ *   diffs against this file's TS export. Catches future drift where one side
+ *   adds a signal key or action without the other.
+ */
+export {};
+//# sourceMappingURL=signalActionMap.test.d.ts.map

package/dist/__tests__/signalActionMap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalActionMap.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/signalActionMap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/__tests__/signalActionMap.test.js

@@ -0,0 +1,165 @@
+/**
+ * SignalActionMap — unit tests for getAvailableActionsFromMap + TS↔Py parity.
+ *
+ * Asserts (post-§4.3 collapse):
+ *   - api_listings appears for buyer-side "I have work to do" signals
+ *     (task_assigned, bounty_claimed, mining_opportunity) without browse_tools.
+ *   - api_listings does NOT leak into unrelated signals (e.g. xmtp_message).
+ *   - Provider-only api actions (api_endpoint, api_usage) stay category-gated —
+ *     only reachable via browse_tools("marketplace").
+ *
+ * Cross-language parity (Phase 6.0):
+ *   Parses SIGNAL_CONTEXT_ACTIONS from runtime-py/.../signal_action_map.py and
+ *   diffs against this file's TS export. Catches future drift where one side
+ *   adds a signal key or action without the other.
+ */
+import { describe, it, expect } from "vitest";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { CORE_ACTIONS, SIGNAL_CONTEXT_ACTIONS, getAvailableActionsFromMap, } from "../signalActionMap.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = join(__dirname, "..", "..", "..");
+const PROVIDER_ONLY_API_ACTIONS = [
+    "api_endpoint",
+    "api_usage",
+];
+describe("getAvailableActionsFromMap — api_listings discoverability (G1)", () => {
+    it("includes api_listings on task_assigned without loading marketplace category", () => {
+        const actions = getAvailableActionsFromMap("task_assigned", new Set());
+        expect(actions).toContain("api_listings");
+    });
+    it("includes api_listings on bounty_claimed without loading marketplace category", () => {
+        const actions = getAvailableActionsFromMap("bounty_claimed", new Set());
+        expect(actions).toContain("api_listings");
+    });
+    it("includes api_listings on mining_opportunity without loading marketplace category", () => {
+        const actions = getAvailableActionsFromMap("mining_opportunity", new Set());
+        expect(actions).toContain("api_listings");
+    });
+    it("does NOT include api_listings on xmtp_message (unrelated signal)", () => {
+        const actions = getAvailableActionsFromMap("xmtp_message", new Set());
+        expect(actions).not.toContain("api_listings");
+    });
+    it("provider-only api actions stay category-gated (not in any SIGNAL_CONTEXT_ACTIONS entry)", () => {
+        for (const action of PROVIDER_ONLY_API_ACTIONS) {
+            for (const [signal, list] of Object.entries(SIGNAL_CONTEXT_ACTIONS)) {
+                expect(list, `${action} leaked into ${signal}`).not.toContain(action);
+            }
+            expect(CORE_ACTIONS, `${action} must not be in CORE_ACTIONS`).not.toContain(action);
+        }
+    });
+    it("api_listings itself is not in CORE_ACTIONS (avoids bloating every prompt)", () => {
+        expect(CORE_ACTIONS).not.toContain("api_listings");
+    });
+    it("includes pay_api alongside api_listings on the 3 work-bearing signals", () => {
+        for (const signal of ["task_assigned", "bounty_claimed", "mining_opportunity"]) {
+            const actions = getAvailableActionsFromMap(signal, new Set());
+            expect(actions, `${signal} should offer pay_api`).toContain("pay_api");
+        }
+    });
+    it("does NOT include pay_api on xmtp_message (money action stays scoped)", () => {
+        expect(getAvailableActionsFromMap("xmtp_message", new Set())).not.toContain("pay_api");
+    });
+    it("pay_api is not in CORE_ACTIONS (signal-scoped, not always-on)", () => {
+        expect(CORE_ACTIONS).not.toContain("pay_api");
+    });
+    it("includes api_onboard on the service signal (agent-first listing creation)", () => {
+        const actions = getAvailableActionsFromMap("service", new Set());
+        expect(actions).toContain("api_onboard");
+    });
+    it("does NOT include api_onboard on unrelated signals (xmtp_message)", () => {
+        expect(getAvailableActionsFromMap("xmtp_message", new Set())).not.toContain("api_onboard");
+    });
+    it("api_onboard is not in CORE_ACTIONS (signal-scoped seller action)", () => {
+        expect(CORE_ACTIONS).not.toContain("api_onboard");
+    });
+});
+// ──────────────────────────────────────────────────────────────────────────
+// TS ↔ Python SIGNAL_CONTEXT_ACTIONS parity (Phase 6.0)
+// ──────────────────────────────────────────────────────────────────────────
+/**
+ * Parse SIGNAL_CONTEXT_ACTIONS dict from the Python source file.
+ *
+ * Pattern: each top-level entry follows
+ *     "<signal_name>": [<comma-separated string list, possibly multi-line>],
+ *
+ * Lightweight regex-based parser — same approach as codegen-drift.test.ts.
+ * Tolerates trailing commas, inline `# ...` comments, and multi-line lists.
+ */
+function loadPythonSignalContextActions() {
+    const path = join(REPO_ROOT, "runtime-py", "nookplot_runtime", "signal_action_map.py");
+    const raw = readFileSync(path, "utf-8").replace(/\r\n/g, "\n");
+    // Slice out the SIGNAL_CONTEXT_ACTIONS body between its opening `{` and the
+    // line that closes it (`}` at column 0). The first match of
+    // `SIGNAL_CONTEXT_ACTIONS: dict[str, list[str]] = {` is the start anchor.
+    const start = raw.indexOf("SIGNAL_CONTEXT_ACTIONS:");
+    if (start === -1)
+        throw new Error("SIGNAL_CONTEXT_ACTIONS not found in Python source");
+    const braceStart = raw.indexOf("{", start);
+    if (braceStart === -1)
+        throw new Error("Opening brace not found");
+    // Find matching closing brace by depth-tracking.
+    let depth = 0;
+    let braceEnd = -1;
+    for (let i = braceStart; i < raw.length; i++) {
+        const ch = raw[i];
+        if (ch === "{")
+            depth++;
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0) {
+                braceEnd = i;
+                break;
+            }
+        }
+    }
+    if (braceEnd === -1)
+        throw new Error("Closing brace not found");
+    const body = raw.slice(braceStart + 1, braceEnd);
+    // Strip Python `#` comments to end of line — they could otherwise contain
+    // stray punctuation that confuses the entry regex.
+    const noComments = body.replace(/(^|\s)#[^\n]*/g, "$1");
+    const map = new Map();
+    // Match "key": [ ... ] across multi-line lists.
+    const entryRe = /"([a-z_][a-z0-9_]*)"\s*:\s*\[([\s\S]*?)\]\s*,/g;
+    let match;
+    while ((match = entryRe.exec(noComments)) !== null) {
+        const key = match[1];
+        const listBody = match[2];
+        const actions = [];
+        const actionRe = /"([^"]+)"/g;
+        let am;
+        while ((am = actionRe.exec(listBody)) !== null) {
+            actions.push(am[1]);
+        }
+        map.set(key, actions);
+    }
+    return map;
+}
+describe("SIGNAL_CONTEXT_ACTIONS — TS ↔ Python parity (Phase 6.0)", () => {
+    const pyMap = loadPythonSignalContextActions();
+    const tsKeys = new Set(Object.keys(SIGNAL_CONTEXT_ACTIONS));
+    const pyKeys = new Set(pyMap.keys());
+    it("both sides export the same set of signal keys", () => {
+        const tsOnly = [...tsKeys].filter((k) => !pyKeys.has(k)).sort();
+        const pyOnly = [...pyKeys].filter((k) => !tsKeys.has(k)).sort();
+        expect({ tsOnly, pyOnly }).toEqual({ tsOnly: [], pyOnly: [] });
+    });
+    it("each signal key has the same action set on both sides", () => {
+        const drifts = [];
+        for (const key of tsKeys) {
+            if (!pyKeys.has(key))
+                continue; // covered by previous test
+            const tsList = new Set(SIGNAL_CONTEXT_ACTIONS[key]);
+            const pyList = new Set(pyMap.get(key));
+            const tsOnly = [...tsList].filter((a) => !pyList.has(a)).sort();
+            const pyOnly = [...pyList].filter((a) => !tsList.has(a)).sort();
+            if (tsOnly.length || pyOnly.length) {
+                drifts.push({ signal: key, tsOnly, pyOnly });
+            }
+        }
+        expect(drifts).toEqual([]);
+    });
+});
+//# sourceMappingURL=signalActionMap.test.js.map

package/dist/__tests__/signalActionMap.test.js.map

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

package/dist/__tests__/usdcBudget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usdcBudget.test.d.ts.map

package/dist/__tests__/usdcBudget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdcBudget.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/usdcBudget.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/usdcBudget.test.js

@@ -0,0 +1,128 @@
+/**
+ * Unit tests for the UsdcBudget primitive (the hard-stop x402 spend cap).
+ */
+import { describe, it, expect } from "vitest";
+import { UsdcBudget, createUsdcBudget, parseUsdcToBaseUnits, formatUsdc, DEFAULT_DAILY_USDC_CAP_BASE_UNITS, } from "../usdcBudget.js";
+const USDC = 1000000n; // 1 USDC in base units
+describe("parseUsdcToBaseUnits", () => {
+    it("parses whole and fractional USDC", () => {
+        expect(parseUsdcToBaseUnits("10")).toBe(10n * USDC);
+        expect(parseUsdcToBaseUnits("0.5")).toBe(500000n);
+        expect(parseUsdcToBaseUnits("1.234567")).toBe(1234567n);
+    });
+    it("truncates beyond 6 decimals", () => {
+        expect(parseUsdcToBaseUnits("1.2345678")).toBe(1234567n);
+    });
+    it("returns 0n (unlimited) for empty / invalid input", () => {
+        expect(parseUsdcToBaseUnits(undefined)).toBe(0n);
+        expect(parseUsdcToBaseUnits("")).toBe(0n);
+        expect(parseUsdcToBaseUnits("abc")).toBe(0n);
+        expect(parseUsdcToBaseUnits("-5")).toBe(0n);
+    });
+});
+describe("formatUsdc", () => {
+    it("formats base units to a $ string", () => {
+        expect(formatUsdc(10n * USDC)).toBe("$10");
+        expect(formatUsdc(500000n)).toBe("$0.5");
+        expect(formatUsdc(1230000n)).toBe("$1.23");
+    });
+});
+describe("UsdcBudget", () => {
+    it("unlimited (cap 0n) never blocks or exhausts", () => {
+        const b = new UsdcBudget({ dailyCapBaseUnits: 0n });
+        expect(b.check(1000n * USDC).allowed).toBe(true);
+        expect(b.maxForNextCall()).toBeUndefined();
+        b.record(1000n * USDC);
+        expect(b.isExhausted()).toBe(false);
+        expect(b.remaining()).toBe(-1n);
+    });
+    it("enforces the daily cap with zero overshoot via maxForNextCall", () => {
+        const b = new UsdcBudget({ dailyCapBaseUnits: 2n * USDC });
+        expect(b.maxForNextCall()).toBe(2n * USDC);
+        // first $1.50 call fits
+        expect(b.check(1500000n).allowed).toBe(true);
+        b.record(1500000n);
+        // remaining is $0.50 → a second $1.50 call is refused by the ceiling
+        expect(b.maxForNextCall()).toBe(500000n);
+        expect(b.check(1500000n).allowed).toBe(false);
+        expect(b.remaining()).toBe(500000n);
+    });
+    it("isExhausted flips once the cap is fully consumed", () => {
+        const b = new UsdcBudget({ dailyCapBaseUnits: 1n * USDC });
+        expect(b.isExhausted()).toBe(false);
+        b.record(1n * USDC);
+        expect(b.isExhausted()).toBe(true);
+        expect(b.maxForNextCall()).toBe(0n);
+    });
+    it("honors a per-call ceiling independent of the daily cap", () => {
+        const b = new UsdcBudget({ dailyCapBaseUnits: 100n * USDC, perCallCapBaseUnits: 2n * USDC });
+        expect(b.check(3n * USDC).allowed).toBe(false); // exceeds per-call ceiling
+        expect(b.check(2n * USDC).allowed).toBe(true);
+        // maxForNextCall = min(perCall 2, remaining 100) = 2
+        expect(b.maxForNextCall()).toBe(2n * USDC);
+    });
+    it("rolls the window after the period elapses", () => {
+        let t = 1_000_000;
+        const b = new UsdcBudget({ dailyCapBaseUnits: 1n * USDC, windowMs: 1000, now: () => t });
+        b.record(1n * USDC);
+        expect(b.isExhausted()).toBe(true);
+        t += 1001; // advance past the window
+        expect(b.isExhausted()).toBe(false);
+        expect(b.spent).toBe(0n);
+    });
+});
+describe("createUsdcBudget", () => {
+    it("defaults to the conservative daily cap when nothing is configured", () => {
+        const prevDaily = process.env.X402_DAILY_USDC_CAP;
+        const prevPer = process.env.X402_PER_CALL_USDC_CAP;
+        delete process.env.X402_DAILY_USDC_CAP;
+        delete process.env.X402_PER_CALL_USDC_CAP;
+        try {
+            const b = createUsdcBudget();
+            expect(b.dailyCapBaseUnits).toBe(DEFAULT_DAILY_USDC_CAP_BASE_UNITS);
+            expect(b.perCallCapBaseUnits).toBe(0n);
+        }
+        finally {
+            if (prevDaily !== undefined)
+                process.env.X402_DAILY_USDC_CAP = prevDaily;
+            if (prevPer !== undefined)
+                process.env.X402_PER_CALL_USDC_CAP = prevPer;
+        }
+    });
+    it("reads caps from env (USDC display units)", () => {
+        const prevDaily = process.env.X402_DAILY_USDC_CAP;
+        const prevPer = process.env.X402_PER_CALL_USDC_CAP;
+        process.env.X402_DAILY_USDC_CAP = "25";
+        process.env.X402_PER_CALL_USDC_CAP = "0.5";
+        try {
+            const b = createUsdcBudget();
+            expect(b.dailyCapBaseUnits).toBe(25n * USDC);
+            expect(b.perCallCapBaseUnits).toBe(500000n);
+        }
+        finally {
+            if (prevDaily !== undefined)
+                process.env.X402_DAILY_USDC_CAP = prevDaily;
+            else
+                delete process.env.X402_DAILY_USDC_CAP;
+            if (prevPer !== undefined)
+                process.env.X402_PER_CALL_USDC_CAP = prevPer;
+            else
+                delete process.env.X402_PER_CALL_USDC_CAP;
+        }
+    });
+    it("explicit options win over env", () => {
+        const prev = process.env.X402_DAILY_USDC_CAP;
+        process.env.X402_DAILY_USDC_CAP = "25";
+        try {
+            const b = createUsdcBudget({ dailyCapBaseUnits: 0n });
+            expect(b.dailyCapBaseUnits).toBe(0n); // explicit unlimited beats env
+        }
+        finally {
+            if (prev !== undefined)
+                process.env.X402_DAILY_USDC_CAP = prev;
+            else
+                delete process.env.X402_DAILY_USDC_CAP;
+        }
+    });
+});
+//# sourceMappingURL=usdcBudget.test.js.map

package/dist/__tests__/usdcBudget.test.js.map

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

package/dist/__tests__/x402.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=x402.test.d.ts.map

package/dist/__tests__/x402.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/x402.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/x402.test.js

@@ -0,0 +1,117 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { ethers } from "ethers";
+import { X402Manager } from "../x402.js";
+const SPLITTER = "0x5555555555555555555555555555555555555555";
+const USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const GATEWAY = "https://gw.example.com";
+const RECEIVE_TYPES = {
+    ReceiveWithAuthorization: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "validAfter", type: "uint256" },
+        { name: "validBefore", type: "uint256" },
+        { name: "nonce", type: "bytes32" },
+    ],
+};
+function challenge() {
+    return {
+        x402Version: 2,
+        accepts: [
+            {
+                scheme: "exact",
+                network: "eip155:8453",
+                asset: USDC,
+                payTo: SPLITTER,
+                maxAmountRequired: "1000000",
+                maxTimeoutSeconds: 600,
+                extra: { listingId: "42" },
+            },
+        ],
+    };
+}
+function res(status, body) {
+    return new Response(typeof body === "string" ? body : JSON.stringify(body), {
+        status,
+        headers: { "content-type": "application/json" },
+    });
+}
+describe("X402Manager.payAndCall", () => {
+    afterEach(() => vi.unstubAllGlobals());
+    it("probes, signs EIP-3009, and re-sends a gateway-recoverable authorization", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const fetchFn = vi
+            .fn()
+            .mockResolvedValueOnce(res(402, challenge()))
+            .mockResolvedValueOnce(res(200, { ok: "upstream" }));
+        vi.stubGlobal("fetch", fetchFn);
+        const mgr = new X402Manager(GATEWAY);
+        const result = await mgr.payAndCall({ listingId: 42, path: "chat", method: "POST", body: { q: "hi" } }, wallet);
+        expect(result.paid).toBe(true);
+        expect(result.status).toBe(200);
+        expect(result.body).toEqual({ ok: "upstream" });
+        expect(fetchFn).toHaveBeenCalledTimes(2);
+        expect(fetchFn.mock.calls[0][0]).toBe(`${GATEWAY}/v1/api-x402/42/chat`);
+        // The re-send carries the encoded payment header.
+        const init2 = fetchFn.mock.calls[1][1];
+        const header = init2.headers["PAYMENT-SIGNATURE"];
+        expect(header).toBeTruthy();
+        // Decode it and confirm the EIP-3009 signature recovers to the buyer — i.e.
+        // exactly what the gateway facilitator's verify() will check.
+        const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf8"));
+        const auth = decoded.payload.authorization;
+        expect(auth.from).toBe(wallet.address);
+        expect(auth.to).toBe(SPLITTER);
+        expect(auth.value).toBe("1000000");
+        const recovered = ethers.verifyTypedData({ name: "USD Coin", version: "2", chainId: 8453, verifyingContract: USDC }, RECEIVE_TYPES, auth, decoded.payload.signature);
+        expect(recovered).toBe(wallet.address);
+    });
+    it("returns immediately (no signing) when the gateway does not answer 402", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const fetchFn = vi.fn().mockResolvedValueOnce(res(404, { error: "listing not available for x402" }));
+        vi.stubGlobal("fetch", fetchFn);
+        const result = await new X402Manager(GATEWAY).payAndCall({ listingId: 9, path: "x" }, wallet);
+        expect(result.paid).toBe(false);
+        expect(result.status).toBe(404);
+        expect(fetchFn).toHaveBeenCalledTimes(1);
+    });
+    it("throws when the 402 offers no supported 'exact' scheme", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const fetchFn = vi.fn().mockResolvedValueOnce(res(402, { x402Version: 2, accepts: [{ scheme: "weird" }] }));
+        vi.stubGlobal("fetch", fetchFn);
+        await expect(new X402Manager(GATEWAY).payAndCall({ listingId: 1, path: "x" }, wallet)).rejects.toThrow(/exact/);
+    });
+    it("aborts BEFORE signing when the quote exceeds maxAmountBaseUnits (spend cap)", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const fetchFn = vi.fn().mockResolvedValueOnce(res(402, challenge())); // quote = 1_000_000
+        vi.stubGlobal("fetch", fetchFn);
+        await expect(new X402Manager(GATEWAY).payAndCall({ listingId: 42, path: "x", maxAmountBaseUnits: 500000n }, // ceiling below quote
+        wallet)).rejects.toThrow(/spend blocked/i);
+        // Only the probe ran — no payment was signed or submitted.
+        expect(fetchFn).toHaveBeenCalledTimes(1);
+    });
+    it("returns amountPaidBaseUnits on a paid call within the ceiling", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const fetchFn = vi.fn().mockResolvedValueOnce(res(402, challenge())).mockResolvedValueOnce(res(200, {}));
+        vi.stubGlobal("fetch", fetchFn);
+        const result = await new X402Manager(GATEWAY).payAndCall({ listingId: 42, path: "x", maxAmountBaseUnits: 1000000n }, // == quote, allowed
+        wallet);
+        expect(result.paid).toBe(true);
+        expect(result.amountPaidBaseUnits).toBe("1000000");
+        expect(fetchFn).toHaveBeenCalledTimes(2);
+    });
+    it("derives chainId from the 402 network and honors an override", async () => {
+        const wallet = ethers.Wallet.createRandom();
+        const ch = challenge();
+        ch.accepts[0].network = "base-sepolia";
+        const fetchFn = vi.fn().mockResolvedValueOnce(res(402, ch)).mockResolvedValueOnce(res(200, {}));
+        vi.stubGlobal("fetch", fetchFn);
+        await new X402Manager(GATEWAY).payAndCall({ listingId: 42, path: "x" }, wallet);
+        const header = fetchFn.mock.calls[1][1].headers;
+        const decoded = JSON.parse(Buffer.from(header["PAYMENT-SIGNATURE"], "base64").toString("utf8"));
+        // Signature recovers only under chainId 84532 (base-sepolia).
+        const recovered = ethers.verifyTypedData({ name: "USD Coin", version: "2", chainId: 84532, verifyingContract: USDC }, RECEIVE_TYPES, decoded.payload.authorization, decoded.payload.signature);
+        expect(recovered).toBe(wallet.address);
+    });
+});
+//# sourceMappingURL=x402.test.js.map

package/dist/__tests__/x402.test.js.map

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

package/dist/actionCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actionCatalog.d.ts","sourceRoot":"","sources":["../src/actionCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgJD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGrD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBhE"}
+{"version":3,"file":"actionCatalog.d.ts","sourceRoot":"","sources":["../src/actionCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoID;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGrD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBhE"}

package/dist/actionCatalog.generated.d.ts

@@ -1,4 +1,4 @@
 import type { ActionInfo } from "./actionCatalog.js";
-/** MCP-derived action catalog entries (476 tools). */
+/** MCP-derived action catalog entries (501 tools). */
 export declare const GENERATED_CATALOG: Record<string, ActionInfo>;
 //# sourceMappingURL=actionCatalog.generated.d.ts.map

package/dist/actionCatalog.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actionCatalog.generated.d.ts","sourceRoot":"","sources":["../src/actionCatalog.generated.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAuyExD,CAAC"}
+{"version":3,"file":"actionCatalog.generated.d.ts","sourceRoot":"","sources":["../src/actionCatalog.generated.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAo6ExD,CAAC"}