@indigoai-us/cq 0.0.1

package/dist/providers/__tests__/providers.test.js

@@ -0,0 +1,195 @@
+import { describe, it, expect } from "vitest";
+import { createSearchProvider, createModelProvider, OpenAISearchProvider, ClaudeModelProvider, } from "../index.js";
+// ---------------------------------------------------------------------------
+// Mock providers — verify interface contracts without hitting real APIs
+// ---------------------------------------------------------------------------
+class MockSearchProvider {
+    name = "mock-search";
+    _lastCost = 0;
+    _results;
+    constructor(results) {
+        this._results = results ?? [
+            {
+                title: "Test Result 1",
+                url: "https://example.com/1",
+                snippet: "First test result snippet",
+            },
+            {
+                title: "Test Result 2",
+                url: "https://example.com/2",
+                snippet: "Second test result snippet",
+                content: "Full content of second result",
+            },
+        ];
+    }
+    async search(query, maxResults = 5) {
+        this._lastCost = 0.01;
+        return this._results.slice(0, maxResults);
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+}
+class MockModelProvider {
+    name = "mock-model";
+    _lastCost = 0;
+    async synthesize(question, searchResults) {
+        this._lastCost = 0.002;
+        return {
+            title: `Synthesis of: ${question}`,
+            category: "technology",
+            content: `Synthesised from ${searchResults.length} results.`,
+            tags: ["test", "mock"],
+            source: searchResults[0]?.url ?? "unknown",
+            confidence: 0.85,
+        };
+    }
+    async categorize(content, categories) {
+        this._lastCost = 0.001;
+        return categories[0];
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+}
+// ---------------------------------------------------------------------------
+// Interface contract tests (using mocks)
+// ---------------------------------------------------------------------------
+describe("SearchProvider interface contract", () => {
+    it("returns an array of WebSearchResult objects", async () => {
+        const provider = new MockSearchProvider();
+        const results = await provider.search("test query");
+        expect(Array.isArray(results)).toBe(true);
+        expect(results.length).toBeGreaterThan(0);
+        for (const r of results) {
+            expect(r).toHaveProperty("title");
+            expect(r).toHaveProperty("url");
+            expect(r).toHaveProperty("snippet");
+            expect(typeof r.title).toBe("string");
+            expect(typeof r.url).toBe("string");
+            expect(typeof r.snippet).toBe("string");
+        }
+    });
+    it("respects maxResults parameter", async () => {
+        const provider = new MockSearchProvider();
+        const results = await provider.search("test query", 1);
+        expect(results.length).toBe(1);
+    });
+    it("optional content field is present when provided", async () => {
+        const provider = new MockSearchProvider();
+        const results = await provider.search("test query");
+        const withContent = results.find((r) => r.content !== undefined);
+        expect(withContent).toBeDefined();
+        expect(typeof withContent.content).toBe("string");
+    });
+    it("tracks cost per call", async () => {
+        const provider = new MockSearchProvider();
+        expect(provider.lastCallCostUsd()).toBe(0);
+        await provider.search("test");
+        expect(provider.lastCallCostUsd()).toBeGreaterThan(0);
+    });
+    it("has a name property", () => {
+        const provider = new MockSearchProvider();
+        expect(typeof provider.name).toBe("string");
+        expect(provider.name.length).toBeGreaterThan(0);
+    });
+});
+describe("ModelProvider interface contract", () => {
+    it("synthesize returns a SynthesisResult", async () => {
+        const provider = new MockModelProvider();
+        const searchResults = [
+            { title: "Test", url: "https://example.com", snippet: "A test result" },
+        ];
+        const result = await provider.synthesize("What is AI?", searchResults);
+        expect(result).toHaveProperty("title");
+        expect(result).toHaveProperty("category");
+        expect(result).toHaveProperty("content");
+        expect(result).toHaveProperty("tags");
+        expect(result).toHaveProperty("source");
+        expect(result).toHaveProperty("confidence");
+        expect(typeof result.title).toBe("string");
+        expect(typeof result.category).toBe("string");
+        expect(typeof result.content).toBe("string");
+        expect(Array.isArray(result.tags)).toBe(true);
+        expect(typeof result.source).toBe("string");
+        expect(typeof result.confidence).toBe("number");
+        expect(result.confidence).toBeGreaterThanOrEqual(0);
+        expect(result.confidence).toBeLessThanOrEqual(1);
+    });
+    it("categorize returns one of the provided categories", async () => {
+        const provider = new MockModelProvider();
+        const categories = ["science", "technology", "culture"];
+        const result = await provider.categorize("Some AI content", categories);
+        expect(categories).toContain(result);
+    });
+    it("tracks cost per call", async () => {
+        const provider = new MockModelProvider();
+        expect(provider.lastCallCostUsd()).toBe(0);
+        await provider.synthesize("test", []);
+        const synthCost = provider.lastCallCostUsd();
+        expect(synthCost).toBeGreaterThan(0);
+        await provider.categorize("test", ["a"]);
+        const catCost = provider.lastCallCostUsd();
+        expect(catCost).toBeGreaterThan(0);
+    });
+    it("has a name property", () => {
+        const provider = new MockModelProvider();
+        expect(typeof provider.name).toBe("string");
+        expect(provider.name.length).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Concrete provider instantiation tests
+// ---------------------------------------------------------------------------
+describe("OpenAISearchProvider", () => {
+    it("can be instantiated with an API key", () => {
+        const provider = new OpenAISearchProvider("test-key");
+        expect(provider.name).toBe("openai");
+        expect(provider.lastCallCostUsd()).toBe(0);
+    });
+});
+describe("ClaudeModelProvider", () => {
+    it("can be instantiated with an API key", () => {
+        const provider = new ClaudeModelProvider("test-key");
+        expect(provider.name).toBe("claude");
+        expect(provider.lastCallCostUsd()).toBe(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Factory function tests
+// ---------------------------------------------------------------------------
+describe("createSearchProvider", () => {
+    it("creates an OpenAI provider by default", () => {
+        const provider = createSearchProvider();
+        expect(provider.name).toBe("openai");
+    });
+    it("creates an OpenAI provider when explicitly named", () => {
+        const provider = createSearchProvider("openai");
+        expect(provider.name).toBe("openai");
+    });
+    it("is case-insensitive", () => {
+        const provider = createSearchProvider("OpenAI");
+        expect(provider.name).toBe("openai");
+    });
+    it("throws on unknown provider", () => {
+        expect(() => createSearchProvider("unknown")).toThrow(/Unknown search provider/);
+    });
+});
+describe("createModelProvider", () => {
+    it("creates a Claude provider by default", () => {
+        const provider = createModelProvider();
+        expect(provider.name).toBe("claude");
+    });
+    it("creates a Claude provider when explicitly named", () => {
+        const provider = createModelProvider("claude");
+        expect(provider.name).toBe("claude");
+    });
+    it("is case-insensitive", () => {
+        const provider = createModelProvider("Claude");
+        expect(provider.name).toBe("claude");
+    });
+    it("throws on unknown provider", () => {
+        expect(() => createModelProvider("unknown")).toThrow(/Unknown model provider/);
+    });
+});
+//# sourceMappingURL=providers.test.js.map

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

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

package/dist/providers/claude-model.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude Model Provider — uses Anthropic Messages API with claude-haiku for
+ * cost-efficient synthesis and categorisation.
+ */
+import type { ModelProvider, WebSearchResult, SynthesisResult } from "./types.js";
+export declare class ClaudeModelProvider implements ModelProvider {
+    readonly name = "claude";
+    private client;
+    private _lastCost;
+    constructor(apiKey?: string);
+    synthesize(question: string, searchResults: WebSearchResult[]): Promise<SynthesisResult>;
+    categorize(content: string, categories: string[]): Promise<string>;
+    lastCallCostUsd(): number;
+    private computeCost;
+    private parseSynthesisResponse;
+}
+//# sourceMappingURL=claude-model.d.ts.map

package/dist/providers/claude-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-model.d.ts","sourceRoot":"","sources":["../../src/providers/claude-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAWpB,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,CAAC,EAAE,MAAM;IAMrB,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,eAAe,CAAC;IAuCrB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxE,eAAe,IAAI,MAAM;IAQzB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,sBAAsB;CAkC/B"}

package/dist/providers/claude-model.js

@@ -0,0 +1,119 @@
+/**
+ * Claude Model Provider — uses Anthropic Messages API with claude-haiku for
+ * cost-efficient synthesis and categorisation.
+ */
+import Anthropic from "@anthropic-ai/sdk";
+// ---------------------------------------------------------------------------
+// Cost constants (claude-haiku-4-5-20251001)
+// ---------------------------------------------------------------------------
+const INPUT_COST_PER_TOKEN = 0.8 / 1_000_000; // $0.80 / 1M input tokens
+const OUTPUT_COST_PER_TOKEN = 4.0 / 1_000_000; // $4.00 / 1M output tokens
+const MODEL = "claude-haiku-4-5-20251001";
+export class ClaudeModelProvider {
+    name = "claude";
+    client;
+    _lastCost = 0;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    async synthesize(question, searchResults) {
+        const sourceSummary = searchResults
+            .map((r, i) => `[${i + 1}] ${r.title}\n    URL: ${r.url}\n    ${r.snippet}${r.content ? `\n    Content: ${r.content.slice(0, 1000)}` : ""}`)
+            .join("\n\n");
+        const response = await this.client.messages.create({
+            model: MODEL,
+            max_tokens: 1024,
+            messages: [
+                {
+                    role: "user",
+                    content: `You are a knowledge synthesiser. Given a question and web search results, produce a structured knowledge entry.
+
+Question: ${question}
+
+Search Results:
+${sourceSummary}
+
+Respond with ONLY a JSON object (no markdown fences) with these fields:
+- "title": concise title for the knowledge entry
+- "category": a short lowercase category slug (e.g. "ai", "science", "business", "technology", "culture")
+- "content": a clear, well-structured synthesis (2-4 paragraphs of markdown)
+- "tags": array of 3-7 lowercase keyword tags
+- "source": primary source URL or "multiple" if from several
+- "confidence": 0-1 float indicating how confident you are in the accuracy`,
+                },
+            ],
+        });
+        this._lastCost = this.computeCost(response.usage);
+        const text = response.content[0].type === "text" ? response.content[0].text : "";
+        return this.parseSynthesisResponse(text);
+    }
+    async categorize(content, categories) {
+        const response = await this.client.messages.create({
+            model: MODEL,
+            max_tokens: 64,
+            messages: [
+                {
+                    role: "user",
+                    content: `Classify the following content into exactly one of these categories: ${categories.join(", ")}
+
+Content: ${content.slice(0, 2000)}
+
+Respond with ONLY the category name, nothing else.`,
+                },
+            ],
+        });
+        this._lastCost = this.computeCost(response.usage);
+        const text = response.content[0].type === "text"
+            ? response.content[0].text.trim().toLowerCase()
+            : categories[0];
+        // Return the best match from the provided categories
+        const match = categories.find((c) => c.toLowerCase() === text);
+        return match ?? categories[0];
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    computeCost(usage) {
+        return (usage.input_tokens * INPUT_COST_PER_TOKEN +
+            usage.output_tokens * OUTPUT_COST_PER_TOKEN);
+    }
+    parseSynthesisResponse(text) {
+        try {
+            // Strip markdown code fences if present
+            const cleaned = text
+                .replace(/^```(?:json)?\s*\n?/m, "")
+                .replace(/\n?```\s*$/m, "")
+                .trim();
+            const parsed = JSON.parse(cleaned);
+            return {
+                title: String(parsed.title ?? "Untitled"),
+                category: String(parsed.category ?? "general"),
+                content: String(parsed.content ?? ""),
+                tags: Array.isArray(parsed.tags)
+                    ? parsed.tags.map(String)
+                    : [],
+                source: String(parsed.source ?? "unknown"),
+                confidence: typeof parsed.confidence === "number"
+                    ? Math.max(0, Math.min(1, parsed.confidence))
+                    : 0.5,
+            };
+        }
+        catch {
+            // Fallback if JSON parsing fails
+            return {
+                title: "Synthesis Error",
+                category: "general",
+                content: text,
+                tags: [],
+                source: "unknown",
+                confidence: 0.2,
+            };
+        }
+    }
+}
+//# sourceMappingURL=claude-model.js.map

package/dist/providers/claude-model.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pluggable Providers — search and model backends with factory functions.
+ */
+export type { WebSearchResult, SynthesisResult, SearchProvider, ModelProvider, } from "./types.js";
+export { OpenAISearchProvider } from "./openai-search.js";
+export { ClaudeModelProvider } from "./claude-model.js";
+import type { SearchProvider, ModelProvider } from "./types.js";
+/**
+ * Create a SearchProvider by name.
+ *
+ * @param name - Provider name. Defaults to "openai".
+ * @returns A configured SearchProvider instance.
+ */
+export declare function createSearchProvider(name?: string): SearchProvider;
+/**
+ * Create a ModelProvider by name.
+ *
+ * @param name - Provider name. Defaults to "claude".
+ * @returns A configured ModelProvider instance.
+ */
+export declare function createModelProvider(name?: string): ModelProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMxD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAQhE"}

package/dist/providers/index.js

@@ -0,0 +1,38 @@
+/**
+ * Pluggable Providers — search and model backends with factory functions.
+ */
+export { OpenAISearchProvider } from "./openai-search.js";
+export { ClaudeModelProvider } from "./claude-model.js";
+import { OpenAISearchProvider } from "./openai-search.js";
+import { ClaudeModelProvider } from "./claude-model.js";
+/**
+ * Create a SearchProvider by name.
+ *
+ * @param name - Provider name. Defaults to "openai".
+ * @returns A configured SearchProvider instance.
+ */
+export function createSearchProvider(name) {
+    const resolved = (name ?? "openai").toLowerCase();
+    switch (resolved) {
+        case "openai":
+            return new OpenAISearchProvider();
+        default:
+            throw new Error(`Unknown search provider: "${resolved}". Available: openai`);
+    }
+}
+/**
+ * Create a ModelProvider by name.
+ *
+ * @param name - Provider name. Defaults to "claude".
+ * @returns A configured ModelProvider instance.
+ */
+export function createModelProvider(name) {
+    const resolved = (name ?? "claude").toLowerCase();
+    switch (resolved) {
+        case "claude":
+            return new ClaudeModelProvider();
+        default:
+            throw new Error(`Unknown model provider: "${resolved}". Available: claude`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,IAAI,oBAAoB,EAAE,CAAC;QACpC;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,sBAAsB,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,sBAAsB,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/providers/openai-search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OpenAI Search Provider — uses the Responses API with web_search_preview tool.
+ */
+import type { SearchProvider, WebSearchResult } from "./types.js";
+export declare class OpenAISearchProvider implements SearchProvider {
+    readonly name = "openai";
+    private client;
+    private _lastCost;
+    constructor(apiKey?: string);
+    search(query: string, maxResults?: number): Promise<WebSearchResult[]>;
+    lastCallCostUsd(): number;
+    private parseSearchResults;
+}
+//# sourceMappingURL=openai-search.d.ts.map

package/dist/providers/openai-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-search.d.ts","sourceRoot":"","sources":["../../src/providers/openai-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUlE,qBAAa,oBAAqB,YAAW,cAAc;IACzD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,CAAC,EAAE,MAAM;IAOrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyCvE,eAAe,IAAI,MAAM;IAQzB,OAAO,CAAC,kBAAkB;CA2C3B"}

package/dist/providers/openai-search.js

@@ -0,0 +1,97 @@
+/**
+ * OpenAI Search Provider — uses the Responses API with web_search_preview tool.
+ */
+import OpenAI from "openai";
+// ---------------------------------------------------------------------------
+// Cost tracking constants
+// ---------------------------------------------------------------------------
+/** Per-search-call cost estimate for web_search_preview (context-size dependent). */
+const SEARCH_COST_LOW = 0.03;
+const SEARCH_COST_HIGH = 0.05;
+export class OpenAISearchProvider {
+    name = "openai";
+    client;
+    _lastCost = 0;
+    constructor(apiKey) {
+        const key = apiKey ?? process.env.OPENAI_API_KEY;
+        this.client = new OpenAI({
+            apiKey: key ?? "unset",
+        });
+    }
+    async search(query, maxResults = 5) {
+        const response = await this.client.responses.create({
+            model: "gpt-4.1-mini",
+            tools: [
+                {
+                    type: "web_search_preview",
+                    search_context_size: maxResults <= 3 ? "low" : "medium",
+                },
+            ],
+            input: `Search the web for: ${query}\n\nReturn the top results with titles, URLs, and brief summaries.`,
+        });
+        const results = [];
+        // Extract results from output items
+        for (const item of response.output) {
+            if (item.type === "web_search_call") {
+                // The search call itself doesn't contain results — they come in message output
+                continue;
+            }
+            if (item.type === "message") {
+                // Parse search results from the message content
+                for (const block of item.content) {
+                    if (block.type === "output_text") {
+                        const parsed = this.parseSearchResults(block.text, block.annotations ?? [], maxResults);
+                        results.push(...parsed);
+                    }
+                }
+            }
+        }
+        // Estimate cost based on context size
+        this._lastCost = maxResults <= 3 ? SEARCH_COST_LOW : SEARCH_COST_HIGH;
+        return results.slice(0, maxResults);
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    parseSearchResults(text, annotations, maxResults) {
+        const results = [];
+        // Extract from URL citation annotations (most reliable)
+        for (const ann of annotations) {
+            if (ann.type === "url_citation" && ann.url && ann.title) {
+                // Avoid duplicate URLs
+                if (results.some((r) => r.url === ann.url))
+                    continue;
+                results.push({
+                    title: ann.title,
+                    url: ann.url,
+                    snippet: "",
+                });
+                if (results.length >= maxResults)
+                    break;
+            }
+        }
+        // If we got annotations, use text chunks as snippets
+        if (results.length > 0) {
+            // Split text by double-newline to get rough per-result blocks
+            const blocks = text.split(/\n{2,}/);
+            for (let i = 0; i < Math.min(blocks.length, results.length); i++) {
+                if (!results[i].snippet && blocks[i]) {
+                    results[i].snippet = blocks[i].trim().slice(0, 300);
+                }
+            }
+        }
+        // Fallback: if no annotations, return text as a single result
+        if (results.length === 0 && text.trim()) {
+            results.push({
+                title: "Search Results",
+                url: "",
+                snippet: text.trim().slice(0, 500),
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=openai-search.js.map

package/dist/providers/openai-search.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provider type definitions — pluggable interfaces for search and model backends.
+ */
+/** A single result from a web search. */
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    /** Full page content, if available. */
+    content?: string;
+}
+/** Interface that all search providers must implement. */
+export interface SearchProvider {
+    /** Human-readable provider name (e.g. "openai"). */
+    readonly name: string;
+    /** Run a web search and return results. */
+    search(query: string, maxResults?: number): Promise<WebSearchResult[]>;
+    /** USD cost of the most recent search() call. Returns 0 before any call. */
+    lastCallCostUsd(): number;
+}
+/** The output of a synthesis operation. */
+export interface SynthesisResult {
+    title: string;
+    category: string;
+    content: string;
+    tags: string[];
+    source: string;
+    /** 0–1 confidence in the synthesised output. */
+    confidence: number;
+}
+/** Interface that all model providers must implement. */
+export interface ModelProvider {
+    /** Human-readable provider name (e.g. "claude"). */
+    readonly name: string;
+    /** Synthesise search results into a knowledge entry. */
+    synthesize(question: string, searchResults: WebSearchResult[]): Promise<SynthesisResult>;
+    /** Classify content into one of the provided categories. */
+    categorize(content: string, categories: string[]): Promise<string>;
+    /** USD cost of the most recent API call. Returns 0 before any call. */
+    lastCallCostUsd(): number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEvE,4EAA4E;IAC5E,eAAe,IAAI,MAAM,CAAC;CAC3B;AAMD,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B,4DAA4D;IAC5D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnE,uEAAuE;IACvE,eAAe,IAAI,MAAM,CAAC;CAC3B"}

package/dist/providers/types.js

@@ -0,0 +1,5 @@
+/**
+ * Provider type definitions — pluggable interfaces for search and model backends.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}