@getplumb/core 0.3.0 → 0.4.1

package/dist/fact-search.js

@@ -1,174 +0,0 @@
-/**
- * Fact hybrid search (Layer 2 retrieval).
- *
- * Pipeline:
- *   1. BM25 keyword search over concatenated fact text (subject+predicate+object+context)
- *   2. KNN vector search via JS cosine similarity (replaces sqlite-vec)
- *   3. Reciprocal Rank Fusion (RRF, k=60) merges both ranked lists
- *   4. Recency decay: score *= e^(-lambda × age_in_days), using per-fact decay_rate
- *   5. Cross-encoder reranker (top-20 candidates → Xenova/ms-marco-MiniLM-L-6-v2)
- *   6. Return top-k by reranker score (falls back to RRF×decay if reranker fails)
- *
- * Decay lambdas by fact decay_rate:
- *   slow=0.003 (half-life ~231 days) — identity, stable preferences
- *   medium=0.012 (half-life ~58 days) — project context, tool choices
- *   fast=0.05 (half-life ~14 days) — transient state
- */
-import { Bm25 } from './bm25.js';
-import { embedQuery, rerankScores } from './embedder.js';
-import { knnSearch, deserializeEmbedding } from './vector-search.js';
-// RRF constant (standard k=60).
-const RRF_K = 60;
-// Number of candidates passed to the cross-encoder.
-const RERANK_TOP_K = 20;
-// Decay lambdas by fact decay_rate field.
-const DECAY_LAMBDAS = {
-    slow: 0.003,
-    medium: 0.012,
-    fast: 0.05,
-};
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-function factText(row) {
-    return `${row.subject} ${row.predicate} ${row.object} ${row.context ?? ''}`.trim();
-}
-function ageInDays(timestamp) {
-    return (Date.now() - new Date(timestamp).getTime()) / (1_000 * 60 * 60 * 24);
-}
-function recencyDecay(timestamp, decayRate) {
-    const lambda = DECAY_LAMBDAS[decayRate] ?? DECAY_LAMBDAS.medium;
-    return Math.exp(-lambda * ageInDays(timestamp));
-}
-function rowToFact(row) {
-    return {
-        id: row.id,
-        subject: row.subject,
-        predicate: row.predicate,
-        object: row.object,
-        confidence: row.confidence,
-        decayRate: row.decay_rate,
-        timestamp: new Date(row.timestamp),
-        sourceSessionId: row.source_session_id,
-        ...(row.source_session_label !== null ? { sourceSessionLabel: row.source_session_label } : {}),
-        ...(row.context !== null ? { context: row.context } : {}),
-    };
-}
-/**
- * Merge two ranked lists via Reciprocal Rank Fusion.
- */
-function rrf(vecRanked, bm25Ranked) {
-    const scores = new Map();
-    for (let rank = 0; rank < vecRanked.length; rank++) {
-        const id = vecRanked[rank]?.[0];
-        if (id === undefined)
-            continue;
-        scores.set(id, (scores.get(id) ?? 0) + 1 / (RRF_K + rank + 1));
-    }
-    for (let rank = 0; rank < bm25Ranked.length; rank++) {
-        const id = bm25Ranked[rank]?.[0];
-        if (id === undefined)
-            continue;
-        scores.set(id, (scores.get(id) ?? 0) + 1 / (RRF_K + rank + 1));
-    }
-    return scores;
-}
-// ─── Public API ───────────────────────────────────────────────────────────────
-/**
- * Hybrid search over facts.
- *
- * @param db                The WASM SQLite Database instance
- * @param userId            Scopes the search to this user's data
- * @param query             Natural language query string
- * @param limit             Number of results to return (default 20)
- * @param preloadedCorpus   Optional pre-loaded vec_facts corpus (T-096: in-memory cache)
- */
-export async function searchFacts(db, userId, query, limit = 20, preloadedCorpus) {
-    // ── 1. Fetch all non-deleted fact rows for this user ────────────────────
-    const stmt = db.prepare(`SELECT id, user_id, subject, predicate, object, confidence,
-            decay_rate, timestamp, source_session_id, source_session_label,
-            context, deleted_at, vec_rowid
-     FROM facts
-     WHERE user_id = ? AND deleted_at IS NULL AND confidence >= 0.65
-     ORDER BY timestamp DESC`);
-    stmt.bind([userId]);
-    const allRows = [];
-    while (stmt.step()) {
-        allRows.push(stmt.get({}));
-    }
-    stmt.finalize();
-    if (allRows.length === 0)
-        return [];
-    const idToRow = new Map(allRows.map((r) => [r.id, r]));
-    // ── 2. BM25 search ───────────────────────────────────────────────────────
-    const corpus = allRows.map(factText);
-    const bm25 = new Bm25(corpus);
-    const bm25RawScores = bm25.scores(query);
-    const bm25Ranked = allRows
-        .map((r, i) => [r.id, bm25RawScores[i] ?? 0])
-        .sort((a, b) => b[1] - a[1]);
-    // ── 3. Vector search via JS cosine similarity ───────────────────────────
-    const queryVec = await embedQuery(query);
-    // T-096: Use preloaded corpus if provided, otherwise fetch from vec_facts
-    let vecCorpus;
-    if (preloadedCorpus !== undefined) {
-        // Map rowid → id for knnSearch compatibility
-        vecCorpus = preloadedCorpus.map(entry => ({ id: entry.rowid, embedding: entry.embedding }));
-    }
-    else {
-        // Fetch all embeddings from vec_facts (legacy path, used if cache not provided)
-        const vecStmt = db.prepare(`SELECT id, embedding FROM vec_facts`);
-        vecCorpus = [];
-        while (vecStmt.step()) {
-            const row = vecStmt.get({});
-            vecCorpus.push({
-                id: row.id,
-                embedding: deserializeEmbedding(row.embedding),
-            });
-        }
-        vecStmt.finalize();
-    }
-    // Perform KNN search
-    const vecFetchLimit = Math.min(allRows.length, Math.max(RERANK_TOP_K * 2, limit * 3, 50));
-    const vecResults = knnSearch(queryVec, vecCorpus, vecFetchLimit);
-    // Map vec_facts ids back to fact ids
-    const vecRanked = [];
-    for (const vecResult of vecResults) {
-        const factRow = allRows.find((r) => r.vec_rowid === vecResult.id);
-        if (factRow !== undefined) {
-            vecRanked.push([factRow.id, 1 - vecResult.distance]);
-        }
-    }
-    // ── 4. RRF merge ────────────────────────────────────────────────────────
-    const rrfScores = rrf(vecRanked, bm25Ranked);
-    // ── 5. Recency decay (per-fact lambda) ──────────────────────────────────
-    const decayedScores = [];
-    for (const [id, rrfScore] of rrfScores) {
-        const row = idToRow.get(id);
-        if (row === undefined)
-            continue;
-        const decay = recencyDecay(row.timestamp, row.decay_rate);
-        decayedScores.push([id, rrfScore * decay]);
-    }
-    decayedScores.sort((a, b) => b[1] - a[1]);
-    // ── 6. Take top candidates for reranking ────────────────────────────────
-    const candidates = decayedScores.slice(0, Math.max(RERANK_TOP_K, limit));
-    // ── 7. Cross-encoder reranking ──────────────────────────────────────────
-    const passages = candidates.map(([id]) => factText(idToRow.get(id)));
-    const rerankerScores = await rerankScores(query, passages);
-    const hasRerankerSignal = rerankerScores.some((s) => s !== 0);
-    const ranked = candidates.map(([id, rrfDecayScore], i) => ({
-        id,
-        finalScore: hasRerankerSignal ? (rerankerScores[i] ?? 0) : rrfDecayScore,
-    }));
-    ranked.sort((a, b) => b.finalScore - a.finalScore);
-    // ── 8. Build output ─────────────────────────────────────────────────────
-    return ranked.slice(0, limit).map(({ id, finalScore }) => {
-        const row = idToRow.get(id);
-        const fact = rowToFact(row);
-        return {
-            fact,
-            score: finalScore,
-            ageInDays: ageInDays(row.timestamp),
-        };
-    });
-}
-//# sourceMappingURL=fact-search.js.map

package/dist/fact-search.js.map

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

package/dist/fact-search.test.d.ts

@@ -1,12 +0,0 @@
-/**
- * Tests for Layer 2 hybrid search (fact-search.ts).
- *
- * Stores 3 facts with distinct topics via store.store(), then verifies that
- * search() returns ranked results with the expected structure.
- *
- * Note: The first test run downloads the BAAI/bge-small-en-v1.5 embedding model
- * (~100 MB) and the ms-marco cross-encoder (~50 MB) — subsequent runs use the
- * local ~/.cache/huggingface/ cache.
- */
-export {};
-//# sourceMappingURL=fact-search.test.d.ts.map

package/dist/fact-search.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fact-search.test.d.ts","sourceRoot":"","sources":["../src/fact-search.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/fact-search.test.js

@@ -1,117 +0,0 @@
-/**
- * Tests for Layer 2 hybrid search (fact-search.ts).
- *
- * Stores 3 facts with distinct topics via store.store(), then verifies that
- * search() returns ranked results with the expected structure.
- *
- * Note: The first test run downloads the BAAI/bge-small-en-v1.5 embedding model
- * (~100 MB) and the ms-marco cross-encoder (~50 MB) — subsequent runs use the
- * local ~/.cache/huggingface/ cache.
- */
-import { test, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { rmSync } from 'node:fs';
-import { LocalStore } from './local-store.js';
-import { DecayRate } from './types.js';
-const dbPath = join(tmpdir(), `plumb-fact-search-test-${Date.now()}.db`);
-const store = new LocalStore({ dbPath, userId: 'fact-search-test-user' });
-after(() => {
-    store.close();
-    rmSync(dbPath, { force: true });
-});
-// ─── Fixtures ────────────────────────────────────────────────────────────────
-const FACTS = [
-    {
-        subject: 'Clay',
-        predicate: 'is actively searching for',
-        object: 'software engineering jobs',
-        context: 'Clay is looking at Samsara, applied to multiple companies, tracking applications and interviews',
-        confidence: 0.95,
-        decayRate: DecayRate.slow,
-        timestamp: new Date(Date.now() - 1 * 24 * 60 * 60 * 1000), // 1 day ago
-        sourceSessionId: 'session-job-search',
-        sourceSessionLabel: 'job-search-chat',
-    },
-    {
-        subject: 'Clay',
-        predicate: 'prefers',
-        object: 'TypeScript over JavaScript',
-        context: 'Clay mentioned preferring strict typing and has all projects configured with strict mode',
-        confidence: 0.9,
-        decayRate: DecayRate.slow,
-        timestamp: new Date(Date.now() - 5 * 24 * 60 * 60 * 1000), // 5 days ago
-        sourceSessionId: 'session-ts-prefs',
-        sourceSessionLabel: 'typescript-chat',
-    },
-    {
-        subject: 'chocolate cake recipe',
-        predicate: 'requires',
-        object: '200g butter and 50g cocoa powder',
-        context: 'Classic recipe baked at 180 degrees for 30 minutes with ganache frosting',
-        confidence: 0.85,
-        decayRate: DecayRate.fast,
-        timestamp: new Date(Date.now() - 2 * 24 * 60 * 60 * 1000), // 2 days ago
-        sourceSessionId: 'session-cooking',
-        sourceSessionLabel: 'cooking-chat',
-    },
-];
-// ─── Store facts (shared setup) ──────────────────────────────────────────────
-test('store 3 facts with distinct topics', { timeout: 120_000 }, async () => {
-    for (const fact of FACTS) {
-        const id = await store.store(fact);
-        assert.match(id, /^[0-9a-f-]{36}$/, 'id should be a UUID');
-    }
-    const status = await store.status();
-    assert.equal(status.factCount, 3, 'all 3 facts should be stored');
-});
-// ─── Search ──────────────────────────────────────────────────────────────────
-test('search returns results with required SearchResult fields', { timeout: 120_000 }, async () => {
-    const results = await store.search('job search applications', 3);
-    assert.ok(results.length > 0, 'should return at least one result');
-    for (const r of results) {
-        assert.ok(typeof r.fact.id === 'string', 'fact.id must be a string');
-        assert.ok(typeof r.fact.subject === 'string', 'fact.subject must be a string');
-        assert.ok(typeof r.fact.predicate === 'string', 'fact.predicate must be a string');
-        assert.ok(typeof r.fact.object === 'string', 'fact.object must be a string');
-        assert.ok(typeof r.score === 'number', 'score must be a number');
-        assert.ok(typeof r.ageInDays === 'number', 'ageInDays must be a number');
-        assert.ok(r.fact.timestamp instanceof Date, 'timestamp must be a Date');
-    }
-});
-test('search ranks job-search fact first for job query', { timeout: 120_000 }, async () => {
-    const results = await store.search('job search applications Samsara', 3);
-    assert.ok(results.length > 0, 'should return results');
-    const top = results[0];
-    assert.ok(top !== undefined, 'should have a top result');
-    // The job-search fact should rank first.
-    assert.equal(top.fact.subject, 'Clay', 'top result subject should be Clay');
-    assert.ok(top.fact.object.includes('job') || top.fact.object.includes('engineering'), 'top result should be about job search');
-});
-test('search returns cooking fact in results for recipe query', { timeout: 120_000 }, async () => {
-    const results = await store.search('chocolate cake recipe baking', 3);
-    assert.ok(results.length > 0, 'should return results');
-    const cookingResult = results.find((r) => r.fact.sourceSessionId === 'session-cooking');
-    assert.ok(cookingResult !== undefined, 'cooking fact should appear in results');
-});
-test('search returns empty array when no facts exist', { timeout: 30_000 }, async () => {
-    const emptyStore = new LocalStore({
-        dbPath: join(tmpdir(), `plumb-fact-empty-${Date.now()}.db`),
-        userId: 'empty-user',
-    });
-    try {
-        const results = await emptyStore.search('anything', 5);
-        assert.deepEqual(results, []);
-    }
-    finally {
-        emptyStore.close();
-    }
-});
-test('benchmark smoke: job search query returns at least 1 result with correct subject', { timeout: 120_000 }, async () => {
-    const results = await store.search('job search applications', 5);
-    assert.ok(results.length >= 1, 'should return at least 1 result');
-    const jobResult = results.find((r) => r.fact.subject === 'Clay' && r.fact.object.includes('job'));
-    assert.ok(jobResult !== undefined, 'should find Clay job search fact');
-});
-//# sourceMappingURL=fact-search.test.js.map

package/dist/fact-search.test.js.map

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

package/dist/llm-client.d.ts

@@ -1,59 +0,0 @@
-/**
- * LLM configuration that can be passed directly instead of relying on environment variables.
- * When provided, these values take precedence over env vars.
- */
-export interface LLMConfig {
-    /** Provider: 'google' (recommended) | 'openai' | 'anthropic' | 'ollama' | 'openai-compatible'. Defaults to 'openai'. */
-    provider?: string;
-    /** Model ID. Defaults to provider-specific default. */
-    model?: string;
-    /** API key. Takes precedence over env var for the given provider. */
-    apiKey?: string;
-    /** Base URL for 'openai-compatible' or 'ollama' providers. */
-    baseUrl?: string;
-}
-/**
- * Resolve the OpenAI API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set OPENAI_API_KEY in your environment before using Plumb with the OpenAI provider.
- *
- * @throws Error if no key is found
- */
-export declare function resolveOpenAIKey(): string;
-/**
- * Resolve the Anthropic API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set ANTHROPIC_API_KEY in your environment before using Plumb with the Anthropic provider.
- *
- * @throws Error if no key is found
- */
-export declare function resolveAnthropicKey(): string;
-/**
- * Resolve the Gemini API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set GEMINI_API_KEY in your environment before using Plumb with the Google provider.
- *
- * @throws Error if no key is found
- */
-export declare function resolveGeminiKey(): string;
-/**
- * Calls the configured LLM with the given prompt and returns the text response.
- * Provider and model are configurable via env:
- *   PLUMB_LLM_PROVIDER — 'openai' (default), 'anthropic', 'ollama', 'openai-compatible', 'google'
- *   PLUMB_LLM_MODEL    — model ID, defaults vary per provider
- *   PLUMB_LLM_BASE_URL — for 'openai-compatible' provider
- *   OLLAMA_HOST        — for 'ollama' provider (default: http://localhost:11434/v1)
- */
-export declare function callLLM(prompt: string): Promise<string>;
-/**
- * Calls the LLM using explicitly provided config rather than environment variables.
- * Falls back to env vars for any values not provided in config.
- *
- * Use this when you want to pass LLM credentials programmatically (e.g. from plugin config)
- * without mutating process.env.
- */
-export declare function callLLMWithConfig(prompt: string, config: LLMConfig): Promise<string>;
-//# sourceMappingURL=llm-client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../src/llm-client.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,wHAAwH;IACxH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2F7D;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAoF1F"}

package/dist/llm-client.js

@@ -1,227 +0,0 @@
-import OpenAI from 'openai';
-/**
- * Default models per provider
- * Recommended: google/gemini-2.5-flash-lite (extremely cheap and fast)
- */
-const DEFAULT_MODELS = {
-    google: 'gemini-2.5-flash-lite',
-    openai: 'gpt-4o-mini',
-    anthropic: 'claude-haiku-4-5-20251001',
-    ollama: 'llama3.1',
-    'openai-compatible': 'gpt-4o-mini',
-};
-/**
- * Resolve the OpenAI API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set OPENAI_API_KEY in your environment before using Plumb with the OpenAI provider.
- *
- * @throws Error if no key is found
- */
-export function resolveOpenAIKey() {
-    const envKey = process.env['OPENAI_API_KEY'];
-    if (envKey)
-        return envKey;
-    throw new Error('Plumb fact extraction requires OPENAI_API_KEY. ' +
-        'Set the OPENAI_API_KEY environment variable and try again.');
-}
-/**
- * Resolve the Anthropic API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set ANTHROPIC_API_KEY in your environment before using Plumb with the Anthropic provider.
- *
- * @throws Error if no key is found
- */
-export function resolveAnthropicKey() {
-    const envKey = process.env['ANTHROPIC_API_KEY'];
-    if (envKey)
-        return envKey;
-    throw new Error('Plumb fact extraction requires ANTHROPIC_API_KEY. ' +
-        'Set the ANTHROPIC_API_KEY environment variable and try again.');
-}
-/**
- * Resolve the Gemini API key from environment variables.
- * Returns the key if found, otherwise throws a clear error.
- *
- * Set GEMINI_API_KEY in your environment before using Plumb with the Google provider.
- *
- * @throws Error if no key is found
- */
-export function resolveGeminiKey() {
-    const envKey = process.env['GEMINI_API_KEY'];
-    if (envKey)
-        return envKey;
-    throw new Error('Plumb fact extraction requires GEMINI_API_KEY. ' +
-        'Set the GEMINI_API_KEY environment variable and try again.');
-}
-/**
- * Calls the configured LLM with the given prompt and returns the text response.
- * Provider and model are configurable via env:
- *   PLUMB_LLM_PROVIDER — 'openai' (default), 'anthropic', 'ollama', 'openai-compatible', 'google'
- *   PLUMB_LLM_MODEL    — model ID, defaults vary per provider
- *   PLUMB_LLM_BASE_URL — for 'openai-compatible' provider
- *   OLLAMA_HOST        — for 'ollama' provider (default: http://localhost:11434/v1)
- */
-export async function callLLM(prompt) {
-    const provider = process.env['PLUMB_LLM_PROVIDER'] ?? 'openai';
-    const model = process.env['PLUMB_LLM_MODEL'] ?? DEFAULT_MODELS[provider] ?? 'gpt-4o-mini';
-    if (provider === 'openai') {
-        const apiKey = resolveOpenAIKey();
-        const client = new OpenAI({ apiKey });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'anthropic') {
-        // Dynamic import to handle optional dependency
-        let Anthropic;
-        try {
-            Anthropic = (await import('@anthropic-ai/sdk')).default;
-        }
-        catch {
-            throw new Error('Anthropic provider requires @anthropic-ai/sdk. Install it with: npm install @anthropic-ai/sdk');
-        }
-        const apiKey = resolveAnthropicKey();
-        const client = new Anthropic({ apiKey });
-        const message = await client.messages.create({
-            model,
-            max_tokens: 4096,
-            messages: [{ role: 'user', content: prompt }],
-        });
-        const block = message.content[0];
-        if (block === undefined || block.type !== 'text') {
-            throw new Error('Unexpected response type from Anthropic LLM');
-        }
-        return block.text;
-    }
-    if (provider === 'ollama') {
-        // Ollama provides an OpenAI-compatible API
-        const baseURL = process.env['OLLAMA_HOST'] ?? 'http://localhost:11434/v1';
-        const client = new OpenAI({
-            baseURL,
-            apiKey: 'ollama', // Required by openai package but ignored by Ollama
-        });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'google') {
-        // Google Gemini via OpenAI-compatible endpoint
-        const apiKey = resolveGeminiKey();
-        const client = new OpenAI({
-            baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai',
-            apiKey,
-        });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'openai-compatible') {
-        const baseURL = process.env['PLUMB_LLM_BASE_URL'];
-        if (!baseURL) {
-            throw new Error('PLUMB_LLM_BASE_URL is required for openai-compatible provider. ' +
-                'Example: export PLUMB_LLM_BASE_URL=https://api.together.xyz/v1');
-        }
-        const apiKey = resolveOpenAIKey();
-        const client = new OpenAI({ baseURL, apiKey });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    throw new Error(`Unsupported PLUMB_LLM_PROVIDER: ${provider}. Supported: openai, anthropic, ollama, google, openai-compatible`);
-}
-/**
- * Calls the LLM using explicitly provided config rather than environment variables.
- * Falls back to env vars for any values not provided in config.
- *
- * Use this when you want to pass LLM credentials programmatically (e.g. from plugin config)
- * without mutating process.env.
- */
-export async function callLLMWithConfig(prompt, config) {
-    const provider = config.provider ?? process.env['PLUMB_LLM_PROVIDER'] ?? 'openai';
-    const model = config.model ?? process.env['PLUMB_LLM_MODEL'] ?? DEFAULT_MODELS[provider] ?? 'gpt-4o-mini';
-    if (provider === 'openai') {
-        const apiKey = config.apiKey ?? resolveOpenAIKey();
-        const client = new OpenAI({ apiKey });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'anthropic') {
-        let Anthropic;
-        try {
-            Anthropic = (await import('@anthropic-ai/sdk')).default;
-        }
-        catch {
-            throw new Error('Anthropic provider requires @anthropic-ai/sdk. Install it with: npm install @anthropic-ai/sdk');
-        }
-        const apiKey = config.apiKey ?? resolveAnthropicKey();
-        const client = new Anthropic({ apiKey });
-        const message = await client.messages.create({
-            model,
-            max_tokens: 4096,
-            messages: [{ role: 'user', content: prompt }],
-        });
-        const block = message.content[0];
-        if (block === undefined || block.type !== 'text') {
-            throw new Error('Unexpected response type from Anthropic LLM');
-        }
-        return block.text;
-    }
-    if (provider === 'ollama') {
-        const baseURL = config.baseUrl ?? process.env['OLLAMA_HOST'] ?? 'http://localhost:11434/v1';
-        const client = new OpenAI({ baseURL, apiKey: 'ollama' });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'google') {
-        const apiKey = config.apiKey ?? resolveGeminiKey();
-        const client = new OpenAI({
-            baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai',
-            apiKey,
-        });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    if (provider === 'openai-compatible') {
-        const baseURL = config.baseUrl ?? process.env['PLUMB_LLM_BASE_URL'];
-        if (!baseURL) {
-            throw new Error('PLUMB_LLM_BASE_URL is required for openai-compatible provider. ' +
-                'Example: export PLUMB_LLM_BASE_URL=https://api.together.xyz/v1');
-        }
-        const apiKey = config.apiKey ?? resolveOpenAIKey();
-        const client = new OpenAI({ baseURL, apiKey });
-        const response = await client.chat.completions.create({
-            model,
-            messages: [{ role: 'user', content: prompt }],
-            max_tokens: 4096,
-        });
-        return response.choices[0]?.message?.content ?? '';
-    }
-    throw new Error(`Unsupported provider: ${provider}. Supported: openai, anthropic, ollama, google, openai-compatible`);
-}
-//# sourceMappingURL=llm-client.js.map

package/dist/llm-client.js.map

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

package/dist/local-store.test.d.ts

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

package/dist/local-store.test.d.ts.map

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