@nookplot/runtime 0.5.131 → 0.5.132

package/dist/__tests__/memory.test.js

@@ -0,0 +1,192 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { MemoryBridge } from "../memory.js";
+// ---------------------------------------------------------------------------
+//  Mock ConnectionManager
+// ---------------------------------------------------------------------------
+function createMockConnection() {
+    return {
+        request: vi.fn(),
+        privateKey: null,
+    };
+}
+describe("MemoryBridge — Agent Memory methods", () => {
+    let conn;
+    let bridge;
+    beforeEach(() => {
+        conn = createMockConnection();
+        bridge = new MemoryBridge(conn);
+    });
+    // -----------------------------------------------------------------------
+    //  storeMemory
+    // -----------------------------------------------------------------------
+    describe("storeMemory", () => {
+        it("POSTs to /v1/agent-memory/store with type and content", async () => {
+            conn.request.mockResolvedValue({ id: "mem_1", type: "episodic" });
+            const result = await bridge.storeMemory("episodic", "I saw a cat");
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/store", {
+                type: "episodic",
+                content: "I saw a cat",
+            });
+            expect(result.id).toBe("mem_1");
+        });
+        it("passes optional fields when provided", async () => {
+            conn.request.mockResolvedValue({ id: "mem_2" });
+            await bridge.storeMemory("semantic", "Cats are feline", {
+                importance: 0.8,
+                decayRate: 0.05,
+                tags: ["animals", "facts"],
+                source: "experience",
+                parentMemoryId: "mem_0",
+                metadata: { context: "learning" },
+            });
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/store", {
+                type: "semantic",
+                content: "Cats are feline",
+                importance: 0.8,
+                decayRate: 0.05,
+                tags: ["animals", "facts"],
+                source: "experience",
+                parentMemoryId: "mem_0",
+                metadata: { context: "learning" },
+            });
+        });
+    });
+    // -----------------------------------------------------------------------
+    //  recall
+    // -----------------------------------------------------------------------
+    describe("recall", () => {
+        it("POSTs to /v1/agent-memory/recall with query", async () => {
+            const memories = [{ id: "m1", content: "cat fact" }];
+            conn.request.mockResolvedValue({ memories, count: 1 });
+            const result = await bridge.recall("what do I know about cats?");
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/recall", {
+                query: "what do I know about cats?",
+            });
+            expect(result.memories).toEqual(memories);
+            expect(result.count).toBe(1);
+        });
+        it("passes optional filters", async () => {
+            conn.request.mockResolvedValue({ memories: [], count: 0 });
+            await bridge.recall("test", {
+                types: ["semantic", "procedural"],
+                limit: 5,
+                minImportance: 0.3,
+            });
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/recall", {
+                query: "test",
+                types: ["semantic", "procedural"],
+                limit: 5,
+                minImportance: 0.3,
+            });
+        });
+    });
+    // -----------------------------------------------------------------------
+    //  listMemories
+    // -----------------------------------------------------------------------
+    describe("listMemories", () => {
+        it("GETs /v1/agent-memory/list with no params by default", async () => {
+            conn.request.mockResolvedValue({ memories: [], count: 0 });
+            await bridge.listMemories();
+            expect(conn.request).toHaveBeenCalledWith("GET", "/v1/agent-memory/list");
+        });
+        it("includes type, limit, and offset in query string", async () => {
+            conn.request.mockResolvedValue({ memories: [], count: 0 });
+            await bridge.listMemories("episodic", 10, 5);
+            const [method, path] = conn.request.mock.calls[0];
+            expect(method).toBe("GET");
+            expect(path).toContain("type=episodic");
+            expect(path).toContain("limit=10");
+            expect(path).toContain("offset=5");
+        });
+    });
+    // -----------------------------------------------------------------------
+    //  getMemoryStats
+    // -----------------------------------------------------------------------
+    describe("getMemoryStats", () => {
+        it("GETs /v1/agent-memory/stats", async () => {
+            const stats = { totalMemories: 42 };
+            conn.request.mockResolvedValue(stats);
+            const result = await bridge.getMemoryStats();
+            expect(conn.request).toHaveBeenCalledWith("GET", "/v1/agent-memory/stats");
+            expect(result).toEqual(stats);
+        });
+    });
+    // -----------------------------------------------------------------------
+    //  exportMemories
+    // -----------------------------------------------------------------------
+    describe("exportMemories", () => {
+        it("POSTs to /v1/agent-memory/export", async () => {
+            const pack = { memories: [{ id: "m1" }], packHash: "abc" };
+            conn.request.mockResolvedValue(pack);
+            const result = await bridge.exportMemories();
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/export");
+            expect(result).toEqual(pack);
+        });
+    });
+    // -----------------------------------------------------------------------
+    //  importMemories
+    // -----------------------------------------------------------------------
+    describe("importMemories", () => {
+        it("POSTs pack to /v1/agent-memory/import", async () => {
+            const pack = { memories: [{ id: "m1" }], packHash: "abc" };
+            conn.request.mockResolvedValue({ imported: 1 });
+            const result = await bridge.importMemories(pack);
+            expect(conn.request).toHaveBeenCalledWith("POST", "/v1/agent-memory/import", pack);
+            expect(result).toEqual({ imported: 1 });
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+//  Existing MemoryBridge methods (smoke tests)
+// ---------------------------------------------------------------------------
+describe("MemoryBridge — existing methods", () => {
+    let conn;
+    let bridge;
+    beforeEach(() => {
+        conn = createMockConnection();
+        bridge = new MemoryBridge(conn);
+    });
+    it("queryKnowledge sends POST to /v1/memory/query", async () => {
+        conn.request.mockResolvedValue({ items: [] });
+        await bridge.queryKnowledge({ community: "test" });
+        expect(conn.request).toHaveBeenCalledWith("POST", "/v1/memory/query", { community: "test" });
+    });
+    it("syncFromNetwork sends GET with params", async () => {
+        conn.request.mockResolvedValue({ items: [], cursor: "t1", hasMore: false });
+        await bridge.syncFromNetwork("t0", { community: "ai", limit: 10 });
+        const [method, path] = conn.request.mock.calls[0];
+        expect(method).toBe("GET");
+        expect(path).toContain("since=t0");
+        expect(path).toContain("community=ai");
+        expect(path).toContain("limit=10");
+    });
+    it("getExpertise sends GET with topic", async () => {
+        conn.request.mockResolvedValue({ experts: [], topic: "ml" });
+        await bridge.getExpertise("ml", 5);
+        const [method, path] = conn.request.mock.calls[0];
+        expect(method).toBe("GET");
+        expect(path).toContain("/v1/memory/expertise/ml");
+        expect(path).toContain("limit=5");
+    });
+    it("getReputation sends GET for self", async () => {
+        conn.request.mockResolvedValue({ score: 0.5 });
+        await bridge.getReputation();
+        expect(conn.request).toHaveBeenCalledWith("GET", "/v1/memory/reputation");
+    });
+    it("getReputation sends GET for specific address", async () => {
+        conn.request.mockResolvedValue({ score: 0.7 });
+        await bridge.getReputation("0xabc");
+        expect(conn.request).toHaveBeenCalledWith("GET", "/v1/memory/reputation/0xabc");
+    });
+    it("listCommunities sends GET", async () => {
+        conn.request.mockResolvedValue({ communities: [], default: "general" });
+        await bridge.listCommunities(10);
+        expect(conn.request).toHaveBeenCalledWith("GET", "/v1/memory/communities?limit=10");
+    });
+    it("semanticQuery sends POST to /v1/knowledge/query", async () => {
+        conn.request.mockResolvedValue({ results: [], totalResults: 0 });
+        await bridge.semanticQuery({ query: "test", limit: 5 });
+        expect(conn.request).toHaveBeenCalledWith("POST", "/v1/knowledge/query", { query: "test", limit: 5 });
+    });
+});
+//# sourceMappingURL=memory.test.js.map

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

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

package/dist/__tests__/onChainActions.parity.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ON_CHAIN_ACTIONS parity — guards the TS / Python set drift.
+ *
+ * `ON_CHAIN_ACTIONS` (TS) and `_ON_CHAIN_ACTIONS_GLOBAL` (Python) gate the
+ * approval handler. If they drift, an action that requires approval in one
+ * runtime can slip past the gate in the other.
+ *
+ * The Python set is module-private (leading underscore), so it is not
+ * importable as a public API. Both sets are parsed from source.
+ */
+export {};
+//# sourceMappingURL=onChainActions.parity.test.d.ts.map

package/dist/__tests__/onChainActions.parity.test.d.ts.map

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

package/dist/__tests__/onChainActions.parity.test.js

@@ -0,0 +1,104 @@
+/**
+ * ON_CHAIN_ACTIONS parity — guards the TS / Python set drift.
+ *
+ * `ON_CHAIN_ACTIONS` (TS) and `_ON_CHAIN_ACTIONS_GLOBAL` (Python) gate the
+ * approval handler. If they drift, an action that requires approval in one
+ * runtime can slip past the gate in the other.
+ *
+ * The Python set is module-private (leading underscore), so it is not
+ * importable as a public API. Both sets are parsed from source.
+ */
+import { describe, it, expect } from "vitest";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = join(__dirname, "..", "..", "..");
+const TS_PATH = join(REPO_ROOT, "runtime", "src", "autonomous.ts");
+const PY_PATH = join(REPO_ROOT, "runtime-py", "nookplot_runtime", "autonomous.py");
+/**
+ * Extract every double-quoted string literal between the opening `[` (TS) or
+ * `{` (Python) of the named declaration and its matching closer. Comments
+ * starting with `//` (TS) or `#` (Python) are stripped first so a commented
+ * `// "foo"` doesn't leak into the set.
+ */
+function extractActions(source, startMarker, openChar) {
+    const startIdx = source.indexOf(startMarker);
+    if (startIdx === -1) {
+        throw new Error(`Could not find marker "${startMarker}" in source`);
+    }
+    const openIdx = source.indexOf(openChar, startIdx);
+    if (openIdx === -1) {
+        throw new Error(`Could not find opener "${openChar}" after marker "${startMarker}"`);
+    }
+    const closeChar = openChar === "[" ? "]" : "}";
+    let depth = 0;
+    let endIdx = -1;
+    for (let i = openIdx; i < source.length; i++) {
+        const c = source[i];
+        if (c === openChar)
+            depth++;
+        else if (c === closeChar) {
+            depth--;
+            if (depth === 0) {
+                endIdx = i;
+                break;
+            }
+        }
+    }
+    if (endIdx === -1) {
+        throw new Error(`Unbalanced "${openChar}…${closeChar}" after marker "${startMarker}"`);
+    }
+    const body = source.slice(openIdx + 1, endIdx);
+    // Strip line comments so `// "ghost_action"` or `# "ghost_action"` is ignored.
+    const cleaned = body
+        .split("\n")
+        .map((line) => {
+        const tsCommentIdx = line.indexOf("//");
+        const pyCommentIdx = line.indexOf("#");
+        if (tsCommentIdx !== -1 && (pyCommentIdx === -1 || tsCommentIdx < pyCommentIdx)) {
+            return line.slice(0, tsCommentIdx);
+        }
+        if (pyCommentIdx !== -1) {
+            return line.slice(0, pyCommentIdx);
+        }
+        return line;
+    })
+        .join("\n");
+    const actions = new Set();
+    const re = /"([^"\\]*(?:\\.[^"\\]*)*)"/g;
+    let match;
+    while ((match = re.exec(cleaned)) !== null) {
+        actions.add(match[1]);
+    }
+    return actions;
+}
+describe("ON_CHAIN_ACTIONS parity — TS ↔ Python", () => {
+    const tsSource = readFileSync(TS_PATH, "utf-8");
+    const pySource = readFileSync(PY_PATH, "utf-8");
+    const tsActions = extractActions(tsSource, "const ON_CHAIN_ACTIONS = new Set(", "[");
+    const pyActions = extractActions(pySource, "_ON_CHAIN_ACTIONS_GLOBAL: set[str] =", "{");
+    it("TS set was extracted (sanity)", () => {
+        expect(tsActions.size).toBeGreaterThan(50);
+    });
+    it("Python set was extracted (sanity)", () => {
+        expect(pyActions.size).toBeGreaterThan(50);
+    });
+    it("TS and Python sets have the same cardinality", () => {
+        expect(tsActions.size).toBe(pyActions.size);
+    });
+    it("every TS action appears in the Python set", () => {
+        const missing = [...tsActions].filter((a) => !pyActions.has(a)).sort();
+        expect(missing).toEqual([]);
+    });
+    it("every Python action appears in the TS set", () => {
+        const missing = [...pyActions].filter((a) => !tsActions.has(a)).sort();
+        expect(missing).toEqual([]);
+    });
+    it("the two sets are exactly equal", () => {
+        const tsSorted = [...tsActions].sort();
+        const pySorted = [...pyActions].sort();
+        expect(tsSorted).toEqual(pySorted);
+    });
+});
+//# sourceMappingURL=onChainActions.parity.test.js.map

package/dist/__tests__/onChainActions.parity.test.js.map

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

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

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

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

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

package/dist/__tests__/querySegmentation.test.js

@@ -0,0 +1,187 @@
+/**
+ * Tests for query segmentation — multi-granularity query expansion for
+ * WakeUpStack L2 retrieval (Change 2 of latent-briefing spec).
+ *
+ * segmentQuery is a pure string function — no I/O, no mocks needed. Each test
+ * asserts a specific invariant of the segmentation contract that the gateway's
+ * multi-query search path depends on.
+ */
+import { describe, it, expect } from "vitest";
+import { segmentQuery, queriesFromSegmented, segmentTaskForQuery, } from "../querySegmentation.js";
+describe("segmentQuery", () => {
+    it("preserves the full trimmed task as .full", () => {
+        const s = segmentQuery("  review the audit findings  ");
+        expect(s.full).toBe("review the audit findings");
+    });
+    it("emits no sliding-window segments for short tasks (< 10 words)", () => {
+        const s = segmentQuery("review this code for security issues please");
+        expect(s.segments).toEqual([]);
+    });
+    it("emits sliding-window segments for long tasks (≥ 10 words)", () => {
+        // 15 words — produces at least one window of 15 words
+        const task = "one two three four five six seven eight nine ten eleven twelve thirteen fourteen fifteen";
+        const s = segmentQuery(task);
+        expect(s.segments.length).toBeGreaterThanOrEqual(1);
+        // First segment should contain the first 15 words
+        expect(s.segments[0]).toBe(task);
+    });
+    it("caps sliding-window segments at maxSegments", () => {
+        // 40 words with stride 8 + window 15 → up to 4 windows, capped at 3 by default
+        const words = Array.from({ length: 40 }, (_, i) => `word${i}`).join(" ");
+        const s = segmentQuery(words);
+        expect(s.segments.length).toBeLessThanOrEqual(3);
+    });
+    it("caps at custom maxSegments", () => {
+        const words = Array.from({ length: 40 }, (_, i) => `word${i}`).join(" ");
+        const s = segmentQuery(words, 2);
+        expect(s.segments.length).toBeLessThanOrEqual(2);
+    });
+    it("extracts hashtags as entities", () => {
+        const s = segmentQuery("discussing #latentspace and #mining topics");
+        expect(s.entities).toContain("#latentspace");
+        expect(s.entities).toContain("#mining");
+    });
+    it("extracts @mentions as entities", () => {
+        const s = segmentQuery("responding to @basedmd about the spec");
+        expect(s.entities).toContain("@basedmd");
+    });
+    it("extracts capitalized multi-word phrases as entities", () => {
+        const s = segmentQuery("Latent Briefing cites MemPalace in the comparison");
+        expect(s.entities).toContain("Latent Briefing");
+        expect(s.entities).not.toContain("MemPalace"); // single word — not captured
+    });
+    it("caps entities at 2", () => {
+        const s = segmentQuery("#a #b #c #d Latent Space Embedding Exchange");
+        expect(s.entities.length).toBeLessThanOrEqual(2);
+    });
+    it("extracts 'what is X' question spans", () => {
+        const s = segmentQuery("what is a knowledge bundle in Nookplot");
+        expect(s.questions.length).toBeGreaterThanOrEqual(1);
+        // The extracted phrase drops the "what is" prefix
+        expect(s.questions[0]).toContain("knowledge bundle");
+    });
+    it("extracts 'how to X' question spans", () => {
+        const s = segmentQuery("how to claim a mining reward safely");
+        expect(s.questions.length).toBeGreaterThanOrEqual(1);
+    });
+    it("emits no questions for non-question queries", () => {
+        const s = segmentQuery("refactor the authentication middleware");
+        expect(s.questions).toEqual([]);
+    });
+    it("handles empty input without throwing", () => {
+        const s = segmentQuery("");
+        expect(s.full).toBe("");
+        expect(s.segments).toEqual([]);
+        expect(s.entities).toEqual([]);
+        expect(s.questions).toEqual([]);
+    });
+    it("handles whitespace-only input without throwing", () => {
+        const s = segmentQuery("   \n\t  ");
+        expect(s.full).toBe("");
+        expect(s.segments).toEqual([]);
+    });
+});
+describe("queriesFromSegmented", () => {
+    it("always places full query first (preserves single-query baseline)", () => {
+        const s = segmentQuery("Latent Briefing explains attention");
+        const q = queriesFromSegmented(s);
+        expect(q[0]).toBe("Latent Briefing explains attention");
+    });
+    it("deduplicates repeated strings", () => {
+        const s = {
+            full: "same query",
+            segments: ["same query"],
+            entities: ["same query"],
+            questions: [],
+        };
+        const q = queriesFromSegmented(s);
+        expect(q.length).toBe(1);
+        expect(q[0]).toBe("same query");
+    });
+    it("drops strings shorter than 2 chars", () => {
+        const s = {
+            full: "real query",
+            segments: [],
+            entities: ["a", "x"],
+            questions: [],
+        };
+        const q = queriesFromSegmented(s);
+        expect(q).toEqual(["real query"]);
+    });
+    it("enforces hard cap at max (default 4)", () => {
+        const s = {
+            full: "full",
+            segments: ["seg1", "seg2", "seg3"],
+            entities: ["#one", "#two"],
+            questions: ["q1"],
+        };
+        const q = queriesFromSegmented(s);
+        expect(q.length).toBeLessThanOrEqual(4);
+        expect(q[0]).toBe("full");
+    });
+    it("respects custom max", () => {
+        const s = {
+            full: "full",
+            segments: ["seg1", "seg2"],
+            entities: ["#one"],
+            questions: ["q1"],
+        };
+        const q = queriesFromSegmented(s, 2);
+        expect(q.length).toBe(2);
+    });
+    it("returns only full when everything else is empty", () => {
+        const s = { full: "just the task", segments: [], entities: [], questions: [] };
+        expect(queriesFromSegmented(s)).toEqual(["just the task"]);
+    });
+    it("preserves order: full, segments, entities, questions", () => {
+        const s = {
+            full: "full task",
+            segments: ["seg-one", "seg-two"],
+            entities: ["#ent"],
+            questions: ["q1"],
+        };
+        const q = queriesFromSegmented(s);
+        // Default max=4 → questions["q1"] gets truncated
+        expect(q).toEqual(["full task", "seg-one", "seg-two", "#ent"]);
+    });
+    it("includes question when under cap", () => {
+        const s = {
+            full: "full task",
+            segments: [],
+            entities: [],
+            questions: ["question phrase"],
+        };
+        const q = queriesFromSegmented(s);
+        expect(q).toEqual(["full task", "question phrase"]);
+    });
+});
+describe("segmentTaskForQuery", () => {
+    it("collapses to a single-element array for short/simple tasks", () => {
+        const q = segmentTaskForQuery("review the PR");
+        expect(q).toEqual(["review the PR"]);
+    });
+    it("expands multi-segment for long queries with entities", () => {
+        const task = "review the Latent Briefing spec changes against our current MemPalace implementation carefully";
+        const q = segmentTaskForQuery(task);
+        // Must have at least the full query; likely picks up "Latent Briefing" as entity
+        expect(q[0]).toBe(task);
+        expect(q.length).toBeGreaterThanOrEqual(1);
+        expect(q.length).toBeLessThanOrEqual(4);
+    });
+    it("enforces 4-query hard cap matching gateway", () => {
+        const words = Array.from({ length: 60 }, (_, i) => `word${i}`).join(" ");
+        const task = `${words} #tag1 #tag2 what is a Knowledge Bundle thing`;
+        const q = segmentTaskForQuery(task);
+        expect(q.length).toBeLessThanOrEqual(4);
+    });
+    it("returns [] for an empty string (guarded by length >= 2 filter)", () => {
+        // full is "" → length 0 → dropped by the >= 2 filter → empty result
+        const q = segmentTaskForQuery("");
+        expect(q).toEqual([]);
+    });
+    it("returns [] for whitespace-only input", () => {
+        const q = segmentTaskForQuery("   ");
+        expect(q).toEqual([]);
+    });
+});
+//# sourceMappingURL=querySegmentation.test.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Sandbox — unit tests.
+ *
+ * Covers:
+ *   - LocalSandbox: exec, python, sh, put/get round-trip, close idempotency.
+ *   - Sandbox.asTools: tool definitions route to python/sh.
+ *   - DockerSandbox.buildRunArgs: --network none, --cpus, --memory defaults +
+ *     port / mount / env serialization. Pure-function tests, no docker required.
+ *   - DockerSandbox.create: mount validation rejects paths outside cwd
+ *     before docker is invoked.
+ */
+export {};
+//# sourceMappingURL=sandbox.test.d.ts.map

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

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