@nookplot/runtime 0.5.144 → 0.5.145

package/dist/__tests__/loadProfile.test.js

@@ -0,0 +1,134 @@
+/**
+ * Tests for the SDK's loadProfile helper.
+ *
+ * Parallel to @nookplot/mcp's auth-profile.test.ts and @nookplot/cli's
+ * profile.test.ts — same resolution order, same backward-compat guarantees.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+let testHome;
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    return {
+        ...actual,
+        homedir: () => testHome,
+    };
+});
+const { loadProfile, listProfiles, resolveActiveProfileName } = await import("../loadProfile.js");
+const BASE_CREDS = {
+    apiKey: "nk_" + "a".repeat(64),
+    privateKey: "0x" + "1".repeat(64),
+    address: "0xcreator0000000000000000000000000000aaaa",
+    gatewayUrl: "https://gateway.nookplot.com",
+    displayName: "Test Creator",
+};
+function seedCreds() {
+    const dir = join(testHome, ".nookplot");
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "credentials.json"), JSON.stringify(BASE_CREDS));
+}
+function seedProfile(name, overrides = {}) {
+    const dir = join(testHome, ".nookplot", "profiles", name);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "profile.json"), JSON.stringify({
+        scopedAgentAddress: "0x" + name.padEnd(40, "f").slice(0, 40),
+        ...overrides,
+    }));
+}
+beforeEach(() => {
+    testHome = mkdtempSync(join(tmpdir(), "sdk-profile-"));
+    delete process.env.NOOKPLOT_PROFILE;
+    delete process.env.NOOKPLOT_GATEWAY_URL;
+});
+afterEach(() => {
+    rmSync(testHome, { recursive: true, force: true });
+    delete process.env.NOOKPLOT_PROFILE;
+    delete process.env.NOOKPLOT_GATEWAY_URL;
+});
+describe("loadProfile — default-path backward compat", () => {
+    it("returns null when no credentials.json exists", () => {
+        expect(loadProfile()).toBeNull();
+    });
+    it("returns flat creds when no profile is active (IDENTICAL to pre-change shape)", () => {
+        seedCreds();
+        const creds = loadProfile();
+        expect(creds).not.toBeNull();
+        expect(creds.apiKey).toBe(BASE_CREDS.apiKey);
+        expect(creds.address).toBe(BASE_CREDS.address);
+        expect(creds.gatewayUrl).toBe(BASE_CREDS.gatewayUrl);
+        // Scope fields absent — SDK users who switch to this helper without
+        // opting into profiles see no behavior change.
+        expect(creds.scopedAgentAddress).toBeUndefined();
+        expect(creds.profileName).toBeUndefined();
+    });
+    it("honors NOOKPLOT_GATEWAY_URL env override (existing SDK convention)", () => {
+        seedCreds();
+        process.env.NOOKPLOT_GATEWAY_URL = "http://127.0.0.1:4321";
+        expect(loadProfile().gatewayUrl).toBe("http://127.0.0.1:4321");
+    });
+});
+describe("loadProfile — profile scope merging", () => {
+    it("merges scopedAgentAddress from a named profile", () => {
+        seedCreds();
+        seedProfile("researcher");
+        const creds = loadProfile("researcher");
+        expect(creds.apiKey).toBe(BASE_CREDS.apiKey); // unchanged
+        expect(creds.scopedAgentAddress).toMatch(/^0xresearcher/);
+        expect(creds.profileName).toBe("researcher");
+    });
+    it("falls back gracefully when the profile doesn't exist (doesn't break scripts)", () => {
+        seedCreds();
+        const creds = loadProfile("ghost");
+        expect(creds).not.toBeNull();
+        expect(creds.scopedAgentAddress).toBeUndefined();
+    });
+    it("falls back gracefully on malformed profile.json", () => {
+        seedCreds();
+        const dir = join(testHome, ".nookplot", "profiles", "broken");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, "profile.json"), "not json at all");
+        const creds = loadProfile("broken");
+        expect(creds).not.toBeNull();
+        expect(creds.scopedAgentAddress).toBeUndefined();
+    });
+    it("never touches the creator credentials.json (additive-only guarantee)", () => {
+        seedCreds();
+        seedProfile("a");
+        loadProfile("a");
+        const raw = require("node:fs").readFileSync(join(testHome, ".nookplot", "credentials.json"), "utf-8");
+        expect(JSON.parse(raw)).toEqual(BASE_CREDS);
+    });
+});
+describe("resolveActiveProfileName — priority order", () => {
+    beforeEach(() => seedCreds());
+    it("explicit argument beats env beats sticky default", () => {
+        writeFileSync(join(testHome, ".nookplot", "active-profile"), "sticky");
+        process.env.NOOKPLOT_PROFILE = "env";
+        expect(resolveActiveProfileName("explicit")).toBe("explicit");
+        expect(resolveActiveProfileName()).toBe("env");
+        delete process.env.NOOKPLOT_PROFILE;
+        expect(resolveActiveProfileName()).toBe("sticky");
+    });
+    it("returns null when nothing is set", () => {
+        expect(resolveActiveProfileName()).toBeNull();
+    });
+});
+describe("listProfiles", () => {
+    it("returns empty when no profiles dir exists", () => {
+        seedCreds();
+        expect(listProfiles()).toEqual([]);
+    });
+    it("enumerates valid profiles sorted alphabetically, skips invalid", () => {
+        seedCreds();
+        seedProfile("writer");
+        seedProfile("researcher");
+        const badDir = join(testHome, ".nookplot", "profiles", "bad");
+        mkdirSync(badDir, { recursive: true });
+        writeFileSync(join(badDir, "profile.json"), "{}");
+        const profiles = listProfiles();
+        expect(profiles.map((p) => p.name)).toEqual(["researcher", "writer"]);
+    });
+});
+//# sourceMappingURL=loadProfile.test.js.map

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

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

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

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

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

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

package/dist/__tests__/mining.test.js

@@ -0,0 +1,306 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { MiningManager, trackOf } from "../mining.js";
+// ─── Mock builders ────────────────────────────────────────────────────
+function createMockConnection() {
+    return {
+        request: vi.fn(),
+        gatewayUrl: "https://gateway.nookplot.com",
+        apiKey: "test-api-key",
+    };
+}
+function createMockEconomy() {
+    return {
+        inference: vi.fn().mockResolvedValue({ content: "x".repeat(200) }),
+    };
+}
+function setupResponses(connection, knowledgeIds, rlmIds = [], embedIds = []) {
+    connection.request.mockImplementation(async (method, path) => {
+        if (method === "GET" && path.startsWith("/v1/mining/earnings-preview")) {
+            return {
+                tracks: [
+                    { track: "knowledge", openCount: knowledgeIds.length },
+                    { track: "embedding", openCount: embedIds.length },
+                    { track: "rlm", openCount: rlmIds.length },
+                ],
+            };
+        }
+        if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open&sourceType=rlm_trajectory")) {
+            return {
+                challenges: rlmIds.map((id, i) => ({
+                    id, title: `RLM ${i}`, difficulty: "medium",
+                    estimatedRewardNook: 50_000, sourceType: "rlm_trajectory", closesAt: "2030-01-01T00:00:00Z",
+                })),
+            };
+        }
+        if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open")) {
+            return {
+                challenges: knowledgeIds.map((id, i) => ({
+                    id, title: `Knowledge ${i}`, difficulty: i === 0 ? "expert" : "easy",
+                    estimatedRewardNook: 100_000 - i * 1000, sourceType: "agent_authored",
+                    closesAt: "2030-01-01T00:00:00Z",
+                })),
+            };
+        }
+        if (method === "GET" && path.startsWith("/v1/mining/embedding-challenges?status=open")) {
+            return {
+                challenges: embedIds.map((id, i) => ({
+                    id, title: `Embedding ${i}`, difficulty: "easy",
+                    estimatedRewardNook: 5_000, sourceType: "embedding_generation", closesAt: "2030-01-01T00:00:00Z",
+                })),
+            };
+        }
+        if (method === "GET" && path.startsWith("/v1/mining/embedding-challenges/")) {
+            return { prompts: ["a", "b"], dimensions: 768 };
+        }
+        if (method === "POST" && path.startsWith("/v1/mining/submissions/")) {
+            return { submissionId: `sub-${path.split("/").pop()}` };
+        }
+        if (method === "POST" && path.includes("/v1/mining/embedding-challenges/") && path.endsWith("/submit")) {
+            return { submissionId: `embed-sub` };
+        }
+        throw new Error(`Unmocked request: ${method} ${path}`);
+    });
+}
+// ─── Tests ────────────────────────────────────────────────────────────
+describe("trackOf", () => {
+    it("classifies known source types", () => {
+        expect(trackOf("embedding_generation")).toBe("embedding");
+        expect(trackOf("rlm_trajectory")).toBe("rlm");
+        expect(trackOf("rlm_audit")).toBe("rlm");
+        expect(trackOf("agent_authored")).toBe("knowledge");
+        expect(trackOf("paper_reproduction")).toBe("knowledge");
+    });
+});
+describe("MiningManager.runOnce", () => {
+    let connection;
+    let economy;
+    let manager;
+    beforeEach(() => {
+        connection = createMockConnection();
+        economy = createMockEconomy();
+        manager = new MiningManager(connection, economy);
+    });
+    it("submits the highest-ranked challenge across enabled tracks", async () => {
+        setupResponses(connection, ["k1", "k2"], [], []);
+        const results = await manager.runOnce({ tracks: ["knowledge"] });
+        expect(results).toHaveLength(1);
+        expect(results[0].track).toBe("knowledge");
+        expect(results[0].status).toBe("submitted");
+        // k1 is "expert" difficulty so it ranks above k2.
+        expect(results[0].challengeId).toBe("k1");
+        expect(economy.inference).toHaveBeenCalledOnce();
+    });
+    it("dry-run does not submit", async () => {
+        setupResponses(connection, ["k1"], [], []);
+        const results = await manager.runOnce({ tracks: ["knowledge"], dryRun: true });
+        expect(results[0].status).toBe("skipped");
+        expect(results[0].reason).toBe("dry-run");
+        // No POST.
+        const posts = connection.request.mock.calls.filter((c) => c[0] === "POST");
+        expect(posts).toHaveLength(0);
+    });
+    it("returns empty array when no tracks have open challenges", async () => {
+        setupResponses(connection, [], [], []);
+        const results = await manager.runOnce({ tracks: ["knowledge", "embedding", "rlm"] });
+        expect(results).toEqual([]);
+    });
+    it("isolates per-track discovery failures (one track erroring does not poison others)", async () => {
+        connection.request.mockImplementation(async (method, path) => {
+            if (method === "GET" && path.startsWith("/v1/mining/embedding-challenges?")) {
+                throw new Error("embedding endpoint exploded");
+            }
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open&sourceType=rlm_trajectory")) {
+                return { challenges: [] };
+            }
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open")) {
+                return {
+                    challenges: [{
+                            id: "k1", title: "K", difficulty: "easy",
+                            estimatedRewardNook: 1000, sourceType: "agent_authored", closesAt: "2030-01-01T00:00:00Z",
+                        }],
+                };
+            }
+            if (method === "POST" && path.startsWith("/v1/mining/submissions/")) {
+                return { submissionId: "sub-k1" };
+            }
+            throw new Error(`unexpected ${method} ${path}`);
+        });
+        const results = await manager.runOnce({ tracks: ["knowledge", "embedding"] });
+        expect(results).toHaveLength(1);
+        expect(results[0].track).toBe("knowledge");
+        expect(results[0].status).toBe("submitted");
+    });
+    it("auto-resolves tracks via earnings-preview when tracks: 'auto'", async () => {
+        setupResponses(connection, ["k1"], [], []);
+        const results = await manager.runOnce({ tracks: "auto" });
+        expect(results[0].track).toBe("knowledge");
+        const previewCall = connection.request.mock.calls.find((c) => typeof c[1] === "string" && c[1].startsWith("/v1/mining/earnings-preview"));
+        expect(previewCall).toBeTruthy();
+    });
+    it("skips embedding when no generateEmbeddings callback is provided", async () => {
+        setupResponses(connection, [], [], ["e1"]);
+        const results = await manager.runOnce({ tracks: ["embedding"] });
+        expect(results[0].track).toBe("embedding");
+        expect(results[0].status).toBe("skipped");
+        expect(results[0].reason).toMatch(/generateEmbeddings/);
+    });
+    it("submits embedding via callback when provided", async () => {
+        setupResponses(connection, [], [], ["e1"]);
+        const generateEmbeddings = vi.fn().mockResolvedValue([Array(768).fill(0.1), Array(768).fill(0.2)]);
+        const results = await manager.runOnce({ tracks: ["embedding"], generateEmbeddings });
+        expect(results[0].status).toBe("submitted");
+        expect(generateEmbeddings).toHaveBeenCalledWith(["a", "b"], 768);
+    });
+    it("skips RLM by default with a deferred reason; uses solveRlm callback when provided", async () => {
+        setupResponses(connection, [], ["r1"], []);
+        const defaultResults = await manager.runOnce({ tracks: ["rlm"] });
+        expect(defaultResults[0].status).toBe("skipped");
+        expect(defaultResults[0].reason).toMatch(/RLM/);
+        const solveRlm = vi.fn().mockResolvedValue({
+            track: "rlm", challengeId: "r1", status: "submitted",
+            submissionId: "rlm-sub",
+        });
+        const customResults = await manager.runOnce({ tracks: ["rlm"], solveRlm });
+        expect(customResults[0].status).toBe("submitted");
+        expect(solveRlm).toHaveBeenCalledOnce();
+    });
+});
+describe("MiningManager.start", () => {
+    let connection;
+    let economy;
+    let manager;
+    beforeEach(() => {
+        connection = createMockConnection();
+        economy = createMockEconomy();
+        manager = new MiningManager(connection, economy);
+    });
+    it("once mode runs until queue drains and then resolves done", async () => {
+        let calls = 0;
+        connection.request.mockImplementation(async (method, path) => {
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open&sourceType=rlm_trajectory")) {
+                return { challenges: [] };
+            }
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open")) {
+                calls++;
+                if (calls === 1) {
+                    return {
+                        challenges: [{
+                                id: "k1", title: "K", difficulty: "easy",
+                                estimatedRewardNook: 1000, sourceType: "agent_authored", closesAt: "2030-01-01T00:00:00Z",
+                            }],
+                    };
+                }
+                return { challenges: [] };
+            }
+            if (method === "POST" && path.startsWith("/v1/mining/submissions/")) {
+                return { submissionId: "sub-k1" };
+            }
+            throw new Error(`unexpected ${method} ${path}`);
+        });
+        const session = await manager.start({ tracks: ["knowledge"], once: true, tickIntervalMs: 5 });
+        await session.done;
+        const stats = session.stats();
+        expect(stats.submitted).toBe(1);
+        expect(stats.byTrack.knowledge.submitted).toBe(1);
+    });
+    it("respects maxCredits — stops when budget is exhausted", async () => {
+        let challengeIdx = 0;
+        connection.request.mockImplementation(async (method, path) => {
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open&sourceType=rlm_trajectory")) {
+                return { challenges: [] };
+            }
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open")) {
+                return {
+                    challenges: [{
+                            id: `k${challengeIdx++}`, title: "K", difficulty: "easy",
+                            estimatedRewardNook: 1000, sourceType: "agent_authored", closesAt: "2030-01-01T00:00:00Z",
+                        }],
+                };
+            }
+            if (method === "POST" && path.startsWith("/v1/mining/submissions/")) {
+                return { submissionId: "sub" };
+            }
+            throw new Error(`unexpected ${method} ${path}`);
+        });
+        const session = await manager.start({
+            tracks: ["knowledge"],
+            maxCredits: 100, // each knowledge solve charges 50 → loop should stop after 2 solves
+            tickIntervalMs: 5,
+        });
+        // Wait briefly for the loop to spin and then stop on budget.
+        await new Promise((r) => setTimeout(r, 80));
+        await session.stop();
+        const stats = session.stats();
+        expect(stats.creditsSpent).toBeGreaterThanOrEqual(100);
+        expect(stats.submitted).toBeGreaterThanOrEqual(2);
+    });
+    it("rejects a second start() while a session is active", async () => {
+        setupResponses(connection, [], [], []);
+        const session = await manager.start({ tracks: ["knowledge"], tickIntervalMs: 5 });
+        await expect(manager.start({ tracks: ["knowledge"] })).rejects.toThrow(/already active/);
+        await session.stop();
+    });
+    it("dry-run skips count separately from real skips in stats.dryRun", async () => {
+        // Drains after one tick: discover returns k1 the first time, then [].
+        // (Real gateway moves a claimed challenge out of the open list; the mock
+        // simulates that so once-mode doesn't loop on the same challenge forever.)
+        let knowledgeCalls = 0;
+        connection.request.mockImplementation(async (method, path) => {
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open&sourceType=rlm_trajectory")) {
+                return { challenges: [] };
+            }
+            if (method === "GET" && path.startsWith("/v1/mining/challenges?status=open")) {
+                knowledgeCalls++;
+                if (knowledgeCalls === 1) {
+                    return { challenges: [{
+                                id: "k1", title: "K", difficulty: "easy",
+                                estimatedRewardNook: 1000, sourceType: "agent_authored",
+                                closesAt: "2030-01-01T00:00:00Z",
+                            }] };
+                }
+                return { challenges: [] };
+            }
+            throw new Error(`unexpected ${method} ${path}`);
+        });
+        const session = await manager.start({
+            tracks: ["knowledge"],
+            dryRun: true,
+            once: true,
+            tickIntervalMs: 5,
+        });
+        await session.done;
+        const stats = session.stats();
+        expect(stats.dryRun).toBe(1);
+        expect(stats.skipped).toBe(0);
+        expect(stats.submitted).toBe(0);
+    });
+});
+describe("MiningManager.runOnce — explain mode", () => {
+    it("logs scoring math when explain: true", async () => {
+        const connection = createMockConnection();
+        const economy = createMockEconomy();
+        const logs = [];
+        const manager = new MiningManager(connection, economy);
+        setupResponses(connection, ["k1", "k2", "k3"]);
+        await manager.runOnce({
+            tracks: ["knowledge"],
+            explain: true,
+            log: (m) => logs.push(m),
+        });
+        const rankLines = logs.filter((l) => l.startsWith("[mining][rank]"));
+        expect(rankLines.length).toBeGreaterThan(0);
+        expect(rankLines[0]).toMatch(/score=/);
+    });
+});
+// Type sanity check
+describe("ChallengeSummary type", () => {
+    it("compiles with expected fields", () => {
+        const s = {
+            id: "x", track: "knowledge", title: "t", difficulty: "easy",
+            estimatedRewardNook: 0, domainTags: [], sourceType: "agent_authored",
+            closesAt: "2030-01-01T00:00:00Z",
+        };
+        expect(s.track).toBe("knowledge");
+    });
+});
+//# sourceMappingURL=mining.test.js.map

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

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

package/dist/__tests__/pack.test.js

@@ -161,20 +161,20 @@ describe("schemaVersion (pack-format gate)", () => {
 });
 describe("parsePack", () => {
     it("parses a YAML pack document", () => {
-        const result = parsePack(`
-name: notion-research-agent
-version: 1.0.0
-tools: [search_knowledge, send_dm]
-mcpServers:
-  - name: notion
-    url: https://mcp.notion.com/mcp
-    connection: notion
-connections:
-  - service: notion
-    owner: agent
-connectors:
-  - platform: email
-    mode: outbound
+        const result = parsePack(`
+name: notion-research-agent
+version: 1.0.0
+tools: [search_knowledge, send_dm]
+mcpServers:
+  - name: notion
+    url: https://mcp.notion.com/mcp
+    connection: notion
+connections:
+  - service: notion
+    owner: agent
+connectors:
+  - platform: email
+    mode: outbound
 `);
         expect(result.errors).toEqual([]);
         expect(result.ok).toBe(true);

package/dist/__tests__/packLoader.test.js

@@ -234,10 +234,10 @@ describe("preset delegation", () => {
 });
 describe("pack file loading", () => {
     it("reads + parses the pack from packPath", async () => {
-        mockReadFile.mockResolvedValueOnce(`
-name: from-file
-version: 1.0.0
-tools: [search_knowledge]
+        mockReadFile.mockResolvedValueOnce(`
+name: from-file
+version: 1.0.0
+tools: [search_knowledge]
 `);
         const { runtime } = makeRuntime();
         const report = await new PackLoader(runtime, { packPath: "./my.pack.yaml" }).load();

package/dist/__tests__/presetLoader.test.js

@@ -27,28 +27,28 @@ function createMockRuntime() {
         identity: { getAddress: vi.fn().mockReturnValue("0xtest") },
     };
 }
-const SAMPLE_YAML = `
-version: "1.0"
-gateway: https://gateway.nookplot.com
-agent:
-  name: TestAgent
-preset:
-  id: "research-biology"
-  version: 1
-  trustLevel: "verified"
-  failurePolicy: "continue"
-  maxCostNook: 5000000
-  sources:
-    - type: "mining"
-      label: "Biology traces"
-      config:
-        domainTags: ["biology"]
-        minScore: 0.6
-        maxTraces: 10
-    - type: "bundle"
-      label: "Bio papers"
-      config:
-        bundleId: 42
+const SAMPLE_YAML = `
+version: "1.0"
+gateway: https://gateway.nookplot.com
+agent:
+  name: TestAgent
+preset:
+  id: "research-biology"
+  version: 1
+  trustLevel: "verified"
+  failurePolicy: "continue"
+  maxCostNook: 5000000
+  sources:
+    - type: "mining"
+      label: "Biology traces"
+      config:
+        domainTags: ["biology"]
+        minScore: 0.6
+        maxTraces: 10
+    - type: "bundle"
+      label: "Bio papers"
+      config:
+        bundleId: 42
 `;
 const FETCH_RESPONSE = {
     presetId: "research-biology",
@@ -713,26 +713,26 @@ describe("E2E: forge data/fetch → KG batch ingest → self-model memory", () =
             totalItems: 2,
             totalCostNook: 50000,
         };
-        const YAML_WITH_AGG = `
-version: "1.0"
-gateway: https://gateway.nookplot.com
-agent:
-  name: GenomicsAgent
-preset:
-  id: "genomics-researcher"
-  version: 1
-  trustLevel: "verified"
-  failurePolicy: "continue"
-  maxCostNook: 5000000
-  sources:
-    - type: "mining"
-      label: "Genomics traces"
-      config:
-        domainTags: ["genomics"]
-    - type: "aggregate"
-      label: "Genomics aggregates"
-      config:
-        domainTags: ["genomics"]
+        const YAML_WITH_AGG = `
+version: "1.0"
+gateway: https://gateway.nookplot.com
+agent:
+  name: GenomicsAgent
+preset:
+  id: "genomics-researcher"
+  version: 1
+  trustLevel: "verified"
+  failurePolicy: "continue"
+  maxCostNook: 5000000
+  sources:
+    - type: "mining"
+      label: "Genomics traces"
+      config:
+        domainTags: ["genomics"]
+    - type: "aggregate"
+      label: "Genomics aggregates"
+      config:
+        domainTags: ["genomics"]
 `;
         setupReadFileMocks(YAML_WITH_AGG);
         setupKgAvailable(runtime, AGGREGATE_FETCH_RESPONSE);

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

@@ -0,0 +1,18 @@
+/**
+ * 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).
+ */
+export {};
+//# sourceMappingURL=runtimeConstructor.test.d.ts.map