@nookplot/runtime 0.5.144 → 0.5.145

package/dist/__tests__/economy.frontierInference.test.js

@@ -1,61 +0,0 @@
-/**
- * EconomyManager.frontierInference() — the one-shot frontier (Surplus) call that
- * backs the `use_frontier_model` autonomous action (spends an owner-reserved
- * pass). Contract:
- *   1. ALWAYS routes to Surplus regardless of the configured default source.
- *   2. Returns `costUsdcMicros` = the spend-tracker delta for this call (so the
- *      caller can finalize the reserved pass with the real settled spend).
- *   3. Throws a keyless SurplusError (no network) when there's no private key.
- *
- * `surplusInference` is mocked here so the test doesn't require the optional
- * x402/viem peers (the real-client path is covered by economy.surplusBranch).
- */
-import { describe, it, expect, vi, beforeEach } from "vitest";
-vi.mock("../inference/surplusInference.js", async (importOriginal) => {
-    const actual = await importOriginal();
-    return {
-        ...actual,
-        // Simulate an x402 spend of $0.042 by bumping the shared tracker, and echo
-        // the requested model so we can assert the override took effect.
-        surplusInference: vi.fn(async (params) => {
-            if (params.tracker)
-                params.tracker.spentBaseUnits += 42000n;
-            return {
-                content: "frontier says hi",
-                model: params.options?.model ?? "unknown",
-                provider: "surplus",
-                usage: { promptTokens: 1, completionTokens: 1, totalTokens: 2, creditsCost: 0 },
-            };
-        }),
-    };
-});
-const { ConnectionManager } = await import("../connection.js");
-const { EconomyManager } = await import("../economy.js");
-const surplusMod = await import("../inference/surplusInference.js");
-const TEST_PK = "0x" + "ab".repeat(32);
-const TEST_BASE = "https://gateway.example.com";
-const MSGS = [{ role: "user", content: "Prove the theorem." }];
-beforeEach(() => vi.clearAllMocks());
-describe("EconomyManager.frontierInference()", () => {
-    it("routes to Surplus even when the default source is platform, and returns the cost delta", async () => {
-        const economy = new EconomyManager(new ConnectionManager({
-            gatewayUrl: TEST_BASE,
-            apiKey: "nk_test",
-            privateKey: TEST_PK,
-            inferenceSource: "platform", // default — frontierInference overrides to Surplus
-            surplus: { model: "llama-3.3-70b" },
-        }));
-        const result = await economy.frontierInference(MSGS, { model: "claude-opus-4.8" });
-        expect(surplusMod.surplusInference).toHaveBeenCalledTimes(1);
-        expect(result.provider).toBe("surplus");
-        expect(result.content).toBe("frontier says hi");
-        expect(result.model).toBe("claude-opus-4.8"); // the per-call override won
-        expect(result.costUsdcMicros).toBe(42_000); // tracker delta, 6-dec base units
-    });
-    it("throws keyless (no surplus call) when there is no private key", async () => {
-        const economy = new EconomyManager(new ConnectionManager({ gatewayUrl: TEST_BASE, apiKey: "nk_test" }));
-        await expect(economy.frontierInference(MSGS, { model: "claude-opus-4.8" })).rejects.toMatchObject({ code: "keyless" });
-        expect(surplusMod.surplusInference).not.toHaveBeenCalled();
-    });
-});
-//# sourceMappingURL=economy.frontierInference.test.js.map

package/dist/__tests__/economy.frontierInference.test.js.map

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

package/dist/frontierPass.d.ts

@@ -1,30 +0,0 @@
-/**
- * Shared `use_frontier_model` executor — used by BOTH the runtime's autonomous
- * loop (autonomous.ts) and the CLI dispatcher (agentLoop.ts), which have
- * parallel action-dispatch paths. Keeping the logic here prevents the two from
- * drifting on a money path.
- *
- * Flow (client-executed, non-custodial — the gateway can't run this):
- *   1. consume — claim ONE owner-reserved pass (gateway enforces reserved count
- *      + rolling daily cap; a 409/429 surfaces as a thrown request error).
- *   2. run — one-shot Surplus completion paid by the agent's OWN client-signed
- *      x402 key (economy.frontierInference).
- *   3. finalize — record the real settled spend; OR revert the pass to
- *      'reserved' on failure so it isn't wasted.
- *
- * @module frontierPass
- */
-import type { ConnectionManager } from "./connection.js";
-import type { EconomyManager } from "./economy.js";
-export interface FrontierPassResult {
-    ok?: boolean;
-    model?: string;
-    answer?: string;
-    spent_usdc?: string;
-    error?: string;
-    message?: string;
-    /** Loose result object the agent reads as a tool result. */
-    [key: string]: unknown;
-}
-export declare function runFrontierPass(connection: ConnectionManager, economy: EconomyManager, args: Record<string, unknown>, agentAddress?: string): Promise<FrontierPassResult>;
-//# sourceMappingURL=frontierPass.d.ts.map

package/dist/frontierPass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontierPass.d.ts","sourceRoot":"","sources":["../src/frontierPass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAyC7B"}

package/dist/frontierPass.js

@@ -1,42 +0,0 @@
-export async function runFrontierPass(connection, economy, args, agentAddress) {
-    const model = String(args.model ?? "").trim();
-    const task = String(args.task ?? "").trim();
-    const reason = typeof args.reason === "string" ? args.reason.slice(0, 280) : undefined;
-    if (!model)
-        return { error: "bad_model", message: "Pass a `model` (a Surplus model id)." };
-    if (!task)
-        return { error: "bad_task", message: "Pass the `task` — the full self-contained prompt for the frontier model." };
-    if (!agentAddress)
-        return { error: "frontier_unavailable", message: "Agent address unknown — cannot consume a pass." };
-    // 1. Claim a reserved pass.
-    let claim;
-    try {
-        claim = await connection.request("POST", `/v1/agents/${agentAddress}/inference-passes/consume`, { model, reason });
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return {
-            error: "no_reserved_pass",
-            message: `Couldn't claim a ${model} pass: ${msg}. Ask your owner to reserve passes in the agent's vault.`,
-        };
-    }
-    // 2. Run the one-shot frontier completion (client-signed x402, own USDC).
-    try {
-        const out = await economy.frontierInference([{ role: "user", content: task }], { model });
-        const costUsdcMicros = Number.isFinite(out.costUsdcMicros) ? out.costUsdcMicros : 0;
-        // 3. Record the settled spend (best-effort — the inference already happened).
-        await connection
-            .request("POST", `/v1/agents/${agentAddress}/inference-passes/${claim.passId}/finalize`, { costUsdcMicros })
-            .catch(() => { });
-        return { ok: true, model, answer: out.content ?? "", spent_usdc: (costUsdcMicros / 1e6).toFixed(6) };
-    }
-    catch (err) {
-        // x402 declined / timed out / provider error → return the pass to 'reserved'.
-        await connection
-            .request("POST", `/v1/agents/${agentAddress}/inference-passes/${claim.passId}/revert`, {})
-            .catch(() => { });
-        const msg = err instanceof Error ? err.message : String(err);
-        return { error: "frontier_call_failed", message: `Frontier call failed (your pass was NOT spent): ${msg}` };
-    }
-}
-//# sourceMappingURL=frontierPass.js.map

package/dist/frontierPass.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontierPass.js","sourceRoot":"","sources":["../src/frontierPass.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAA6B,EAC7B,OAAuB,EACvB,IAA6B,EAC7B,YAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAC3F,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,0EAA0E,EAAE,CAAC;IAC7H,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;IAEvH,4BAA4B;IAC5B,IAAI,KAA8D,CAAC;IACnE,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,CAC9B,MAAM,EACN,cAAc,YAAY,2BAA2B,EACrD,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,oBAAoB,KAAK,UAAU,GAAG,0DAA0D;SAC1G,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACnG,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,8EAA8E;QAC9E,MAAM,UAAU;aACb,OAAO,CAAC,MAAM,EAAE,cAAc,YAAY,qBAAqB,KAAK,CAAC,MAAM,WAAW,EAAE,EAAE,cAAc,EAAE,CAAC;aAC3G,KAAK,CAAC,GAAG,EAAE,GAAoC,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8EAA8E;QAC9E,MAAM,UAAU;aACb,OAAO,CAAC,MAAM,EAAE,cAAc,YAAY,qBAAqB,KAAK,CAAC,MAAM,SAAS,EAAE,EAAE,CAAC;aACzF,KAAK,CAAC,GAAG,EAAE,GAAqB,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,mDAAmD,GAAG,EAAE,EAAE,CAAC;IAC9G,CAAC;AACH,CAAC"}