@debriefer/core 2.0.0

package/dist/__tests__/batch-runner.test.js

@@ -0,0 +1,217 @@
+import { describe, it, expect, vi } from "vitest";
+import { ParallelBatchRunner } from "../batch-runner.js";
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+describe("ParallelBatchRunner", () => {
+    it("processes all items and returns results in order", async () => {
+        const runner = new ParallelBatchRunner({
+            concurrency: 3,
+        });
+        const results = await runner.run([1, 2, 3, 4, 5], async (item) => {
+            await delay(10);
+            return `result-${item}`;
+        });
+        expect(results).toHaveLength(5);
+        expect(results[0]).toEqual({ item: 1, result: "result-1" });
+        expect(results[1]).toEqual({ item: 2, result: "result-2" });
+        expect(results[2]).toEqual({ item: 3, result: "result-3" });
+        expect(results[3]).toEqual({ item: 4, result: "result-4" });
+        expect(results[4]).toEqual({ item: 5, result: "result-5" });
+    });
+    it("respects concurrency limit", async () => {
+        // With concurrency 1, 3 items at ~50ms each should take ~150ms
+        const runnerSerial = new ParallelBatchRunner({
+            concurrency: 1,
+        });
+        const items = [1, 2, 3];
+        const serialStart = Date.now();
+        await runnerSerial.run(items, async (item) => {
+            await delay(50);
+            return item;
+        });
+        const serialElapsed = Date.now() - serialStart;
+        // With concurrency 3, all 3 run in parallel, should take ~50ms
+        const runnerParallel = new ParallelBatchRunner({
+            concurrency: 3,
+        });
+        const parallelStart = Date.now();
+        await runnerParallel.run(items, async (item) => {
+            await delay(50);
+            return item;
+        });
+        const parallelElapsed = Date.now() - parallelStart;
+        // Serial should take at least 130ms (3 * 50ms with some tolerance)
+        expect(serialElapsed).toBeGreaterThanOrEqual(130);
+        // Parallel should take less than 120ms (roughly 1 * 50ms with tolerance)
+        expect(parallelElapsed).toBeLessThan(120);
+        // Serial should be meaningfully slower than parallel
+        expect(serialElapsed).toBeGreaterThan(parallelElapsed * 1.5);
+    });
+    it("handles per-item errors without failing the batch", async () => {
+        const runner = new ParallelBatchRunner({
+            concurrency: 5,
+        });
+        const results = await runner.run([1, 2, 3, 4], async (item) => {
+            if (item === 2 || item === 4) {
+                throw new Error(`failed on ${item}`);
+            }
+            return `ok-${item}`;
+        });
+        expect(results).toHaveLength(4);
+        expect(results[0]).toEqual({ item: 1, result: "ok-1" });
+        expect(results[1]).toEqual({
+            item: 2,
+            result: null,
+            error: expect.objectContaining({ message: "failed on 2" }),
+        });
+        expect(results[2]).toEqual({ item: 3, result: "ok-3" });
+        expect(results[3]).toEqual({
+            item: 4,
+            result: null,
+            error: expect.objectContaining({ message: "failed on 4" }),
+        });
+    });
+    it("calls onItemComplete for each successful item", async () => {
+        const onItemComplete = vi.fn();
+        const runner = new ParallelBatchRunner({
+            concurrency: 1,
+            onItemComplete,
+        });
+        await runner.run([10, 20, 30], async (item) => `done-${item}`);
+        expect(onItemComplete).toHaveBeenCalledTimes(3);
+        expect(onItemComplete).toHaveBeenCalledWith(10, "done-10", {
+            completed: 1,
+            total: 3,
+            inFlight: 0,
+        });
+        expect(onItemComplete).toHaveBeenCalledWith(20, "done-20", {
+            completed: 2,
+            total: 3,
+            inFlight: 0,
+        });
+        expect(onItemComplete).toHaveBeenCalledWith(30, "done-30", {
+            completed: 3,
+            total: 3,
+            inFlight: 0,
+        });
+    });
+    it("calls onItemError for failed items", async () => {
+        const onItemError = vi.fn();
+        const runner = new ParallelBatchRunner({
+            concurrency: 5,
+            onItemError,
+        });
+        await runner.run(["a", "b"], async (item) => {
+            if (item === "b")
+                throw new Error("boom");
+            return item;
+        });
+        expect(onItemError).toHaveBeenCalledTimes(1);
+        expect(onItemError).toHaveBeenCalledWith("b", expect.objectContaining({ message: "boom" }), expect.objectContaining({ total: 2 }));
+    });
+    it("does not call onItemComplete for failed items", async () => {
+        const onItemComplete = vi.fn();
+        const runner = new ParallelBatchRunner({
+            concurrency: 1,
+            onItemComplete,
+        });
+        await runner.run([1, 2], async (item) => {
+            if (item === 2)
+                throw new Error("fail");
+            return `ok-${item}`;
+        });
+        expect(onItemComplete).toHaveBeenCalledTimes(1);
+        expect(onItemComplete).toHaveBeenCalledWith(1, "ok-1", expect.any(Object));
+    });
+    it("respects abort signal and stops processing new items", async () => {
+        const controller = new AbortController();
+        const processedItems = [];
+        const runner = new ParallelBatchRunner({
+            concurrency: 1,
+            signal: controller.signal,
+        });
+        const results = await runner.run([1, 2, 3, 4, 5], async (item) => {
+            processedItems.push(item);
+            await delay(30);
+            // Abort after item 2 completes
+            if (item === 2) {
+                controller.abort();
+            }
+            return item;
+        });
+        expect(results).toHaveLength(5);
+        // Items 1 and 2 should have been processed
+        expect(processedItems).toContain(1);
+        expect(processedItems).toContain(2);
+        // Some later items should have been skipped (result: null, no error)
+        const skipped = results.filter((r) => r.result === null && r.error === undefined);
+        expect(skipped.length).toBeGreaterThan(0);
+    });
+    it("reports correct progress counts", async () => {
+        const progressSnapshots = [];
+        const runner = new ParallelBatchRunner({
+            concurrency: 1,
+            onItemComplete: (_item, _result, progress) => {
+                progressSnapshots.push({ ...progress });
+            },
+        });
+        await runner.run([1, 2, 3], async (item) => item * 10);
+        expect(progressSnapshots).toEqual([
+            { completed: 1, total: 3, inFlight: 0 },
+            { completed: 2, total: 3, inFlight: 0 },
+            { completed: 3, total: 3, inFlight: 0 },
+        ]);
+    });
+    it("reports inFlight > 0 during parallel execution", async () => {
+        const maxInFlightSeen = [];
+        const runner = new ParallelBatchRunner({
+            concurrency: 3,
+            onItemComplete: (_item, _result, progress) => {
+                maxInFlightSeen.push(progress.inFlight);
+            },
+        });
+        await runner.run([1, 2, 3, 4, 5, 6], async (item) => {
+            await delay(50);
+            return item;
+        });
+        // With concurrency 3 and 6 items, some completions should see
+        // other items still in flight
+        const hadInFlight = maxInFlightSeen.some((n) => n > 0);
+        expect(hadInFlight).toBe(true);
+    });
+    it("returns empty results for empty input", async () => {
+        const runner = new ParallelBatchRunner({
+            concurrency: 5,
+        });
+        const results = await runner.run([], async (item) => `${item}`);
+        expect(results).toEqual([]);
+    });
+    it("returns null result for failed items", async () => {
+        const runner = new ParallelBatchRunner({
+            concurrency: 5,
+        });
+        const results = await runner.run([1, 2, 3], async (item) => {
+            if (item === 2)
+                throw new Error("broken");
+            return item * 2;
+        });
+        expect(results[0].result).toBe(2);
+        expect(results[1].result).toBeNull();
+        expect(results[1].error).toBeDefined();
+        expect(results[1].error.message).toBe("broken");
+        expect(results[2].result).toBe(6);
+    });
+    it("wraps non-Error throws into Error objects", async () => {
+        const runner = new ParallelBatchRunner({
+            concurrency: 1,
+        });
+        const results = await runner.run([1], async () => {
+            throw "string error";
+        });
+        expect(results[0].result).toBeNull();
+        expect(results[0].error).toBeInstanceOf(Error);
+        expect(results[0].error.message).toBe("string error");
+    });
+});
+//# sourceMappingURL=batch-runner.test.js.map

package/dist/__tests__/batch-runner.test.js.map

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

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

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

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

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

package/dist/__tests__/cache.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { InMemoryCache } from "../cache/in-memory.js";
+describe("InMemoryCache", () => {
+    let cache;
+    beforeEach(() => {
+        cache = new InMemoryCache();
+    });
+    it("returns null for missing key", async () => {
+        const result = await cache.get("nonexistent");
+        expect(result).toBeNull();
+    });
+    it("set/get roundtrip works", async () => {
+        await cache.set("key1", "value1");
+        const result = await cache.get("key1");
+        expect(result).toBe("value1");
+    });
+    it("delete removes entry", async () => {
+        await cache.set("key1", "value1");
+        await cache.delete("key1");
+        const result = await cache.get("key1");
+        expect(result).toBeNull();
+    });
+    describe("TTL expiration", () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it("returns value before TTL expires", async () => {
+            await cache.set("key1", "value1", 60);
+            vi.advanceTimersByTime(59_000);
+            const result = await cache.get("key1");
+            expect(result).toBe("value1");
+        });
+        it("returns null after TTL expires", async () => {
+            await cache.set("key1", "value1", 60);
+            vi.advanceTimersByTime(61_000);
+            const result = await cache.get("key1");
+            expect(result).toBeNull();
+        });
+        it("evicts expired entry on get", async () => {
+            await cache.set("key1", "value1", 1);
+            expect(cache.size).toBe(1);
+            vi.advanceTimersByTime(2_000);
+            await cache.get("key1");
+            expect(cache.size).toBe(0);
+        });
+    });
+    it("no TTL means no expiration", async () => {
+        vi.useFakeTimers();
+        await cache.set("key1", "value1");
+        vi.advanceTimersByTime(1_000_000_000);
+        const result = await cache.get("key1");
+        expect(result).toBe("value1");
+        vi.useRealTimers();
+    });
+    it("overwrites existing key", async () => {
+        await cache.set("key1", "original");
+        await cache.set("key1", "updated");
+        const result = await cache.get("key1");
+        expect(result).toBe("updated");
+    });
+    it("size property reflects entry count", async () => {
+        expect(cache.size).toBe(0);
+        await cache.set("a", "1");
+        expect(cache.size).toBe(1);
+        await cache.set("b", "2");
+        expect(cache.size).toBe(2);
+        await cache.delete("a");
+        expect(cache.size).toBe(1);
+    });
+    it("clear removes all entries", async () => {
+        await cache.set("a", "1");
+        await cache.set("b", "2");
+        await cache.set("c", "3");
+        expect(cache.size).toBe(3);
+        cache.clear();
+        expect(cache.size).toBe(0);
+        expect(await cache.get("a")).toBeNull();
+        expect(await cache.get("b")).toBeNull();
+        expect(await cache.get("c")).toBeNull();
+    });
+    describe("maxSize eviction", () => {
+        it("evicts oldest entry when maxSize exceeded", async () => {
+            const bounded = new InMemoryCache({ maxSize: 2 });
+            await bounded.set("a", "1");
+            await bounded.set("b", "2");
+            await bounded.set("c", "3"); // should evict "a"
+            expect(bounded.size).toBe(2);
+            expect(await bounded.get("a")).toBeNull();
+            expect(await bounded.get("b")).toBe("2");
+            expect(await bounded.get("c")).toBe("3");
+        });
+        it("overwriting existing key does not trigger eviction", async () => {
+            const bounded = new InMemoryCache({ maxSize: 2 });
+            await bounded.set("a", "1");
+            await bounded.set("b", "2");
+            await bounded.set("a", "updated"); // overwrite, not new entry
+            expect(bounded.size).toBe(2);
+            expect(await bounded.get("a")).toBe("updated");
+            expect(await bounded.get("b")).toBe("2");
+        });
+        it("evicts in FIFO order", async () => {
+            const bounded = new InMemoryCache({ maxSize: 3 });
+            await bounded.set("a", "1");
+            await bounded.set("b", "2");
+            await bounded.set("c", "3");
+            await bounded.set("d", "4"); // evicts "a"
+            await bounded.set("e", "5"); // evicts "b"
+            expect(await bounded.get("a")).toBeNull();
+            expect(await bounded.get("b")).toBeNull();
+            expect(await bounded.get("c")).toBe("3");
+            expect(await bounded.get("d")).toBe("4");
+            expect(await bounded.get("e")).toBe("5");
+        });
+        it("unlimited by default", async () => {
+            const unlimited = new InMemoryCache();
+            for (let i = 0; i < 100; i++) {
+                await unlimited.set(`key-${i}`, `value-${i}`);
+            }
+            expect(unlimited.size).toBe(100);
+            expect(await unlimited.get("key-0")).toBe("value-0");
+        });
+    });
+});
+//# sourceMappingURL=cache.test.js.map

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

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

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

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

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

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

package/dist/__tests__/confidence.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect } from "vitest";
+import { calculateConfidence } from "../confidence.js";
+describe("calculateConfidence", () => {
+    const requiredKeywords = ["died", "death", "passed away"];
+    const bonusKeywords = ["cancer", "heart attack", "accident", "overdose", "suicide"];
+    it("returns 0 for empty text", () => {
+        expect(calculateConfidence("", requiredKeywords)).toBe(0);
+    });
+    it("returns 0 for null-ish text", () => {
+        expect(calculateConfidence("", requiredKeywords)).toBe(0);
+    });
+    it("returns 0 when no required keywords found", () => {
+        const text = "John Wayne starred in many Western films throughout his career.";
+        expect(calculateConfidence(text, requiredKeywords)).toBe(0);
+    });
+    it("returns 0.5 when required keyword found but no bonus keywords defined", () => {
+        const text = "The actor died in 1979 at his home.";
+        expect(calculateConfidence(text, requiredKeywords)).toBe(0.5);
+    });
+    it("returns 0.5 when required keyword found but no bonus keywords match", () => {
+        const text = "The actor died in 1979 at his home.";
+        expect(calculateConfidence(text, requiredKeywords, bonusKeywords)).toBe(0.5);
+    });
+    it("adds bonus proportional to matching bonus keywords", () => {
+        const text = "The actor died of cancer after a heart attack.";
+        // 2 out of 5 bonus keywords match
+        const result = calculateConfidence(text, requiredKeywords, bonusKeywords);
+        expect(result).toBeCloseTo(0.5 + 0.5 * (2 / 5));
+    });
+    it("returns 1.0 when all bonus keywords match", () => {
+        const text = "The actor died of cancer after a heart attack in an accident involving an overdose, ruled a suicide.";
+        const result = calculateConfidence(text, requiredKeywords, bonusKeywords);
+        expect(result).toBe(1.0);
+    });
+    it("caps at 1.0", () => {
+        // Even with all matches, should never exceed 1.0
+        const text = "died death passed away cancer heart attack accident overdose suicide";
+        const result = calculateConfidence(text, requiredKeywords, bonusKeywords);
+        expect(result).toBeLessThanOrEqual(1.0);
+    });
+    it("is case insensitive for required keywords", () => {
+        const text = "The actor DIED in 1979.";
+        expect(calculateConfidence(text, requiredKeywords)).toBe(0.5);
+    });
+    it("is case insensitive for bonus keywords", () => {
+        const text = "The actor died of CANCER.";
+        const result = calculateConfidence(text, requiredKeywords, bonusKeywords);
+        expect(result).toBeGreaterThan(0.5);
+    });
+    it("multiple required keywords - any one is sufficient", () => {
+        const textDied = "He died in 1979.";
+        const textDeath = "His death was unexpected.";
+        const textPassedAway = "She passed away peacefully.";
+        expect(calculateConfidence(textDied, requiredKeywords)).toBe(0.5);
+        expect(calculateConfidence(textDeath, requiredKeywords)).toBe(0.5);
+        expect(calculateConfidence(textPassedAway, requiredKeywords)).toBe(0.5);
+    });
+    it("works with multi-word keywords", () => {
+        const text = "The celebrity passed away after a long illness.";
+        const required = ["passed away", "died"];
+        expect(calculateConfidence(text, required)).toBe(0.5);
+    });
+    it("works with single required keyword", () => {
+        const text = "The obituary mentioned many details.";
+        const required = ["obituary"];
+        expect(calculateConfidence(text, required)).toBe(0.5);
+    });
+    it("works with biography-style keywords", () => {
+        const required = ["childhood", "family", "early life", "grew up"];
+        const bonus = ["parents", "siblings", "school", "education"];
+        const text = "During her childhood, her parents sent her to a boarding school.";
+        const result = calculateConfidence(text, required, bonus);
+        // 1 required match ("childhood") + 2 bonus ("parents", "school") out of 4
+        expect(result).toBeCloseTo(0.5 + 0.5 * (2 / 4));
+    });
+    it("returns 0 with empty required keywords list", () => {
+        const text = "Some text with words.";
+        expect(calculateConfidence(text, [])).toBe(0);
+    });
+});
+//# sourceMappingURL=confidence.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.test.js","sourceRoot":"","sources":["../../src/__tests__/confidence.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACzD,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IAEnF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,iEAAiE,CAAA;QAC9E,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,IAAI,GAAG,qCAAqC,CAAA;QAClD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,IAAI,GAAG,qCAAqC,CAAA;QAClD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,IAAI,GAAG,gDAAgD,CAAA;QAC7D,kCAAkC;QAClC,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GACR,sGAAsG,CAAA;QACxG,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACrB,iDAAiD;QACjD,MAAM,IAAI,GAAG,sEAAsE,CAAA;QACnF,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,yBAAyB,CAAA;QACtC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,2BAA2B,CAAA;QACxC,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,kBAAkB,CAAA;QACnC,MAAM,SAAS,GAAG,2BAA2B,CAAA;QAC7C,MAAM,cAAc,GAAG,6BAA6B,CAAA;QAEpD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClE,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,iDAAiD,CAAA;QAC9D,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG,sCAAsC,CAAA;QACnD,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,CAAA;QAC7B,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;QACjE,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;QAE5D,MAAM,IAAI,GAAG,kEAAkE,CAAA;QAC/E,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;QACzD,0EAA0E;QAC1E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,uBAAuB,CAAA;QACpC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/cost-tracker.test.d.ts

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

package/dist/__tests__/cost-tracker.test.d.ts.map

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

package/dist/__tests__/cost-tracker.test.js

@@ -0,0 +1,149 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { BatchCostTracker } from "../cost-tracker.js";
+describe("BatchCostTracker", () => {
+    describe("with no limits", () => {
+        let tracker;
+        beforeEach(() => {
+            tracker = new BatchCostTracker();
+        });
+        it("starts with zero total cost", () => {
+            expect(tracker.getTotalCost()).toBe(0);
+        });
+        it("addSubjectCost accumulates correctly", () => {
+            tracker.addSubjectCost("actor-1", 0.05);
+            tracker.addSubjectCost("actor-1", 0.1);
+            expect(tracker.getTotalCost()).toBeCloseTo(0.15);
+        });
+        it("tracks per-subject costs independently", () => {
+            tracker.addSubjectCost("actor-1", 0.05);
+            tracker.addSubjectCost("actor-2", 0.2);
+            tracker.addSubjectCost("actor-1", 0.1);
+            expect(tracker.getSubjectCost("actor-1")).toBeCloseTo(0.15);
+            expect(tracker.getSubjectCost("actor-2")).toBeCloseTo(0.2);
+            expect(tracker.getTotalCost()).toBeCloseTo(0.35);
+        });
+        it("never exceeds when no limits are set", () => {
+            const exceeded = tracker.addSubjectCost("actor-1", 1000);
+            expect(exceeded).toBe(false);
+            expect(tracker.isTotalLimitExceeded()).toBe(false);
+            expect(tracker.isSubjectLimitExceeded("actor-1")).toBe(false);
+        });
+        it("returns zero for unknown subject", () => {
+            expect(tracker.getSubjectCost("unknown")).toBe(0);
+        });
+    });
+    describe("with total limit", () => {
+        let tracker;
+        beforeEach(() => {
+            tracker = new BatchCostTracker({ maxTotalCost: 1.0 });
+        });
+        it("isTotalLimitExceeded returns false below limit", () => {
+            tracker.addSubjectCost("actor-1", 0.5);
+            expect(tracker.isTotalLimitExceeded()).toBe(false);
+        });
+        it("isTotalLimitExceeded returns true when limit hit", () => {
+            tracker.addSubjectCost("actor-1", 0.6);
+            tracker.addSubjectCost("actor-2", 0.4);
+            expect(tracker.isTotalLimitExceeded()).toBe(true);
+        });
+        it("isTotalLimitExceeded returns true when limit exceeded", () => {
+            tracker.addSubjectCost("actor-1", 1.5);
+            expect(tracker.isTotalLimitExceeded()).toBe(true);
+        });
+        it("addSubjectCost returns true when total limit exceeded", () => {
+            tracker.addSubjectCost("actor-1", 0.6);
+            const exceeded = tracker.addSubjectCost("actor-2", 0.5);
+            expect(exceeded).toBe(true);
+        });
+    });
+    describe("with per-subject limit", () => {
+        let tracker;
+        beforeEach(() => {
+            tracker = new BatchCostTracker({ maxCostPerSubject: 0.5 });
+        });
+        it("isSubjectLimitExceeded returns false below limit", () => {
+            tracker.addSubjectCost("actor-1", 0.25);
+            expect(tracker.isSubjectLimitExceeded("actor-1")).toBe(false);
+        });
+        it("isSubjectLimitExceeded returns true when per-subject limit hit", () => {
+            tracker.addSubjectCost("actor-1", 0.3);
+            tracker.addSubjectCost("actor-1", 0.2);
+            expect(tracker.isSubjectLimitExceeded("actor-1")).toBe(true);
+        });
+        it("does not affect other subjects", () => {
+            tracker.addSubjectCost("actor-1", 0.6);
+            expect(tracker.isSubjectLimitExceeded("actor-1")).toBe(true);
+            expect(tracker.isSubjectLimitExceeded("actor-2")).toBe(false);
+        });
+        it("addSubjectCost returns true when per-subject limit exceeded", () => {
+            const first = tracker.addSubjectCost("actor-1", 0.25);
+            expect(first).toBe(false);
+            const second = tracker.addSubjectCost("actor-1", 0.3);
+            expect(second).toBe(true);
+        });
+    });
+    describe("source cost tracking", () => {
+        let tracker;
+        beforeEach(() => {
+            tracker = new BatchCostTracker();
+        });
+        it("addSourceCost tracks by source type", () => {
+            tracker.addSourceCost("wikipedia", 0.01);
+            tracker.addSourceCost("claude", 0.05);
+            tracker.addSourceCost("wikipedia", 0.02);
+            const breakdown = tracker.getCostBySource();
+            expect(breakdown["wikipedia"]).toBeCloseTo(0.03);
+            expect(breakdown["claude"]).toBeCloseTo(0.05);
+        });
+        it("getCostBySource returns a copy", () => {
+            tracker.addSourceCost("wikipedia", 0.01);
+            const first = tracker.getCostBySource();
+            tracker.addSourceCost("wikipedia", 0.05);
+            const second = tracker.getCostBySource();
+            // first snapshot should not be mutated
+            expect(first["wikipedia"]).toBeCloseTo(0.01);
+            expect(second["wikipedia"]).toBeCloseTo(0.06);
+        });
+        it("getCostBySource returns empty object when no costs added", () => {
+            expect(tracker.getCostBySource()).toEqual({});
+        });
+    });
+    describe("reset", () => {
+        it("clears all state", () => {
+            const tracker = new BatchCostTracker({
+                maxTotalCost: 10,
+                maxCostPerSubject: 5,
+            });
+            tracker.addSubjectCost("actor-1", 3.0);
+            tracker.addSubjectCost("actor-2", 2.0);
+            tracker.addSourceCost("wikipedia", 1.0);
+            tracker.addSourceCost("claude", 4.0);
+            tracker.reset();
+            expect(tracker.getTotalCost()).toBe(0);
+            expect(tracker.getSubjectCost("actor-1")).toBe(0);
+            expect(tracker.getSubjectCost("actor-2")).toBe(0);
+            expect(tracker.getCostBySource()).toEqual({});
+            expect(tracker.isTotalLimitExceeded()).toBe(false);
+            expect(tracker.isSubjectLimitExceeded("actor-1")).toBe(false);
+        });
+        it("allows tracking to resume after reset", () => {
+            const tracker = new BatchCostTracker({ maxTotalCost: 1.0 });
+            tracker.addSubjectCost("actor-1", 0.9);
+            expect(tracker.isTotalLimitExceeded()).toBe(false);
+            tracker.reset();
+            tracker.addSubjectCost("actor-1", 0.5);
+            expect(tracker.getTotalCost()).toBeCloseTo(0.5);
+            expect(tracker.isTotalLimitExceeded()).toBe(false);
+        });
+    });
+    describe("numeric subject IDs", () => {
+        it("works with number subject IDs", () => {
+            const tracker = new BatchCostTracker({ maxCostPerSubject: 1.0 });
+            tracker.addSubjectCost(42, 0.3);
+            tracker.addSubjectCost(42, 0.4);
+            expect(tracker.getSubjectCost(42)).toBeCloseTo(0.7);
+            expect(tracker.isSubjectLimitExceeded(42)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=cost-tracker.test.js.map