@getrift/rift 0.0.0 → 0.1.0-beta.0

package/dist/src/providers/voyage.js

@@ -0,0 +1,135 @@
+/**
+ * Voyage-3-lite embedding provider.
+ *
+ * Calls the Voyage AI embeddings API with retry + exponential backoff.
+ * Supports optional disk caching to reduce API calls.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { DEFAULT_RETRY_CONFIG, EMBEDDING_DIMENSIONS } from "./types.js";
+const VOYAGE_API_URL = "https://api.voyageai.com/v1/embeddings";
+export class VoyageEmbeddingProvider {
+    apiKey;
+    model;
+    retry;
+    cachePath;
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.model = opts.model ?? "voyage-3-lite";
+        this.retry = { ...DEFAULT_RETRY_CONFIG, ...opts.retry };
+        this.cachePath = opts.cachePath;
+        if (this.cachePath) {
+            fs.mkdirSync(this.cachePath, { recursive: true });
+        }
+    }
+    async embed(text) {
+        const cached = this.readCache(text);
+        if (cached)
+            return cached;
+        const [result] = await this.callApi([text]);
+        if (!result)
+            throw new Error("Voyage API returned empty embeddings");
+        this.writeCache(text, result);
+        return result;
+    }
+    async embedBatch(texts) {
+        // Check cache for each text; collect cache misses.
+        const results = texts.map((t) => this.readCache(t));
+        const misses = [];
+        for (let i = 0; i < texts.length; i++) {
+            if (results[i] === null) {
+                misses.push({ index: i, text: texts[i] });
+            }
+        }
+        if (misses.length > 0) {
+            const embeddings = await this.callApi(misses.map((m) => m.text));
+            for (let i = 0; i < misses.length; i++) {
+                const miss = misses[i];
+                const embedding = embeddings[i];
+                results[miss.index] = embedding;
+                this.writeCache(miss.text, embedding);
+            }
+        }
+        return results;
+    }
+    /** Call Voyage API with retry + exponential backoff. */
+    async callApi(texts) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.retry.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const delay = Math.min(this.retry.baseDelayMs * 2 ** (attempt - 1), this.retry.maxDelayMs);
+                await sleep(delay);
+            }
+            try {
+                const res = await fetch(VOYAGE_API_URL, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify({
+                        input: texts,
+                        model: this.model,
+                    }),
+                });
+                if (res.status === 429 || res.status >= 500) {
+                    lastError = new Error(`Voyage API ${res.status}: ${await res.text()}`);
+                    continue; // Transient — retry
+                }
+                if (!res.ok) {
+                    throw new Error(`Voyage API ${res.status}: ${await res.text()}`);
+                }
+                const body = (await res.json());
+                return body.data.map((d) => d.embedding);
+            }
+            catch (err) {
+                if (err instanceof TypeError) {
+                    // Network error — transient, retry
+                    lastError = err;
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError;
+    }
+    // --- Disk cache ---
+    cacheKey(text) {
+        return crypto
+            .createHash("sha256")
+            .update(`${this.model}:${text}`)
+            .digest("hex");
+    }
+    readCache(text) {
+        if (!this.cachePath)
+            return null;
+        const file = path.join(this.cachePath, this.cacheKey(text) + ".json");
+        try {
+            const raw = fs.readFileSync(file, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed) && parsed.length === EMBEDDING_DIMENSIONS) {
+                return parsed;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    writeCache(text, embedding) {
+        if (!this.cachePath)
+            return;
+        const file = path.join(this.cachePath, this.cacheKey(text) + ".json");
+        try {
+            fs.writeFileSync(file, JSON.stringify(embedding));
+        }
+        catch {
+            // Cache write failure is non-fatal.
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=voyage.js.map

package/dist/src/providers/voyage.js.map

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

package/dist/src/retrieval/compact.d.ts

@@ -0,0 +1,89 @@
+import type { TableName } from "../storage/tables.js";
+import type { RankedResult } from "./reranker.js";
+export declare const SNIPPET_MAX = 400;
+export declare const SUMMARY_MAX = 800;
+export declare const TITLE_MAX = 120;
+export type Tier = "hot" | "cold" | "digest" | "document" | "structured_doc";
+export interface CompactExpand {
+    route: string;
+    params: Record<string, unknown>;
+}
+export interface CompactHit {
+    id: string;
+    source: string;
+    title: string;
+    score: number;
+    retrieval_method: string;
+    timestamp: string;
+    tier: Tier;
+    snippet: string;
+    summary: string;
+    expand: CompactExpand;
+    /** Raw content, present only when the caller asked for detail=full. */
+    content?: string;
+}
+type RawRow = Record<string, unknown>;
+/**
+ * Batch-fetch the raw source rows for reranked results.
+ * Groups ids by source table and issues one `id IN (...)` query per table.
+ */
+export declare function fetchRawRowsForRanked(ranked: RankedResult[]): Promise<Map<string, RawRow>>;
+/** Derive the compact `tier` label from source_table (+ source_scope for docs). */
+export declare function deriveTier(sourceTable: TableName, row?: RawRow): Tier;
+/**
+ * Candidate source tables that can hold a row with the given compact tier.
+ * The `document` and `structured_doc` tiers map to either the cloud or local
+ * structured-docs table — callers should try them in order and keep the first hit.
+ */
+export declare function tablesForTier(tier: Tier): TableName[];
+/**
+ * Fetch a single row by id for the id-based expansion path on /search.
+ *
+ * When `sourceTableHint` is provided, only that table is consulted — this is
+ * the authoritative path for compact hits, which carry their backing table
+ * identity in `expand.params.source_table` precisely to disambiguate rows
+ * that may share an id across the cloud / local structured-doc tables.
+ *
+ * When `sourceTableHint` is omitted, falls back to iterating the candidate
+ * tables for the tier (first-match wins). This fallback is only used for
+ * hand-crafted expansion requests that don't carry `source_table`.
+ */
+export declare function fetchRowByIdForTier(id: string, tier: Tier, sourceTableHint?: TableName): Promise<{
+    row: RawRow;
+    sourceTable: TableName;
+} | null>;
+/**
+ * Build a CompactHit directly from a raw row (bypassing retrieval/ranking).
+ * Used by the id-based expansion path: score is fixed at 1.0 and
+ * retrieval_method is labelled "direct" to signal a non-search fetch.
+ */
+export declare function buildCompactHitFromRow(row: RawRow, sourceTable: TableName, opts: {
+    query?: string;
+    expandRoute?: string;
+}): CompactHit;
+/** Derive a stable `source` string (what produced this row). */
+export declare function deriveSource(sourceTable: TableName, row?: RawRow): string;
+/** Derive a compact title. Prefers stored metadata, then first non-empty line. */
+export declare function deriveTitle(sourceTable: TableName, row: RawRow | undefined, content: string, summary: string): string;
+/**
+ * Derive a bounded snippet.
+ * - lexical/hybrid: up to 400 chars centered on the best query-term hit.
+ * - vector-only: first 400 chars of the first user turn (or content).
+ */
+export declare function deriveSnippet(content: string, query: string, retrievalMethod: string): string;
+/** Derive a bounded summary. Prefers stored summary, then content fallback. */
+export declare function deriveSummary(row: RawRow | undefined, content: string): string;
+export interface BuildCompactHitOptions {
+    query: string;
+    detail: "summary" | "full";
+    /** Route to advertise in `expand.route`. Defaults to "/search". */
+    expandRoute?: string;
+}
+export declare function buildCompactHit(ranked: RankedResult, row: RawRow | undefined, opts: BuildCompactHitOptions): CompactHit;
+/** Compact markdown rendering of a set of hits — no raw JSON. */
+export declare function renderCompactMarkdown(hits: CompactHit[], opts?: {
+    degraded?: boolean;
+    degradedReason?: string;
+}): string;
+export {};
+//# sourceMappingURL=compact.d.ts.map

package/dist/src/retrieval/compact.d.ts.map

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

package/dist/src/retrieval/compact.js

@@ -0,0 +1,348 @@
+/**
+ * Slice 1: Compact retrieval contract.
+ *
+ * Turns reranked results into a compact DTO that is safe to return to
+ * agents: bounded snippet/summary, no raw content by default, and a
+ * self-describing `expand` pointer for `detail=full` retrieval.
+ *
+ * Locked caps:
+ * - snippet  <= 400 characters
+ * - summary  <= 800 characters
+ */
+import { getTable } from "../storage/tables.js";
+import { tokenize } from "./lexical.js";
+export const SNIPPET_MAX = 400;
+export const SUMMARY_MAX = 800;
+export const TITLE_MAX = 120;
+/**
+ * Batch-fetch the raw source rows for reranked results.
+ * Groups ids by source table and issues one `id IN (...)` query per table.
+ */
+export async function fetchRawRowsForRanked(ranked) {
+    const byTable = new Map();
+    for (const r of ranked) {
+        const arr = byTable.get(r.source_table) ?? [];
+        arr.push(r.id);
+        byTable.set(r.source_table, arr);
+    }
+    const out = new Map();
+    for (const [tableName, ids] of byTable) {
+        if (ids.length === 0)
+            continue;
+        const quoted = ids.map((i) => `'${i.replace(/'/g, "''")}'`).join(",");
+        const rows = (await getTable(tableName)
+            .query()
+            .where(`id IN (${quoted})`)
+            .limit(ids.length)
+            .toArray());
+        for (const row of rows) {
+            out.set(row.id, row);
+        }
+    }
+    return out;
+}
+/** Derive the compact `tier` label from source_table (+ source_scope for docs). */
+export function deriveTier(sourceTable, row) {
+    switch (sourceTable) {
+        case "conversations_hot":
+            return "hot";
+        case "conversations_cold":
+            return "cold";
+        case "digests":
+            return "digest";
+        case "structured_docs":
+        case "structured_docs_local": {
+            const scope = row?.source_scope;
+            return scope === "document" ? "document" : "structured_doc";
+        }
+    }
+}
+/**
+ * Candidate source tables that can hold a row with the given compact tier.
+ * The `document` and `structured_doc` tiers map to either the cloud or local
+ * structured-docs table — callers should try them in order and keep the first hit.
+ */
+export function tablesForTier(tier) {
+    switch (tier) {
+        case "hot":
+            return ["conversations_hot"];
+        case "cold":
+            return ["conversations_cold"];
+        case "digest":
+            return ["digests"];
+        case "document":
+        case "structured_doc":
+            return ["structured_docs", "structured_docs_local"];
+    }
+}
+/**
+ * Fetch a single row by id for the id-based expansion path on /search.
+ *
+ * When `sourceTableHint` is provided, only that table is consulted — this is
+ * the authoritative path for compact hits, which carry their backing table
+ * identity in `expand.params.source_table` precisely to disambiguate rows
+ * that may share an id across the cloud / local structured-doc tables.
+ *
+ * When `sourceTableHint` is omitted, falls back to iterating the candidate
+ * tables for the tier (first-match wins). This fallback is only used for
+ * hand-crafted expansion requests that don't carry `source_table`.
+ */
+export async function fetchRowByIdForTier(id, tier, sourceTableHint) {
+    const escaped = id.replace(/'/g, "''");
+    const candidates = sourceTableHint
+        ? [sourceTableHint]
+        : tablesForTier(tier);
+    for (const tableName of candidates) {
+        const rows = (await getTable(tableName)
+            .query()
+            .where(`id = '${escaped}'`)
+            .limit(1)
+            .toArray());
+        if (rows.length > 0) {
+            return { row: rows[0], sourceTable: tableName };
+        }
+    }
+    return null;
+}
+/**
+ * Build a CompactHit directly from a raw row (bypassing retrieval/ranking).
+ * Used by the id-based expansion path: score is fixed at 1.0 and
+ * retrieval_method is labelled "direct" to signal a non-search fetch.
+ */
+export function buildCompactHitFromRow(row, sourceTable, opts) {
+    const tier = deriveTier(sourceTable, row);
+    const content = row.content || "";
+    const summary = deriveSummary(row, content);
+    const title = deriveTitle(sourceTable, row, content, summary);
+    const snippet = deriveSnippet(content, opts.query ?? "", "direct");
+    const timestamp = row.indexed_at ||
+        row.created_at ||
+        "";
+    const id = row.id;
+    return {
+        id,
+        source: deriveSource(sourceTable, row),
+        title,
+        score: 1.0,
+        retrieval_method: "direct",
+        timestamp,
+        tier,
+        snippet,
+        summary,
+        expand: {
+            route: opts.expandRoute ?? "/search",
+            params: { id, tier, source_table: sourceTable, detail: "full" },
+        },
+        content,
+    };
+}
+/** Derive a stable `source` string (what produced this row). */
+export function deriveSource(sourceTable, row) {
+    if (sourceTable === "conversations_hot" || sourceTable === "conversations_cold") {
+        return row?.source || "conversation";
+    }
+    if (sourceTable === "digests")
+        return "digest";
+    return row?.source_type || "filesystem";
+}
+/** Derive a compact title. Prefers stored metadata, then first non-empty line. */
+export function deriveTitle(sourceTable, row, content, summary) {
+    // Explicit stored title in metadata JSON takes precedence.
+    const metaTitle = readMetadataTitle(row);
+    if (metaTitle)
+        return truncate(metaTitle, TITLE_MAX);
+    if (sourceTable === "digests" && row) {
+        const start = row.period_start || "";
+        const end = row.period_end || "";
+        if (start || end)
+            return truncate(`Digest ${start}→${end}`, TITLE_MAX);
+    }
+    // Basename of a document path is a decent fallback for structured_docs.
+    if (sourceTable === "structured_docs" || sourceTable === "structured_docs_local") {
+        const p = row?.source_path;
+        if (p) {
+            const base = p.split("/").filter(Boolean).pop();
+            if (base)
+                return truncate(base, TITLE_MAX);
+        }
+    }
+    const firstLine = firstNonEmptyLine(summary) || firstNonEmptyLine(content);
+    if (firstLine)
+        return truncate(firstLine, TITLE_MAX);
+    return "(untitled)";
+}
+/**
+ * Derive a bounded snippet.
+ * - lexical/hybrid: up to 400 chars centered on the best query-term hit.
+ * - vector-only: first 400 chars of the first user turn (or content).
+ */
+export function deriveSnippet(content, query, retrievalMethod) {
+    if (!content)
+        return "";
+    if (retrievalMethod === "lexical" || retrievalMethod === "hybrid") {
+        const centered = centerOnQueryMatch(content, query);
+        if (centered !== null)
+            return truncate(centered, SNIPPET_MAX);
+    }
+    const firstTurn = extractFirstUserTurn(content);
+    return truncate(collapseWhitespace(firstTurn || content), SNIPPET_MAX);
+}
+/** Derive a bounded summary. Prefers stored summary, then content fallback. */
+export function deriveSummary(row, content) {
+    const stored = row?.summary ?? "";
+    if (stored.trim())
+        return truncate(collapseWhitespace(stored), SUMMARY_MAX);
+    const metaSummary = readMetadataSummary(row);
+    if (metaSummary)
+        return truncate(collapseWhitespace(metaSummary), SUMMARY_MAX);
+    const firstTurn = extractFirstUserTurn(content);
+    return truncate(collapseWhitespace(firstTurn || content), SUMMARY_MAX);
+}
+export function buildCompactHit(ranked, row, opts) {
+    const tier = deriveTier(ranked.source_table, row);
+    const content = ranked.content || row?.content || "";
+    const summary = deriveSummary(row, content);
+    const title = deriveTitle(ranked.source_table, row, content, summary);
+    const snippet = deriveSnippet(content, opts.query, ranked.retrieval_method);
+    const timestamp = row?.indexed_at ||
+        row?.created_at ||
+        "";
+    const hit = {
+        id: ranked.id,
+        source: deriveSource(ranked.source_table, row),
+        title,
+        score: ranked.score,
+        retrieval_method: ranked.retrieval_method,
+        timestamp,
+        tier,
+        snippet,
+        summary,
+        expand: {
+            route: opts.expandRoute ?? "/search",
+            // `source_table` is carried so the expansion path can fetch the exact
+            // backing row without guessing — critical for `document`/`structured_doc`
+            // tiers, where the same id may exist in both cloud and local tables.
+            params: {
+                id: ranked.id,
+                tier,
+                source_table: ranked.source_table,
+                detail: "full",
+            },
+        },
+    };
+    if (opts.detail === "full") {
+        hit.content = content;
+    }
+    return hit;
+}
+// --- Markdown rendering (MCP text channel) ---
+/** Compact markdown rendering of a set of hits — no raw JSON. */
+export function renderCompactMarkdown(hits, opts = {}) {
+    const lines = [];
+    if (opts.degraded) {
+        lines.push(`> ⚠ degraded${opts.degradedReason ? `: ${opts.degradedReason}` : ""}`, "");
+    }
+    if (hits.length === 0) {
+        lines.push("_No results._");
+        return lines.join("\n");
+    }
+    hits.forEach((h, i) => {
+        const title = escapeMd(h.title ?? "(untitled)");
+        const tier = h.tier ?? "?";
+        const source = h.source ?? "?";
+        const score = typeof h.score === "number" ? h.score.toFixed(3) : "?";
+        const method = h.retrieval_method ?? "?";
+        lines.push(`${i + 1}. **${title}** — _${tier}_ · ${source} · score ${score} (${method})`);
+        if (h.snippet)
+            lines.push(`   ${escapeMd(h.snippet)}`);
+        // Render the expand pointer with the *actual* params object the route
+        // expects, so the printed markdown is round-trippable — an agent can
+        // copy-paste `{ ... }` as the request body for the route.
+        const expandRoute = h.expand?.route ?? "/search";
+        const params = h.expand?.params ?? { id: h.id, detail: "full" };
+        lines.push(`   \`expand: ${expandRoute} ${JSON.stringify(params)}\``);
+    });
+    return lines.join("\n");
+}
+// --- Internals ---
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    // Hard cap at `max` to guarantee the locked contract; callers rely on this.
+    return text.slice(0, max);
+}
+function collapseWhitespace(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+function firstNonEmptyLine(text) {
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim();
+        if (t) {
+            // Strip common markdown heading hashes and list bullets for titles.
+            return t.replace(/^#+\s*/, "").replace(/^[-*]\s+/, "");
+        }
+    }
+    return "";
+}
+function extractFirstUserTurn(content) {
+    // Best-effort: look for a "User:" / "Human:" marker at the start of a line
+    // followed by text up to the next role marker. Falls back to empty string.
+    const match = content.match(/(?:^|\n)\s*(?:user|human)\s*:\s*([\s\S]*?)(?:\n\s*(?:assistant|ai|model|system)\s*:|\n{2,}#|$)/i);
+    if (match && match[1])
+        return match[1].trim();
+    return "";
+}
+function centerOnQueryMatch(content, query) {
+    const terms = tokenize(query);
+    if (terms.length === 0)
+        return null;
+    const lower = content.toLowerCase();
+    let bestIdx = -1;
+    for (const t of terms) {
+        const idx = lower.indexOf(t.toLowerCase());
+        if (idx >= 0 && (bestIdx === -1 || idx < bestIdx))
+            bestIdx = idx;
+    }
+    if (bestIdx < 0)
+        return null;
+    const halfWindow = Math.floor(SNIPPET_MAX / 2);
+    const start = Math.max(0, bestIdx - halfWindow);
+    const end = Math.min(content.length, start + SNIPPET_MAX);
+    const adjustedStart = Math.max(0, end - SNIPPET_MAX);
+    const slice = content.slice(adjustedStart, end);
+    return collapseWhitespace(slice);
+}
+function readMetadataTitle(row) {
+    const meta = row?.metadata;
+    if (typeof meta !== "string" || !meta)
+        return null;
+    try {
+        const parsed = JSON.parse(meta);
+        const t = parsed["title"];
+        if (typeof t === "string" && t.trim())
+            return t.trim();
+    }
+    catch {
+        // ignore malformed metadata
+    }
+    return null;
+}
+function readMetadataSummary(row) {
+    const meta = row?.metadata;
+    if (typeof meta !== "string" || !meta)
+        return null;
+    try {
+        const parsed = JSON.parse(meta);
+        const s = parsed["summary"];
+        if (typeof s === "string" && s.trim())
+            return s.trim();
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function escapeMd(text) {
+    return text.replace(/\|/g, "\\|").replace(/\n+/g, " ");
+}
+//# sourceMappingURL=compact.js.map

package/dist/src/retrieval/compact.js.map

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