@nookplot/runtime 0.5.99 → 0.5.105

package/dist/__tests__/guardrails.test.js

@@ -0,0 +1,236 @@
+/**
+ * GuardrailRegistry — unit tests.
+ *
+ * Covers: pass-through, partial mutation, error wrapping, ordering,
+ * disposer behavior, output-guardrail merge semantics, withGuardrails
+ * standalone wrapper.
+ */
+import { describe, it, expect } from "vitest";
+import { GuardrailRegistry, GuardrailTripped, InputGuardrailTripped, OutputGuardrailTripped, withGuardrails, } from "../guardrails.js";
+describe("GuardrailRegistry — input", () => {
+    it("returns args unchanged when no guardrails registered", async () => {
+        const reg = new GuardrailRegistry();
+        const out = await reg.runInput("send_dm", { to: "0xABC", content: "hi" });
+        expect(out).toEqual({ to: "0xABC", content: "hi" });
+    });
+    it("guardrail returning undefined is a pass-through", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { input: [() => undefined] });
+        const out = await reg.runInput("send_dm", { to: "0x1", content: "hi" });
+        expect(out).toEqual({ to: "0x1", content: "hi" });
+    });
+    it("guardrail returning Partial<TArgs> shallow-merges", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", {
+            input: [({ content }) => ({ content: `[REDACTED:${content.length}]` })],
+        });
+        const out = await reg.runInput("send_dm", { to: "0x1", content: "secret" });
+        expect(out).toEqual({ to: "0x1", content: "[REDACTED:6]" });
+    });
+    it("multiple guardrails compose in declared order", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", {
+            input: [
+                () => ({ content: "first" }),
+                ({ content }) => ({ content: `${content}+second` }),
+            ],
+        });
+        const out = await reg.runInput("send_dm", { to: "0x1", content: "raw" });
+        expect(out.content).toBe("first+second");
+    });
+    it("InputGuardrailTripped is re-thrown as-is", async () => {
+        const reg = new GuardrailRegistry();
+        const err = new InputGuardrailTripped("invalid recipient");
+        reg.register("send_dm", { input: [() => { throw err; }] });
+        await expect(reg.runInput("send_dm", { to: "" })).rejects.toBe(err);
+    });
+    it("non-guardrail errors get wrapped with the original as cause", async () => {
+        const reg = new GuardrailRegistry();
+        const inner = new Error("boom");
+        reg.register("send_dm", { input: [() => { throw inner; }] });
+        await expect(reg.runInput("send_dm", { to: "0x1" }))
+            .rejects.toMatchObject({
+            name: "InputGuardrailTripped",
+            message: expect.stringContaining("boom"),
+            cause: inner,
+        });
+    });
+    it("InputGuardrailTripped is also a GuardrailTripped", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { input: [() => { throw new InputGuardrailTripped("x"); }] });
+        try {
+            await reg.runInput("send_dm", {});
+            throw new Error("expected throw");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(GuardrailTripped);
+            expect(err).toBeInstanceOf(InputGuardrailTripped);
+        }
+    });
+    it("the original args object is not mutated", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { input: [() => ({ content: "modified" })] });
+        const original = { to: "0x1", content: "raw" };
+        await reg.runInput("send_dm", original);
+        expect(original).toEqual({ to: "0x1", content: "raw" });
+    });
+    it("async guardrails are awaited", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", {
+            input: [
+                async ({ content }) => {
+                    await new Promise((r) => setTimeout(r, 10));
+                    return { content: `${content}-awaited` };
+                },
+            ],
+        });
+        const out = await reg.runInput("send_dm", { to: "0x1", content: "x" });
+        expect(out.content).toBe("x-awaited");
+    });
+});
+describe("GuardrailRegistry — output", () => {
+    it("returns result unchanged when no guardrails registered", async () => {
+        const reg = new GuardrailRegistry();
+        const out = await reg.runOutput("send_dm", { messageId: "m1" });
+        expect(out).toEqual({ messageId: "m1" });
+    });
+    it("output guardrail returning Partial merges onto result", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", {
+            output: [() => ({ scrubbed: true })],
+        });
+        const out = await reg.runOutput("send_dm", { messageId: "m1" });
+        expect(out).toEqual({ messageId: "m1", scrubbed: true });
+    });
+    it("output guardrail cannot drop security-critical fields silently", async () => {
+        // Returning a partial CANNOT replace the whole result — txHash survives.
+        const reg = new GuardrailRegistry();
+        reg.register("create_bounty", {
+            output: [() => ({ logged: true })],
+        });
+        const out = await reg.runOutput("create_bounty", {
+            txHash: "0xCRITICAL",
+            bountyId: 42,
+        });
+        expect(out).toEqual({ txHash: "0xCRITICAL", bountyId: 42, logged: true });
+    });
+    it("OutputGuardrailTripped is re-thrown as-is", async () => {
+        const reg = new GuardrailRegistry();
+        const err = new OutputGuardrailTripped("bad result");
+        reg.register("send_dm", { output: [() => { throw err; }] });
+        await expect(reg.runOutput("send_dm", {})).rejects.toBe(err);
+    });
+    it("non-guardrail errors in output get wrapped", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { output: [() => { throw new Error("bad"); }] });
+        await expect(reg.runOutput("send_dm", {}))
+            .rejects.toMatchObject({
+            name: "OutputGuardrailTripped",
+            message: expect.stringContaining("bad"),
+        });
+    });
+    it("non-object results are returned unchanged even if guardrail returns a partial", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { output: [() => ({ extra: 1 })] });
+        // Result is a string — there's nothing to merge into.
+        const out = await reg.runOutput("send_dm", "ok");
+        expect(out).toBe("ok");
+    });
+    it("output guardrail returning { txHash: undefined } cannot drop txHash", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("create_bounty", {
+            output: [() => ({ txHash: undefined, logged: true })],
+        });
+        const out = await reg.runOutput("create_bounty", {
+            txHash: "0xCRITICAL",
+            bountyId: 42,
+        });
+        expect(out).toEqual({ txHash: "0xCRITICAL", bountyId: 42, logged: true });
+    });
+    it("input guardrail returning { field: undefined } cannot drop the field", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", {
+            input: [() => ({ to: undefined, content: "sanitized" })],
+        });
+        const out = await reg.runInput("send_dm", {
+            to: "0xADDR",
+            content: "raw",
+        });
+        expect(out).toEqual({ to: "0xADDR", content: "sanitized" });
+    });
+    it("output guardrail returning empty object preserves all original fields", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("create_bounty", { output: [() => ({})] });
+        const out = await reg.runOutput("create_bounty", {
+            txHash: "0xabc",
+            signature: "0xsig",
+            bountyId: 1,
+        });
+        expect(out).toEqual({ txHash: "0xabc", signature: "0xsig", bountyId: 1 });
+    });
+    it("original result reference is not mutated by output guardrail merge", async () => {
+        const reg = new GuardrailRegistry();
+        reg.register("create_bounty", { output: [() => ({ extra: "tag" })] });
+        const original = { txHash: "0xabc", bountyId: 1 };
+        const out = await reg.runOutput("create_bounty", original);
+        expect(original).toEqual({ txHash: "0xabc", bountyId: 1 }); // untouched
+        expect(out).toEqual({ txHash: "0xabc", bountyId: 1, extra: "tag" });
+    });
+});
+describe("GuardrailRegistry — registration", () => {
+    it("disposer returned by register() removes only that call's guardrails", async () => {
+        const reg = new GuardrailRegistry();
+        const dispose = reg.register("send_dm", {
+            input: [() => ({ content: "first" })],
+        });
+        reg.register("send_dm", {
+            input: [() => ({ content: "second" })],
+        });
+        expect(reg.countInput("send_dm")).toBe(2);
+        dispose();
+        expect(reg.countInput("send_dm")).toBe(1);
+        const out = await reg.runInput("send_dm", { to: "0x1" });
+        expect(out.content).toBe("second");
+    });
+    it("clear(actionType) removes only that action's guardrails", () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { input: [() => undefined] });
+        reg.register("create_bounty", { input: [() => undefined] });
+        reg.clear("send_dm");
+        expect(reg.countInput("send_dm")).toBe(0);
+        expect(reg.countInput("create_bounty")).toBe(1);
+    });
+    it("clear() removes all guardrails", () => {
+        const reg = new GuardrailRegistry();
+        reg.register("send_dm", { input: [() => undefined], output: [() => undefined] });
+        reg.register("create_bounty", { input: [() => undefined] });
+        reg.clear();
+        expect(reg.countInput("send_dm")).toBe(0);
+        expect(reg.countOutput("send_dm")).toBe(0);
+        expect(reg.countInput("create_bounty")).toBe(0);
+    });
+    it("registering an empty set is a no-op (returns no-op disposer)", () => {
+        const reg = new GuardrailRegistry();
+        const dispose = reg.register("send_dm", {});
+        expect(reg.countInput("send_dm")).toBe(0);
+        expect(() => dispose()).not.toThrow();
+    });
+});
+describe("withGuardrails (standalone wrapper)", () => {
+    it("wraps a handler with input + output guardrails", async () => {
+        const wrapped = withGuardrails(async ({ value }) => ({ doubled: value * 2 }), {
+            input: [({ value }) => {
+                    if (value < 0)
+                        throw new InputGuardrailTripped("negative");
+                }],
+            output: [({ doubled }) => {
+                    if (doubled > 100)
+                        throw new OutputGuardrailTripped("too big");
+                }],
+        });
+        expect(await wrapped({ value: 5 })).toEqual({ doubled: 10 });
+        await expect(wrapped({ value: -1 })).rejects.toBeInstanceOf(InputGuardrailTripped);
+        await expect(wrapped({ value: 51 })).rejects.toBeInstanceOf(OutputGuardrailTripped);
+    });
+});
+//# sourceMappingURL=guardrails.test.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * HookRegistry — unit tests.
+ *
+ * Covers: registration order, prepend, throwing-callback isolation,
+ * deregister + disposer, async emit semantics, fire-and-forget, clear,
+ * and the parity-fixture key-shape contract.
+ */
+export {};
+//# sourceMappingURL=hooks.test.d.ts.map

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

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

package/dist/__tests__/hooks.test.js

@@ -0,0 +1,188 @@
+/**
+ * HookRegistry — unit tests.
+ *
+ * Covers: registration order, prepend, throwing-callback isolation,
+ * deregister + disposer, async emit semantics, fire-and-forget, clear,
+ * and the parity-fixture key-shape contract.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { HookRegistry, hooks as moduleSingleton, } from "../hooks.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURE_PATH = join(__dirname, "fixtures", "hook-events.json");
+const fixture = JSON.parse(readFileSync(FIXTURE_PATH, "utf8"));
+describe("HookRegistry", () => {
+    it("preserves insertion order on emit", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        reg.register("action_start", () => { calls.push(1); });
+        reg.register("action_start", () => { calls.push(2); });
+        reg.register("action_start", () => { calls.push(3); });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual([1, 2, 3]);
+    });
+    it("prepend: true puts callback at the front", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        reg.register("action_start", () => { calls.push("b"); });
+        reg.register("action_start", () => { calls.push("a"); }, { prepend: true });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual(["a", "b"]);
+    });
+    it("one throwing callback does not prevent others", async () => {
+        const reg = new HookRegistry();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        let counted = 0;
+        reg.register("action_start", () => { throw new Error("boom"); });
+        reg.register("action_start", () => { counted += 1; });
+        reg.register("action_start", async () => { counted += 1; });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(counted).toBe(2);
+        errSpy.mockRestore();
+    });
+    it("logs callback errors via console.error (observability)", async () => {
+        const reg = new HookRegistry();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        reg.register("action_start", () => { throw new Error("boom"); });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(errSpy).toHaveBeenCalledTimes(1);
+        const [msg, err] = errSpy.mock.calls[0] ?? [];
+        expect(String(msg)).toContain("action_start");
+        expect(err.message).toBe("boom");
+        errSpy.mockRestore();
+    });
+    it("deregister removes only the matching callback", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        const cbA = () => { calls.push("a"); };
+        const cbB = () => { calls.push("b"); };
+        reg.register("action_start", cbA);
+        reg.register("action_start", cbB);
+        reg.deregister("action_start", cbA);
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual(["b"]);
+        expect(reg.count("action_start")).toBe(1);
+    });
+    it("disposer returned by register() removes only that callback", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        const dispose = reg.register("action_start", () => { calls.push("a"); });
+        reg.register("action_start", () => { calls.push("b"); });
+        dispose();
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual(["b"]);
+    });
+    it("emit awaits async callbacks before resolving", async () => {
+        const reg = new HookRegistry();
+        let resolved = false;
+        reg.register("action_start", async () => {
+            await new Promise((r) => setTimeout(r, 20));
+            resolved = true;
+        });
+        const t0 = Date.now();
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(resolved).toBe(true);
+        expect(Date.now() - t0).toBeGreaterThanOrEqual(15);
+    });
+    it("emitFireAndForget returns synchronously even with async callbacks", async () => {
+        const reg = new HookRegistry();
+        let resolved = false;
+        reg.register("action_start", async () => {
+            await new Promise((r) => setTimeout(r, 20));
+            resolved = true;
+        });
+        reg.emitFireAndForget("action_start", { actionType: "x", args: {} });
+        expect(resolved).toBe(false);
+        await new Promise((r) => setTimeout(r, 30));
+        expect(resolved).toBe(true);
+    });
+    it("sync and async callbacks coexist on the same event", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        reg.register("action_start", () => { calls.push("sync1"); });
+        reg.register("action_start", async () => { calls.push("async1"); });
+        reg.register("action_start", () => { calls.push("sync2"); });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls.sort()).toEqual(["async1", "sync1", "sync2"]);
+    });
+    it("clear(event) removes only that event's subscribers", async () => {
+        const reg = new HookRegistry();
+        let a = 0;
+        let b = 0;
+        reg.register("action_start", () => { a++; });
+        reg.register("action_end", () => { b++; });
+        reg.clear("action_start");
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        await reg.emit("action_end", { actionType: "x", args: {}, result: null, durationMs: 0 });
+        expect(a).toBe(0);
+        expect(b).toBe(1);
+    });
+    it("clear() removes all events", () => {
+        const reg = new HookRegistry();
+        reg.register("action_start", () => { });
+        reg.register("action_end", () => { });
+        reg.clear();
+        expect(reg.count("action_start")).toBe(0);
+        expect(reg.count("action_end")).toBe(0);
+    });
+    it("snapshot semantics: a callback that registers another mid-emit doesn't fire it this turn", async () => {
+        const reg = new HookRegistry();
+        const calls = [];
+        reg.register("action_start", () => {
+            calls.push("first");
+            reg.register("action_start", () => { calls.push("late"); });
+        });
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual(["first"]);
+        await reg.emit("action_start", { actionType: "x", args: {} });
+        expect(calls).toEqual(["first", "first", "late"]);
+    });
+    it("module singleton is a usable HookRegistry", () => {
+        expect(moduleSingleton).toBeInstanceOf(HookRegistry);
+    });
+    describe("parity fixture", () => {
+        it("declares the same set of events as HookEventMap", () => {
+            // Sanity check: every event mentioned in the TS HookEvent union must
+            // have an entry in the fixture, otherwise the Py side would test a
+            // shape the TS side doesn't agree with.
+            const tsEvents = [
+                "action_start", "action_end", "action_error", "action_rejected",
+                "signal_received", "tool_input", "tool_output",
+                "chat_turn_complete", "memory_compacted", "compaction_failed",
+            ];
+            for (const evt of tsEvents) {
+                expect(fixture.events[evt], `fixture missing event: ${evt}`).toBeDefined();
+            }
+        });
+        it("a representative payload for each event satisfies its required keys", async () => {
+            const samples = {
+                action_start: { actionType: "vote", args: { postCid: "QmX" } },
+                action_end: { actionType: "vote", args: {}, result: { txHash: "0x1" }, durationMs: 12 },
+                action_error: { actionType: "vote", args: {}, error: new Error("nope"), durationMs: 5 },
+                action_rejected: { actionType: "vote", args: {}, reason: "denied" },
+                signal_received: { signalType: "dm_received" },
+                tool_input: { toolName: "send_dm", args: { to: "0x1", content: "hi" } },
+                tool_output: { toolName: "send_dm", args: {}, result: { ok: true } },
+                chat_turn_complete: {
+                    sender: "alice", platform: "telegram", message: "hi", response: "hello",
+                    toolsUsed: false, toolCallCount: 0,
+                },
+                memory_compacted: {
+                    sessionId: "sess1", compactionNumber: 1, messagesCompacted: 8, summaryTokens: 256,
+                },
+                compaction_failed: {
+                    sessionId: "sess1", error: new Error("LLM down"), attemptedMessages: 12,
+                },
+            };
+            for (const [evt, payload] of Object.entries(samples)) {
+                const spec = fixture.events[evt];
+                for (const key of spec.required_keys) {
+                    expect(payload[key], `${evt}.${key}`).toBeDefined();
+                }
+            }
+        });
+    });
+});
+//# sourceMappingURL=hooks.test.js.map

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

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