@nookplot/runtime 0.5.123 → 0.5.124

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":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,aAAc,OAAkB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;SACpF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,KAAK,EAAE;gBACL,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBAC5B,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAiB,SAAS,EAAE,CAAC;aAC9D;SACF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;QAC3D,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;aACjD,OAAO,CAAC,aAAa,CAAC;YACrB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC;YACxC,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/C,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;oBACpB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC5C,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,UAAU,EAAE,CAAC;gBAC3C,CAAC;aACF;SACF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;SACrC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,yEAAyE;QACzE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE;YAC5B,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;SACnC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE;YAC/C,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrD,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;aACvC,OAAO,CAAC,aAAa,CAAC;YACrB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC;SACxC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,sDAAsD;QACtD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE;YAC5B,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;SACtD,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE;YAC/C,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;SACzD,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAA0B,SAAS,EAAE;YACjE,EAAE,EAAE,QAAQ;YACZ,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE;YAC/C,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;SACtC,CAAC,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE;YACtB,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;SACvC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAA0B,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjF,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,cAAc,CAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAC7C;YACE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;oBACpB,IAAI,KAAK,GAAG,CAAC;wBAAE,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;gBAC7D,CAAC,CAAC;YACF,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;oBACvB,IAAI,OAAO,GAAG,GAAG;wBAAE,MAAM,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;gBACjE,CAAC,CAAC;SACH,CACF,CAAC;QAEF,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QACnF,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/helpers/mockRuntime.d.ts

@@ -0,0 +1,11 @@
+import type { NookplotRuntime } from "../../index.js";
+/** Captured callbacks from proactive.onSignal / proactive.onActionRequest */
+export interface CapturedCallbacks {
+    signalCb: ((event: unknown) => void) | null;
+    actionCb: ((event: unknown) => void) | null;
+}
+export declare function createMockRuntime(): {
+    runtime: NookplotRuntime;
+    callbacks: CapturedCallbacks;
+};
+//# sourceMappingURL=mockRuntime.d.ts.map

package/dist/__tests__/helpers/mockRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockRuntime.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/mockRuntime.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,IAAI;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,CAgJ9F"}

package/dist/__tests__/helpers/mockRuntime.js

@@ -0,0 +1,153 @@
+/**
+ * Mock NookplotRuntime factory for unit tests.
+ *
+ * Creates a fully stubbed runtime with all 22+ managers.
+ * Each method returns sensible defaults (resolved promises).
+ */
+import { vi } from "vitest";
+const ok = { txHash: "0xMOCK_TX", success: true };
+const okAsync = () => Promise.resolve(ok);
+export function createMockRuntime() {
+    const captured = { signalCb: null, actionCb: null };
+    const runtime = {
+        connection: {
+            address: "0xAGENT0000000000000000000000000000000001",
+            request: vi.fn().mockResolvedValue({ success: true }),
+        },
+        identity: {
+            getAddress: vi.fn().mockReturnValue("0xAGENT0000000000000000000000000000000001"),
+            updateProfile: vi.fn().mockResolvedValue(ok),
+            // Goal execution (L3 — migration 247). Defaults to "no goal" so existing
+            // tests don't accidentally trigger bootstrap paths.
+            getGoal: vi.fn().mockResolvedValue(null),
+            updateGoalStatus: vi.fn().mockResolvedValue(undefined),
+            completeGoal: vi.fn().mockResolvedValue(undefined),
+            recordGoalStep: vi.fn().mockResolvedValue({ id: "step-1" }),
+            createPendingTask: vi.fn().mockResolvedValue({ id: "task-1" }),
+        },
+        memory: {
+            publishKnowledge: vi.fn().mockResolvedValue({ cid: "Qm_mock_cid", txHash: "0xMOCK_TX" }),
+            publishComment: vi.fn().mockResolvedValue({ cid: "Qm_comment_cid", txHash: "0xMOCK_TX" }),
+            vote: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+        },
+        events: {
+            subscribe: vi.fn(),
+            emit: vi.fn(),
+        },
+        heartbeat: {},
+        economy: {
+            getBalance: vi.fn().mockResolvedValue({ balance: 100 }),
+        },
+        social: {
+            follow: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            attest: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+        },
+        inbox: {
+            send: vi.fn().mockResolvedValue({ messageId: "msg_1" }),
+        },
+        channels: {
+            send: vi.fn().mockResolvedValue({ messageId: "ch_msg_1" }),
+            sendToProject: vi.fn().mockResolvedValue({ messageId: "proj_msg_1" }),
+            getHistory: vi.fn().mockResolvedValue({ messages: [] }),
+        },
+        projects: {
+            commitFiles: vi.fn().mockResolvedValue({ commitId: "abc123" }),
+            addCollaborator: vi.fn().mockResolvedValue({ success: true }),
+            submitReview: vi.fn().mockResolvedValue({ id: "review_1" }),
+            requestAIReview: vi.fn().mockResolvedValue({ reviewId: "ai_rev_1", verdict: "approve", findingsCount: 0, creditsCost: 150 }),
+            createTask: vi.fn().mockResolvedValue({ taskId: "task_1" }),
+            assignTask: vi.fn().mockResolvedValue({ success: true }),
+            updateTask: vi.fn().mockResolvedValue({ success: true }),
+            getCommit: vi.fn().mockResolvedValue({ message: "test commit", changes: [{ path: "file.ts", diff: "+hello" }] }),
+            setGuildAttribution: vi.fn().mockResolvedValue({ success: true }),
+        },
+        leaderboard: {},
+        tools: {
+            httpRequest: vi.fn().mockResolvedValue({ status: 200, body: "{}" }),
+            executeTool: vi.fn().mockResolvedValue({ result: "ok" }),
+            connectMcpServer: vi.fn().mockResolvedValue({ serverId: "mcp_1" }),
+            disconnectMcpServer: vi.fn().mockResolvedValue(undefined),
+            registerWebhook: vi.fn().mockResolvedValue({ webhookId: "wh_1" }),
+        },
+        proactive: {
+            onSignal: vi.fn().mockImplementation((cb) => { captured.signalCb = cb; }),
+            onActionRequest: vi.fn().mockImplementation((cb) => { captured.actionCb = cb; }),
+            completeAction: vi.fn().mockResolvedValue(undefined),
+            rejectDelegatedAction: vi.fn().mockResolvedValue(undefined),
+        },
+        discovery: {
+            discoverBundles: vi.fn().mockResolvedValue([]),
+        },
+        bounties: {},
+        bundles: {},
+        guilds: {
+            linkProject: vi.fn().mockResolvedValue({ success: true }),
+            get: vi.fn().mockResolvedValue({ members: [] }),
+            depositTreasury: vi.fn().mockResolvedValue(ok),
+            withdrawTreasury: vi.fn().mockResolvedValue(ok),
+            fundBountyFromTreasury: vi.fn().mockResolvedValue(ok),
+            distributeRevenue: vi.fn().mockResolvedValue(ok),
+        },
+        communities: {},
+        marketplace: {
+            createListing: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            createAgreement: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            deliver: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            settle: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            dispute: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            cancel: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            expireDispute: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            expireDelivered: vi.fn().mockResolvedValue({ txHash: "0xMOCK_TX" }),
+            submitReview: vi.fn().mockResolvedValue({ reviewId: "rev_1" }),
+            sendAgreementMessage: vi.fn().mockResolvedValue({ messageId: "msg_1" }),
+        },
+        teaching: {},
+        matching: {
+            findAgents: vi.fn().mockResolvedValue({ results: [] }),
+            assembleTeam: vi.fn().mockResolvedValue({ teamId: "team_1" }),
+            sendInvitations: vi.fn().mockResolvedValue({ sent: 3 }),
+        },
+        workspaces: {
+            create: vi.fn().mockResolvedValue({ workspaceId: "ws_1" }),
+            setState: vi.fn().mockResolvedValue({ success: true }),
+            createSnapshot: vi.fn().mockResolvedValue({ snapshotId: "snap_1" }),
+            createProposal: vi.fn().mockResolvedValue({ proposalId: "prop_1" }),
+            vote: vi.fn().mockResolvedValue({ success: true }),
+            cancelProposal: vi.fn().mockResolvedValue({ success: true }),
+        },
+        insights: {
+            publish: vi.fn().mockResolvedValue({ insightId: "ins_1" }),
+            cite: vi.fn().mockResolvedValue({ citationId: "cite_1" }),
+            apply: vi.fn().mockResolvedValue({ applicationId: "app_1" }),
+        },
+        swarms: {
+            create: vi.fn().mockResolvedValue({ swarmId: "swarm_1" }),
+            claimSubtask: vi.fn().mockResolvedValue({ success: true }),
+            submitResult: vi.fn().mockResolvedValue({ success: true }),
+            aggregate: vi.fn().mockResolvedValue({ aggregationId: "agg_1" }),
+        },
+        specialization: {
+            recordGap: vi.fn().mockResolvedValue(undefined),
+            updateProficiency: vi.fn().mockResolvedValue({ success: true }),
+            generateRecommendations: vi.fn().mockResolvedValue([]),
+            dismissRecommendation: vi.fn().mockResolvedValue(undefined),
+        },
+        intents: {
+            create: vi.fn().mockResolvedValue({ intentId: "intent_1" }),
+            list: vi.fn().mockResolvedValue({ intents: [] }),
+            submitProposal: vi.fn().mockResolvedValue({ proposalId: "prop_1" }),
+            acceptProposal: vi.fn().mockResolvedValue({ success: true }),
+            cancel: vi.fn().mockResolvedValue({ success: true }),
+            complete: vi.fn().mockResolvedValue({ success: true }),
+            withdrawProposal: vi.fn().mockResolvedValue({ success: true }),
+        },
+        oracle: {
+            getProjectSignals: vi.fn().mockResolvedValue({ signals: [] }),
+            getAgentSignals: vi.fn().mockResolvedValue({ signals: [] }),
+            getIntentSignals: vi.fn().mockResolvedValue({ signals: [] }),
+            getGuildSignals: vi.fn().mockResolvedValue({ signals: [] }),
+        },
+    };
+    return { runtime, callbacks: captured };
+}
+//# sourceMappingURL=mockRuntime.js.map

package/dist/__tests__/helpers/mockRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockRuntime.js","sourceRoot":"","sources":["../../../src/__tests__/helpers/mockRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG5B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAQ1C,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAEvE,MAAM,OAAO,GAAG;QACd,UAAU,EAAE;YACV,OAAO,EAAE,2CAA2C;YACpD,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACtD;QACD,QAAQ,EAAE;YACR,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,2CAA2C,CAAC;YAChF,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,yEAAyE;YACzE,oDAAoD;YACpD,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;YACxC,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACtD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAClD,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;YAC3D,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;SAC/D;QACD,MAAM,EAAE;YACN,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACxF,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACzF,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;SACzD;QACD,MAAM,EAAE;YACN,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;SACd;QACD,SAAS,EAAE,EAAE;QACb,OAAO,EAAE;YACP,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;SACxD;QACD,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC1D,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;SAC3D;QACD,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;SACxD;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;YAC1D,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YACrE,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;SACxD;QACD,QAAQ,EAAE;YACR,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YAC9D,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7D,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;YAC3D,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAC5H,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC3D,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACxD,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACxD,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAChH,mBAAmB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAClE;QACD,WAAW,EAAE,EAAE;QACf,KAAK,EAAE;YACL,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACnE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACxD,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAClE,mBAAmB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACzD,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SAClE;QACD,SAAS,EAAE;YACT,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAA4B,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACnG,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAA4B,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1G,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACpD,qBAAqB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAC5D;QACD,SAAS,EAAE;YACT,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;SAC/C;QACD,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,MAAM,EAAE;YACN,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzD,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC/C,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC9C,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC/C,sBAAsB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACrD,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;SACjD;QACD,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACX,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACjE,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACnE,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC3D,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC1D,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC3D,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC1D,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACjE,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACnE,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAC9D,oBAAoB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;SACxE;QACD,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE;YACR,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACtD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC7D,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SACxD;QACD,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;YAC1D,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACtD,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACnE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACnE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAClD,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC7D;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YAC1D,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACzD,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;SAC7D;QACD,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACzD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC1D,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC1D,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;SACjE;QACD,cAAc,EAAE;YACd,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC/C,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC/D,uBAAuB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtD,qBAAqB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAC5D;QACD,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;YAC3D,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAChD,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACnE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC5D,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACpD,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACtD,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC/D;QACD,MAAM,EAAE;YACN,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC7D,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC3D,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC5D,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;SAC5D;KAC4B,CAAC;IAEhC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

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,192 @@
+/**
+ * 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",
+                "doom_loop_detected",
+            ];
+            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,
+                },
+                doom_loop_detected: {
+                    offender: "send_dm", triggers: 1, actionType: "send_dm",
+                },
+            };
+            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