@sumeru/server 0.1.0

package/dist/search/sqlite-index.js

@@ -0,0 +1,508 @@
+/**
+ * Phase 5 — FTS5 search index.
+ *
+ * This module owns the SQLite FTS5 schema that backs Sumeru's session search.
+ * The index lives in `<ocasDir>/_store.db` — the same file `@ocas/fs` opens
+ * for variables and tags. We open a second `DatabaseSync` handle on the same
+ * file (safe because `@ocas/fs` enables WAL).
+ *
+ * The schema:
+ *   - `sumeru_turn_index`     — one row per turn (PK = turn ocas hash)
+ *   - `sumeru_turn_fts`       — contentless FTS5 virtual table (mirrors content)
+ *   - `sumeru_session_index`  — one row per session (PK = session id)
+ *
+ * Triggers keep `sumeru_turn_fts` in lockstep with `sumeru_turn_index`.
+ *
+ * All write paths are idempotent on the turn hash / session id, so re-indexing
+ * the same node is a no-op.
+ */
+import { DatabaseSync } from "node:sqlite";
+const SCHEMA_DDL = `
+CREATE TABLE IF NOT EXISTS sumeru_turn_index (
+  turn_hash      TEXT PRIMARY KEY,
+  session_id     TEXT NOT NULL,
+  gateway        TEXT NOT NULL,
+  turn_index     INTEGER NOT NULL,
+  role           TEXT NOT NULL,
+  content        TEXT NOT NULL,
+  created_at     TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_sumeru_turn_index_session
+  ON sumeru_turn_index(session_id);
+CREATE INDEX IF NOT EXISTS idx_sumeru_turn_index_gateway
+  ON sumeru_turn_index(gateway);
+
+CREATE TABLE IF NOT EXISTS sumeru_session_index (
+  session_id      TEXT PRIMARY KEY,
+  gateway         TEXT NOT NULL,
+  adapter         TEXT NOT NULL,
+  status          TEXT NOT NULL,
+  created_at      TEXT NOT NULL,
+  last_active_at  TEXT NOT NULL,
+  turn_count      INTEGER NOT NULL DEFAULT 0,
+  meta_hash       TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_sumeru_session_index_gateway
+  ON sumeru_session_index(gateway);
+CREATE INDEX IF NOT EXISTS idx_sumeru_session_index_last_active
+  ON sumeru_session_index(last_active_at DESC);
+
+-- Phase 6 (Refs #399): durable, ordered, per-session turn-list pointer. This
+-- is the canonical list the session store rehydrates on boot. It is NOT owned
+-- by FTS and is never cleared by rebuild().
+CREATE TABLE IF NOT EXISTS sumeru_session_turns (
+  session_id  TEXT NOT NULL,
+  turn_index  INTEGER NOT NULL,
+  turn_hash   TEXT NOT NULL,
+  PRIMARY KEY (session_id, turn_index)
+);
+CREATE INDEX IF NOT EXISTS idx_sumeru_session_turns_session
+  ON sumeru_session_turns(session_id);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS sumeru_turn_fts USING fts5(
+  content,
+  content='sumeru_turn_index',
+  content_rowid='rowid',
+  tokenize='unicode61 remove_diacritics 2'
+);
+
+CREATE TRIGGER IF NOT EXISTS sumeru_turn_fts_ai AFTER INSERT ON sumeru_turn_index BEGIN
+  INSERT INTO sumeru_turn_fts(rowid, content) VALUES (new.rowid, new.content);
+END;
+CREATE TRIGGER IF NOT EXISTS sumeru_turn_fts_ad AFTER DELETE ON sumeru_turn_index BEGIN
+  INSERT INTO sumeru_turn_fts(sumeru_turn_fts, rowid, content) VALUES('delete', old.rowid, old.content);
+END;
+`;
+/**
+ * Open a second SQLite handle on the same `_store.db` file `@ocas/fs` writes
+ * vars/tags into. Creates the FTS5 schema if not present. Retries up to 3×
+ * on `SQLITE_BUSY` with a 50 ms backoff.
+ *
+ * Throws `failed to create FTS5 index: <cause>` on persistent failure — the
+ * caller (`openSumeruOcas`) prepends `failed to open ocas store at <dir>: `
+ * so all boot failures share the same prefix.
+ */
+export function createSearchIndex(dbPath) {
+    const db = openWithRetry(dbPath);
+    try {
+        db.exec("BEGIN");
+        db.exec(SCHEMA_DDL);
+        migrateMetaHashColumn(db);
+        db.exec("COMMIT");
+    }
+    catch (err) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            // best-effort
+        }
+        const cause = err instanceof Error ? err.message : String(err);
+        throw new Error(`failed to create FTS5 index: ${cause}`);
+    }
+    const insertSession = db.prepare(`
+		INSERT INTO sumeru_session_index
+			(session_id, gateway, adapter, status, created_at, last_active_at, turn_count, meta_hash)
+		VALUES (?, ?, ?, 'idle', ?, ?, 0, ?)
+		ON CONFLICT(session_id) DO NOTHING
+	`);
+    const insertTurn = db.prepare(`
+		INSERT INTO sumeru_turn_index
+			(turn_hash, session_id, gateway, turn_index, role, content, created_at)
+		VALUES (?, ?, ?, ?, ?, ?, ?)
+		ON CONFLICT(turn_hash) DO NOTHING
+	`);
+    const bumpSession = db.prepare(`
+		UPDATE sumeru_session_index
+		   SET last_active_at = ?,
+		       turn_count     = turn_count + 1
+		 WHERE session_id = ?
+	`);
+    const closeSession = db.prepare(`
+		UPDATE sumeru_session_index
+		   SET status = 'closed'
+		 WHERE session_id = ?
+	`);
+    const countTurns = db.prepare(`SELECT COUNT(*) AS c FROM sumeru_turn_index`);
+    // Phase 6 (Refs #399): turn-list pointer statements.
+    const appendTurn = db.prepare(`
+		INSERT INTO sumeru_session_turns (session_id, turn_index, turn_hash)
+		VALUES (?, ?, ?)
+		ON CONFLICT(session_id, turn_index) DO NOTHING
+	`);
+    const selectTurnsForSession = db.prepare(`
+		SELECT turn_hash
+		  FROM sumeru_session_turns
+		 WHERE session_id = ?
+		 ORDER BY turn_index ASC
+	`);
+    const selectAllTurns = db.prepare(`
+		SELECT session_id, turn_hash
+		  FROM sumeru_session_turns
+		 ORDER BY session_id, turn_index ASC
+	`);
+    const selectAllSessions = db.prepare(`
+		SELECT session_id, gateway, adapter, status,
+		       created_at, last_active_at, turn_count, meta_hash
+		  FROM sumeru_session_index
+		 ORDER BY created_at ASC
+	`);
+    function indexSessionMeta(meta) {
+        insertSession.run(meta.sessionId, meta.gateway, meta.adapter, meta.createdAt, meta.createdAt, meta.metaHash);
+    }
+    function appendSessionTurn(sessionId, turnIndex, turnHash) {
+        appendTurn.run(sessionId, turnIndex, turnHash);
+    }
+    function listSessionTurns(sessionId) {
+        const rows = selectTurnsForSession.all(sessionId);
+        return rows.map((r) => r.turn_hash);
+    }
+    function loadSessionTurnsBulk() {
+        const rows = selectAllTurns.all();
+        const out = new Map();
+        for (const row of rows) {
+            let list = out.get(row.session_id);
+            if (list === undefined) {
+                list = [];
+                out.set(row.session_id, list);
+            }
+            list.push(row.turn_hash);
+        }
+        return out;
+    }
+    function loadSessionRows() {
+        const rows = selectAllSessions.all();
+        return rows.map((r) => ({
+            sessionId: r.session_id,
+            gateway: r.gateway,
+            adapter: r.adapter,
+            status: normalizeStatus(r.status),
+            createdAt: r.created_at,
+            lastActiveAt: r.last_active_at,
+            turnCount: Number(r.turn_count ?? 0),
+            metaHash: r.meta_hash === null ? null : r.meta_hash,
+        }));
+    }
+    function indexTurn(input) {
+        db.exec("BEGIN");
+        try {
+            const result = insertTurn.run(input.turnHash, input.sessionId, input.gateway, input.turnIndex, input.role, input.content, input.createdAt);
+            // On INSERT-vs-conflict: only bump turn_count when a new row was
+            // actually inserted. node:sqlite's run() returns { changes } where
+            // changes === 0 means the conflict path took DO NOTHING.
+            if (Number(result.changes ?? 0) > 0) {
+                bumpSession.run(input.createdAt, input.sessionId);
+            }
+            db.exec("COMMIT");
+        }
+        catch (err) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // best-effort
+            }
+            throw err;
+        }
+    }
+    function markSessionClosed(sessionId) {
+        try {
+            closeSession.run(sessionId);
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err.message : String(err);
+            console.warn(`[sumeru] search index update failed: ${cause}`);
+        }
+    }
+    function search(opts) {
+        const trimmed = opts.query.trim();
+        if (trimmed.length === 0) {
+            return { query: "", results: [], total: 0 };
+        }
+        const matchExpr = quoteFtsPhrase(trimmed);
+        const limit = clamp(opts.limit, 1, 100);
+        const offset = Math.max(0, opts.offset);
+        // FTS5 auxiliary functions (bm25, snippet) only work in queries that
+        // reference the FTS5 virtual table at the top level; they don't work
+        // through CTEs. So we collect raw matches first, then aggregate in JS.
+        const matchStmt = db.prepare(`
+			SELECT t.session_id AS session_id,
+			       snippet(sumeru_turn_fts, 0, '<<', '>>', '…', 24) AS snip,
+			       bm25(sumeru_turn_fts) AS score
+			  FROM sumeru_turn_fts
+			  JOIN sumeru_turn_index t ON t.rowid = sumeru_turn_fts.rowid
+			 WHERE sumeru_turn_fts MATCH ?
+			   AND ( ?2 IS NULL OR t.gateway = ?2 )
+			 ORDER BY score ASC
+		`);
+        let matchRows;
+        try {
+            matchRows = matchStmt.all(matchExpr, opts.gateway);
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err.message : String(err);
+            console.warn(`[sumeru] search index query failed: ${cause}`);
+            return { query: trimmed, results: [], total: 0 };
+        }
+        // Aggregate to session granularity — keep best (lowest BM25) per session.
+        // `matchRows` is already sorted ASC by score, so the first occurrence per
+        // session is its best.
+        const bestBySession = new Map();
+        for (const row of matchRows) {
+            if (!bestBySession.has(row.session_id)) {
+                bestBySession.set(row.session_id, {
+                    score: Number(row.score),
+                    snip: String(row.snip),
+                });
+            }
+        }
+        const total = bestBySession.size;
+        if (total === 0) {
+            return { query: trimmed, results: [], total: 0 };
+        }
+        // Read session rows in one IN-clause query, then re-order in JS by best
+        // score ASC, last_active_at DESC for stable tie-break.
+        const ids = Array.from(bestBySession.keys());
+        const placeholders = ids.map(() => "?").join(", ");
+        const sessionStmt = db.prepare(`
+			SELECT session_id, gateway, status, last_active_at, turn_count
+			  FROM sumeru_session_index
+			 WHERE session_id IN (${placeholders})
+		`);
+        const sessionRows = sessionStmt.all(...ids);
+        const merged = [];
+        for (const sess of sessionRows) {
+            const best = bestBySession.get(sess.session_id);
+            if (best === undefined)
+                continue;
+            merged.push({ best, session: sess });
+        }
+        merged.sort((a, b) => {
+            if (a.best.score !== b.best.score)
+                return a.best.score - b.best.score;
+            // Tie-break by last_active_at DESC (newer first).
+            return a.session.last_active_at > b.session.last_active_at
+                ? -1
+                : a.session.last_active_at < b.session.last_active_at
+                    ? 1
+                    : 0;
+        });
+        const paged = merged.slice(offset, offset + limit);
+        const results = [];
+        for (const r of paged) {
+            const score = r.best.score;
+            // FTS5 BM25 is negative-weighted by default in SQLite (lower = better,
+            // negative numbers are common). Use abs for normalization so the
+            // 1/(1+|s|) formula keeps the (0, 1] mapping regardless of sign.
+            const relevance = 1 / (1 + Math.abs(score));
+            const rawSnip = r.best.snip;
+            const matchContext = opts.stripHighlights
+                ? rawSnip.replace(/<<|>>/g, "")
+                : rawSnip;
+            results.push({
+                id: r.session.session_id,
+                gateway: r.session.gateway,
+                status: r.session.status,
+                relevance,
+                matchContext,
+                turns: Number(r.session.turn_count ?? 0),
+                lastActiveAt: r.session.last_active_at,
+            });
+        }
+        return { query: trimmed, results, total };
+    }
+    function rebuild(ocas) {
+        // Step 1: Read sumeru_session_turns BEFORE any deletes to build
+        // turnHash → sessionId lookup (this table survives the rebuild).
+        const turnAssocRows = selectAllTurns.all();
+        const turnHashToSessionId = new Map();
+        for (const row of turnAssocRows) {
+            turnHashToSessionId.set(row.turn_hash, row.session_id);
+        }
+        // Step 2: DELETE from FTS index tables (sumeru_session_turns is NOT touched).
+        db.exec("BEGIN");
+        try {
+            db.exec("DELETE FROM sumeru_turn_index");
+            db.exec("DELETE FROM sumeru_session_index");
+            db.exec("COMMIT");
+        }
+        catch (err) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // best-effort
+            }
+            throw err;
+        }
+        // Step 3: Enumerate all session-meta nodes from ocas store.
+        const sessionMetaEntries = ocas.store.cas.listByType(ocas.sessionMetaSchemaHash);
+        // Step 4-6: Index each session-meta and build sessionId → gateway map.
+        const sessionIdToGateway = new Map();
+        for (const entry of sessionMetaEntries) {
+            const node = ocas.store.cas.get(entry.hash);
+            if (node === null)
+                continue;
+            const payload = node.payload;
+            indexSessionMeta({
+                sessionId: payload.id,
+                gateway: payload.gateway,
+                adapter: payload.adapter,
+                createdAt: payload.createdAt,
+                metaHash: entry.hash,
+            });
+            sessionIdToGateway.set(payload.id, payload.gateway);
+        }
+        // Step 7-8: Enumerate all turn nodes and index them.
+        const turnEntries = ocas.store.cas.listByType(ocas.turnSchemaHash);
+        for (const entry of turnEntries) {
+            const node = ocas.store.cas.get(entry.hash);
+            if (node === null)
+                continue;
+            const payload = node.payload;
+            // Look up sessionId from the turnHash → sessionId map.
+            const sessionId = turnHashToSessionId.get(entry.hash);
+            if (sessionId === undefined) {
+                console.warn(`[sumeru] rebuild: skipping orphaned turn ${entry.hash}`);
+                continue;
+            }
+            // Look up gateway from the sessionId → gateway map.
+            const gateway = sessionIdToGateway.get(sessionId);
+            if (gateway === undefined) {
+                console.warn(`[sumeru] rebuild: skipping orphaned turn ${entry.hash}`);
+                continue;
+            }
+            indexTurn({
+                turnHash: entry.hash,
+                sessionId,
+                gateway,
+                turnIndex: payload.index,
+                role: payload.role,
+                content: payload.content,
+                createdAt: payload.timestamp,
+            });
+        }
+        // Step 9: Corrective UPDATE to fix turn_count and last_active_at.
+        db.exec(`
+			UPDATE sumeru_session_index
+			   SET turn_count = (
+			         SELECT COUNT(*) FROM sumeru_turn_index
+			          WHERE sumeru_turn_index.session_id = sumeru_session_index.session_id
+			       ),
+			       last_active_at = COALESCE(
+			         (SELECT MAX(created_at) FROM sumeru_turn_index
+			           WHERE sumeru_turn_index.session_id = sumeru_session_index.session_id),
+			         sumeru_session_index.created_at
+			       )
+		`);
+    }
+    function turnCount() {
+        const row = countTurns.get();
+        return Number(row?.c ?? 0);
+    }
+    function close() {
+        db.close();
+    }
+    return {
+        indexSessionMeta,
+        indexTurn,
+        markSessionClosed,
+        appendSessionTurn,
+        listSessionTurns,
+        loadSessionTurnsBulk,
+        loadSessionRows,
+        search,
+        rebuild,
+        turnCount,
+        close,
+    };
+}
+/**
+ * Walk every `@sumeru/session-meta` and `@sumeru/turn` node in the ocas store
+ * and rebuild the FTS5 index from scratch. The internal `rebuild` closure
+ * handles full enumeration via `listByType` and uses `sumeru_session_turns`
+ * for turn→session association.
+ *
+ * Callers no longer need to supply `roots` — the store is the source of truth.
+ */
+export function rebuildSearchIndex(index, ocas) {
+    index.rebuild(ocas);
+}
+/** Wrap a query in `"..."` and double internal `"` to force FTS5 phrase mode. */
+export function quoteFtsPhrase(raw) {
+    return `"${raw.replace(/"/g, '""')}"`;
+}
+/**
+ * Public wrapper that exposes the same `searchSessions` signature the spec
+ * documents. Equivalent to calling `index.search(opts)` with `stripHighlights`
+ * defaulted to `false`.
+ */
+export function searchSessions(index, opts) {
+    return index.search({
+        query: opts.query,
+        gateway: opts.gateway,
+        limit: opts.limit,
+        offset: opts.offset,
+        stripHighlights: opts.stripHighlights ?? false,
+    });
+}
+function clamp(n, min, max) {
+    if (Number.isNaN(n))
+        return min;
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+/**
+ * Phase 6 (Refs #399): add the nullable `meta_hash` column to a pre-existing
+ * `sumeru_session_index` that predates it. SQLite has no
+ * `ADD COLUMN IF NOT EXISTS`, so we probe `PRAGMA table_info` first and only
+ * `ALTER` when the column is absent. Runs inside the open transaction; a no-op
+ * when the column already exists (fresh DBs already define it in the DDL).
+ */
+function migrateMetaHashColumn(db) {
+    const cols = db
+        .prepare("PRAGMA table_info(sumeru_session_index)")
+        .all();
+    const hasMetaHash = cols.some((c) => c.name === "meta_hash");
+    if (!hasMetaHash) {
+        db.exec("ALTER TABLE sumeru_session_index ADD COLUMN meta_hash TEXT");
+    }
+}
+/**
+ * Normalize a persisted status column into a `SessionStatus` for rehydration.
+ * `closed` is preserved; everything else (idle, active, or any unexpected
+ * value) folds to `idle` — a process restart can never leave a send in flight,
+ * so `active` is a transient in-memory state that must not be restored.
+ */
+function normalizeStatus(raw) {
+    return raw === "closed" ? "closed" : "idle";
+}
+/** Open a SQLite handle, retrying on SQLITE_BUSY up to 3× with 50 ms backoff. */
+function openWithRetry(dbPath) {
+    let lastErr = null;
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            const db = new DatabaseSync(dbPath);
+            db.exec("PRAGMA journal_mode = WAL");
+            db.exec("PRAGMA foreign_keys = ON");
+            return db;
+        }
+        catch (err) {
+            lastErr = err;
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!/busy/i.test(msg) && !/locked/i.test(msg))
+                throw err;
+            // 50 ms busy-wait
+            const start = Date.now();
+            while (Date.now() - start < 50) {
+                /* spin */
+            }
+        }
+    }
+    const cause = lastErr instanceof Error ? lastErr.message : String(lastErr);
+    throw new Error(`failed to create FTS5 index: ${cause}`);
+}
+//# sourceMappingURL=sqlite-index.js.map

package/dist/search/sqlite-index.js.map

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

package/dist/search/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Phase 5 — search index types.
+ *
+ * These types are shared by the index module and the HTTP endpoints. The
+ * `SearchIndex` is a closure carrying the SQLite handle; consumers obtain
+ * one from `openSumeruOcas` via the new `searchIndex` slice on the result
+ * (mirrored on `OcasConfig`).
+ */
+import type { Hash, Store } from "@ocas/core";
+import type { SessionStatus } from "../types.js";
+/**
+ * Opaque handle to the FTS5 search index. Carries the SQLite database
+ * handle plus the prepared statements; created by `createSearchIndex`.
+ */
+export type SearchIndex = {
+    /**
+     * Insert a row into `sumeru_session_index`. Idempotent
+     * (`ON CONFLICT DO NOTHING`).
+     */
+    indexSessionMeta: (meta: SessionMetaInput) => void;
+    /**
+     * Insert a row into `sumeru_turn_index` and bump the matching session
+     * row's `turn_count` and `last_active_at`. Idempotent on the turn hash.
+     */
+    indexTurn: (input: IndexTurnInput) => void;
+    /** Update `sumeru_session_index.status` for a session. Best-effort. */
+    markSessionClosed: (sessionId: string) => void;
+    /**
+     * Phase 6 (Refs #399): persist one durable row in `sumeru_session_turns`
+     * recording `(session_id, turn_index, turn_hash)`. Idempotent on
+     * `(session_id, turn_index)` (`ON CONFLICT DO NOTHING`). This is the
+     * canonical turn-list pointer the session store rehydrates from on boot;
+     * it is NOT touched by `rebuild`.
+     */
+    appendSessionTurn: (sessionId: string, turnIndex: number, turnHash: Hash) => void;
+    /**
+     * Phase 6 (Refs #399): read one session's ordered turn hashes from
+     * `sumeru_session_turns`, ordered by `turn_index ASC`. Returns `[]` for an
+     * unknown session.
+     */
+    listSessionTurns: (sessionId: string) => Hash[];
+    /**
+     * Phase 6 (Refs #399): bulk-load every session's ordered turn hashes in a
+     * single query, grouped by `session_id` and ordered by `turn_index ASC`.
+     * Used at store construction so rehydration is O(1) queries.
+     */
+    loadSessionTurnsBulk: () => Map<string, Hash[]>;
+    /**
+     * Phase 6 (Refs #399): read every persisted session row from
+     * `sumeru_session_index` (ordered by `created_at ASC`) so the store can
+     * rebuild its in-memory maps on boot.
+     */
+    loadSessionRows: () => PersistedSessionRow[];
+    /** Run a search and return aggregated session-granularity hits. */
+    search: (opts: SearchOptions) => SearchResult;
+    /** Walk the ocas store and rebuild every index row from scratch. */
+    rebuild: (ocas: SearchRebuildOcas) => void;
+    /** Number of rows currently in `sumeru_turn_index`. */
+    turnCount: () => number;
+    /** Close the underlying SQLite handle (test-only — never used by server). */
+    close: () => void;
+};
+/**
+ * Payload accepted by `indexSessionMeta`. Mirrors the public
+ * `@sumeru/session-meta` schema with `status` defaulted to `idle`.
+ *
+ * Phase 6 (Refs #399): carries `metaHash` so the persisted
+ * `sumeru_session_index` row records the immutable `@sumeru/session-meta`
+ * node hash. On boot the store re-reads `config` from that node. `null` is
+ * accepted for callers/tests that have no meta node (the column is nullable).
+ */
+export type SessionMetaInput = {
+    sessionId: string;
+    gateway: string;
+    adapter: string;
+    createdAt: string;
+    metaHash: Hash | null;
+};
+/**
+ * One row read back from `sumeru_session_index` at boot (Refs #399). Used by
+ * the session store to rebuild its in-memory maps. `metaHash` is `null` for
+ * rows that predate the `meta_hash` column.
+ */
+export type PersistedSessionRow = {
+    sessionId: string;
+    gateway: string;
+    adapter: string;
+    status: SessionStatus;
+    createdAt: string;
+    lastActiveAt: string;
+    turnCount: number;
+    metaHash: Hash | null;
+};
+/** Payload accepted by `indexTurn`. */
+export type IndexTurnInput = {
+    turnHash: Hash;
+    sessionId: string;
+    gateway: string;
+    turnIndex: number;
+    role: "user" | "assistant" | "system";
+    content: string;
+    createdAt: string;
+};
+/** Options accepted by `searchSessions` (and `search`). */
+export type SearchOptions = {
+    /** Raw user query — `searchSessions` trims and quotes it before binding. */
+    query: string;
+    /** Filter by gateway. `null` means cross-gateway. */
+    gateway: string | null;
+    /** 1 ≤ limit ≤ 100. */
+    limit: number;
+    /** ≥ 0. */
+    offset: number;
+    /** When true, FTS5 highlight markers (`<<` / `>>`) are stripped. */
+    stripHighlights: boolean;
+};
+/** Single hit in `SearchResult.results`. */
+export type SearchHit = {
+    id: string;
+    gateway: string;
+    status: SessionStatus;
+    relevance: number;
+    matchContext: string;
+    turns: number;
+    lastActiveAt: string;
+};
+/** Internal-only result of `searchSessions`. */
+export type SearchResult = {
+    query: string;
+    results: SearchHit[];
+    /** Total distinct sessions matching `query` (before limit/offset). */
+    total: number;
+};
+/**
+ * Subset of the ocas store exposed to `rebuild`. The rebuild walker needs
+ * only `cas` reads and the two schema hashes.
+ */
+export type SearchRebuildOcas = {
+    store: Store;
+    turnSchemaHash: Hash;
+    sessionMetaSchemaHash: Hash;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,uEAAuE;IACvE,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;;;;OAMG;IACH,iBAAiB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,KACV,IAAI,CAAC;IACV;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;IAChD;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD;;;;OAIG;IACH,eAAe,EAAE,MAAM,mBAAmB,EAAE,CAAC;IAC7C,mEAAmE;IACnE,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,YAAY,CAAC;IAC9C,oEAAoE;IACpE,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3C,uDAAuD;IACvD,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,IAAI,CAAC;IACrB,qBAAqB,EAAE,IAAI,CAAC;CAC5B,CAAC"}