@nookplot/runtime 0.5.120 → 0.5.121

package/dist/__tests__/manifestActivationHook.test.js

@@ -0,0 +1,312 @@
+/**
+ * manifestActivationHook contract tests.
+ *
+ * Stub-based unit tests against `installManifestActivationHook(runtime, opts)`.
+ * The runtime is a minimal mock — `hooks` is a fresh `HookRegistry` per test
+ * so listeners never leak; `manifests` is a vi.fn() bag covering the methods
+ * the hook calls (`setFocus`, `updateManifest`, `getMyManifest`).
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { HookRegistry } from "../hooks.js";
+import { installManifestActivationHook, TASK_BEARING_SIGNALS, TERMINAL_ACTIONS, extractDomain, } from "../manifestActivationHook.js";
+function makeRuntime(initialUncertainties = []) {
+    const hooks = new HookRegistry();
+    const manifests = {
+        setFocus: vi.fn().mockResolvedValue({ agentId: "a1", currentFocus: null }),
+        updateManifest: vi.fn().mockResolvedValue({ agentId: "a1", currentFocus: null }),
+        getMyManifest: vi.fn().mockResolvedValue({
+            agentId: "a1",
+            uncertainties: initialUncertainties,
+        }),
+    };
+    const runtime = { hooks, manifests };
+    return { runtime, hooks, manifests };
+}
+async function flush() {
+    // Hooks fire via `Promise.resolve()`-scheduled emits; one microtask flush
+    // is enough for the sync-look listeners. The async appendUncertainty path
+    // chains a getMyManifest then updateManifest — give it three rounds.
+    await new Promise((r) => setTimeout(r, 5));
+    await new Promise((r) => setTimeout(r, 5));
+    await new Promise((r) => setTimeout(r, 5));
+}
+describe("manifestActivationHook — installer", () => {
+    it("registers four listeners and the disposer removes them all", () => {
+        const { runtime, hooks } = makeRuntime();
+        expect(hooks.count("signal_received")).toBe(0);
+        expect(hooks.count("action_end")).toBe(0);
+        expect(hooks.count("action_error")).toBe(0);
+        expect(hooks.count("doom_loop_detected")).toBe(0);
+        const dispose = installManifestActivationHook(runtime);
+        expect(hooks.count("signal_received")).toBe(1);
+        expect(hooks.count("action_end")).toBe(1);
+        expect(hooks.count("action_error")).toBe(1);
+        expect(hooks.count("doom_loop_detected")).toBe(1);
+        dispose();
+        expect(hooks.count("signal_received")).toBe(0);
+        expect(hooks.count("action_end")).toBe(0);
+        expect(hooks.count("action_error")).toBe(0);
+        expect(hooks.count("doom_loop_detected")).toBe(0);
+    });
+    it("uses the registry from opts when provided", () => {
+        const { runtime, hooks: runtimeHooks } = makeRuntime();
+        const optsHooks = new HookRegistry();
+        installManifestActivationHook(runtime, { hooks: optsHooks });
+        expect(optsHooks.count("signal_received")).toBe(1);
+        expect(runtimeHooks.count("signal_received")).toBe(0);
+    });
+});
+describe("manifestActivationHook — signal_received → setFocus", () => {
+    it("calls setFocus for a task-bearing signal with extracted domain", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("signal_received", {
+            signalType: "mining_opportunity",
+            domainTags: ["solidity-security"],
+        });
+        await flush();
+        expect(manifests.setFocus).toHaveBeenCalledTimes(1);
+        expect(manifests.setFocus).toHaveBeenCalledWith({
+            taskType: "mining_opportunity",
+            domain: "solidity-security",
+        });
+    });
+    it("skips setFocus for non-allowlisted (social) signals", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("signal_received", { signalType: "channel_message" });
+        await hooks.emit("signal_received", { signalType: "dm_received" });
+        await hooks.emit("signal_received", { signalType: "new_follower" });
+        await flush();
+        expect(manifests.setFocus).not.toHaveBeenCalled();
+    });
+    it("falls back to 'general' when no domain hint is present", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("signal_received", { signalType: "bounty" });
+        await flush();
+        expect(manifests.setFocus).toHaveBeenCalledWith({
+            taskType: "bounty",
+            domain: "general",
+        });
+    });
+    it("swallows manifest write rejections so the agent loop is unaffected", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        manifests.setFocus.mockRejectedValueOnce(new Error("gateway down"));
+        installManifestActivationHook(runtime);
+        // The handler is sync-look; emit.allSettled inside HookRegistry plus our
+        // .catch swallow means this must NOT throw.
+        await expect(hooks.emit("signal_received", {
+            signalType: "task_assigned",
+            domain: "data-science",
+        })).resolves.toBeUndefined();
+    });
+});
+describe("manifestActivationHook — action_end → clearFocus", () => {
+    it("clears focus on a terminal action", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("action_end", {
+            actionType: "submit_mining_solution",
+            args: {},
+            result: {},
+            durationMs: 100,
+        });
+        await flush();
+        expect(manifests.updateManifest).toHaveBeenCalledTimes(1);
+        expect(manifests.updateManifest).toHaveBeenCalledWith({ currentFocus: null });
+    });
+    it("does NOT clear focus on a non-terminal action", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("action_end", {
+            actionType: "browse_tools",
+            args: {},
+            result: {},
+            durationMs: 100,
+        });
+        await hooks.emit("action_end", {
+            actionType: "get_my_balance",
+            args: {},
+            result: {},
+            durationMs: 100,
+        });
+        await flush();
+        expect(manifests.updateManifest).not.toHaveBeenCalled();
+    });
+});
+describe("manifestActivationHook — action_error debounce", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    it("does not write after 1 error", async () => {
+        vi.useRealTimers();
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("action_error", {
+            actionType: "submit_mining_solution",
+            args: {},
+            error: new Error("network blip"),
+            durationMs: 100,
+        });
+        await flush();
+        expect(manifests.getMyManifest).not.toHaveBeenCalled();
+        expect(manifests.updateManifest).not.toHaveBeenCalled();
+    });
+    it("writes one uncertainty after 3 errors of the same actionType inside the window", async () => {
+        vi.useRealTimers();
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        for (let i = 0; i < 3; i++) {
+            await hooks.emit("action_error", {
+                actionType: "submit_mining_solution",
+                args: {},
+                error: new Error(`fail-${i}`),
+                durationMs: 50,
+            });
+        }
+        await flush();
+        expect(manifests.getMyManifest).toHaveBeenCalledTimes(1);
+        expect(manifests.updateManifest).toHaveBeenCalledTimes(1);
+        const call = manifests.updateManifest.mock.calls[0][0];
+        expect(call.uncertainties).toHaveLength(1);
+        expect(call.uncertainties[0].description).toContain("Stuck on submit_mining_solution");
+        expect(call.uncertainties[0].description).toContain("fail-2");
+        expect(call.uncertainties[0].valueOfResolution).toBe(0.7);
+    });
+    it("resets the counter when errors are spread beyond the window", async () => {
+        vi.useRealTimers();
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime, { errorDebounceWindowMs: 50 });
+        await hooks.emit("action_error", {
+            actionType: "deliver_work",
+            args: {},
+            error: new Error("a"),
+            durationMs: 0,
+        });
+        await new Promise((r) => setTimeout(r, 80)); // exceeds 50ms window
+        await hooks.emit("action_error", {
+            actionType: "deliver_work",
+            args: {},
+            error: new Error("b"),
+            durationMs: 0,
+        });
+        await flush();
+        // First error opens window, second resets — only 2 emissions, no 3rd inside window.
+        expect(manifests.updateManifest).not.toHaveBeenCalled();
+    });
+    it("does not conflate counters across different actionTypes", async () => {
+        vi.useRealTimers();
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("action_error", { actionType: "A", args: {}, error: new Error("x"), durationMs: 0 });
+        await hooks.emit("action_error", { actionType: "B", args: {}, error: new Error("x"), durationMs: 0 });
+        await hooks.emit("action_error", { actionType: "A", args: {}, error: new Error("x"), durationMs: 0 });
+        await flush();
+        // 2 A errors + 1 B error → no threshold trip.
+        expect(manifests.updateManifest).not.toHaveBeenCalled();
+    });
+});
+describe("manifestActivationHook — doom_loop_detected", () => {
+    it("appends an uncertainty unconditionally", async () => {
+        const { runtime, hooks, manifests } = makeRuntime();
+        installManifestActivationHook(runtime);
+        await hooks.emit("doom_loop_detected", {
+            offender: "submit_mining_solution",
+            triggers: 1,
+            actionType: "submit_mining_solution",
+        });
+        await flush();
+        expect(manifests.updateManifest).toHaveBeenCalledTimes(1);
+        const call = manifests.updateManifest.mock.calls[0][0];
+        expect(call.uncertainties[0].description).toBe("Doom loop on submit_mining_solution");
+        expect(call.uncertainties[0].valueOfResolution).toBe(0.9);
+    });
+});
+describe("manifestActivationHook — uncertainty cap", () => {
+    it("drops the oldest entry FIFO when at the 20-cap", async () => {
+        const existing = Array.from({ length: 20 }, (_, i) => ({
+            description: `old-${i}`,
+            valueOfResolution: 0.5,
+        }));
+        const { runtime, hooks, manifests } = makeRuntime(existing);
+        installManifestActivationHook(runtime);
+        await hooks.emit("doom_loop_detected", {
+            offender: "X",
+            triggers: 1,
+            actionType: "X",
+        });
+        await flush();
+        const call = manifests.updateManifest.mock.calls[0][0];
+        expect(call.uncertainties).toHaveLength(20);
+        // Oldest dropped, newest appended.
+        expect(call.uncertainties[0].description).toBe("old-1");
+        expect(call.uncertainties[19].description).toBe("Doom loop on X");
+    });
+    it("respects a custom cap", async () => {
+        const existing = Array.from({ length: 5 }, (_, i) => ({
+            description: `old-${i}`,
+            valueOfResolution: 0.5,
+        }));
+        const { runtime, hooks, manifests } = makeRuntime(existing);
+        installManifestActivationHook(runtime, { maxUncertainties: 5 });
+        await hooks.emit("doom_loop_detected", {
+            offender: "Y",
+            triggers: 1,
+            actionType: "Y",
+        });
+        await flush();
+        const call = manifests.updateManifest.mock.calls[0][0];
+        expect(call.uncertainties).toHaveLength(5);
+        expect(call.uncertainties[4].description).toBe("Doom loop on Y");
+    });
+});
+describe("manifestActivationHook — extractDomain", () => {
+    it("prefers domainTags[0] when present", () => {
+        expect(extractDomain({ signalType: "x", domainTags: ["alpha", "beta"] }))
+            .toBe("alpha");
+    });
+    it("falls back to domain field", () => {
+        expect(extractDomain({ signalType: "x", domain: "bio" }))
+            .toBe("bio");
+    });
+    it("falls back to skillDomain", () => {
+        expect(extractDomain({ signalType: "x", skillDomain: "code-review" }))
+            .toBe("code-review");
+    });
+    it("falls back to metadata.domain", () => {
+        expect(extractDomain({ signalType: "x", metadata: { domain: "math" } })).toBe("math");
+    });
+    it("falls back to community when present", () => {
+        expect(extractDomain({ signalType: "x", community: "defi" })).toBe("defi");
+    });
+    it("returns 'general' as last resort", () => {
+        expect(extractDomain({ signalType: "x" })).toBe("general");
+    });
+    it("ignores empty domainTags array", () => {
+        expect(extractDomain({ signalType: "x", domainTags: [] }))
+            .toBe("general");
+    });
+});
+describe("manifestActivationHook — allowlists", () => {
+    it("TASK_BEARING_SIGNALS is non-empty and excludes social signals", () => {
+        expect(TASK_BEARING_SIGNALS.size).toBeGreaterThan(10);
+        expect(TASK_BEARING_SIGNALS.has("channel_message")).toBe(false);
+        expect(TASK_BEARING_SIGNALS.has("dm_received")).toBe(false);
+        expect(TASK_BEARING_SIGNALS.has("new_follower")).toBe(false);
+        expect(TASK_BEARING_SIGNALS.has("attestation_received")).toBe(false);
+        expect(TASK_BEARING_SIGNALS.has("welcome_guide")).toBe(false);
+    });
+    it("TERMINAL_ACTIONS includes the canonical work-completion actions", () => {
+        expect(TERMINAL_ACTIONS.has("submit_mining_solution")).toBe(true);
+        expect(TERMINAL_ACTIONS.has("deliver_work")).toBe(true);
+        expect(TERMINAL_ACTIONS.has("mark_task_done")).toBe(true);
+        expect(TERMINAL_ACTIONS.has("resolve_clarification")).toBe(true);
+    });
+    it("TERMINAL_ACTIONS excludes read-only / browse actions", () => {
+        expect(TERMINAL_ACTIONS.has("browse_tools")).toBe(false);
+        expect(TERMINAL_ACTIONS.has("get_my_balance")).toBe(false);
+        expect(TERMINAL_ACTIONS.has("nookplot_get_manifest")).toBe(false);
+    });
+});
+//# sourceMappingURL=manifestActivationHook.test.js.map

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

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