@nookplot/runtime 0.5.146 → 0.5.147

package/dist/__tests__/usdcBudget.test.js

@@ -1,128 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

package/dist/__tests__/x402.test.js

@@ -1,117 +0,0 @@
-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

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

package/dist/goal/goalLoop.d.ts

@@ -1,78 +0,0 @@
-/**
- * GoalLoop — the L3 step-by-step execution engine for goal-driven agents.
- *
- * Invoked by `AutonomousAgent.bootstrapGoal()` when an agent was forged
- * with `initial_goal` set (typically via an L1 swarm suggestion).
- *
- * The loop:
- *   1. Asks the LLM "what's the next step?" given the goal + recent history
- *   2. Parses a JSON decision from the response
- *   3. Executes or records the decision
- *   4. Checks termination conditions (complete, budget, stuck, capability gap)
- *
- * Design choices (see ROADMAP_orchestrator-swarm-autodeploy.md §3):
- *   - Atomic goals, no project decomposition (v1 simplification)
- *   - Budget is soft — the real gate is owner NOOK balance, not the goal cap
- *   - 3 reformulations of the same step → blocked_stuck
- *   - 3 consecutive no-ops → treat as complete (the agent has nothing else to do)
- *
- * @module goal/goalLoop
- */
-import type { GoalAction, GoalResult, GoalLoopOptions } from "./types.js";
-export declare class GoalLoop {
-    private readonly runtime;
-    private readonly goal;
-    private readonly budgetNook;
-    private readonly maxSteps;
-    private readonly maxNoops;
-    private readonly maxReformulations;
-    private readonly verbose;
-    private readonly inferenceCall;
-    private readonly parentSwarmId;
-    private recentSteps;
-    private spentNook;
-    private stepsExecuted;
-    private toolSignatures;
-    private doomLoopTriggers;
-    private doomLoopNote;
-    constructor(opts: GoalLoopOptions);
-    /**
-     * Run the loop to completion. Returns exactly one of four outcomes.
-     * Never throws for normal termination — only throws for unrecoverable
-     * infrastructure errors (e.g. runtime not connected).
-     */
-    run(): Promise<GoalResult>;
-    private askLLMForNextAction;
-    /**
-     * Default inference caller — uses the runtime's inference API if available,
-     * otherwise returns a noop response. Consumers with custom inference wiring
-     * should pass `inferenceCall` in GoalLoopOptions.
-     */
-    private defaultInferenceCall;
-    /**
-     * Execute one action via the runtime's action dispatch pipeline.
-     *
-     * All actions go through `POST /v1/actions/execute` which handles both
-     * off-chain (direct) and on-chain (sign-required) action types. This
-     * preserves the CLAUDE.md Rule 5 invariant that all on-chain state
-     * changes go through prepare → sign → relay.
-     */
-    private executeAction;
-    private recordStepRemotely;
-    /**
-     * Treat the current state as a completed goal. Used when the LLM stalls
-     * or the max step count is exceeded. Produces a summary artifact from
-     * the recent step history so the user has something to review.
-     */
-    private finalizeFallback;
-}
-/**
- * Parse a goal action from an LLM response. Tries to extract the first
- * `{...}` JSON block from the content and coerce it into a GoalAction.
- *
- * Exported for unit testing.
- */
-export declare function parseGoalAction(content: string): (GoalAction & {
-    description: string;
-}) | null;
-//# sourceMappingURL=goalLoop.d.ts.map

package/dist/goal/goalLoop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"goalLoop.d.ts","sourceRoot":"","sources":["../../src/goal/goalLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,eAAe,EAEhB,MAAM,YAAY,CAAC;AAqBpB,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,IAAI,EAAE,eAAe;IAYjC;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;YAyIlB,mBAAmB;IA4BjC;;;;OAIG;YACW,oBAAoB;IA6BlC;;;;;;;OAOG;YACW,aAAa;YAyDb,kBAAkB;IAuBhC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,UAAU,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAgD9F"}