@getplumb/core 0.4.0 → 0.4.2

package/dist/extractor.test.js

@@ -1,158 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { extractFacts } from './extractor.js';
-import { DecayRate } from './types.js';
-// ---------------------------------------------------------------------------
-// Test fixtures
-// ---------------------------------------------------------------------------
-const testExchange = {
-    userMessage: 'I prefer dark mode for all my editors.',
-    agentResponse: 'Noted, I will use dark mode settings.',
-    timestamp: new Date('2026-01-01T12:00:00Z'),
-    source: 'openclaw',
-    sessionId: 'session-001',
-    sessionLabel: 'prefs-chat',
-};
-const testExchangeNoLabel = {
-    userMessage: 'I use TypeScript for everything.',
-    agentResponse: 'Great choice.',
-    timestamp: new Date('2026-01-01T13:00:00Z'),
-    source: 'openclaw',
-    sessionId: 'session-002',
-};
-// ---------------------------------------------------------------------------
-// In-memory mock store
-// ---------------------------------------------------------------------------
-function createMockStore() {
-    const stored = [];
-    const store = {
-        async store(fact) {
-            const id = crypto.randomUUID();
-            stored.push({ id, ...fact });
-            return id;
-        },
-        async search(_query, _limit) {
-            return [];
-        },
-        async delete(_id) { },
-        async status() {
-            return { factCount: stored.length, rawLogCount: 0, lastIngestion: null, storageBytes: 0 };
-        },
-        async ingest(_exchange) {
-            return { rawLogId: crypto.randomUUID(), factsExtracted: 0, factIds: [] };
-        },
-    };
-    return { store, stored };
-}
-// ---------------------------------------------------------------------------
-// LLM mock helpers
-// ---------------------------------------------------------------------------
-function mockLLM(responseJson) {
-    return async (_prompt) => JSON.stringify(responseJson);
-}
-function mockLLMWithFences(responseJson) {
-    return async (_prompt) => '```json\n' + JSON.stringify(responseJson) + '\n```';
-}
-// ---------------------------------------------------------------------------
-// Tests: structured output parsing
-// ---------------------------------------------------------------------------
-test('extractFacts: parses a valid JSON array and stores each fact', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        {
-            subject: 'user',
-            predicate: 'prefers',
-            object: 'dark mode',
-            context: 'mentioned for all editors',
-            confidence: 0.9,
-            decay_rate: 'slow',
-        },
-    ]));
-    assert.equal(result.length, 1);
-    assert.equal(result[0].subject, 'user');
-    assert.equal(result[0].predicate, 'prefers');
-    assert.equal(result[0].object, 'dark mode');
-    assert.equal(result[0].context, 'mentioned for all editors');
-    assert.equal(result[0].confidence, 0.9);
-    assert.equal(result[0].decayRate, DecayRate.slow);
-    assert.equal(result[0].sourceSessionId, 'session-001');
-    assert.equal(result[0].sourceSessionLabel, 'prefs-chat');
-    assert.match(result[0].id, /^[0-9a-f-]{36}$/);
-    assert.equal(stored.length, 1);
-});
-test('extractFacts: strips markdown code fences before parsing', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLMWithFences([
-        { subject: 'user', predicate: 'uses', object: 'TypeScript', confidence: 0.95, decay_rate: 'medium' },
-    ]));
-    assert.equal(result.length, 1);
-    assert.equal(result[0].object, 'TypeScript');
-    assert.equal(result[0].decayRate, DecayRate.medium);
-});
-test('extractFacts: returns [] and stores nothing when LLM returns []', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([]));
-    assert.equal(result.length, 0);
-    assert.equal(stored.length, 0);
-});
-test('extractFacts: returns [] gracefully when LLM returns invalid JSON', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, async () => 'This is definitely not JSON.');
-    assert.equal(result.length, 0);
-    assert.equal(stored.length, 0);
-});
-test('extractFacts: handles multiple facts in one LLM response', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        { subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' },
-        { subject: 'user', predicate: 'uses', object: 'vim keybindings', confidence: 0.8, decay_rate: 'medium' },
-    ]));
-    assert.equal(result.length, 2);
-    assert.equal(stored.length, 2);
-});
-test('extractFacts: clamps confidence to [0, 1]', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        { subject: 'a', predicate: 'b', object: 'c', confidence: 1.5, decay_rate: 'slow' },
-        { subject: 'd', predicate: 'e', object: 'f', confidence: -0.3, decay_rate: 'fast' },
-    ]));
-    assert.equal(result[0].confidence, 1.0);
-    assert.equal(result[1].confidence, 0.0);
-});
-test('extractFacts: unknown decay_rate defaults to medium', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([{ subject: 'a', predicate: 'b', object: 'c', confidence: 0.5, decay_rate: 'unknown-rate' }]));
-    assert.equal(result[0].decayRate, DecayRate.medium);
-});
-test('extractFacts: sourceSessionLabel is omitted when exchange has no sessionLabel', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchangeNoLabel, 'user-1', store, mockLLM([{ subject: 'user', predicate: 'uses', object: 'TypeScript', confidence: 0.9, decay_rate: 'slow' }]));
-    assert.equal(result[0].sourceSessionId, 'session-002');
-    assert.equal(result[0].sourceSessionLabel, undefined);
-});
-test('extractFacts: context field is omitted when LLM does not include it', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([{ subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' }]));
-    assert.equal(result[0].context, undefined);
-});
-// ---------------------------------------------------------------------------
-// Tests: deduplication strategy
-// ---------------------------------------------------------------------------
-test('extractFacts dedup: inserts new entry when same subject+predicate already exists', async () => {
-    const { store, stored } = createMockStore();
-    const singleFact = [
-        { subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' },
-    ];
-    // First extraction
-    await extractFacts(testExchange, 'user-1', store, mockLLM(singleFact));
-    assert.equal(stored.length, 1);
-    // Second extraction with same subject+predicate
-    await extractFacts(testExchange, 'user-1', store, mockLLM(singleFact));
-    assert.equal(stored.length, 2, 'should insert new entry, not overwrite existing');
-    // Both entries have unique IDs
-    assert.notEqual(stored[0].id, stored[1].id);
-    // Both have same subject+predicate
-    assert.equal(stored[0].subject, stored[1].subject);
-    assert.equal(stored[0].predicate, stored[1].predicate);
-});
-//# sourceMappingURL=extractor.test.js.map

package/dist/extractor.test.js.map

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

package/dist/fact-search.d.ts

@@ -1,32 +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 type { WasmDb } from './wasm-db.js';
-import type { SearchResult } from './types.js';
-/**
- * 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 declare function searchFacts(db: WasmDb, userId: string, query: string, limit?: number, preloadedCorpus?: Array<{
-    rowid: number;
-    embedding: Float32Array;
-}>): Promise<readonly SearchResult[]>;
-//# sourceMappingURL=fact-search.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fact-search.d.ts","sourceRoot":"","sources":["../src/fact-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0F/C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,eAAe,CAAC,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,GAClE,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CA2GlC"}

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"}