@debriefer/ai 1.0.0

package/dist/__tests__/ai-defaults.test.d.ts

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

package/dist/__tests__/ai-defaults.test.d.ts.map

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

package/dist/__tests__/ai-defaults.test.js

@@ -0,0 +1,369 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { createAISectionFilter } from "../section-filter.js";
+import { createAIConfidenceScorer } from "../confidence.js";
+import { createAILinkSelector } from "../link-selector.js";
+import { createAIPersonValidator } from "../person-validator.js";
+import { createAIDefaults } from "../index.js";
+// ============================================================================
+// Mock AI Client
+// ============================================================================
+function mockClient(response) {
+    return {
+        complete: vi.fn().mockResolvedValue({
+            text: response,
+            usage: { inputTokens: 100, outputTokens: 50 },
+        }),
+    };
+}
+function failingClient(error) {
+    return {
+        complete: vi.fn().mockRejectedValue(new Error(error)),
+    };
+}
+function mockTelemetry() {
+    return {
+        recordEvent: vi.fn(),
+        startSpan: vi.fn().mockReturnValue({ end: vi.fn(), setAttributes: vi.fn() }),
+        recordError: vi.fn(),
+    };
+}
+const testSubject = {
+    id: 1,
+    name: "Marie Curie",
+    context: { birthYear: "1867", deathday: "1934-07-04", occupation: "physicist" },
+};
+const testSections = [
+    { index: 0, title: "Introduction", depth: 0 },
+    { index: 1, title: "Early life", depth: 0 },
+    { index: 2, title: "Scientific career", depth: 0 },
+    { index: 3, title: "Nobel Prizes", depth: 0 },
+    { index: 4, title: "Death", depth: 0 },
+    { index: 5, title: "Legacy", depth: 0 },
+];
+const testSearchResults = [
+    { url: "https://example.com/a", title: "Result A", snippet: "About Marie" },
+    { url: "https://example.com/b", title: "Result B", snippet: "Unrelated page" },
+    { url: "https://example.com/c", title: "Result C", snippet: "Curie biography" },
+];
+// ============================================================================
+// Section Filter
+// ============================================================================
+describe("createAISectionFilter", () => {
+    it("returns sections selected by AI", async () => {
+        const client = mockClient("[0, 3, 4]");
+        const filter = createAISectionFilter({
+            client,
+            researchGoal: "Find death info",
+            fallbackToHeuristics: true,
+        });
+        const result = await filter(testSections, "Full article text...");
+        expect(result).toHaveLength(3);
+        expect(result.map((s) => s.index)).toEqual([0, 3, 4]);
+        expect(client.complete).toHaveBeenCalledOnce();
+    });
+    it("falls back to all sections on AI failure when fallback enabled", async () => {
+        const client = failingClient("API error");
+        const telemetry = mockTelemetry();
+        const filter = createAISectionFilter({
+            client,
+            fallbackToHeuristics: true,
+            telemetry,
+        });
+        const result = await filter(testSections, "Full article text...");
+        expect(result).toEqual(testSections);
+        expect(telemetry.recordEvent).toHaveBeenCalledWith("ai.call_failed", expect.objectContaining({
+            callback: "sectionFilter",
+            fallback: true,
+        }));
+    });
+    it("returns empty on AI failure when fallback disabled", async () => {
+        const client = failingClient("API error");
+        const filter = createAISectionFilter({
+            client,
+            fallbackToHeuristics: false,
+        });
+        const result = await filter(testSections, "Full article text...");
+        expect(result).toEqual([]);
+    });
+    it("returns all sections when AI returns invalid JSON", async () => {
+        const client = mockClient("not valid json");
+        const filter = createAISectionFilter({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await filter(testSections, "Full article text...");
+        expect(result).toEqual(testSections);
+    });
+    it("returns all sections when AI returns empty array", async () => {
+        const client = mockClient("[]");
+        const filter = createAISectionFilter({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await filter(testSections, "Full article text...");
+        expect(result).toEqual(testSections);
+    });
+    it("returns empty array for empty input", async () => {
+        const client = mockClient("[0]");
+        const filter = createAISectionFilter({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await filter([], "");
+        expect(result).toEqual([]);
+        expect(client.complete).not.toHaveBeenCalled();
+    });
+});
+// ============================================================================
+// Confidence Scorer
+// ============================================================================
+describe("createAIConfidenceScorer", () => {
+    it("returns AI-assessed confidence score", async () => {
+        const client = mockClient("0.85");
+        const scorer = createAIConfidenceScorer({
+            client,
+            researchGoal: "Find death info",
+            fallbackToHeuristics: true,
+        });
+        const result = await scorer("Marie Curie died in 1934.", testSubject);
+        expect(result).toBe(0.85);
+        expect(client.complete).toHaveBeenCalledOnce();
+    });
+    it("returns 0 for empty text", async () => {
+        const client = mockClient("0.85");
+        const scorer = createAIConfidenceScorer({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await scorer("", testSubject);
+        expect(result).toBe(0);
+        expect(client.complete).not.toHaveBeenCalled();
+    });
+    it("falls back to 0.5 on AI failure when fallback enabled", async () => {
+        const client = failingClient("Rate limited");
+        const telemetry = mockTelemetry();
+        const scorer = createAIConfidenceScorer({
+            client,
+            fallbackToHeuristics: true,
+            telemetry,
+        });
+        const result = await scorer("Some text", testSubject);
+        expect(result).toBe(0.5);
+        expect(telemetry.recordEvent).toHaveBeenCalledWith("ai.call_failed", expect.objectContaining({
+            callback: "confidenceScorer",
+        }));
+    });
+    it("returns 0 on AI failure when fallback disabled", async () => {
+        const client = failingClient("Rate limited");
+        const scorer = createAIConfidenceScorer({
+            client,
+            fallbackToHeuristics: false,
+        });
+        const result = await scorer("Some text", testSubject);
+        expect(result).toBe(0);
+    });
+    it("falls back on invalid score (out of range)", async () => {
+        const client = mockClient("1.5");
+        const scorer = createAIConfidenceScorer({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await scorer("Some text", testSubject);
+        expect(result).toBe(0.5); // fallback
+    });
+    it("falls back on non-numeric response", async () => {
+        const client = mockClient("very relevant");
+        const scorer = createAIConfidenceScorer({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await scorer("Some text", testSubject);
+        expect(result).toBe(0.5); // fallback
+    });
+});
+// ============================================================================
+// Link Selector
+// ============================================================================
+describe("createAILinkSelector", () => {
+    it("reorders results based on AI ranking", async () => {
+        const client = mockClient("[2, 0, 1]");
+        const selector = createAILinkSelector({
+            client,
+            researchGoal: "Find death info",
+            fallbackToHeuristics: true,
+        });
+        const result = await selector(testSearchResults, testSubject);
+        expect(result).toHaveLength(3);
+        expect(result[0].url).toBe("https://example.com/c");
+        expect(result[1].url).toBe("https://example.com/a");
+        expect(result[2].url).toBe("https://example.com/b");
+    });
+    it("returns empty array for empty input", async () => {
+        const client = mockClient("[]");
+        const selector = createAILinkSelector({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await selector([], testSubject);
+        expect(result).toEqual([]);
+        expect(client.complete).not.toHaveBeenCalled();
+    });
+    it("falls back to original order on AI failure when fallback enabled", async () => {
+        const client = failingClient("API error");
+        const selector = createAILinkSelector({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await selector(testSearchResults, testSubject);
+        expect(result).toEqual(testSearchResults);
+    });
+    it("returns empty on AI failure when fallback disabled", async () => {
+        const client = failingClient("API error");
+        const selector = createAILinkSelector({
+            client,
+            fallbackToHeuristics: false,
+        });
+        const result = await selector(testSearchResults, testSubject);
+        expect(result).toEqual([]);
+    });
+    it("appends unmentioned results at the end", async () => {
+        // AI only mentions index 2, remaining should be appended
+        const client = mockClient("[2]");
+        const selector = createAILinkSelector({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await selector(testSearchResults, testSubject);
+        expect(result).toHaveLength(3);
+        expect(result[0].url).toBe("https://example.com/c"); // AI picked
+        expect(result[1].url).toBe("https://example.com/a"); // appended
+        expect(result[2].url).toBe("https://example.com/b"); // appended
+    });
+    it("deduplicates repeated indices from AI", async () => {
+        const client = mockClient("[0, 0, 1, 1, 2]");
+        const selector = createAILinkSelector({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await selector(testSearchResults, testSubject);
+        expect(result).toHaveLength(3);
+    });
+});
+// ============================================================================
+// Person Validator
+// ============================================================================
+describe("createAIPersonValidator", () => {
+    it("returns true when AI confirms person match", async () => {
+        const client = mockClient("true");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await validator("Marie Curie was a physicist born in Warsaw.", testSubject);
+        expect(result).toBe(true);
+        expect(client.complete).toHaveBeenCalledOnce();
+    });
+    it("returns false when AI denies person match", async () => {
+        const client = mockClient("false");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await validator("Pierre Curie was born in Paris.", testSubject);
+        expect(result).toBe(false);
+    });
+    it("returns false for empty article text", async () => {
+        const client = mockClient("true");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await validator("", testSubject);
+        expect(result).toBe(false);
+        expect(client.complete).not.toHaveBeenCalled();
+    });
+    it("falls back to true on AI failure when fallback enabled", async () => {
+        const client = failingClient("Network error");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: true,
+        });
+        const result = await validator("Some article text", testSubject);
+        expect(result).toBe(true);
+    });
+    it("returns false on AI failure when fallback disabled", async () => {
+        const client = failingClient("Network error");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: false,
+        });
+        const result = await validator("Some article text", testSubject);
+        expect(result).toBe(false);
+    });
+    it("includes context hints in the prompt", async () => {
+        const client = mockClient("true");
+        const validator = createAIPersonValidator({
+            client,
+            fallbackToHeuristics: true,
+        });
+        await validator("Some text", testSubject);
+        const call = client.complete.mock.calls[0][0];
+        expect(call.user).toContain("Born: 1867");
+        expect(call.user).toContain("Died: 1934-07-04");
+        expect(call.user).toContain("Occupation: physicist");
+    });
+});
+// ============================================================================
+// createAIDefaults
+// ============================================================================
+describe("createAIDefaults", () => {
+    const originalEnv = process.env.ANTHROPIC_API_KEY;
+    beforeEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.ANTHROPIC_API_KEY;
+        }
+        else {
+            process.env.ANTHROPIC_API_KEY = originalEnv;
+        }
+    });
+    it("creates all four callbacks with a custom client", () => {
+        const client = mockClient("test");
+        const ai = createAIDefaults({ client });
+        expect(ai.sectionFilter).toBeTypeOf("function");
+        expect(ai.confidenceScorer).toBeTypeOf("function");
+        expect(ai.linkSelector).toBeTypeOf("function");
+        expect(ai.personValidator).toBeTypeOf("function");
+        expect(ai.isAvailable).toBe(true);
+    });
+    it("reports unavailable when no API key and no custom client", () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        const telemetry = mockTelemetry();
+        const ai = createAIDefaults({ telemetry });
+        expect(ai.isAvailable).toBe(false);
+        expect(telemetry.recordEvent).toHaveBeenCalledWith("ai.unavailable", expect.objectContaining({ reason: expect.stringContaining("ANTHROPIC_API_KEY not set") }));
+    });
+    it("provides passthrough callbacks when unavailable", async () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        const ai = createAIDefaults();
+        const sections = await ai.sectionFilter(testSections, "text");
+        expect(sections).toEqual(testSections);
+        const confidence = await ai.confidenceScorer("text", testSubject);
+        expect(confidence).toBe(0.5);
+        const links = await ai.linkSelector(testSearchResults, testSubject);
+        expect(links).toEqual(testSearchResults);
+        const valid = await ai.personValidator("text", testSubject);
+        expect(valid).toBe(true);
+        vi.restoreAllMocks();
+    });
+    it("reports available when API key is set", () => {
+        process.env.ANTHROPIC_API_KEY = "test-key";
+        const ai = createAIDefaults();
+        expect(ai.isAvailable).toBe(true);
+    });
+    it("reports available when explicit apiKey provided", () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        const ai = createAIDefaults({ apiKey: "explicit-key" });
+        expect(ai.isAvailable).toBe(true);
+    });
+});
+//# sourceMappingURL=ai-defaults.test.js.map

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

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

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

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

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

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

package/dist/__tests__/synthesizer.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { ReliabilityTier } from "@debriefer/core";
+vi.mock("@anthropic-ai/sdk", () => {
+    return {
+        default: class MockAnthropic {
+            messages = {
+                create: vi.fn().mockResolvedValue({
+                    content: [{ type: "text", text: '```json\n{"result": "test"}\n```' }],
+                    usage: { input_tokens: 1000, output_tokens: 500 },
+                }),
+            };
+            constructor() { }
+        },
+    };
+});
+import { ClaudeSynthesizer } from "../synthesizer.js";
+function makeFinding(overrides = {}) {
+    return {
+        text: "Some finding text",
+        confidence: 0.8,
+        costUsd: 0,
+        sourceType: "wikipedia",
+        sourceName: "Wikipedia",
+        reliabilityTier: ReliabilityTier.SECONDARY_COMPILATION,
+        reliabilityScore: 0.85,
+        ...overrides,
+    };
+}
+// Identity parser for tests where we just want the raw JSON back
+const identityParser = (raw) => raw;
+const testSubject = {
+    id: 1,
+    name: "John Wayne",
+    context: { deathday: "1979-06-11" },
+};
+describe("ClaudeSynthesizer", () => {
+    let promptBuilderSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        promptBuilderSpy = vi.fn().mockReturnValue({
+            system: "You are a test system",
+            user: "Test user prompt",
+        });
+    });
+    it("calls Anthropic with correct model and max_tokens", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+            defaultModel: "claude-haiku-3-20250101",
+            defaultMaxTokens: 2048,
+        });
+        await synthesizer.synthesize(testSubject, [makeFinding()]);
+        const client = synthesizer.client;
+        expect(client.messages.create).toHaveBeenCalledWith(expect.objectContaining({
+            model: "claude-haiku-3-20250101",
+            max_tokens: 2048,
+            system: "You are a test system",
+            messages: [{ role: "user", content: "Test user prompt" }],
+        }));
+    });
+    it("sorts findings by reliability score before passing to promptBuilder", async () => {
+        const findings = [
+            makeFinding({
+                sourceType: "find_a_grave",
+                reliabilityScore: 0.35,
+                text: "Low reliability",
+            }),
+            makeFinding({
+                sourceType: "ap_news",
+                reliabilityScore: 0.95,
+                text: "High reliability",
+            }),
+            makeFinding({
+                sourceType: "wikipedia",
+                reliabilityScore: 0.85,
+                text: "Medium reliability",
+            }),
+        ];
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+        });
+        await synthesizer.synthesize(testSubject, findings);
+        const passedFindings = promptBuilderSpy.mock.calls[0][1];
+        expect(passedFindings[0].reliabilityScore).toBe(0.95);
+        expect(passedFindings[1].reliabilityScore).toBe(0.85);
+        expect(passedFindings[2].reliabilityScore).toBe(0.35);
+    });
+    it("parses JSON response through responseParser", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+        });
+        const result = await synthesizer.synthesize(testSubject, [makeFinding()]);
+        expect(result.data).toEqual({ result: "test" });
+    });
+    it("calculates cost from token counts", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+            // Default model is Sonnet: input $3/M, output $15/M
+        });
+        const result = await synthesizer.synthesize(testSubject, [makeFinding()]);
+        // 1000 input tokens * $3/M + 500 output tokens * $15/M
+        const expectedCost = (1000 * 3) / 1_000_000 + (500 * 15) / 1_000_000;
+        expect(result.costUsd).toBeCloseTo(expectedCost);
+        expect(result.inputTokens).toBe(1000);
+        expect(result.outputTokens).toBe(500);
+    });
+    it("uses custom responseParser for validation", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: (raw) => {
+                const obj = raw;
+                return { transformed: `parsed-${obj.result}` };
+            },
+        });
+        const result = await synthesizer.synthesize(testSubject, [makeFinding()]);
+        expect(result.data).toEqual({ transformed: "parsed-test" });
+    });
+    it("uses default model when none specified", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+        });
+        await synthesizer.synthesize(testSubject, [makeFinding()]);
+        const client = synthesizer.client;
+        expect(client.messages.create).toHaveBeenCalledWith(expect.objectContaining({
+            model: "claude-sonnet-4-20250514",
+        }));
+    });
+    it("uses options.model override", async () => {
+        const synthesizer = new ClaudeSynthesizer({
+            promptBuilder: promptBuilderSpy,
+            responseParser: identityParser,
+            defaultModel: "claude-sonnet-4-20250514",
+        });
+        await synthesizer.synthesize(testSubject, [makeFinding()], {
+            model: "claude-opus-4-5-20251101",
+        });
+        const client = synthesizer.client;
+        expect(client.messages.create).toHaveBeenCalledWith(expect.objectContaining({
+            model: "claude-opus-4-5-20251101",
+        }));
+    });
+});
+//# sourceMappingURL=synthesizer.test.js.map

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

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

package/dist/ai-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AIClient abstraction for making AI inference calls.
+ *
+ * The default implementation uses Anthropic's Claude API via @anthropic-ai/sdk.
+ * Consumers can provide their own AIClient for non-Anthropic providers (OpenAI,
+ * Gemini, local models, etc.).
+ */
+/**
+ * A single message completion request.
+ */
+export interface AICompletionRequest {
+    /** System prompt providing context and instructions */
+    system: string;
+    /** User message to respond to */
+    user: string;
+    /** Maximum tokens in the response */
+    maxTokens?: number;
+}
+/**
+ * Response from an AI completion call.
+ */
+export interface AICompletionResponse {
+    /** The text response from the model */
+    text: string;
+    /** Token usage for cost tracking */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Interface for AI inference providers. Abstracts the API call so
+ * consumers can swap Claude for OpenAI, Gemini, local models, etc.
+ */
+export interface AIClient {
+    /** Make a completion call and return the text response. */
+    complete(request: AICompletionRequest): Promise<AICompletionResponse>;
+}
+/**
+ * Default AIClient implementation using Anthropic's Claude API.
+ * Uses Haiku 4.5 by default for cost-effective AI callbacks.
+ */
+export declare class HaikuClient implements AIClient {
+    private client;
+    private model;
+    constructor(options?: {
+        apiKey?: string;
+        model?: string;
+    });
+    complete(request: AICompletionRequest): Promise<AICompletionResponse>;
+}
+//# sourceMappingURL=ai-client.d.ts.map

package/dist/ai-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../src/ai-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACtE;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IAC1C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,KAAK,CAAQ;gBAET,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAKvD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAqB5E"}

package/dist/ai-client.js

@@ -0,0 +1,40 @@
+/**
+ * AIClient abstraction for making AI inference calls.
+ *
+ * The default implementation uses Anthropic's Claude API via @anthropic-ai/sdk.
+ * Consumers can provide their own AIClient for non-Anthropic providers (OpenAI,
+ * Gemini, local models, etc.).
+ */
+import Anthropic from "@anthropic-ai/sdk";
+/**
+ * Default AIClient implementation using Anthropic's Claude API.
+ * Uses Haiku 4.5 by default for cost-effective AI callbacks.
+ */
+export class HaikuClient {
+    client;
+    model;
+    constructor(options = {}) {
+        this.client = new Anthropic({ apiKey: options.apiKey });
+        this.model = options.model ?? "claude-haiku-4-5-20251001";
+    }
+    async complete(request) {
+        const response = await this.client.messages.create({
+            model: this.model,
+            max_tokens: request.maxTokens ?? 1024,
+            system: request.system,
+            messages: [{ role: "user", content: request.user }],
+        });
+        const text = response.content
+            .filter((block) => block.type === "text")
+            .map((block) => block.text)
+            .join("");
+        return {
+            text,
+            usage: {
+                inputTokens: response.usage.input_tokens,
+                outputTokens: response.usage.output_tokens,
+            },
+        };
+    }
+}
+//# sourceMappingURL=ai-client.js.map