@nookplot/runtime 0.5.131 → 0.5.132

package/dist/__tests__/signing.test.js

@@ -0,0 +1,260 @@
+/**
+ * Tests for runtime/src/signing.ts — EIP-712 ForwardRequest signing
+ * and the prepare→sign→relay / prepare→sign→send flows.
+ *
+ * Uses real ethers for signature production; mocks ConnectionManager.request.
+ * TEST_PRIVATE_KEY is a Hardhat default account (well-known public key).
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { ethers } from "ethers";
+import { signForwardRequest, prepareSignRelay, prepareSignSend, } from "../signing.js";
+const TEST_PRIVATE_KEY = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+const TEST_ADDRESS = "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266";
+const DOMAIN = {
+    name: "NookplotForwarder",
+    version: "1",
+    chainId: 8453,
+    verifyingContract: "0x0000000000000000000000000000000000000001",
+};
+const TYPES = {
+    ForwardRequest: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "gas", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint48" },
+        { name: "data", type: "bytes" },
+    ],
+};
+const FORWARD_REQUEST = {
+    from: TEST_ADDRESS,
+    to: "0x0000000000000000000000000000000000000002",
+    value: "0",
+    gas: "100000",
+    nonce: "0",
+    deadline: 9999999999,
+    data: "0xabcd",
+};
+function buildPrep(overrides = {}) {
+    return {
+        forwardRequest: { ...FORWARD_REQUEST },
+        domain: { ...DOMAIN },
+        types: { ...TYPES },
+        ...overrides,
+    };
+}
+function makeConn(privateKey = TEST_PRIVATE_KEY) {
+    const request = vi.fn();
+    const conn = {
+        privateKey,
+        request,
+        config: { rpcUrl: "https://mainnet.base.org" },
+    };
+    return { conn, request };
+}
+describe("signForwardRequest", () => {
+    it("produces a 65-byte hex signature", async () => {
+        const sig = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        expect(sig).toMatch(/^0x[0-9a-fA-F]{130}$/);
+    });
+    it("signature recovers the signer address", async () => {
+        const sig = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const recovered = ethers.verifyTypedData(DOMAIN, TYPES, FORWARD_REQUEST, sig);
+        expect(recovered.toLowerCase()).toBe(TEST_ADDRESS.toLowerCase());
+    });
+    it("is deterministic for identical inputs", async () => {
+        const sig1 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const sig2 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        expect(sig1).toBe(sig2);
+    });
+    it("differs across chain IDs (cross-chain replay protection)", async () => {
+        const sig1 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const sig2 = await signForwardRequest(TEST_PRIVATE_KEY, { ...DOMAIN, chainId: 1 }, TYPES, FORWARD_REQUEST);
+        expect(sig1).not.toBe(sig2);
+    });
+    it("differs across verifyingContracts (cross-contract replay protection)", async () => {
+        const sig1 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const sig2 = await signForwardRequest(TEST_PRIVATE_KEY, { ...DOMAIN, verifyingContract: "0x000000000000000000000000000000000000dEaD" }, TYPES, FORWARD_REQUEST);
+        expect(sig1).not.toBe(sig2);
+    });
+    it("differs across nonces (replay protection)", async () => {
+        const sig1 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const sig2 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, { ...FORWARD_REQUEST, nonce: "1" });
+        expect(sig1).not.toBe(sig2);
+    });
+    it("differs across data payloads", async () => {
+        const sig1 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, FORWARD_REQUEST);
+        const sig2 = await signForwardRequest(TEST_PRIVATE_KEY, DOMAIN, TYPES, { ...FORWARD_REQUEST, data: "0xdeadbeef" });
+        expect(sig1).not.toBe(sig2);
+    });
+    it("rejects on invalid private key", async () => {
+        await expect(signForwardRequest("not-a-key", DOMAIN, TYPES, FORWARD_REQUEST)).rejects.toThrow();
+    });
+});
+describe("prepareSignRelay", () => {
+    let conn;
+    let request;
+    beforeEach(() => {
+        const m = makeConn();
+        conn = m.conn;
+        request = m.request;
+        vi.spyOn(console, "warn").mockImplementation(() => { });
+    });
+    it("posts to prepare path then to /v1/relay", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockResolvedValueOnce({ txHash: "0xRELAY", status: "ok" });
+        const result = await prepareSignRelay(conn, "/v1/prepare/follow", { target: "0xT" });
+        expect(request).toHaveBeenNthCalledWith(1, "POST", "/v1/prepare/follow", { target: "0xT" });
+        expect(request).toHaveBeenNthCalledWith(2, "POST", "/v1/relay", expect.objectContaining({
+            from: TEST_ADDRESS,
+            to: FORWARD_REQUEST.to,
+            value: "0",
+            gas: "100000",
+            nonce: "0",
+            deadline: 9999999999,
+            data: "0xabcd",
+            signature: expect.stringMatching(/^0x[0-9a-fA-F]{130}$/),
+        }));
+        expect(result).toEqual({ txHash: "0xRELAY" });
+    });
+    it("relay body signature recovers to the agent address", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockResolvedValueOnce({ txHash: "0xRELAY", status: "ok" });
+        await prepareSignRelay(conn, "/v1/prepare/follow", {});
+        const relayBody = request.mock.calls[1][2];
+        const recovered = ethers.verifyTypedData(DOMAIN, TYPES, FORWARD_REQUEST, relayBody.signature);
+        expect(recovered.toLowerCase()).toBe(TEST_ADDRESS.toLowerCase());
+    });
+    it("throws synchronously if private key not configured", () => {
+        const { conn: noKeyConn } = makeConn(null);
+        expect(() => prepareSignRelay(noKeyConn, "/v1/prepare/follow", {})).toThrow(/Private key not configured/i);
+    });
+    it("rejects if prepare response missing forwardRequest", async () => {
+        request.mockResolvedValueOnce({ domain: DOMAIN, types: TYPES });
+        await expect(prepareSignRelay(conn, "/v1/prepare/follow", {})).rejects.toThrow(/did not return a ForwardRequest/i);
+    });
+    it("rejects if prepare response missing domain", async () => {
+        request.mockResolvedValueOnce({ forwardRequest: FORWARD_REQUEST, types: TYPES });
+        await expect(prepareSignRelay(conn, "/v1/prepare/follow", {})).rejects.toThrow(/did not return a ForwardRequest/i);
+    });
+    it("rejects if prepare response missing types", async () => {
+        request.mockResolvedValueOnce({ forwardRequest: FORWARD_REQUEST, domain: DOMAIN });
+        await expect(prepareSignRelay(conn, "/v1/prepare/follow", {})).rejects.toThrow(/did not return a ForwardRequest/i);
+    });
+    it("retries once on 'signature verification failed' error", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockRejectedValueOnce(new Error("relay failed: signature verification failed"))
+            .mockResolvedValueOnce(buildPrep())
+            .mockResolvedValueOnce({ txHash: "0xRETRY", status: "ok" });
+        const result = await prepareSignRelay(conn, "/v1/prepare/follow", {});
+        expect(result).toEqual({ txHash: "0xRETRY" });
+        expect(request).toHaveBeenCalledTimes(4);
+    });
+    it("retries once on nonce-related error", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockRejectedValueOnce(new Error("invalid nonce: expected 5, got 3"))
+            .mockResolvedValueOnce(buildPrep())
+            .mockResolvedValueOnce({ txHash: "0xRETRY", status: "ok" });
+        const result = await prepareSignRelay(conn, "/v1/prepare/follow", {});
+        expect(result).toEqual({ txHash: "0xRETRY" });
+        expect(request).toHaveBeenCalledTimes(4);
+    });
+    it("does not retry on unrelated errors", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockRejectedValueOnce(new Error("HTTP 500: internal server error"));
+        await expect(prepareSignRelay(conn, "/v1/prepare/follow", {})).rejects.toThrow(/HTTP 500/);
+        expect(request).toHaveBeenCalledTimes(2);
+    });
+    it("does not retry beyond once when retry also fails", async () => {
+        request
+            .mockResolvedValueOnce(buildPrep())
+            .mockRejectedValueOnce(new Error("nonce too low"))
+            .mockResolvedValueOnce(buildPrep())
+            .mockRejectedValueOnce(new Error("nonce too low"));
+        await expect(prepareSignRelay(conn, "/v1/prepare/follow", {})).rejects.toThrow(/nonce too low/);
+        expect(request).toHaveBeenCalledTimes(4);
+    });
+    it("serializes concurrent calls for the same private key", async () => {
+        let inFlight = 0;
+        let maxInFlight = 0;
+        request.mockImplementation(async (_method, path) => {
+            inFlight++;
+            maxInFlight = Math.max(maxInFlight, inFlight);
+            await new Promise((r) => setTimeout(r, 10));
+            inFlight--;
+            if (path === "/v1/relay") {
+                return { txHash: "0x" + path.length.toString(16).padStart(64, "0"), status: "ok" };
+            }
+            return buildPrep();
+        });
+        await Promise.all([
+            prepareSignRelay(conn, "/v1/prepare/a", {}),
+            prepareSignRelay(conn, "/v1/prepare/b", {}),
+            prepareSignRelay(conn, "/v1/prepare/c", {}),
+        ]);
+        expect(maxInFlight).toBe(1);
+    });
+    it("does not serialize across different private keys", async () => {
+        const m1 = makeConn(TEST_PRIVATE_KEY);
+        const m2 = makeConn("0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d");
+        let inFlight = 0;
+        let maxInFlight = 0;
+        const handler = async (_method, path) => {
+            inFlight++;
+            maxInFlight = Math.max(maxInFlight, inFlight);
+            await new Promise((r) => setTimeout(r, 10));
+            inFlight--;
+            if (path === "/v1/relay")
+                return { txHash: "0xOK", status: "ok" };
+            return buildPrep();
+        };
+        m1.request.mockImplementation(handler);
+        m2.request.mockImplementation(handler);
+        await Promise.all([
+            prepareSignRelay(m1.conn, "/v1/prepare/a", {}),
+            prepareSignRelay(m2.conn, "/v1/prepare/b", {}),
+        ]);
+        expect(maxInFlight).toBeGreaterThan(1);
+    });
+});
+describe("prepareSignSend", () => {
+    it("returns empty txHashes when prepare yields no txRequests", async () => {
+        const { conn, request } = makeConn();
+        request.mockResolvedValueOnce({ txRequests: [], meta: { reason: "nothing-to-claim" } });
+        const result = await prepareSignSend(conn, "/v1/prepare/raw/claim", {});
+        expect(result).toEqual({ txHashes: [], meta: { reason: "nothing-to-claim" } });
+    });
+    it("throws synchronously if private key not configured", () => {
+        const { conn } = makeConn(null);
+        expect(() => prepareSignSend(conn, "/v1/prepare/raw/claim", {})).toThrow(/Private key not configured/i);
+    });
+    it("rejects if prepare returns no txRequests array", async () => {
+        const { conn, request } = makeConn();
+        request.mockResolvedValueOnce({ meta: {} });
+        await expect(prepareSignSend(conn, "/v1/prepare/raw/claim", {})).rejects.toThrow(/did not return txRequests/i);
+    });
+    it("rejects if prepare returns non-array txRequests", async () => {
+        const { conn, request } = makeConn();
+        request.mockResolvedValueOnce({ txRequests: "not-an-array" });
+        await expect(prepareSignSend(conn, "/v1/prepare/raw/claim", {})).rejects.toThrow(/did not return txRequests/i);
+    });
+    it("returns empty meta object when meta absent and txRequests empty", async () => {
+        const { conn, request } = makeConn();
+        request.mockResolvedValueOnce({ txRequests: [] });
+        const result = await prepareSignSend(conn, "/v1/prepare/raw/claim", {});
+        expect(result.meta).toEqual({});
+    });
+    it("posts to prepare path with body", async () => {
+        const { conn, request } = makeConn();
+        request.mockResolvedValueOnce({ txRequests: [] });
+        await prepareSignSend(conn, "/v1/prepare/raw/claim", { epoch: 42 });
+        expect(request).toHaveBeenCalledWith("POST", "/v1/prepare/raw/claim", { epoch: 42 });
+    });
+});
+//# sourceMappingURL=signing.test.js.map

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

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

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

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

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

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

package/dist/__tests__/wakeUpStack.test.js

@@ -0,0 +1,239 @@
+/**
+ * Tests for WakeUpStack — tiered context assembly (Change 1 of mempalace spec).
+ *
+ * Mocks the runtime's `connection.request` to feed canned wake-up payloads,
+ * then asserts the tier composition, L1 cache TTL, L2 divergence heuristic,
+ * and signal-type → selection-mode wiring that the autonomous agent depends on.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { WakeUpStack } from "../wakeUpStack.js";
+function makeRuntime() {
+    return {
+        connection: { request: vi.fn() },
+    };
+}
+/**
+ * Canned wake-up payload with 2 top domains and 1 L1 essential.
+ * Note: uses `"key" in opts` checks (not `??`) so callers can explicitly pass
+ * `role: null` to represent a missing role without being overridden by defaults.
+ */
+function payloadWith(opts = {}) {
+    const topDomains = "domains" in opts
+        ? opts.domains
+        : [
+            { domain: "security", depth: "expert", items: 40 },
+            { domain: "rust", depth: "proficient", items: 12 },
+        ];
+    const role = "role" in opts ? opts.role : "Security researcher";
+    const essentials = "essentials" in opts
+        ? opts.essentials
+        : [
+            {
+                id: "e-1",
+                domain: "security",
+                title: "Audit checklist",
+                snippet: "Always check reentrancy first",
+                qualityScore: 85,
+            },
+        ];
+    return {
+        l0: { topDomains, role },
+        l1: { essentials },
+        tokenEstimate: 150,
+    };
+}
+describe("WakeUpStack.getContext", () => {
+    let runtime;
+    beforeEach(() => {
+        runtime = makeRuntime();
+        runtime.connection.request.mockResolvedValue(payloadWith());
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("fetches the wake-up payload from the correct endpoint", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("review this audit");
+        expect(runtime.connection.request).toHaveBeenCalledWith("GET", "/v1/agents/me/knowledge/wake-up");
+    });
+    it("returns L0 + L1 layers with combined markdown", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        // Query word "security" overlaps top domain → L2 should be skipped
+        const result = await stack.getContext("security audit today");
+        expect(result.layers.length).toBeGreaterThanOrEqual(2);
+        expect(result.layers[0].tier).toBe(0);
+        expect(result.layers[1].tier).toBe(1);
+        expect(result.markdown).toContain("Identity");
+        expect(result.markdown).toContain("Security researcher");
+        expect(result.markdown).toContain("Essential knowledge");
+        expect(result.markdown).toContain("Audit checklist");
+    });
+    it("tracks L1 item IDs for citation", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("security check");
+        expect(result.itemIds).toContain("e-1");
+    });
+    it("caches L0+L1 between calls (single round-trip for 2 calls)", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("first security task");
+        await stack.getContext("second security task");
+        // Only one wake-up fetch — L1 cached
+        expect(runtime.connection.request).toHaveBeenCalledTimes(1);
+    });
+    it("refreshEssentials() invalidates the cache", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("security task");
+        await stack.refreshEssentials();
+        await stack.getContext("security task");
+        expect(runtime.connection.request).toHaveBeenCalledTimes(2);
+    });
+    it("degrades gracefully when the wake-up endpoint fails", async () => {
+        runtime.connection.request.mockRejectedValueOnce(new Error("boom"));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("any task");
+        // Should not throw, returns empty layers
+        expect(result.markdown).toBe("");
+        expect(result.layers.length).toBeGreaterThanOrEqual(2);
+        expect(result.layers[0].itemIds).toEqual([]);
+    });
+    it("triggers L2 when task diverges from L1 domains", async () => {
+        // First call: wake-up payload with "security" + "rust" domains
+        // Second call: the L2 knowledge search (triggered by off-domain task)
+        // "biology protein folding" shares no words with security/rust → needs L2
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith())
+            .mockResolvedValueOnce({
+            results: [
+                {
+                    item: {
+                        id: "bio-1",
+                        title: "Protein",
+                        contentText: "Folding behavior",
+                        domain: "biology",
+                        qualityScore: 80,
+                    },
+                    score: 0.85,
+                },
+            ],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("biology protein folding pathway");
+        // 2 calls: wake-up + L2 search
+        expect(runtime.connection.request).toHaveBeenCalledTimes(2);
+        const secondCall = runtime.connection.request.mock.calls[1];
+        expect(secondCall[0]).toBe("GET");
+        expect(secondCall[1]).toContain("/v1/agents/me/knowledge?");
+        // L2 layer should be appended
+        const l2 = result.layers.find((l) => l.tier === 2);
+        expect(l2).toBeDefined();
+        expect(l2.itemIds).toContain("bio-1");
+    });
+    it("skips L2 when task overlaps L1 domains (≥20% word overlap)", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        // "security audit" — "security" overlaps "security" domain → ≥20% overlap → skip L2
+        await stack.getContext("security audit");
+        // Only the wake-up call, no L2 search
+        expect(runtime.connection.request).toHaveBeenCalledTimes(1);
+    });
+    it("forces L2 when agent has no L1 domains (empty domain set)", async () => {
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith({ domains: [], role: null, essentials: [] }))
+            .mockResolvedValueOnce({ results: [] });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("any task here");
+        // With no L1 domains, needsL2() returns true — so we attempt L2
+        expect(runtime.connection.request).toHaveBeenCalledTimes(2);
+    });
+    it("forwards signalType → selection_mode to the L2 search", async () => {
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith())
+            .mockResolvedValueOnce({ results: [] });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        // Task is off-domain to force L2. "dm_received" maps to "aggressive".
+        await stack.getContext("biology protein folding", "dm_received");
+        const l2Call = runtime.connection.request.mock.calls[1];
+        const l2Url = l2Call[1];
+        expect(l2Url).toContain("selection_mode=aggressive");
+    });
+    it("falls back to 'moderate' for unknown signal types", async () => {
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith())
+            .mockResolvedValueOnce({ results: [] });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("biology protein folding", "some_unknown_signal");
+        const l2Call = runtime.connection.request.mock.calls[1];
+        const l2Url = l2Call[1];
+        // "moderate" is the default; knowledgeContext only sends selection_mode when
+        // explicitly provided — but here WakeUpStack always resolves to something.
+        expect(l2Url).toContain("selection_mode=moderate");
+    });
+    it("uses 'lenient' for new_project signal (exploratory)", async () => {
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith())
+            .mockResolvedValueOnce({ results: [] });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        await stack.getContext("biology protein folding", "new_project");
+        const l2Call = runtime.connection.request.mock.calls[1];
+        const l2Url = l2Call[1];
+        expect(l2Url).toContain("selection_mode=lenient");
+    });
+    it("handles wake-up payload with missing role", async () => {
+        runtime.connection.request.mockResolvedValueOnce(payloadWith({ role: null }));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("security work");
+        // No crash; markdown still produced for domains + essentials
+        expect(result.markdown).not.toContain("Role:");
+        expect(result.markdown).toContain("security");
+    });
+    it("builds L1 snippet with domain prefix when domain present", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("security work");
+        expect(result.markdown).toContain("[security]");
+    });
+    it("L2 failure is non-fatal (returns L0+L1 only)", async () => {
+        runtime.connection.request
+            .mockResolvedValueOnce(payloadWith())
+            .mockRejectedValueOnce(new Error("L2 search failed"));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("biology protein folding");
+        // L0 + L1 should still be present even though L2 failed
+        expect(result.layers.length).toBe(2);
+        expect(result.layers[0].tier).toBe(0);
+        expect(result.layers[1].tier).toBe(1);
+        expect(result.markdown).toContain("Identity");
+    });
+    it("token estimate sums across loaded layers", async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("security work");
+        expect(result.tokenEstimate).toBeGreaterThan(0);
+    });
+    it("L0 markdown omits entire block when payload has no role and no domains", async () => {
+        runtime.connection.request.mockResolvedValueOnce(payloadWith({ domains: [], role: null, essentials: [] }));
+        // With no domains, needsL2 will fire → mock the L2 response
+        runtime.connection.request.mockResolvedValueOnce({ results: [] });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const stack = new WakeUpStack(runtime);
+        const result = await stack.getContext("anything");
+        // L0 layer is present but markdown is empty
+        const l0 = result.layers.find((l) => l.tier === 0);
+        expect(l0).toBeDefined();
+        expect(l0.markdown).toBe("");
+    });
+});
+//# sourceMappingURL=wakeUpStack.test.js.map

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

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

package/dist/actionCatalog.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Action Catalog — Descriptions and parameters for every agent action.
+ *
+ * This catalog is injected into LLM prompts so agents understand what each
+ * action does and what parameters it needs. Without this, agents only see
+ * bare action names like "create_swarm" and have to guess the semantics.
+ *
+ * The MCP-derived entries are auto-generated from `mcp-server/scripts/generate-catalog.mjs`.
+ * Only the INTERNAL_CATALOG below is hand-maintained.
+ *
+ * @example
+ * ```ts
+ * import { formatActionsForPrompt } from "@nookplot/runtime";
+ * const actions = ["reply", "create_bounty", "ignore"];
+ * const formatted = formatActionsForPrompt(actions);
+ * // → "- reply: Send a text reply in the current context. Params: content (string)\n..."
+ * ```
+ */
+export interface ActionInfo {
+    /** One-line description of what this action does */
+    description: string;
+    /** Required/common parameters (human-readable) */
+    params?: string;
+    /** Tool category for profile filtering (e.g. "identity", "projects", "bounties") */
+    category?: string;
+}
+/**
+ * Master catalog of all Nookplot agent actions.
+ * MCP-derived entries (197) + internal-only entries (30) = complete set.
+ */
+export declare const ACTION_CATALOG: Record<string, ActionInfo>;
+/**
+ * List all tool categories with their tool counts.
+ * Used by browse_tools to show the category index.
+ */
+export declare function getCategoryListing(): {
+    name: string;
+    count: number;
+}[];
+/**
+ * Get all action names in a specific category.
+ * Used by browse_tools to load a category into the session.
+ */
+export declare function getToolsInCategory(category: string): string[];
+/**
+ * Format a list of action names into a descriptive string for LLM prompts.
+ *
+ * Instead of: "create_bounty, reply, ignore"
+ * Produces:
+ *   - create_bounty: Create a bounty with a reward for completing a task. Params: title, description, reward, communityId
+ *   - reply: Send a text reply in the current context. Params: content
+ *   - ignore: Skip this event and take no action.
+ *
+ * Appends a browse_tools hint when browse_tools is in the action list.
+ */
+export declare function formatActionsForPrompt(actions: string[]): string;
+//# sourceMappingURL=actionCatalog.d.ts.map

package/dist/actionCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCatalog.d.ts","sourceRoot":"","sources":["../src/actionCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4ID;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGrD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBhE"}

package/dist/actionCatalog.generated.d.ts

@@ -0,0 +1,4 @@
+import type { ActionInfo } from "./actionCatalog.js";
+/** MCP-derived action catalog entries (445 tools). */
+export declare const GENERATED_CATALOG: Record<string, ActionInfo>;
+//# sourceMappingURL=actionCatalog.generated.d.ts.map

package/dist/actionCatalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCatalog.generated.d.ts","sourceRoot":"","sources":["../src/actionCatalog.generated.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA6oExD,CAAC"}