@nookplot/runtime 0.5.145 → 0.5.147

package/dist/loadProfile.d.ts

@@ -1,100 +0,0 @@
-/**
- * Profile-aware credential loading for @nookplot/runtime.
- *
- * The SDK normally takes `{ apiKey, gatewayUrl }` at instantiation —
- * developers pass keys directly. This helper is for developers who want
- * the SDK to read from `~/.nookplot/` like @nookplot/cli and @nookplot/mcp
- * do, so a user running multiple forged agents can point the SDK at
- * whichever scope is active in their shell.
- *
- * Reads from the same files the rest of the Nookplot stack uses:
- *   ~/.nookplot/credentials.json              ← creator API key (shared)
- *   ~/.nookplot/profiles/<name>/profile.json  ← per-agent scope
- *   ~/.nookplot/active-profile                ← sticky default (CLI-written)
- *
- * Resolution order:
- *   1. Explicit `name` argument to loadProfile()
- *   2. NOOKPLOT_PROFILE env var
- *   3. Sticky default from ~/.nookplot/active-profile
- *   4. null (load default creds only, no scope)
- *
- * @module loadProfile
- *
- * @example Basic usage — pick up whatever profile is active
- * ```ts
- * import { NookplotRuntime } from "@nookplot/runtime";
- * import { loadProfile } from "@nookplot/runtime/loadProfile";
- *
- * const creds = loadProfile();   // respects NOOKPLOT_PROFILE env + sticky default
- * if (!creds) throw new Error("No credentials — run `nookplot register` first");
- *
- * const runtime = new NookplotRuntime({
- *   apiKey: creds.apiKey,
- *   gatewayUrl: creds.gatewayUrl,
- * });
- * ```
- *
- * @example Explicit profile override
- * ```ts
- * const creds = loadProfile("jeffs-researcher");
- * ```
- *
- * @example Multi-agent — run two SDK instances in parallel
- * ```ts
- * const researcherCreds = loadProfile("jeffs-researcher");
- * const writerCreds = loadProfile("jeffs-writer");
- *
- * const researcher = new NookplotRuntime({ apiKey: researcherCreds!.apiKey, ... });
- * const writer = new NookplotRuntime({ apiKey: writerCreds!.apiKey, ... });
- * // Both clients share the creator's API key but scope to different forged agents.
- * ```
- */
-export interface LoadedProfile {
-    /** Creator's API key (shared across all forged agents owned by this creator). */
-    apiKey: string;
-    /** Creator's wallet address. */
-    address: string;
-    /** Creator's private key — only read if developer passes { requirePrivateKey }. */
-    privateKey: string;
-    /** Gateway base URL, honoring NOOKPLOT_GATEWAY_URL env if set. */
-    gatewayUrl: string;
-    /** Present when a profile was active — the forged agent's address to scope to. */
-    scopedAgentAddress?: string;
-    /** Present when a profile was active — the profile's name (for logging). */
-    profileName?: string;
-    /** Display name of the creator (not the scoped forged agent). */
-    displayName?: string;
-}
-/**
- * Resolve the active profile name in priority order.
- * Exported for testing + for developers who want to see which profile
- * WOULD be used without actually loading credentials.
- */
-export declare function resolveActiveProfileName(explicitName?: string): string | null;
-/**
- * Load credentials, optionally merging a named profile's scope on top.
- *
- * Returns null if no `credentials.json` exists — the developer should
- * surface a clear "run `nookplot register` first" message in that case.
- *
- * Does not throw on invalid profiles — if the named profile doesn't
- * exist or is malformed, falls back to plain creator-direct credentials
- * (matches @nookplot/mcp's fail-open behavior so stale env vars don't
- * break unrelated commands).
- */
-export declare function loadProfile(name?: string): LoadedProfile | null;
-/**
- * List all profiles registered on the local machine. Each entry includes
- * the profile name + its metadata. Useful for SDK consumers who want to
- * enumerate the user's forged agents programmatically.
- *
- * Returns an empty array if ~/.nookplot/profiles doesn't exist. Never
- * throws — invalid profiles are silently skipped.
- */
-export declare function listProfiles(): Array<{
-    name: string;
-    scopedAgentAddress: string;
-    displayName?: string;
-    hermesProfile?: string;
-}>;
-//# sourceMappingURL=loadProfile.d.ts.map

package/dist/loadProfile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loadProfile.d.ts","sourceRoot":"","sources":["../src/loadProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhI"}

package/dist/loadProfile.js

@@ -1,221 +0,0 @@
-/**
- * Profile-aware credential loading for @nookplot/runtime.
- *
- * The SDK normally takes `{ apiKey, gatewayUrl }` at instantiation —
- * developers pass keys directly. This helper is for developers who want
- * the SDK to read from `~/.nookplot/` like @nookplot/cli and @nookplot/mcp
- * do, so a user running multiple forged agents can point the SDK at
- * whichever scope is active in their shell.
- *
- * Reads from the same files the rest of the Nookplot stack uses:
- *   ~/.nookplot/credentials.json              ← creator API key (shared)
- *   ~/.nookplot/profiles/<name>/profile.json  ← per-agent scope
- *   ~/.nookplot/active-profile                ← sticky default (CLI-written)
- *
- * Resolution order:
- *   1. Explicit `name` argument to loadProfile()
- *   2. NOOKPLOT_PROFILE env var
- *   3. Sticky default from ~/.nookplot/active-profile
- *   4. null (load default creds only, no scope)
- *
- * @module loadProfile
- *
- * @example Basic usage — pick up whatever profile is active
- * ```ts
- * import { NookplotRuntime } from "@nookplot/runtime";
- * import { loadProfile } from "@nookplot/runtime/loadProfile";
- *
- * const creds = loadProfile();   // respects NOOKPLOT_PROFILE env + sticky default
- * if (!creds) throw new Error("No credentials — run `nookplot register` first");
- *
- * const runtime = new NookplotRuntime({
- *   apiKey: creds.apiKey,
- *   gatewayUrl: creds.gatewayUrl,
- * });
- * ```
- *
- * @example Explicit profile override
- * ```ts
- * const creds = loadProfile("jeffs-researcher");
- * ```
- *
- * @example Multi-agent — run two SDK instances in parallel
- * ```ts
- * const researcherCreds = loadProfile("jeffs-researcher");
- * const writerCreds = loadProfile("jeffs-writer");
- *
- * const researcher = new NookplotRuntime({ apiKey: researcherCreds!.apiKey, ... });
- * const writer = new NookplotRuntime({ apiKey: writerCreds!.apiKey, ... });
- * // Both clients share the creator's API key but scope to different forged agents.
- * ```
- */
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-function nookplotDir() {
-    return join(homedir(), ".nookplot");
-}
-function credentialsPath() {
-    return join(nookplotDir(), "credentials.json");
-}
-function profilePath(name) {
-    return join(nookplotDir(), "profiles", name, "profile.json");
-}
-function activeProfilePath() {
-    return join(nookplotDir(), "active-profile");
-}
-/**
- * Resolve the active profile name in priority order.
- * Exported for testing + for developers who want to see which profile
- * WOULD be used without actually loading credentials.
- */
-export function resolveActiveProfileName(explicitName) {
-    if (explicitName)
-        return explicitName;
-    const env = process.env.NOOKPLOT_PROFILE;
-    if (env)
-        return env;
-    try {
-        if (existsSync(activeProfilePath())) {
-            const content = readFileSync(activeProfilePath(), "utf-8").trim();
-            if (content)
-                return content;
-        }
-    }
-    catch {
-        // Permissions error or disk issue — fall through
-    }
-    return null;
-}
-/**
- * Load credentials, optionally merging a named profile's scope on top.
- *
- * Returns null if no `credentials.json` exists — the developer should
- * surface a clear "run `nookplot register` first" message in that case.
- *
- * Does not throw on invalid profiles — if the named profile doesn't
- * exist or is malformed, falls back to plain creator-direct credentials
- * (matches @nookplot/mcp's fail-open behavior so stale env vars don't
- * break unrelated commands).
- */
-export function loadProfile(name) {
-    // 1. Load base credentials — the shared creator API key.
-    if (!existsSync(credentialsPath()))
-        return null;
-    let creds;
-    try {
-        creds = JSON.parse(readFileSync(credentialsPath(), "utf-8"));
-    }
-    catch {
-        return null;
-    }
-    if (!creds.apiKey || !creds.address || !creds.privateKey || !creds.gatewayUrl) {
-        return null;
-    }
-    // 2. Honor NOOKPLOT_GATEWAY_URL env if set (matches SDK + MCP convention).
-    const gatewayUrl = process.env.NOOKPLOT_GATEWAY_URL ?? creds.gatewayUrl;
-    // 3. Resolve profile (if any) and read its scope.
-    const profileName = resolveActiveProfileName(name);
-    if (!profileName) {
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    const pPath = profilePath(profileName);
-    if (!existsSync(pPath)) {
-        // Stale profile reference — fall back to creator-direct. Matches
-        // @nookplot/mcp's fail-open pattern.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    try {
-        const p = JSON.parse(readFileSync(pPath, "utf-8"));
-        if (typeof p.scopedAgentAddress !== "string" || p.scopedAgentAddress.length === 0) {
-            // Malformed profile — fall back.
-            return {
-                apiKey: creds.apiKey,
-                address: creds.address,
-                privateKey: creds.privateKey,
-                gatewayUrl,
-                displayName: creds.displayName,
-            };
-        }
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            scopedAgentAddress: p.scopedAgentAddress,
-            profileName,
-            displayName: creds.displayName,
-        };
-    }
-    catch {
-        // JSON parse error on profile — fall back to creator-direct.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-}
-/**
- * List all profiles registered on the local machine. Each entry includes
- * the profile name + its metadata. Useful for SDK consumers who want to
- * enumerate the user's forged agents programmatically.
- *
- * Returns an empty array if ~/.nookplot/profiles doesn't exist. Never
- * throws — invalid profiles are silently skipped.
- */
-export function listProfiles() {
-    const dir = join(nookplotDir(), "profiles");
-    if (!existsSync(dir))
-        return [];
-    const out = [];
-    try {
-        const { readdirSync, statSync } = require("node:fs");
-        for (const name of readdirSync(dir).sort()) {
-            const full = join(dir, name);
-            try {
-                if (!statSync(full).isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const pPath = join(full, "profile.json");
-            if (!existsSync(pPath))
-                continue;
-            try {
-                const p = JSON.parse(readFileSync(pPath, "utf-8"));
-                if (typeof p.scopedAgentAddress !== "string")
-                    continue;
-                out.push({
-                    name,
-                    scopedAgentAddress: p.scopedAgentAddress,
-                    displayName: p.displayName,
-                    hermesProfile: p.hermesProfile,
-                });
-            }
-            catch {
-                // Skip invalid profiles
-            }
-        }
-    }
-    catch {
-        // Missing dir or perms — return empty
-    }
-    return out;
-}
-//# sourceMappingURL=loadProfile.js.map

package/dist/loadProfile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loadProfile.js","sourceRoot":"","sources":["../src/loadProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,SAAS,WAAW;IAClB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AACD,SAAS,eAAe;IACtB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,kBAAkB,CAAC,CAAC;AACjD,CAAC;AACD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC;AACD,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAAqB;IAC5D,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACzC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,YAAY,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,yDAAyD;IACzD,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,KAA6B,CAAC;IAClC,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC,CAA2B,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC;IAExE,kDAAkD;IAClD,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,iEAAiE;QACjE,qCAAqC;QACrC,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAgB,CAAC;QAClE,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClF,iCAAiC;YACjC,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU;gBACV,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU;YACV,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;YACxC,WAAW;YACX,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAsG,EAAE,CAAC;IAClH,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAA6B,CAAC;QACjF,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,SAAS;YAC9C,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAgB,CAAC;gBAClE,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ;oBAAE,SAAS;gBACvD,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI;oBACJ,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;oBACxC,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;iBAC/B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/usdcBudget.d.ts

@@ -1,90 +0,0 @@
-/**
- * UsdcBudget — a hard-stop, rolling-window USDC spend cap for the per-call x402
- * `pay_api` action.
- *
- * A first-class sibling to the goal loop's `budgetNook`, with two deliberate
- * differences: it is **money-denominated** (USDC base units) and it **enforces**
- * (`budgetNook` is soft/warn-only — `goalLoop.ts:190`). One tracker per agent
- * process, hung off `runtime.usdcBudget`, so every `pay_api` dispatch site
- * (reactive + goal-loop, TS + the Python mirror) shares the SAME ledger and the
- * cap holds no matter which path spends.
- *
- * Enforcement model (zero overshoot):
- *   1. Before paying, a dispatch site asks `maxForNextCall()` for the largest
- *      amount this call may spend (min of the per-call ceiling and remaining
- *      daily headroom). It passes that as `payAndCall`'s `maxAmountBaseUnits`,
- *      which aborts BEFORE signing if the 402 quote exceeds it.
- *   2. After a successful pay, the site `record()`s the exact amount.
- *   3. The goal loop reads `isExhausted()` and terminates with `blocked_budget`
- *      once the daily cap is fully consumed (the consumer that finally makes the
- *      `blocked_budget` outcome live — see `goal/types.ts`).
- *
- * Amounts are USDC base units (6 decimals): 1 USDC = 1_000_000n.
- * A `dailyCapBaseUnits` of 0n means "unlimited" (cap disabled); likewise 0n for
- * the per-call ceiling means "no per-call ceiling".
- *
- * @module usdcBudget
- */
-/** USDC has 6 decimals on Base. */
-export declare const USDC_DECIMALS = 6;
-/** Default daily cap when nothing is configured: $10/day. Conservative
- *  safety net for a runaway buyer — operators raise it via `X402_DAILY_USDC_CAP`
- *  (or `dailyCapBaseUnits: 0n` to disable). pay_api is the only consumer, so a
- *  non-zero default never affects non-buying agents. */
-export declare const DEFAULT_DAILY_USDC_CAP_BASE_UNITS: bigint;
-export interface UsdcBudgetCheck {
-    allowed: boolean;
-    /** Human-readable reason when `allowed` is false. */
-    reason?: string;
-    /** Remaining daily headroom in base units; -1n when unlimited. */
-    remainingBaseUnits: bigint;
-}
-export interface UsdcBudgetOptions {
-    /** Daily cap in USDC base units. 0n = unlimited. Default: 10 USDC. */
-    dailyCapBaseUnits?: bigint;
-    /** Per-call ceiling in USDC base units. 0n = no per-call ceiling. Default: 0n. */
-    perCallCapBaseUnits?: bigint;
-    /** Rolling window length in ms (default 24h). */
-    windowMs?: number;
-    /** Clock injection for deterministic tests. Default `Date.now`. */
-    now?: () => number;
-}
-/** Parse a USDC display amount ("10", "0.5") into base units. Returns 0n
- *  (unlimited) for empty / non-positive / unparseable input. */
-export declare function parseUsdcToBaseUnits(display: string | undefined): bigint;
-/** Format base units as a `$x.xx` USDC string for log/agent messages. */
-export declare function formatUsdc(baseUnits: bigint): string;
-export declare class UsdcBudget {
-    /** Daily cap in USDC base units. 0n = unlimited. */
-    readonly dailyCapBaseUnits: bigint;
-    /** Per-call ceiling in USDC base units. 0n = none. */
-    readonly perCallCapBaseUnits: bigint;
-    private readonly windowMs;
-    private readonly now;
-    private spentBaseUnits;
-    private windowStartMs;
-    constructor(opts?: UsdcBudgetOptions);
-    /** Roll the spend window when the current 24h period has elapsed. */
-    private roll;
-    /** Pre-pay check for a known quote. Honors both the per-call ceiling and the
-     *  remaining daily headroom. */
-    check(amountBaseUnits: bigint): UsdcBudgetCheck;
-    /** The largest amount a single call may spend right now (min of per-call
-     *  ceiling and remaining daily headroom). `undefined` = unlimited. `0n` =
-     *  budget already exhausted (caller should not pay at all). */
-    maxForNextCall(): bigint | undefined;
-    /** Record a completed spend (call AFTER a successful payment). */
-    record(amountBaseUnits: bigint): void;
-    /** Remaining daily headroom in base units; -1n when unlimited. */
-    remaining(): bigint;
-    /** True when a daily cap is set and fully consumed — the goal loop's
-     *  `blocked_budget` trigger. Always false when unlimited. */
-    isExhausted(): boolean;
-    /** Spent-so-far in the current window (base units). */
-    get spent(): bigint;
-}
-/** Build a UsdcBudget from explicit options falling back to env
- *  (`X402_DAILY_USDC_CAP`, `X402_PER_CALL_USDC_CAP`, both USDC display units)
- *  and finally the conservative default daily cap. */
-export declare function createUsdcBudget(opts?: UsdcBudgetOptions): UsdcBudget;
-//# sourceMappingURL=usdcBudget.d.ts.map

package/dist/usdcBudget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"usdcBudget.d.ts","sourceRoot":"","sources":["../src/usdcBudget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,mCAAmC;AACnC,eAAO,MAAM,aAAa,IAAI,CAAC;AAG/B;;;wDAGwD;AACxD,eAAO,MAAM,iCAAiC,QAAiB,CAAC;AAIhE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;gEACgE;AAChE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOxE;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,qBAAa,UAAU;IACrB,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,aAAa,CAAS;gBAElB,IAAI,GAAE,iBAAsB;IAQxC,qEAAqE;IACrE,OAAO,CAAC,IAAI;IAQZ;oCACgC;IAChC,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,eAAe;IAmB/C;;mEAE+D;IAC/D,cAAc,IAAI,MAAM,GAAG,SAAS;IAUpC,kEAAkE;IAClE,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAKrC,kEAAkE;IAClE,SAAS,IAAI,MAAM;IAOnB;iEAC6D;IAC7D,WAAW,IAAI,OAAO;IAMtB,uDAAuD;IACvD,IAAI,KAAK,IAAI,MAAM,CAGlB;CACF;AAED;;sDAEsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAWzE"}

package/dist/usdcBudget.js

@@ -1,155 +0,0 @@
-/**
- * UsdcBudget — a hard-stop, rolling-window USDC spend cap for the per-call x402
- * `pay_api` action.
- *
- * A first-class sibling to the goal loop's `budgetNook`, with two deliberate
- * differences: it is **money-denominated** (USDC base units) and it **enforces**
- * (`budgetNook` is soft/warn-only — `goalLoop.ts:190`). One tracker per agent
- * process, hung off `runtime.usdcBudget`, so every `pay_api` dispatch site
- * (reactive + goal-loop, TS + the Python mirror) shares the SAME ledger and the
- * cap holds no matter which path spends.
- *
- * Enforcement model (zero overshoot):
- *   1. Before paying, a dispatch site asks `maxForNextCall()` for the largest
- *      amount this call may spend (min of the per-call ceiling and remaining
- *      daily headroom). It passes that as `payAndCall`'s `maxAmountBaseUnits`,
- *      which aborts BEFORE signing if the 402 quote exceeds it.
- *   2. After a successful pay, the site `record()`s the exact amount.
- *   3. The goal loop reads `isExhausted()` and terminates with `blocked_budget`
- *      once the daily cap is fully consumed (the consumer that finally makes the
- *      `blocked_budget` outcome live — see `goal/types.ts`).
- *
- * Amounts are USDC base units (6 decimals): 1 USDC = 1_000_000n.
- * A `dailyCapBaseUnits` of 0n means "unlimited" (cap disabled); likewise 0n for
- * the per-call ceiling means "no per-call ceiling".
- *
- * @module usdcBudget
- */
-/** USDC has 6 decimals on Base. */
-export const USDC_DECIMALS = 6;
-const USDC_ONE = 1000000n;
-/** Default daily cap when nothing is configured: $10/day. Conservative
- *  safety net for a runaway buyer — operators raise it via `X402_DAILY_USDC_CAP`
- *  (or `dailyCapBaseUnits: 0n` to disable). pay_api is the only consumer, so a
- *  non-zero default never affects non-buying agents. */
-export const DEFAULT_DAILY_USDC_CAP_BASE_UNITS = 10n * USDC_ONE;
-const WINDOW_MS = 24 * 60 * 60 * 1000;
-/** Parse a USDC display amount ("10", "0.5") into base units. Returns 0n
- *  (unlimited) for empty / non-positive / unparseable input. */
-export function parseUsdcToBaseUnits(display) {
-    if (!display)
-        return 0n;
-    const trimmed = display.trim();
-    if (!/^\d+(\.\d+)?$/.test(trimmed))
-        return 0n;
-    const [whole, frac = ""] = trimmed.split(".");
-    const fracPadded = (frac + "000000").slice(0, USDC_DECIMALS);
-    return BigInt(whole) * USDC_ONE + BigInt(fracPadded || "0");
-}
-/** Format base units as a `$x.xx` USDC string for log/agent messages. */
-export function formatUsdc(baseUnits) {
-    const whole = baseUnits / USDC_ONE;
-    const frac = (baseUnits % USDC_ONE).toString().padStart(USDC_DECIMALS, "0").replace(/0+$/, "");
-    return frac ? `$${whole}.${frac}` : `$${whole}`;
-}
-export class UsdcBudget {
-    /** Daily cap in USDC base units. 0n = unlimited. */
-    dailyCapBaseUnits;
-    /** Per-call ceiling in USDC base units. 0n = none. */
-    perCallCapBaseUnits;
-    windowMs;
-    now;
-    spentBaseUnits = 0n;
-    windowStartMs;
-    constructor(opts = {}) {
-        this.dailyCapBaseUnits = opts.dailyCapBaseUnits ?? DEFAULT_DAILY_USDC_CAP_BASE_UNITS;
-        this.perCallCapBaseUnits = opts.perCallCapBaseUnits ?? 0n;
-        this.windowMs = opts.windowMs ?? WINDOW_MS;
-        this.now = opts.now ?? (() => Date.now());
-        this.windowStartMs = this.now();
-    }
-    /** Roll the spend window when the current 24h period has elapsed. */
-    roll() {
-        const t = this.now();
-        if (t - this.windowStartMs >= this.windowMs) {
-            this.spentBaseUnits = 0n;
-            this.windowStartMs = t;
-        }
-    }
-    /** Pre-pay check for a known quote. Honors both the per-call ceiling and the
-     *  remaining daily headroom. */
-    check(amountBaseUnits) {
-        this.roll();
-        if (this.perCallCapBaseUnits > 0n && amountBaseUnits > this.perCallCapBaseUnits) {
-            return {
-                allowed: false,
-                reason: `per-call ${formatUsdc(amountBaseUnits)} exceeds the ceiling ${formatUsdc(this.perCallCapBaseUnits)}`,
-                remainingBaseUnits: this.remaining(),
-            };
-        }
-        if (this.dailyCapBaseUnits > 0n && this.spentBaseUnits + amountBaseUnits > this.dailyCapBaseUnits) {
-            return {
-                allowed: false,
-                reason: `daily USDC cap ${formatUsdc(this.dailyCapBaseUnits)} would be exceeded (already spent ${formatUsdc(this.spentBaseUnits)})`,
-                remainingBaseUnits: this.remaining(),
-            };
-        }
-        return { allowed: true, remainingBaseUnits: this.remaining() };
-    }
-    /** The largest amount a single call may spend right now (min of per-call
-     *  ceiling and remaining daily headroom). `undefined` = unlimited. `0n` =
-     *  budget already exhausted (caller should not pay at all). */
-    maxForNextCall() {
-        this.roll();
-        const limits = [];
-        if (this.perCallCapBaseUnits > 0n)
-            limits.push(this.perCallCapBaseUnits);
-        if (this.dailyCapBaseUnits > 0n)
-            limits.push(this.dailyCapBaseUnits - this.spentBaseUnits);
-        if (limits.length === 0)
-            return undefined; // fully unlimited
-        const m = limits.reduce((a, b) => (b < a ? b : a));
-        return m > 0n ? m : 0n;
-    }
-    /** Record a completed spend (call AFTER a successful payment). */
-    record(amountBaseUnits) {
-        this.roll();
-        if (amountBaseUnits > 0n)
-            this.spentBaseUnits += amountBaseUnits;
-    }
-    /** Remaining daily headroom in base units; -1n when unlimited. */
-    remaining() {
-        if (this.dailyCapBaseUnits === 0n)
-            return -1n;
-        this.roll();
-        const r = this.dailyCapBaseUnits - this.spentBaseUnits;
-        return r > 0n ? r : 0n;
-    }
-    /** True when a daily cap is set and fully consumed — the goal loop's
-     *  `blocked_budget` trigger. Always false when unlimited. */
-    isExhausted() {
-        if (this.dailyCapBaseUnits === 0n)
-            return false;
-        this.roll();
-        return this.spentBaseUnits >= this.dailyCapBaseUnits;
-    }
-    /** Spent-so-far in the current window (base units). */
-    get spent() {
-        this.roll();
-        return this.spentBaseUnits;
-    }
-}
-/** Build a UsdcBudget from explicit options falling back to env
- *  (`X402_DAILY_USDC_CAP`, `X402_PER_CALL_USDC_CAP`, both USDC display units)
- *  and finally the conservative default daily cap. */
-export function createUsdcBudget(opts = {}) {
-    const env = typeof process !== "undefined" ? process.env : undefined;
-    const dailyCapBaseUnits = opts.dailyCapBaseUnits ??
-        (env?.X402_DAILY_USDC_CAP !== undefined
-            ? parseUsdcToBaseUnits(env.X402_DAILY_USDC_CAP)
-            : DEFAULT_DAILY_USDC_CAP_BASE_UNITS);
-    const perCallCapBaseUnits = opts.perCallCapBaseUnits ??
-        (env?.X402_PER_CALL_USDC_CAP !== undefined ? parseUsdcToBaseUnits(env.X402_PER_CALL_USDC_CAP) : 0n);
-    return new UsdcBudget({ ...opts, dailyCapBaseUnits, perCallCapBaseUnits });
-}
-//# sourceMappingURL=usdcBudget.js.map

package/dist/usdcBudget.js.map

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

package/dist/x402.d.ts

@@ -1,69 +0,0 @@
-/**
- * Optional convenience wrapper for paying marketplace API listings per-call via
- * x402 (ROADMAP_x402-marketplace-fees.md v2). This is NOT required — any standard
- * x402 client (Base MCP, x402-axios, x402-py) can pay a Nookplot listing because
- * the gateway speaks the standard `"exact"` scheme. This wrapper just removes the
- * boilerplate for agents already holding an ethers signer.
- *
- * Unlike the agreement-based {@link ApiMarketplaceManager.proxyRequest}, the x402
- * path is **accountless**: there is no gateway API key and no on-chain agreement.
- * The buyer's per-call EIP-3009 USDC authorization IS the payment + the auth.
- *
- * Flow:
- *   1. Probe `GET/POST /v1/api-x402/:listingId/*` with no payment → HTTP 402 +
- *      the `accepts[]` challenge (splitter `payTo`, USDC `asset`, price).
- *   2. Sign an EIP-3009 `ReceiveWithAuthorization` over the advertised amount.
- *   3. Re-send the request with the encoded payment header → upstream response.
- *
- * v2.0 accepts USDC only, so the token's EIP-712 domain is the USDC default
- * ("USD Coin" / "2"). NOOK (a different domain) is deferred to v2.1.
- *
- * @module x402
- */
-import { ethers } from "ethers";
-export interface X402PayAndCallInput {
-    /** On-chain listing id. */
-    listingId: number | string;
-    /** Upstream path after the listing id (e.g. "chat/completions"). */
-    path: string;
-    /** HTTP method. Default "GET". */
-    method?: string;
-    /** JSON request body (serialized for non-GET/HEAD). */
-    body?: unknown;
-    /** Extra request headers passed through to the upstream. */
-    headers?: Record<string, string>;
-    /** Hard per-call ceiling in USDC base units. When set, `payAndCall` throws
-     *  BEFORE signing if the 402-quoted `maxAmountRequired` exceeds it. The
-     *  `pay_api` dispatch sites pass `runtime.usdcBudget.maxForNextCall()` here so
-     *  the spend cap is enforced at the point of payment. */
-    maxAmountBaseUnits?: bigint;
-}
-export interface X402PayAndCallResult {
-    status: number;
-    headers: Record<string, string>;
-    /** Parsed JSON when possible, else raw text. */
-    body: unknown;
-    /** True when a payment was signed + submitted; false when the gateway
-     *  short-circuited before payment (e.g. listing unavailable). */
-    paid: boolean;
-    /** USDC base units actually authorized when `paid` is true (the 402
-     *  `maxAmountRequired`). Lets the caller record the spend against a budget. */
-    amountPaidBaseUnits?: string;
-}
-export interface X402ManagerOptions {
-    /** Override the EIP-712 chain id (else derived from the 402 `network`). */
-    chainId?: number;
-}
-export declare class X402Manager {
-    private readonly gatewayUrl;
-    private readonly chainIdOverride?;
-    constructor(gatewayUrl: string, opts?: X402ManagerOptions);
-    /**
-     * Pay for and make a single metered call to a marketplace API listing.
-     *
-     * @param input  The listing + upstream request.
-     * @param signer An ethers signer holding the buyer's USDC (e.g. `new ethers.Wallet(pk)`).
-     */
-    payAndCall(input: X402PayAndCallInput, signer: ethers.Signer): Promise<X402PayAndCallResult>;
-}
-//# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgBhC,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;6DAGyD;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;IACd;qEACiE;IACjE,IAAI,EAAE,OAAO,CAAC;IACd;mFAC+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAYD,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;gBAE9B,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;IAK7D;;;;;OAKG;IACG,UAAU,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAiEnG"}