audrey 0.17.0 → 0.20.0

package/dist/src/events.js

@@ -0,0 +1,149 @@
+/**
+ * memory_events CRUD. Thin wrapper — business logic (hashing, redaction,
+ * summarization) lives in tool-trace.ts.
+ */
+import { generateId } from './ulid.js';
+function toJson(value) {
+    if (value == null)
+        return null;
+    return JSON.stringify(value);
+}
+export function insertEvent(db, input) {
+    const id = input.id ?? generateId();
+    const createdAt = input.createdAt ?? new Date().toISOString();
+    const redactionState = input.redactionState ?? 'unreviewed';
+    const fileFingerprints = input.fileFingerprints && input.fileFingerprints.length > 0
+        ? JSON.stringify(input.fileFingerprints)
+        : null;
+    const metadata = toJson(input.metadata ?? null);
+    db.prepare(`
+    INSERT INTO memory_events (
+      id, session_id, event_type, source, actor_agent, tool_name,
+      input_hash, output_hash, outcome, error_summary, cwd,
+      file_fingerprints, redaction_state, metadata, created_at
+    ) VALUES (
+      @id, @sessionId, @eventType, @source, @actorAgent, @toolName,
+      @inputHash, @outputHash, @outcome, @errorSummary, @cwd,
+      @fileFingerprints, @redactionState, @metadata, @createdAt
+    )
+  `).run({
+        id,
+        sessionId: input.sessionId ?? null,
+        eventType: input.eventType,
+        source: input.source,
+        actorAgent: input.actorAgent ?? null,
+        toolName: input.toolName ?? null,
+        inputHash: input.inputHash ?? null,
+        outputHash: input.outputHash ?? null,
+        outcome: input.outcome ?? null,
+        errorSummary: input.errorSummary ?? null,
+        cwd: input.cwd ?? null,
+        fileFingerprints,
+        redactionState,
+        metadata,
+        createdAt,
+    });
+    return {
+        id,
+        session_id: input.sessionId ?? null,
+        event_type: input.eventType,
+        source: input.source,
+        actor_agent: input.actorAgent ?? null,
+        tool_name: input.toolName ?? null,
+        input_hash: input.inputHash ?? null,
+        output_hash: input.outputHash ?? null,
+        outcome: input.outcome ?? null,
+        error_summary: input.errorSummary ?? null,
+        cwd: input.cwd ?? null,
+        file_fingerprints: fileFingerprints,
+        redaction_state: redactionState,
+        metadata,
+        created_at: createdAt,
+    };
+}
+export function listEvents(db, query = {}) {
+    const conditions = [];
+    const params = {};
+    if (query.sessionId) {
+        conditions.push('session_id = @sessionId');
+        params.sessionId = query.sessionId;
+    }
+    if (query.toolName) {
+        conditions.push('tool_name = @toolName');
+        params.toolName = query.toolName;
+    }
+    if (query.eventType) {
+        conditions.push('event_type = @eventType');
+        params.eventType = query.eventType;
+    }
+    if (query.outcome) {
+        conditions.push('outcome = @outcome');
+        params.outcome = query.outcome;
+    }
+    if (query.since) {
+        conditions.push('created_at >= @since');
+        params.since = query.since;
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const limit = Math.max(1, Math.min(query.limit ?? 100, 1000));
+    return db.prepare(`SELECT * FROM memory_events ${where} ORDER BY created_at DESC LIMIT ${limit}`).all(params);
+}
+export function countEvents(db, query = {}) {
+    const conditions = [];
+    const params = {};
+    if (query.sessionId) {
+        conditions.push('session_id = @sessionId');
+        params.sessionId = query.sessionId;
+    }
+    if (query.toolName) {
+        conditions.push('tool_name = @toolName');
+        params.toolName = query.toolName;
+    }
+    if (query.eventType) {
+        conditions.push('event_type = @eventType');
+        params.eventType = query.eventType;
+    }
+    if (query.outcome) {
+        conditions.push('outcome = @outcome');
+        params.outcome = query.outcome;
+    }
+    if (query.since) {
+        conditions.push('created_at >= @since');
+        params.since = query.since;
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const row = db.prepare(`SELECT COUNT(*) AS c FROM memory_events ${where}`).get(params);
+    return row.c;
+}
+/**
+ * Tools that have failed recently, most recent first. Feeds PreToolUse
+ * preflight warnings: "this command failed last time — here's what fixed it."
+ */
+export function recentFailures(db, options = {}) {
+    const since = options.since ?? new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+    const limit = Math.max(1, Math.min(options.limit ?? 20, 200));
+    return db.prepare(`
+    SELECT tool_name,
+           COUNT(*) AS failure_count,
+           MAX(created_at) AS last_failed_at,
+           (
+             SELECT error_summary FROM memory_events e2
+             WHERE e2.tool_name = e1.tool_name
+               AND e2.outcome = 'failed'
+               AND e2.created_at >= @since
+             ORDER BY e2.created_at DESC LIMIT 1
+           ) AS last_error_summary
+    FROM memory_events e1
+    WHERE outcome = 'failed'
+      AND tool_name IS NOT NULL
+      AND created_at >= @since
+    GROUP BY tool_name
+    ORDER BY last_failed_at DESC
+    LIMIT ${limit}
+  `).all({ since });
+}
+export function deleteEventsBefore(db, cutoffIso) {
+    const result = db.prepare('DELETE FROM memory_events WHERE created_at < ?').run(cutoffIso);
+    return Number(result.changes);
+}
+//# sourceMappingURL=events.js.map

package/dist/src/events.js.map

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

package/dist/src/export.d.ts

@@ -0,0 +1,3 @@
+import Database from 'better-sqlite3';
+export declare function exportMemories(db: Database.Database): object;
+//# sourceMappingURL=export.d.ts.map

package/dist/src/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA2GtC,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CA0D5D"}

package/dist/src/export.js

@@ -0,0 +1,46 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { join, dirname } from 'node:path';
+import { safeJsonParse } from './utils.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+export function exportMemories(db) {
+    const episodes = db.prepare('SELECT id, content, source, source_reliability, salience, context, affect, tags, causal_trigger, causal_consequence, created_at, embedding_model, embedding_version, supersedes, superseded_by, consolidated, "private" FROM episodes').all().map(ep => ({
+        ...ep,
+        tags: safeJsonParse(ep.tags, null),
+        context: safeJsonParse(ep.context, null),
+        affect: safeJsonParse(ep.affect, null),
+    }));
+    const semantics = db.prepare('SELECT id, content, state, conditions, evidence_episode_ids, evidence_count, supporting_count, contradicting_count, source_type_diversity, consolidation_checkpoint, embedding_model, embedding_version, consolidation_model, consolidation_prompt_hash, created_at, last_reinforced_at, retrieval_count, challenge_count, interference_count, salience FROM semantics').all().map(sem => ({
+        ...sem,
+        evidence_episode_ids: safeJsonParse(sem.evidence_episode_ids, []),
+    }));
+    const procedures = db.prepare('SELECT id, content, state, trigger_conditions, evidence_episode_ids, success_count, failure_count, embedding_model, embedding_version, created_at, last_reinforced_at, retrieval_count, interference_count, salience FROM procedures').all().map(proc => ({
+        ...proc,
+        evidence_episode_ids: safeJsonParse(proc.evidence_episode_ids, []),
+    }));
+    const causalLinks = db.prepare('SELECT * FROM causal_links').all();
+    const contradictions = db.prepare('SELECT id, claim_a_id, claim_a_type, claim_b_id, claim_b_type, state, resolution, resolved_at, reopened_at, reopen_evidence_id, created_at FROM contradictions').all();
+    const consolidationRuns = db.prepare('SELECT id, checkpoint_cursor, input_episode_ids, output_memory_ids, confidence_deltas, consolidation_model, consolidation_prompt_hash, started_at, completed_at, status FROM consolidation_runs').all().map(run => ({
+        ...run,
+        confidence_deltas: safeJsonParse(run.confidence_deltas, null),
+        input_episode_ids: safeJsonParse(run.input_episode_ids, []),
+        output_memory_ids: safeJsonParse(run.output_memory_ids, []),
+    }));
+    const consolidationMetrics = db.prepare('SELECT id, run_id, min_cluster_size, similarity_threshold, episodes_evaluated, clusters_found, principles_extracted, created_at FROM consolidation_metrics').all();
+    const configRows = db.prepare('SELECT key, value FROM audrey_config').all();
+    const config = Object.fromEntries(configRows.map(r => [r.key, r.value]));
+    return {
+        version: pkg.version,
+        exportedAt: new Date().toISOString(),
+        episodes,
+        semantics,
+        procedures,
+        causalLinks,
+        contradictions,
+        consolidationRuns,
+        consolidationMetrics,
+        config,
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/src/export.js.map

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

package/dist/src/forget.d.ts

@@ -0,0 +1,11 @@
+import Database from 'better-sqlite3';
+import type { EmbeddingProvider, ForgetResult, PurgeResult } from './types.js';
+export declare function forgetMemory(db: Database.Database, id: string, { purge }?: {
+    purge?: boolean;
+}): ForgetResult;
+export declare function purgeMemories(db: Database.Database): PurgeResult;
+export declare function forgetByQuery(db: Database.Database, embeddingProvider: EmbeddingProvider, query: string, { minSimilarity, purge }?: {
+    minSimilarity?: number;
+    purge?: boolean;
+}): Promise<ForgetResult | null>;
+//# sourceMappingURL=forget.d.ts.map

package/dist/src/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/forget.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAc,WAAW,EAAE,MAAM,YAAY,CAAC;AAa3F,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,EAAE,KAAa,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,YAAY,CAyCd;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAoChE;AAED,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,MAAM,EACb,EAAE,aAAmB,EAAE,KAAa,EAAE,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACvF,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmC9B"}

package/dist/src/forget.js

@@ -0,0 +1,105 @@
+import { deleteFTSEpisode, deleteFTSSemantic, deleteFTSProcedure } from './fts.js';
+export function forgetMemory(db, id, { purge = false } = {}) {
+    const episode = db.prepare('SELECT id FROM episodes WHERE id = ?').get(id);
+    if (episode) {
+        if (purge) {
+            db.prepare('DELETE FROM vec_episodes WHERE id = ?').run(id);
+            db.prepare('DELETE FROM episodes WHERE id = ?').run(id);
+        }
+        else {
+            db.prepare("UPDATE episodes SET superseded_by = 'forgotten' WHERE id = ?").run(id);
+            db.prepare('DELETE FROM vec_episodes WHERE id = ?').run(id);
+        }
+        deleteFTSEpisode(db, id);
+        return { id, type: 'episodic', purged: purge };
+    }
+    const semantic = db.prepare('SELECT id FROM semantics WHERE id = ?').get(id);
+    if (semantic) {
+        if (purge) {
+            db.prepare('DELETE FROM vec_semantics WHERE id = ?').run(id);
+            db.prepare('DELETE FROM semantics WHERE id = ?').run(id);
+        }
+        else {
+            db.prepare("UPDATE semantics SET state = 'superseded' WHERE id = ?").run(id);
+            db.prepare('DELETE FROM vec_semantics WHERE id = ?').run(id);
+        }
+        deleteFTSSemantic(db, id);
+        return { id, type: 'semantic', purged: purge };
+    }
+    const procedure = db.prepare('SELECT id FROM procedures WHERE id = ?').get(id);
+    if (procedure) {
+        if (purge) {
+            db.prepare('DELETE FROM vec_procedures WHERE id = ?').run(id);
+            db.prepare('DELETE FROM procedures WHERE id = ?').run(id);
+        }
+        else {
+            db.prepare("UPDATE procedures SET state = 'superseded' WHERE id = ?").run(id);
+            db.prepare('DELETE FROM vec_procedures WHERE id = ?').run(id);
+        }
+        deleteFTSProcedure(db, id);
+        return { id, type: 'procedural', purged: purge };
+    }
+    throw new Error(`Memory not found: ${id}`);
+}
+export function purgeMemories(db) {
+    const deadEpisodes = db.prepare('SELECT id FROM episodes WHERE superseded_by IS NOT NULL').all();
+    const deadSemantics = db.prepare("SELECT id FROM semantics WHERE state IN ('superseded', 'dormant', 'rolled_back')").all();
+    const deadProcedures = db.prepare("SELECT id FROM procedures WHERE state IN ('superseded', 'dormant', 'rolled_back')").all();
+    const purgeAll = db.transaction(() => {
+        for (const row of deadEpisodes) {
+            db.prepare('DELETE FROM vec_episodes WHERE id = ?').run(row.id);
+            db.prepare('DELETE FROM episodes WHERE id = ?').run(row.id);
+            deleteFTSEpisode(db, row.id);
+        }
+        for (const row of deadSemantics) {
+            db.prepare('DELETE FROM vec_semantics WHERE id = ?').run(row.id);
+            db.prepare('DELETE FROM semantics WHERE id = ?').run(row.id);
+            deleteFTSSemantic(db, row.id);
+        }
+        for (const row of deadProcedures) {
+            db.prepare('DELETE FROM vec_procedures WHERE id = ?').run(row.id);
+            db.prepare('DELETE FROM procedures WHERE id = ?').run(row.id);
+            deleteFTSProcedure(db, row.id);
+        }
+    });
+    purgeAll();
+    return {
+        episodes: deadEpisodes.length,
+        semantics: deadSemantics.length,
+        procedures: deadProcedures.length,
+    };
+}
+export async function forgetByQuery(db, embeddingProvider, query, { minSimilarity = 0.9, purge = false } = {}) {
+    const queryVector = await embeddingProvider.embed(query);
+    const queryBuffer = embeddingProvider.vectorToBuffer(queryVector);
+    const candidates = [];
+    const epMatch = db.prepare(`
+    SELECT e.id, (1.0 - v.distance) AS similarity, 'episodic' AS type
+    FROM vec_episodes v JOIN episodes e ON e.id = v.id
+    WHERE v.embedding MATCH ? AND k = 1 AND e.superseded_by IS NULL
+  `).get(queryBuffer);
+    if (epMatch)
+        candidates.push(epMatch);
+    const semMatch = db.prepare(`
+    SELECT s.id, (1.0 - v.distance) AS similarity, 'semantic' AS type
+    FROM vec_semantics v JOIN semantics s ON s.id = v.id
+    WHERE v.embedding MATCH ? AND k = 1 AND (v.state = 'active' OR v.state = 'context_dependent')
+  `).get(queryBuffer);
+    if (semMatch)
+        candidates.push(semMatch);
+    const procMatch = db.prepare(`
+    SELECT p.id, (1.0 - v.distance) AS similarity, 'procedural' AS type
+    FROM vec_procedures v JOIN procedures p ON p.id = v.id
+    WHERE v.embedding MATCH ? AND k = 1 AND (v.state = 'active' OR v.state = 'context_dependent')
+  `).get(queryBuffer);
+    if (procMatch)
+        candidates.push(procMatch);
+    if (candidates.length === 0)
+        return null;
+    candidates.sort((a, b) => b.similarity - a.similarity);
+    const best = candidates[0];
+    if (best.similarity < minSimilarity)
+        return null;
+    return forgetMemory(db, best.id, { purge });
+}
+//# sourceMappingURL=forget.js.map

package/dist/src/forget.js.map

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

package/dist/src/fts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * FTS5 full-text search for Audrey memories.
+ * Creates virtual tables alongside vec0 tables for hybrid retrieval.
+ */
+import Database from 'better-sqlite3';
+export interface FTSMatch {
+    id: string;
+    content: string;
+    agent: string;
+    rank: number;
+}
+export declare function createFTSTables(db: Database.Database): void;
+export declare function hasFTSTables(db: Database.Database): boolean;
+export declare function insertFTSEpisode(db: Database.Database, id: string, content: string, tags?: string | string[] | null): void;
+export declare function insertFTSSemantic(db: Database.Database, id: string, content: string): void;
+export declare function insertFTSProcedure(db: Database.Database, id: string, content: string): void;
+export declare function deleteFTSEpisode(db: Database.Database, id: string): void;
+export declare function deleteFTSSemantic(db: Database.Database, id: string): void;
+export declare function deleteFTSProcedure(db: Database.Database, id: string): void;
+/**
+ * Search episodes via FTS5 BM25.
+ */
+export declare function searchFTSEpisodes(db: Database.Database, query: string, limit?: number, agentFilter?: string | null): FTSMatch[];
+export declare function searchFTSSemantics(db: Database.Database, query: string, limit?: number, agentFilter?: string | null): FTSMatch[];
+export declare function searchFTSProcedures(db: Database.Database, query: string, limit?: number, agentFilter?: string | null): FTSMatch[];
+/**
+ * Backfill FTS tables from existing data.
+ */
+export declare function backfillFTS(db: Database.Database): void;
+/**
+ * Sanitize FTS5 query — escape special characters.
+ */
+export declare function sanitizeFTSQuery(query: string): string;
+//# sourceMappingURL=fts.d.ts.map

package/dist/src/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../src/fts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAS3D;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAK3D;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAC9B,IAAI,CAKN;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,QAAQ,EAAE,CAaZ;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,QAAQ,EAAE,CAaZ;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,QAAQ,EAAE,CAaZ;AAaD;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAoBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD"}

package/dist/src/fts.js

@@ -0,0 +1,117 @@
+/**
+ * FTS5 full-text search for Audrey memories.
+ * Creates virtual tables alongside vec0 tables for hybrid retrieval.
+ */
+export function createFTSTables(db) {
+    db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS fts_episodes
+      USING fts5(id UNINDEXED, content, tags, tokenize='porter unicode61');
+    CREATE VIRTUAL TABLE IF NOT EXISTS fts_semantics
+      USING fts5(id UNINDEXED, content, tokenize='porter unicode61');
+    CREATE VIRTUAL TABLE IF NOT EXISTS fts_procedures
+      USING fts5(id UNINDEXED, content, tokenize='porter unicode61');
+  `);
+}
+export function hasFTSTables(db) {
+    const row = db.prepare("SELECT COUNT(*) AS c FROM sqlite_master WHERE type='table' AND name='fts_episodes'").get();
+    return row.c > 0;
+}
+export function insertFTSEpisode(db, id, content, tags) {
+    const tagsText = tags ? (Array.isArray(tags) ? tags.join(' ') : tags) : '';
+    db.prepare('INSERT OR REPLACE INTO fts_episodes(id, content, tags) VALUES (?, ?, ?)').run(id, content, tagsText);
+}
+export function insertFTSSemantic(db, id, content) {
+    db.prepare('INSERT OR REPLACE INTO fts_semantics(id, content) VALUES (?, ?)').run(id, content);
+}
+export function insertFTSProcedure(db, id, content) {
+    db.prepare('INSERT OR REPLACE INTO fts_procedures(id, content) VALUES (?, ?)').run(id, content);
+}
+export function deleteFTSEpisode(db, id) {
+    db.prepare('DELETE FROM fts_episodes WHERE id = ?').run(id);
+}
+export function deleteFTSSemantic(db, id) {
+    db.prepare('DELETE FROM fts_semantics WHERE id = ?').run(id);
+}
+export function deleteFTSProcedure(db, id) {
+    db.prepare('DELETE FROM fts_procedures WHERE id = ?').run(id);
+}
+/**
+ * Search episodes via FTS5 BM25.
+ */
+export function searchFTSEpisodes(db, query, limit = 30, agentFilter = null) {
+    const agentClause = agentFilter ? 'AND e.agent = ?' : '';
+    const params = agentFilter ? [query, agentFilter, limit] : [query, limit];
+    return db.prepare(`
+    SELECT f.id, f.content, e.agent, bm25(fts_episodes) AS rank
+    FROM fts_episodes f
+    JOIN episodes e ON e.id = f.id
+    WHERE fts_episodes MATCH ?
+      AND e.superseded_by IS NULL
+      ${agentClause}
+    ORDER BY rank
+    LIMIT ?
+  `).all(...params);
+}
+export function searchFTSSemantics(db, query, limit = 30, agentFilter = null) {
+    const agentClause = agentFilter ? 'AND s.agent = ?' : '';
+    const params = agentFilter ? [query, agentFilter, limit] : [query, limit];
+    return db.prepare(`
+    SELECT f.id, f.content, s.agent, bm25(fts_semantics) AS rank
+    FROM fts_semantics f
+    JOIN semantics s ON s.id = f.id
+    WHERE fts_semantics MATCH ?
+      AND s.state = 'active'
+      ${agentClause}
+    ORDER BY rank
+    LIMIT ?
+  `).all(...params);
+}
+export function searchFTSProcedures(db, query, limit = 30, agentFilter = null) {
+    const agentClause = agentFilter ? 'AND p.agent = ?' : '';
+    const params = agentFilter ? [query, agentFilter, limit] : [query, limit];
+    return db.prepare(`
+    SELECT f.id, f.content, p.agent, bm25(fts_procedures) AS rank
+    FROM fts_procedures f
+    JOIN procedures p ON p.id = f.id
+    WHERE fts_procedures MATCH ?
+      AND p.state = 'active'
+      ${agentClause}
+    ORDER BY rank
+    LIMIT ?
+  `).all(...params);
+}
+/**
+ * Backfill FTS tables from existing data.
+ */
+export function backfillFTS(db) {
+    const episodes = db.prepare('SELECT id, content, tags FROM episodes').all();
+    const insert = db.prepare('INSERT OR IGNORE INTO fts_episodes(id, content, tags) VALUES (?, ?, ?)');
+    for (const ep of episodes) {
+        const parsed = ep.tags ? (typeof ep.tags === 'string' ? JSON.parse(ep.tags) : ep.tags) : [];
+        const tagsText = Array.isArray(parsed) ? parsed.join(' ') : '';
+        insert.run(ep.id, ep.content, tagsText);
+    }
+    const semantics = db.prepare('SELECT id, content FROM semantics').all();
+    const insertSem = db.prepare('INSERT OR IGNORE INTO fts_semantics(id, content) VALUES (?, ?)');
+    for (const sem of semantics) {
+        insertSem.run(sem.id, sem.content);
+    }
+    const procedures = db.prepare('SELECT id, content FROM procedures').all();
+    const insertProc = db.prepare('INSERT OR IGNORE INTO fts_procedures(id, content) VALUES (?, ?)');
+    for (const proc of procedures) {
+        insertProc.run(proc.id, proc.content);
+    }
+}
+/**
+ * Sanitize FTS5 query — escape special characters.
+ */
+export function sanitizeFTSQuery(query) {
+    return query
+        .replace(/[*"(){}[\]^~\:]/g, ' ')
+        .replace(/\bAND\b|\bOR\b|\bNOT\b|\bNEAR\b/gi, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .join(' ');
+}
+//# sourceMappingURL=fts.js.map

package/dist/src/fts.js.map

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

package/dist/src/hybrid-recall.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Hybrid retrieval: vector KNN + FTS5 BM25, fused via Reciprocal Rank Fusion.
+ *
+ * RRF is the simplest fusion that tends to hold up in practice:
+ *     score(d) = sum_i 1 / (k + rank_i(d))
+ * where each `i` is a retriever (vector, FTS) and `k` is a smoothing constant
+ * (60 is the classic default). Documents that show up in only one retriever
+ * still contribute; documents in both get additive boosts without either
+ * retriever dominating.
+ *
+ * This module does NOT re-implement confidence scoring — vector candidates
+ * arrive already scored; FTS-only candidates get an enrichment pass that
+ * loads the underlying row and computes a reduced "base confidence" from
+ * source reliability / support ratio. That's intentionally simpler than the
+ * full KNN confidence pipeline for v1; the demo gets what it needs and the
+ * capsule's categorization layer does the heavy interpretive lifting.
+ */
+import Database from 'better-sqlite3';
+import type { MemoryType, RecallResult, RetrievalMode } from './types.js';
+export declare function ftsIdsByType(db: Database.Database, query: string, types: MemoryType[], limit: number): Map<MemoryType, string[]>;
+export interface FuseFilters {
+    tags?: string[];
+    sources?: string[];
+    after?: string;
+    before?: string;
+}
+export interface FuseInput {
+    vectorResults: RecallResult[];
+    ftsIds: Map<MemoryType, string[]>;
+    mode: RetrievalMode;
+    includePrivate?: boolean;
+    includeDormant?: boolean;
+    minConfidence?: number;
+    filters?: FuseFilters;
+}
+export declare function fuseResults(db: Database.Database, input: FuseInput): RecallResult[];
+//# sourceMappingURL=hybrid-recall.d.ts.map

package/dist/src/hybrid-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-recall.d.ts","sourceRoot":"","sources":["../../src/hybrid-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4C1E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAqB3B;AAwED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyBD,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,YAAY,EAAE,CA+DnF"}