@consensus-tools/universal 0.9.0

package/dist/__tests__/defaults.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from "vitest";
+import { DEFAULTS, DEFAULT_GUARD, DEFAULT_POLICY, DEFAULT_PERSONA_COUNT, DEFAULT_PERSONA_TRIO, policyToStrategy, } from "../defaults.js";
+import { ConfigError } from "../errors.js";
+describe("DEFAULTS", () => {
+    it("provides full defaults matching expected values", () => {
+        expect(DEFAULTS.policy).toBe("majority");
+        expect(DEFAULTS.guards).toEqual(["agent_action"]);
+        expect(DEFAULTS.failPolicy).toBe("closed");
+        expect(DEFAULTS.storage).toBe("memory");
+        expect(DEFAULTS.logger).toBe(true);
+    });
+    it("exports expected guard and policy constants", () => {
+        expect(DEFAULT_GUARD).toBe("agent_action");
+        expect(DEFAULT_POLICY).toBe("majority");
+        expect(DEFAULT_PERSONA_COUNT).toBe(3);
+        expect(DEFAULT_PERSONA_TRIO).toEqual(["security", "compliance", "user-impact"]);
+    });
+    it("merges partial config with defaults", () => {
+        const partial = { policy: "unanimous", failPolicy: "open" };
+        const merged = { ...DEFAULTS, ...partial };
+        expect(merged.policy).toBe("unanimous");
+        expect(merged.failPolicy).toBe("open");
+        // Untouched defaults remain
+        expect(merged.guards).toEqual(["agent_action"]);
+        expect(merged.storage).toBe("memory");
+        expect(merged.logger).toBe(true);
+    });
+});
+describe("policyToStrategy", () => {
+    it("maps 'majority' to { strategy: 'majority' }", () => {
+        expect(policyToStrategy("majority")).toEqual({ strategy: "majority" });
+    });
+    it("maps 'supermajority' to { strategy: 'threshold', threshold: 0.67 }", () => {
+        expect(policyToStrategy("supermajority")).toEqual({ strategy: "threshold", threshold: 0.67 });
+    });
+    it("maps 'unanimous' to { strategy: 'unanimous' }", () => {
+        expect(policyToStrategy("unanimous")).toEqual({ strategy: "unanimous" });
+    });
+    it("maps 'threshold:0.8' to { strategy: 'threshold', threshold: 0.8 }", () => {
+        expect(policyToStrategy("threshold:0.8")).toEqual({ strategy: "threshold", threshold: 0.8 });
+    });
+    it("throws ConfigError for unknown policy name", () => {
+        expect(() => policyToStrategy("bogus")).toThrow(ConfigError);
+        expect(() => policyToStrategy("bogus")).toThrow('Unknown policy "bogus"');
+    });
+    it("throws ConfigError for invalid threshold value", () => {
+        expect(() => policyToStrategy("threshold:abc")).toThrow(ConfigError);
+        expect(() => policyToStrategy("threshold:abc")).toThrow("Invalid threshold value");
+    });
+    it("throws ConfigError for threshold out of range", () => {
+        expect(() => policyToStrategy("threshold:1.5")).toThrow(ConfigError);
+        expect(() => policyToStrategy("threshold:-0.1")).toThrow(ConfigError);
+    });
+});
+//# sourceMappingURL=defaults.test.js.map

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

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

package/dist/__tests__/fail-policy.test.d.ts

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

package/dist/__tests__/fail-policy.test.d.ts.map

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

package/dist/__tests__/fail-policy.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { ConsensusBlockedError } from "../errors.js";
+// Mock the wrapper's consensus function and guards' createGuardTemplate
+const mockWrapped = vi.fn();
+vi.mock("@consensus-tools/wrapper", () => ({
+    consensus: vi.fn(() => mockWrapped),
+}));
+vi.mock("@consensus-tools/guards", () => ({
+    createGuardTemplate: vi.fn((_name, _config) => ({
+        asReviewer: () => vi.fn(),
+    })),
+    GUARD_CONFIGS: {
+        security: { description: "Security reviewer", rules: () => [] },
+        compliance: { description: "Compliance reviewer", rules: () => [] },
+        "user-impact": { description: "User-impact reviewer", rules: () => [] },
+    },
+    DEFAULT_PERSONA_TRIO: ["security", "compliance", "user-impact"],
+}));
+const { consensus } = await import("../index.js");
+describe("failPolicy behavior", () => {
+    let originalNodeEnv;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        originalNodeEnv = process.env["NODE_ENV"];
+    });
+    afterEach(() => {
+        if (originalNodeEnv === undefined) {
+            delete process.env["NODE_ENV"];
+        }
+        else {
+            process.env["NODE_ENV"] = originalNodeEnv;
+        }
+    });
+    it("failPolicy: 'closed' + error -> ConsensusBlockedError thrown", async () => {
+        const fn = vi.fn(async () => "result");
+        mockWrapped.mockRejectedValueOnce(new Error("deliberation crashed"));
+        const wrapped = consensus.wrap(fn, { failPolicy: "closed" });
+        await expect(wrapped("myTool", {})).rejects.toThrow(ConsensusBlockedError);
+        // Second call: verify message
+        mockWrapped.mockRejectedValueOnce(new Error("deliberation crashed again"));
+        const wrapped2 = consensus.wrap(fn, { failPolicy: "closed" });
+        await expect(wrapped2("myTool", {})).rejects.toThrow("Consensus deliberation failed");
+    });
+    it("failPolicy: 'open' + error -> fn result returned", async () => {
+        const fn = vi.fn(async (_name, _args) => "fallback-result");
+        // First call: mockWrapped rejects (deliberation error)
+        mockWrapped.mockRejectedValueOnce(new Error("deliberation crashed"));
+        const wrapped = consensus.wrap(fn, { failPolicy: "open" });
+        const result = await wrapped("myTool", { key: "val" });
+        // failPolicy 'open' should call fn directly and return its result
+        expect(result).toBe("fallback-result");
+        expect(fn).toHaveBeenCalledWith("myTool", { key: "val" });
+    });
+    it("NODE_ENV=production + failPolicy:'open' -> console.warn emitted", () => {
+        process.env["NODE_ENV"] = "production";
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const fn = vi.fn(async () => "result");
+        consensus.wrap(fn, { failPolicy: "open" });
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining("failPolicy 'open' in production"));
+        warnSpy.mockRestore();
+    });
+    it("NODE_ENV=production + storage:'memory' -> console.warn emitted", () => {
+        process.env["NODE_ENV"] = "production";
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const fn = vi.fn(async () => "result");
+        // storage defaults to 'memory', so no explicit override needed
+        consensus.wrap(fn, { storage: "memory" });
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining("storage 'memory' in production"));
+        warnSpy.mockRestore();
+    });
+    it("NODE_ENV=development -> no warnings emitted", () => {
+        process.env["NODE_ENV"] = "development";
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const fn = vi.fn(async () => "result");
+        consensus.wrap(fn, { failPolicy: "open", storage: "memory" });
+        expect(warnSpy).not.toHaveBeenCalled();
+        warnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=fail-policy.test.js.map

package/dist/__tests__/fail-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-policy.test.js","sourceRoot":"","sources":["../../src/__tests__/fail-policy.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,wEAAwE;AACxE,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,EAA4D,CAAC;AAEtF,EAAE,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE,CAAC,CAAC;IACzC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAa,EAAE,OAAgB,EAAE,EAAE,CAAC,CAAC;QAC/D,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;KAC1B,CAAC,CAAC;IACH,aAAa,EAAE;QACb,QAAQ,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QAC/D,UAAU,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACnE,aAAa,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;KACxE;IACD,oBAAoB,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC;CAChE,CAAC,CAAC,CAAC;AAEJ,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAElD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,eAAmC,CAAC;IAExC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QAEvC,WAAW,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAE3E,8BAA8B;QAC9B,WAAW,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAa,EAAE,KAA8B,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAE7F,uDAAuD;QACvD,WAAW,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAEvD,kEAAkE;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;QACvC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAClC,MAAM,CAAC,gBAAgB,CAAC,iCAAiC,CAAC,CAC3D,CAAC;QACF,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;QACvC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QACvC,+DAA+D;QAC/D,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE1C,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAClC,MAAM,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,CAC1D,CAAC;QACF,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC;QACxC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvC,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/frameworks.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect, vi } from "vitest";
+import { MissingDependencyError } from "../errors.js";
+// Mock the wrapper and guards (needed for module load)
+vi.mock("@consensus-tools/wrapper", () => ({
+    consensus: vi.fn(() => vi.fn()),
+}));
+vi.mock("@consensus-tools/guards", () => ({
+    createGuardTemplate: vi.fn((_name, _config) => ({
+        asReviewer: () => vi.fn(),
+    })),
+}));
+// Mock the optional adapter packages to simulate them not being installed
+vi.mock("@consensus-tools/langchain", () => {
+    throw new Error("Cannot find module '@consensus-tools/langchain'");
+});
+vi.mock("@consensus-tools/ai-sdk", () => {
+    throw new Error("Cannot find module '@consensus-tools/ai-sdk'");
+});
+vi.mock("@consensus-tools/mcp", () => {
+    throw new Error("Cannot find module '@consensus-tools/mcp'");
+});
+const { consensus } = await import("../index.js");
+describe("framework shortcuts", () => {
+    it("consensus.langchain() throws MissingDependencyError when adapter not installed", async () => {
+        await expect(consensus.langchain({})).rejects.toThrow(MissingDependencyError);
+        await expect(consensus.langchain({})).rejects.toThrow("@consensus-tools/langchain");
+    });
+    it("consensus.aiSdk() throws MissingDependencyError when adapter not installed", async () => {
+        await expect(consensus.aiSdk(() => { })).rejects.toThrow(MissingDependencyError);
+        await expect(consensus.aiSdk(() => { })).rejects.toThrow("@consensus-tools/ai-sdk");
+    });
+    it("consensus.mcp() throws MissingDependencyError when adapter not installed", async () => {
+        await expect(consensus.mcp()).rejects.toThrow(MissingDependencyError);
+        await expect(consensus.mcp()).rejects.toThrow("@consensus-tools/mcp");
+    });
+});
+describe("consensus.langchain() with adapter installed", () => {
+    it("returns a handler instance when adapter is available", async () => {
+        // Create a mock handler class
+        class MockGuardHandler {
+            name = "consensus-guard";
+            config;
+            constructor(config) {
+                this.config = config;
+            }
+        }
+        // Temporarily override the langchain mock to return a working module
+        const mockMod = {
+            ConsensusGuardCallbackHandler: MockGuardHandler,
+        };
+        // We need to test with a fresh import; use vi.doMock to override for a scoped import
+        vi.doMock("@consensus-tools/langchain", () => mockMod);
+        // Re-import to pick up the new mock
+        const { consensus: freshConsensus } = await import("../index.js");
+        const handler = await freshConsensus.langchain(null, { policy: "supermajority", guards: ["security"] });
+        expect(handler).toBeInstanceOf(MockGuardHandler);
+        expect(handler.config).toEqual({
+            policy: "supermajority",
+            guards: ["security"],
+            onDecision: undefined,
+        });
+        // Restore the original mock (not installed)
+        vi.doMock("@consensus-tools/langchain", () => {
+            throw new Error("Cannot find module '@consensus-tools/langchain'");
+        });
+    });
+    it("uses default policy 'majority' when no config provided", async () => {
+        class MockGuardHandler {
+            name = "consensus-guard";
+            config;
+            constructor(config) {
+                this.config = config;
+            }
+        }
+        vi.doMock("@consensus-tools/langchain", () => ({
+            ConsensusGuardCallbackHandler: MockGuardHandler,
+        }));
+        const { consensus: freshConsensus } = await import("../index.js");
+        const handler = await freshConsensus.langchain(null);
+        expect(handler.config.policy).toBe("majority");
+        vi.doMock("@consensus-tools/langchain", () => {
+            throw new Error("Cannot find module '@consensus-tools/langchain'");
+        });
+    });
+});
+//# sourceMappingURL=frameworks.test.js.map

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

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

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

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

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

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

package/dist/__tests__/logger.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect, vi } from "vitest";
+import { createLogger } from "../logger.js";
+describe("createLogger", () => {
+    it("emits deliberation.start event via beforeSubmit hook", () => {
+        const logFn = vi.fn();
+        const hooks = createLogger({ logger: logFn });
+        hooks.beforeSubmit(["arg1", "arg2"]);
+        expect(logFn).toHaveBeenCalledOnce();
+        const event = logFn.mock.calls[0][0];
+        expect(event.event).toBe("deliberation.start");
+        expect(event.data).toEqual({ args: ["arg1", "arg2"] });
+        expect(typeof event.timestamp).toBe("number");
+    });
+    it("emits deliberation.result event via afterResolve hook", () => {
+        const logFn = vi.fn();
+        const hooks = createLogger({ logger: logFn });
+        const mockResult = {
+            action: "allow",
+            output: "ok",
+            scores: [{ score: 0.9, rationale: "safe" }],
+            aggregateScore: 0.9,
+            attempt: 1,
+        };
+        hooks.afterResolve(mockResult);
+        expect(logFn).toHaveBeenCalledOnce();
+        const event = logFn.mock.calls[0][0];
+        expect(event.event).toBe("deliberation.result");
+        expect(event.data).toEqual({
+            action: "allow",
+            aggregateScore: 0.9,
+            attempt: 1,
+            scoresCount: 1,
+        });
+    });
+    it("emits deliberation.error-level event via onBlock hook", () => {
+        const logFn = vi.fn();
+        const hooks = createLogger({ logger: logFn });
+        const mockResult = {
+            action: "block",
+            output: null,
+            scores: [{ score: 0, rationale: "blocked" }],
+            aggregateScore: 0,
+            attempt: 1,
+        };
+        hooks.onBlock(mockResult);
+        expect(logFn).toHaveBeenCalledOnce();
+        const event = logFn.mock.calls[0][0];
+        expect(event.event).toBe("deliberation.result");
+        expect(event.data.action).toBe("block");
+    });
+    it("returns empty hooks when logger is false (suppresses all events)", () => {
+        const hooks = createLogger({ logger: false });
+        expect(hooks.beforeSubmit).toBeUndefined();
+        expect(hooks.afterResolve).toBeUndefined();
+        expect(hooks.onBlock).toBeUndefined();
+        expect(hooks.onEscalate).toBeUndefined();
+    });
+    it("uses custom logger function to receive events", () => {
+        const events = [];
+        const customLogger = (event) => {
+            events.push(event);
+        };
+        const hooks = createLogger({ logger: customLogger });
+        hooks.beforeSubmit(["hello"]);
+        hooks.afterResolve({
+            action: "allow",
+            output: "world",
+            scores: [],
+            aggregateScore: 1.0,
+            attempt: 1,
+        });
+        expect(events).toHaveLength(2);
+        expect(events[0].event).toBe("deliberation.start");
+        expect(events[1].event).toBe("deliberation.result");
+    });
+});
+//# sourceMappingURL=logger.test.js.map

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

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

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

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

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

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

package/dist/__tests__/resolve.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { resolveWrappable } from "../resolve.js";
+describe("resolveWrappable", () => {
+    it("returns the function directly when input is a function", () => {
+        const fn = async (name, args) => ({ name, args });
+        const result = resolveWrappable(fn);
+        expect(result).toBe(fn);
+    });
+    it("returns .execute when input has .execute", async () => {
+        const obj = {
+            state: "bound",
+            execute: async function (name, args) {
+                return { name, args, state: this.state };
+            },
+        };
+        const resolved = resolveWrappable(obj);
+        const output = await resolved("test", { a: 1 });
+        expect(output).toEqual({ name: "test", args: { a: 1 }, state: "bound" });
+    });
+    it("returns .invoke when input has .invoke", async () => {
+        const obj = {
+            state: "invoked",
+            invoke: async function (name, args) {
+                return { name, args, state: this.state };
+            },
+        };
+        const resolved = resolveWrappable(obj);
+        const output = await resolved("test", { b: 2 });
+        expect(output).toEqual({ name: "test", args: { b: 2 }, state: "invoked" });
+    });
+    it("returns .call when input has .call", async () => {
+        const obj = {
+            state: "called",
+            call: async function (name, args) {
+                return { name, args, state: this.state };
+            },
+        };
+        const resolved = resolveWrappable(obj);
+        const output = await resolved("test", { c: 3 });
+        expect(output).toEqual({ name: "test", args: { c: 3 }, state: "called" });
+    });
+    it("prefers .execute over .invoke when both exist (resolution order)", async () => {
+        const obj = {
+            execute: async (_name, _args) => "execute-wins",
+            invoke: async (_name, _args) => "invoke-loses",
+        };
+        const resolved = resolveWrappable(obj);
+        const output = await resolved("test", {});
+        expect(output).toBe("execute-wins");
+    });
+    it("throws TypeError for null", () => {
+        expect(() => resolveWrappable(null)).toThrow(TypeError);
+        expect(() => resolveWrappable(null)).toThrow("Expected a Wrappable");
+    });
+    it("throws TypeError for undefined", () => {
+        expect(() => resolveWrappable(undefined)).toThrow(TypeError);
+        expect(() => resolveWrappable(undefined)).toThrow("Expected a Wrappable");
+    });
+    it("throws TypeError for object with no matching methods", () => {
+        const obj = { foo: () => "bar" };
+        expect(() => resolveWrappable(obj)).toThrow(TypeError);
+        expect(() => resolveWrappable(obj)).toThrow("Expected a Wrappable");
+    });
+    it("throws TypeError for string primitive", () => {
+        expect(() => resolveWrappable("hello")).toThrow(TypeError);
+    });
+    it("throws TypeError for number primitive", () => {
+        expect(() => resolveWrappable(42)).toThrow(TypeError);
+    });
+});
+//# sourceMappingURL=resolve.test.js.map

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

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

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

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

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

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

package/dist/__tests__/wrap.test.js

@@ -0,0 +1,90 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { ConsensusBlockedError } from "../errors.js";
+// Mock the wrapper's consensus function and guards' createGuardTemplate
+const mockWrapped = vi.fn();
+vi.mock("@consensus-tools/wrapper", () => ({
+    consensus: vi.fn(() => mockWrapped),
+}));
+vi.mock("@consensus-tools/guards", () => ({
+    createGuardTemplate: vi.fn((_name, _config) => ({
+        asReviewer: () => vi.fn(),
+    })),
+    GUARD_CONFIGS: {
+        security: { description: "Security reviewer", rules: () => [] },
+        compliance: { description: "Compliance reviewer", rules: () => [] },
+        "user-impact": { description: "User-impact reviewer", rules: () => [] },
+    },
+    DEFAULT_PERSONA_TRIO: ["security", "compliance", "user-impact"],
+}));
+// Import after mocks are set up
+const { consensus } = await import("../index.js");
+describe("consensus.wrap()", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("happy path: wrap function, reviewers run, decision returned", async () => {
+        const fn = vi.fn(async (_name, _args) => "tool-result");
+        mockWrapped.mockResolvedValueOnce({
+            action: "allow",
+            output: "tool-result",
+            scores: [{ score: 0.9, rationale: "approved" }],
+            aggregateScore: 0.9,
+            attempt: 1,
+        });
+        const wrapped = consensus.wrap(fn);
+        const result = await wrapped("myTool", { input: "data" });
+        expect(result).toBe("tool-result");
+        expect(mockWrapped).toHaveBeenCalledWith("myTool", { input: "data" });
+    });
+    it("wrapped fn returns undefined -> reviewers evaluate undefined", async () => {
+        const fn = vi.fn(async () => undefined);
+        mockWrapped.mockResolvedValueOnce({
+            action: "allow",
+            output: undefined,
+            scores: [{ score: 0.8 }],
+            aggregateScore: 0.8,
+            attempt: 1,
+        });
+        const wrapped = consensus.wrap(fn);
+        const result = await wrapped("myTool", {});
+        expect(result).toBeUndefined();
+    });
+    it("wrapped fn throws synchronously -> failPolicy 'closed' throws ConsensusBlockedError", async () => {
+        const fn = vi.fn(() => {
+            throw new Error("sync explosion");
+        });
+        mockWrapped.mockRejectedValueOnce(new Error("sync explosion"));
+        const wrapped = consensus.wrap(fn, { failPolicy: "closed" });
+        await expect(wrapped("myTool", {})).rejects.toThrow(ConsensusBlockedError);
+    });
+    it("all reviewers return score=0 -> unanimous block with failPolicy closed", async () => {
+        const fn = vi.fn(async () => "result");
+        mockWrapped.mockResolvedValueOnce({
+            action: "block",
+            output: null,
+            scores: [
+                { score: 0, rationale: "blocked-1" },
+                { score: 0, rationale: "blocked-2" },
+                { score: 0, rationale: "blocked-3" },
+            ],
+            aggregateScore: 0,
+            attempt: 1,
+        });
+        const wrapped = consensus.wrap(fn, { failPolicy: "closed" });
+        await expect(wrapped("dangerousTool", {})).rejects.toThrow(ConsensusBlockedError);
+        // Second call to verify message content
+        mockWrapped.mockResolvedValueOnce({
+            action: "block",
+            output: null,
+            scores: [
+                { score: 0, rationale: "blocked-1" },
+                { score: 0, rationale: "blocked-2" },
+                { score: 0, rationale: "blocked-3" },
+            ],
+            aggregateScore: 0,
+            attempt: 1,
+        });
+        await expect(wrapped("dangerousTool", {})).rejects.toThrow(/Consensus block/);
+    });
+});
+//# sourceMappingURL=wrap.test.js.map

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

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

package/dist/defaults.d.ts

@@ -0,0 +1,20 @@
+import type { StrategyConfig } from "@consensus-tools/wrapper";
+import type { UniversalConfig } from "./types.js";
+export { DEFAULT_PERSONA_TRIO } from "@consensus-tools/guards";
+export declare const DEFAULT_GUARD = "agent_action";
+export declare const DEFAULT_POLICY = "majority";
+export declare const DEFAULT_PERSONA_COUNT = 3;
+export declare const DEFAULTS: Required<Pick<UniversalConfig, "policy" | "guards" | "failPolicy" | "storage" | "logger">>;
+/**
+ * Maps a user-facing policy name to a wrapper StrategyConfig.
+ *
+ * Supported names:
+ *   'majority'        -> { strategy: 'majority' }
+ *   'supermajority'   -> { strategy: 'threshold', threshold: 0.67 }
+ *   'unanimous'       -> { strategy: 'unanimous' }
+ *   'threshold:X'     -> { strategy: 'threshold', threshold: X }
+ *
+ * @throws ConfigError for unrecognized policy names.
+ */
+export declare function policyToStrategy(policy: string): StrategyConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAI/D,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAC5C,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAC7B,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC,CAOjF,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CA0B/D"}

package/dist/defaults.js

@@ -0,0 +1,48 @@
+import { ConfigError } from "./errors.js";
+export { DEFAULT_PERSONA_TRIO } from "@consensus-tools/guards";
+// ── Default Configuration ────────────────────────────────────────────
+export const DEFAULT_GUARD = "agent_action";
+export const DEFAULT_POLICY = "majority";
+export const DEFAULT_PERSONA_COUNT = 3;
+export const DEFAULTS = {
+    policy: DEFAULT_POLICY,
+    guards: [DEFAULT_GUARD],
+    failPolicy: "closed",
+    storage: "memory",
+    logger: true,
+};
+// ── Policy-to-Strategy Mapping ───────────────────────────────────────
+/**
+ * Maps a user-facing policy name to a wrapper StrategyConfig.
+ *
+ * Supported names:
+ *   'majority'        -> { strategy: 'majority' }
+ *   'supermajority'   -> { strategy: 'threshold', threshold: 0.67 }
+ *   'unanimous'       -> { strategy: 'unanimous' }
+ *   'threshold:X'     -> { strategy: 'threshold', threshold: X }
+ *
+ * @throws ConfigError for unrecognized policy names.
+ */
+export function policyToStrategy(policy) {
+    switch (policy) {
+        case "majority":
+            return { strategy: "majority" };
+        case "supermajority":
+            return { strategy: "threshold", threshold: 0.67 };
+        case "unanimous":
+            return { strategy: "unanimous" };
+        default: {
+            // Handle 'threshold:X' pattern
+            if (policy.startsWith("threshold:")) {
+                const value = Number(policy.slice("threshold:".length));
+                if (Number.isNaN(value) || value < 0 || value > 1) {
+                    throw new ConfigError(`Invalid threshold value in policy "${policy}". Expected a number between 0 and 1.`);
+                }
+                return { strategy: "threshold", threshold: value };
+            }
+            throw new ConfigError(`Unknown policy "${policy}". ` +
+                `Supported: 'majority', 'supermajority', 'unanimous', 'threshold:X' (where X is 0-1).`);
+        }
+    }
+}
+//# sourceMappingURL=defaults.js.map