@getplumb/core 0.1.0

package/dist/extractor.js

@@ -0,0 +1,89 @@
+import { callLLM } from './llm-client.js';
+import { DecayRate } from './types.js';
+/** Build the extraction prompt from a conversation exchange. */
+function buildExtractionPrompt(exchange) {
+    return (`Extract facts from this conversation exchange worth remembering in future conversations.\n\n` +
+        `User: ${exchange.userMessage}\n` +
+        `Agent: ${exchange.agentResponse}\n\n` +
+        `Rules:\n` +
+        `- Output ONLY a valid JSON array. No prose, no explanation, no markdown fences.\n` +
+        `- Each item: {"subject": string, "predicate": string, "object": string, "context": string, "confidence": number 0-1, "decay_rate": "slow"|"medium"|"fast"}\n` +
+        `- decay_rate: slow=identity/stable prefs/decisions, medium=project context/tool choices, fast=transient state\n` +
+        `- confidence: 0.95 for explicit statements, 0.7-0.85 for inferred\n` +
+        `- Output [] if nothing is worth remembering\n` +
+        `- Skip: pleasantries, small talk, transient questions, tool outputs, error messages\n` +
+        `- Extract: decisions, preferences, facts about people/projects/systems, deadlines, named entities\n\n` +
+        `JSON array:`);
+}
+/**
+ * Parse a JSON array from LLM output, tolerating markdown code fences and leading prose.
+ * Returns empty array on any parse failure.
+ */
+function parseJsonArray(text) {
+    // Find the first '[' and last ']' — extract just that substring
+    const start = text.indexOf('[');
+    const end = text.lastIndexOf(']');
+    if (start === -1 || end === -1 || end < start)
+        return [];
+    const jsonSlice = text.slice(start, end + 1).trim();
+    const parsed = JSON.parse(jsonSlice);
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed;
+}
+function toDecayRate(raw) {
+    if (raw === 'slow')
+        return DecayRate.slow;
+    if (raw === 'fast')
+        return DecayRate.fast;
+    return DecayRate.medium;
+}
+/**
+ * Extract facts from a conversation exchange via an LLM call.
+ *
+ * Makes one LLM call, parses the JSON array response, persists each fact via
+ * the provided store, and returns the stored Fact[].
+ *
+ * Dedup strategy: always insert as a new entry — never update an existing fact
+ * with the same subject+predicate. Decay scoring (T-006) handles ranking.
+ *
+ * @param exchange - The conversation exchange to extract facts from.
+ * @param userId   - The user ID to scope facts to (passed to store.store()).
+ *                   NOTE: LocalStore captures userId at construction time, so
+ *                   this param is accepted here for documentation/future use
+ *                   but the store itself enforces the scope.
+ * @param store    - The MemoryStore instance to persist facts into.
+ * @param llmFn    - Optional LLM function to use (injectable for testing).
+ */
+export async function extractFacts(exchange, _userId, store, llmFn = callLLM) {
+    const prompt = buildExtractionPrompt(exchange);
+    const response = await llmFn(prompt);
+    let rawFacts;
+    try {
+        rawFacts = parseJsonArray(response);
+    }
+    catch {
+        console.error('[plumb/extractor] Failed to parse LLM response as JSON array:', response);
+        return [];
+    }
+    const facts = [];
+    for (const raw of rawFacts) {
+        const factInput = {
+            subject: String(raw.subject),
+            predicate: String(raw.predicate),
+            object: String(raw.object),
+            confidence: Math.max(0, Math.min(1, Number(raw.confidence))),
+            decayRate: toDecayRate(String(raw.decay_rate)),
+            timestamp: new Date(),
+            sourceSessionId: exchange.sessionId,
+            ...(exchange.sessionLabel !== undefined ? { sourceSessionLabel: exchange.sessionLabel } : {}),
+            ...(raw.context !== undefined ? { context: String(raw.context) } : {}),
+        };
+        // Dedup: always insert as a new entry (do not update existing same subject+predicate).
+        // The store always inserts; decay scoring handles which entry wins at retrieval time.
+        const id = await store.store(factInput);
+        facts.push({ id, ...factInput });
+    }
+    return facts;
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor.js.map

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

package/dist/fact-search.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Fact hybrid search (Layer 2 retrieval).
+ *
+ * Pipeline:
+ *   1. BM25 keyword search over concatenated fact text (subject+predicate+object+context)
+ *   2. KNN vector search via sqlite-vec vec_facts virtual table
+ *   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 Database from 'better-sqlite3';
+import type { SearchResult } from './types.js';
+/**
+ * Hybrid search over facts.
+ *
+ * @param db      The better-sqlite3 Database instance (with sqlite-vec loaded)
+ * @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)
+ */
+export declare function searchFacts(db: Database.Database, userId: string, query: string, limit?: number): Promise<readonly SearchResult[]>;
+//# sourceMappingURL=fact-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fact-search.d.ts","sourceRoot":"","sources":["../src/fact-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6F/C;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAgGlC"}

package/dist/fact-search.js

@@ -0,0 +1,155 @@
+/**
+ * Fact hybrid search (Layer 2 retrieval).
+ *
+ * Pipeline:
+ *   1. BM25 keyword search over concatenated fact text (subject+predicate+object+context)
+ *   2. KNN vector search via sqlite-vec vec_facts virtual table
+ *   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';
+// 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 better-sqlite3 Database instance (with sqlite-vec loaded)
+ * @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)
+ */
+export async function searchFacts(db, userId, query, limit = 20) {
+    // ── 1. Fetch all non-deleted fact rows for this user ────────────────────
+    const allRows = db
+        .prepare(`SELECT id, user_id, subject, predicate, object, confidence,
+              decay_rate, timestamp, source_session_id, source_session_label,
+              context, deleted_at
+       FROM facts
+       WHERE user_id = ? AND deleted_at IS NULL
+       ORDER BY timestamp DESC`)
+        .all(userId);
+    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 sqlite-vec ─────────────────────────────────────
+    const queryVec = await embedQuery(query);
+    const queryBlob = Buffer.from(queryVec.buffer);
+    const vecFetchLimit = Math.min(allRows.length, Math.max(RERANK_TOP_K * 2, limit * 3, 50));
+    const vecRows = db
+        .prepare(`SELECT rowid, distance FROM vec_facts
+       WHERE embedding MATCH ?
+       ORDER BY distance
+       LIMIT ?`)
+        .all(queryBlob, vecFetchLimit);
+    const vecRanked = [];
+    for (const vecRow of vecRows) {
+        const factRow = db
+            .prepare(`SELECT id FROM facts WHERE vec_rowid = ? AND user_id = ? AND deleted_at IS NULL`)
+            .get(vecRow.rowid, userId);
+        if (factRow !== undefined) {
+            vecRanked.push([factRow.id, 1 - vecRow.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

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { Fact, IngestResult, MessageExchange, SearchResult, StoreStatus } from './types.js';
+export { DecayRate } from './types.js';
+export type { MemoryStore } from './store.js';
+export type { RawLogChunk, ScoreResult } from './scorer.js';
+export { computeDecay, scoreFact, scoreRawLog } from './scorer.js';
+export { LocalStore } from './local-store.js';
+export type { LocalStoreOptions, RawLogSearchResult, RawFact, RawLogEntry, ExportData } from './local-store.js';
+export { extractFacts } from './extractor.js';
+export { callLLM, resolveAnthropicKey } from './llm-client.js';
+export { embed, embedQuery, rerankScores, EMBED_DIM } from './embedder.js';
+export { Bm25, tokenize } from './bm25.js';
+export { chunkExchange, formatExchange, CHUNK_WORDS, OVERLAP_WORDS } from './chunker.js';
+export type { Chunk } from './chunker.js';
+export { searchRawLog } from './raw-log-search.js';
+export type { ScoredFact, RawChunk, MemoryContext, ReadPathOptions, ReadPathStore } from './read-path.js';
+export { buildMemoryContext } from './read-path.js';
+export { formatContextBlock, formatAge } from './context-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { DecayRate } from './types.js';
+export { computeDecay, scoreFact, scoreRawLog } from './scorer.js';
+export { LocalStore } from './local-store.js';
+export { extractFacts } from './extractor.js';
+export { callLLM, resolveAnthropicKey } from './llm-client.js';
+export { embed, embedQuery, rerankScores, EMBED_DIM } from './embedder.js';
+export { Bm25, tokenize } from './bm25.js';
+export { chunkExchange, formatExchange, CHUNK_WORDS, OVERLAP_WORDS } from './chunker.js';
+export { searchRawLog } from './raw-log-search.js';
+export { buildMemoryContext } from './read-path.js';
+export { formatContextBlock, formatAge } from './context-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/llm-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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;
+/**
+ * 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'
+ *   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>;
+//# sourceMappingURL=llm-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../src/llm-client.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4E7D"}

package/dist/llm-client.js

@@ -0,0 +1,115 @@
+import OpenAI from 'openai';
+/**
+ * Default models per provider
+ */
+const DEFAULT_MODELS = {
+    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.');
+}
+/**
+ * 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'
+ *   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 === '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, openai-compatible`);
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/llm-client.js.map

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

package/dist/local-store.d.ts

@@ -0,0 +1,99 @@
+import Database from 'better-sqlite3';
+import type { MemoryStore } from './store.js';
+import type { Fact, IngestResult, MessageExchange, SearchResult, StoreStatus } from './types.js';
+import { type RawLogSearchResult } from './raw-log-search.js';
+export type { RawLogSearchResult };
+export interface RawFact {
+    readonly id: string;
+    readonly userId: string;
+    readonly subject: string;
+    readonly predicate: string;
+    readonly object: string;
+    readonly confidence: number;
+    readonly decayRate: string;
+    readonly timestamp: string;
+    readonly sourceSessionId: string;
+    readonly sourceSessionLabel: string | null;
+    readonly context: string | null;
+    readonly deleted: boolean;
+    readonly deletedAt: string | null;
+}
+export interface RawLogEntry {
+    readonly id: string;
+    readonly userId: string;
+    readonly sessionId: string;
+    readonly sessionLabel: string | null;
+    readonly userMessage: string;
+    readonly agentResponse: string;
+    readonly timestamp: string;
+    readonly source: string;
+    readonly chunkText: string;
+    readonly chunkIndex: number;
+    readonly contentHash: string | null;
+}
+export interface ExportData {
+    readonly facts: readonly RawFact[];
+    readonly rawLog: readonly RawLogEntry[];
+}
+export interface LocalStoreOptions {
+    /** Absolute path to the SQLite database file. Defaults to ~/.plumb/memory.db */
+    dbPath?: string;
+    /** User ID for scoping all data. Defaults to 'default' (single-user local install). */
+    userId?: string;
+}
+export declare class LocalStore implements MemoryStore {
+    #private;
+    /** Expose database for plugin use (e.g., NudgeManager) */
+    get db(): Database.Database;
+    /** Expose userId for plugin use */
+    get userId(): string;
+    constructor(options?: LocalStoreOptions);
+    store(fact: Omit<Fact, 'id'>): Promise<string>;
+    search(query: string, limit?: number): Promise<readonly SearchResult[]>;
+    delete(id: string): Promise<void>;
+    status(): Promise<StoreStatus>;
+    ingest(exchange: MessageExchange): Promise<IngestResult>;
+    /**
+     * Hybrid search over raw_log (Layer 1 retrieval).
+     * See raw-log-search.ts for the full pipeline description.
+     */
+    searchRawLog(query: string, limit?: number): Promise<readonly RawLogSearchResult[]>;
+    /**
+     * Wait for all in-flight fact extractions to complete.
+     * Call this before close() to ensure all async work is done.
+     */
+    drain(): Promise<void>;
+    /**
+     * Re-extract facts for orphaned raw_log chunks (chunks with no corresponding facts).
+     *
+     * This is useful when fact extraction failed during initial ingest (e.g., missing API key,
+     * rate limits, crashes). Re-running the normal seeder won't help because content-hash dedup
+     * skips already-ingested chunks before reaching the extraction phase.
+     *
+     * This method directly calls extractFacts() for each orphaned chunk, bypassing the dedup gate.
+     *
+     * @param throttleMs - Delay between extractions (default 1000ms) to stay under rate limits
+     * @returns Statistics: orphansFound, factsCreated
+     */
+    reextractOrphans(throttleMs?: number): Promise<{
+        orphansFound: number;
+        factsCreated: number;
+    }>;
+    /**
+     * Get top subjects by fact count (for plumb status command).
+     * Returns subjects ordered by number of facts (non-deleted only).
+     */
+    topSubjects(userId: string, limit?: number): Array<{
+        subject: string;
+        count: number;
+    }>;
+    /**
+     * Export all data for a user (for plumb export command).
+     * Returns raw database rows (no vector data).
+     * Includes soft-deleted facts for transparency.
+     */
+    exportAll(userId: string): ExportData;
+    /** Close the database connection. Call when done (e.g. in tests). */
+    close(): void;
+}
+//# sourceMappingURL=local-store.d.ts.map

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

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