onadit 0.0.1 → 1.0.0

package/dist/src/providers/operator-overrides.js.map

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

package/dist/src/providers/placeholder-embed.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Placeholder embedding provider for no-key (lexical-only) import.
+ *
+ * When Onadit imports an export without any embedding provider configured
+ * (no Voyage key, no local Ollama), conversation rows still need a vector
+ * value because the LanceDB conversation tables require a fixed-width
+ * `embedding` column. This provider returns a zero vector of the correct
+ * dimension so the row is written and becomes immediately searchable via
+ * lexical/BM25 retrieval (which does not use the vector at all).
+ *
+ * Rows embedded by this provider are marked `embedding_provider = "rift-none"`
+ * (see `ConversationRow`). That marker is the ONLY embedding-backfill target:
+ * once a real provider is connected, a future pass can recompute exactly these
+ * rows, and vector search can exclude them in the meantime. Both the exclusion
+ * filter and the backfill are deliberately out of scope here — this provider
+ * only guarantees that no-key import succeeds and lands searchable rows.
+ */
+import { type EmbeddingProvider } from "./types.js";
+/**
+ * `embedding_provider` marker for placeholder (zero) vectors. Distinct from
+ * "" (a valid/legacy embedding) so backfill and vector-exclusion can target
+ * placeholders precisely without relabeling real embeddings.
+ */
+export declare const RIFT_NONE_EMBEDDING_PROVIDER = "rift-none";
+/**
+ * SQL `where` fragment that excludes no-key placeholder rows from a vector
+ * query. Single-sourced so EVERY conversation vector path (the shared
+ * `vector.ts` helper plus the custom hot/cold/conversations-search queries in
+ * the route layer) excludes `rift-none` identically — a placeholder zero
+ * vector is meaningless under cosine distance, so once a real provider is
+ * connected these stale rows must not pollute semantic results until backfill
+ * recomputes them. Lexical search deliberately does NOT use this (keyword
+ * recall over no-key rows is the whole point of no-key mode). Only apply it to
+ * tables that carry the `embedding_provider` column (conversation tables — not
+ * digests or structured_docs). The provider name is a safe constant, so no SQL
+ * escaping is needed.
+ */
+export declare const RIFT_NONE_VECTOR_EXCLUSION_CLAUSE = "embedding_provider != 'rift-none'";
+export declare class PlaceholderEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "rift-none";
+    readonly model = "rift-none";
+    private readonly dimensions;
+    constructor(dimensions?: number);
+    embed(_text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    private zero;
+}
+/**
+ * True when a vector was written by the no-key placeholder path. Centralized
+ * so writers and (future) vector-exclusion share one definition rather than
+ * scattering string comparisons.
+ */
+export declare function isPlaceholderEmbeddingProvider(provider: {
+    name: string;
+}): boolean;
+//# sourceMappingURL=placeholder-embed.d.ts.map

package/dist/src/providers/placeholder-embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-embed.d.ts","sourceRoot":"","sources":["../../../src/providers/placeholder-embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,cAAc,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC,sCAA4D,CAAC;AAE3G,qBAAa,4BAA6B,YAAW,iBAAiB;IACpE,QAAQ,CAAC,IAAI,eAAgC;IAC7C,QAAQ,CAAC,KAAK,eAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,GAAE,MAA6B;IAI/C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAItD,OAAO,CAAC,IAAI;CAGb;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAET"}

package/dist/src/providers/placeholder-embed.js

@@ -0,0 +1,64 @@
+/**
+ * Placeholder embedding provider for no-key (lexical-only) import.
+ *
+ * When Onadit imports an export without any embedding provider configured
+ * (no Voyage key, no local Ollama), conversation rows still need a vector
+ * value because the LanceDB conversation tables require a fixed-width
+ * `embedding` column. This provider returns a zero vector of the correct
+ * dimension so the row is written and becomes immediately searchable via
+ * lexical/BM25 retrieval (which does not use the vector at all).
+ *
+ * Rows embedded by this provider are marked `embedding_provider = "rift-none"`
+ * (see `ConversationRow`). That marker is the ONLY embedding-backfill target:
+ * once a real provider is connected, a future pass can recompute exactly these
+ * rows, and vector search can exclude them in the meantime. Both the exclusion
+ * filter and the backfill are deliberately out of scope here — this provider
+ * only guarantees that no-key import succeeds and lands searchable rows.
+ */
+import { EMBEDDING_DIMENSIONS } from "./types.js";
+/**
+ * `embedding_provider` marker for placeholder (zero) vectors. Distinct from
+ * "" (a valid/legacy embedding) so backfill and vector-exclusion can target
+ * placeholders precisely without relabeling real embeddings.
+ */
+export const RIFT_NONE_EMBEDDING_PROVIDER = "rift-none";
+/**
+ * SQL `where` fragment that excludes no-key placeholder rows from a vector
+ * query. Single-sourced so EVERY conversation vector path (the shared
+ * `vector.ts` helper plus the custom hot/cold/conversations-search queries in
+ * the route layer) excludes `rift-none` identically — a placeholder zero
+ * vector is meaningless under cosine distance, so once a real provider is
+ * connected these stale rows must not pollute semantic results until backfill
+ * recomputes them. Lexical search deliberately does NOT use this (keyword
+ * recall over no-key rows is the whole point of no-key mode). Only apply it to
+ * tables that carry the `embedding_provider` column (conversation tables — not
+ * digests or structured_docs). The provider name is a safe constant, so no SQL
+ * escaping is needed.
+ */
+export const RIFT_NONE_VECTOR_EXCLUSION_CLAUSE = `embedding_provider != '${RIFT_NONE_EMBEDDING_PROVIDER}'`;
+export class PlaceholderEmbeddingProvider {
+    name = RIFT_NONE_EMBEDDING_PROVIDER;
+    model = RIFT_NONE_EMBEDDING_PROVIDER;
+    dimensions;
+    constructor(dimensions = EMBEDDING_DIMENSIONS) {
+        this.dimensions = dimensions;
+    }
+    async embed(_text) {
+        return this.zero();
+    }
+    async embedBatch(texts) {
+        return texts.map(() => this.zero());
+    }
+    zero() {
+        return new Array(this.dimensions).fill(0);
+    }
+}
+/**
+ * True when a vector was written by the no-key placeholder path. Centralized
+ * so writers and (future) vector-exclusion share one definition rather than
+ * scattering string comparisons.
+ */
+export function isPlaceholderEmbeddingProvider(provider) {
+    return provider.name === RIFT_NONE_EMBEDDING_PROVIDER;
+}
+//# sourceMappingURL=placeholder-embed.js.map

package/dist/src/providers/placeholder-embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-embed.js","sourceRoot":"","sources":["../../../src/providers/placeholder-embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,oBAAoB,EAA0B,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,0BAA0B,4BAA4B,GAAG,CAAC;AAE3G,MAAM,OAAO,4BAA4B;IAC9B,IAAI,GAAG,4BAA4B,CAAC;IACpC,KAAK,GAAG,4BAA4B,CAAC;IAC7B,UAAU,CAAS;IAEpC,YAAY,aAAqB,oBAAoB;QACnD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,KAAK,CAAS,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAA0B;IAE1B,OAAO,QAAQ,CAAC,IAAI,KAAK,4BAA4B,CAAC;AACxD,CAAC"}

package/dist/src/providers/shared-request.d.ts

@@ -0,0 +1,22 @@
+/**
+ * One in-flight request shared by concurrent callers, cancelled only when
+ * nobody still wants it.
+ *
+ * Each caller may pass an AbortSignal. Aborting it detaches that caller at
+ * once (its promise rejects with the signal's reason). The underlying work is
+ * aborted only when every caller that joined has aborted. A caller without a
+ * signal (a save) holds the request until it settles, so a query giving up
+ * never cancels work a save is waiting on.
+ */
+interface Entry<T> {
+    promise: Promise<T>;
+    controller: AbortController;
+    holders: number;
+}
+export type SharedRequests<T> = Map<string, Entry<T>>;
+export declare function joinShared<T>(requests: SharedRequests<T>, key: string, start: (signal: AbortSignal) => Promise<T>, signal?: AbortSignal): Promise<T>;
+export declare function abortReason(signal: AbortSignal): unknown;
+/** setTimeout as a promise that rejects as soon as `signal` aborts. */
+export declare function abortableSleep(ms: number, signal?: AbortSignal): Promise<void>;
+export {};
+//# sourceMappingURL=shared-request.d.ts.map

package/dist/src/providers/shared-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-request.d.ts","sourceRoot":"","sources":["../../../src/providers/shared-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,UAAU,KAAK,CAAC,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E"}

package/dist/src/providers/shared-request.js

@@ -0,0 +1,63 @@
+export function joinShared(requests, key, start, signal) {
+    if (signal?.aborted)
+        return Promise.reject(abortReason(signal));
+    let entry = requests.get(key);
+    if (!entry) {
+        const controller = new AbortController();
+        const created = { promise: undefined, controller, holders: 0 };
+        created.promise = start(controller.signal).finally(() => {
+            if (requests.get(key) === created)
+                requests.delete(key);
+        });
+        // Callers attach their own handlers; this one only keeps an abandoned
+        // request's rejection from surfacing as unhandled.
+        created.promise.catch(() => { });
+        requests.set(key, created);
+        entry = created;
+    }
+    const e = entry;
+    e.holders++;
+    if (!signal)
+        return e.promise;
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(abortReason(signal));
+            e.holders--;
+            if (e.holders === 0) {
+                if (requests.get(key) === e)
+                    requests.delete(key);
+                e.controller.abort(abortReason(signal));
+            }
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        e.promise.then((value) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        }, (err) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+    });
+}
+export function abortReason(signal) {
+    return signal.reason ?? new DOMException("aborted", "AbortError");
+}
+/** setTimeout as a promise that rejects as soon as `signal` aborts. */
+export function abortableSleep(ms, signal) {
+    if (!signal)
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    if (signal.aborted)
+        return Promise.reject(abortReason(signal));
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortReason(signal));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=shared-request.js.map

package/dist/src/providers/shared-request.js.map

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

package/dist/src/providers/stub.d.ts

@@ -0,0 +1,19 @@
+import type { EmbeddingProvider, DigestSummarizer, MetadataExtractor, ConversationEntry, ConversationMetadata, DigestContent, RetryConfig } from "./types.js";
+export declare class StubEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "stub";
+    readonly model = "stub";
+    private readonly dimensions;
+    constructor(dimensions?: number);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+export declare class StubDigestSummarizer implements DigestSummarizer {
+    readonly retry: RetryConfig;
+    summarize(conversations: ConversationEntry[]): Promise<DigestContent>;
+}
+export declare class StubMetadataExtractor implements MetadataExtractor {
+    readonly retry: RetryConfig;
+    /** Deterministic extraction: derives metadata from content hash. */
+    extractMetadata(text: string): Promise<ConversationMetadata>;
+}
+//# sourceMappingURL=stub.d.ts.map

package/dist/src/providers/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../../src/providers/stub.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9J,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,KAAK,UAAU;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,GAAE,MAA6B;IAI/C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAItC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAGvD;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAwB;IAE7C,SAAS,CAAC,aAAa,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAU5E;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAwB;IAEnD,oEAAoE;IAC9D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmBnE"}

package/dist/src/providers/stub.js

@@ -0,0 +1,74 @@
+/**
+ * Deterministic stub providers for tests.
+ *
+ * StubEmbeddingProvider: fixed-dimension vectors derived from a content hash.
+ * StubDigestSummarizer: concatenates conversation summaries into a digest.
+ *
+ * Same input always produces the same output. Never makes API calls.
+ */
+import crypto from "node:crypto";
+import { EMBEDDING_DIMENSIONS, DEFAULT_RETRY_CONFIG } from "./types.js";
+export class StubEmbeddingProvider {
+    name = "stub";
+    model = "stub";
+    dimensions;
+    constructor(dimensions = EMBEDDING_DIMENSIONS) {
+        this.dimensions = dimensions;
+    }
+    async embed(text) {
+        return hashToVector(text, this.dimensions);
+    }
+    async embedBatch(texts) {
+        return texts.map((t) => hashToVector(t, this.dimensions));
+    }
+}
+export class StubDigestSummarizer {
+    retry = DEFAULT_RETRY_CONFIG;
+    async summarize(conversations) {
+        const topics = new Set();
+        for (const c of conversations) {
+            for (const t of c.topics)
+                topics.add(t);
+        }
+        return {
+            summary: conversations.map((c) => c.summary).join(" | "),
+            topics: [...topics],
+        };
+    }
+}
+export class StubMetadataExtractor {
+    retry = DEFAULT_RETRY_CONFIG;
+    /** Deterministic extraction: derives metadata from content hash. */
+    async extractMetadata(text) {
+        const hash = crypto.createHash("sha256").update(text).digest();
+        const domainIdx = hash[0] % 7;
+        const intentIdx = hash[1] % 6;
+        const qualityIdx = hash[2] % 3;
+        const domains = ["business", "tech", "personal", "travel", "health", "finance", "creative"];
+        const intents = ["research", "decision", "brainstorm", "build", "learn", "troubleshoot"];
+        const qualities = ["high", "medium", "low"];
+        return {
+            domain: domains[domainIdx],
+            intent: intents[intentIdx],
+            quality: qualities[qualityIdx],
+            topics: ["stub-topic"],
+            decisions: [],
+            key_outputs: [],
+        };
+    }
+}
+/**
+ * Deterministic hash -> vector.
+ * Uses SHA-256 to seed values, then extends to fill the requested dimensions.
+ */
+function hashToVector(text, dimensions) {
+    const hash = crypto.createHash("sha256").update(text).digest();
+    const vector = [];
+    for (let i = 0; i < dimensions; i++) {
+        // Cycle through hash bytes, normalize to [-1, 1]
+        const byte = hash[i % hash.length];
+        vector.push((byte / 127.5) - 1);
+    }
+    return vector;
+}
+//# sourceMappingURL=stub.js.map

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

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

package/dist/src/providers/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Provider interfaces for Slice 4.
+ *
+ * Three distinct contracts:
+ * - EmbeddingProvider: text -> vector (for indexing and search)
+ * - MetadataExtractor: conversation text -> structured fields (for /save, /ingest)
+ * - DigestSummarizer: conversation batch -> summary (for compaction)
+ *
+ * All implementations must include retry with exponential backoff.
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (excluding the initial call). */
+    maxRetries: number;
+    /** Base delay in ms for exponential backoff. */
+    baseDelayMs: number;
+    /** Maximum delay cap in ms. */
+    maxDelayMs: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export declare const CONVERSATION_SOURCES: readonly ["claude_code", "gemini_cli", "codex_cli", "grok_cli", "cursor_composer", "chatgpt_web", "claude_web", "grok_web", "gemini_web"];
+export type ConversationSource = (typeof CONVERSATION_SOURCES)[number];
+export declare const DOMAINS: readonly ["business", "tech", "personal", "travel", "health", "finance", "creative"];
+export type Domain = (typeof DOMAINS)[number];
+export declare const INTENTS: readonly ["research", "decision", "brainstorm", "build", "learn", "troubleshoot"];
+export type Intent = (typeof INTENTS)[number];
+export declare const QUALITY_LEVELS: readonly ["high", "medium", "low"];
+export type ConversationQuality = (typeof QUALITY_LEVELS)[number];
+export declare const SOURCE_TYPES: readonly ["filesystem_watched", "filesystem_scheduled_scan", "report_card"];
+export type SourceType = (typeof SOURCE_TYPES)[number];
+export declare const SOURCE_SCOPES: readonly ["client", "project", "document"];
+export type SourceScope = (typeof SOURCE_SCOPES)[number];
+export declare const EMBEDDING_DIMENSIONS = 512;
+export declare const LOCAL_EMBEDDING_DIMENSIONS = 768;
+export interface EmbedOptions {
+    signal?: AbortSignal;
+}
+export interface EmbeddingProvider {
+    /**
+     * Provider name (e.g. "voyage", "ollama", "stub"). Used to label
+     * embedding-events.jsonl entries without each call site needing to know
+     * which provider it's holding.
+     */
+    readonly name: string;
+    /**
+     * Model identifier (e.g. "voyage-3-lite", "nomic-embed-text"). Same
+     * purpose as `name` — telemetry labelling, not runtime behavior.
+     */
+    readonly model: string;
+    /**
+     * Generate an embedding vector for a single text. `signal` cancels the
+     * request (queries that stopped waiting); omit it for work that must
+     * finish, such as saves.
+     */
+    embed(text: string, opts?: EmbedOptions): Promise<number[]>;
+    /** Generate embedding vectors for a batch of texts. */
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+export interface ConversationMetadata {
+    domain: Domain;
+    intent: Intent;
+    quality: ConversationQuality;
+    topics: string[];
+    decisions: string[];
+    key_outputs: string[];
+}
+export interface MetadataExtractionProvenance {
+    provider: string;
+    model: string;
+    version: string;
+    cli_tag?: string;
+}
+export interface MetadataExtractor {
+    readonly retry: RetryConfig;
+    /** Extract structured metadata from a single conversation text. */
+    extractMetadata(text: string): Promise<ConversationMetadata>;
+    /** Optional provenance for operators inspecting raw ingest artifacts. */
+    getProvenance?(): MetadataExtractionProvenance | undefined;
+}
+export interface ConversationEntry {
+    id: string;
+    content: string;
+    summary: string;
+    source: ConversationSource;
+    domain: Domain;
+    intent: Intent;
+    quality: ConversationQuality;
+    topics: string[];
+    decisions: string[];
+    key_outputs: string[];
+}
+export interface DigestContent {
+    summary: string;
+    topics: string[];
+}
+export interface DigestSummarizer {
+    readonly retry: RetryConfig;
+    /** Generate a summary from a batch of conversations. */
+    summarize(conversations: ConversationEntry[]): Promise<DigestContent>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/providers/types.d.ts.map

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

package/dist/src/providers/types.js

@@ -0,0 +1,63 @@
+/**
+ * Provider interfaces for Slice 4.
+ *
+ * Three distinct contracts:
+ * - EmbeddingProvider: text -> vector (for indexing and search)
+ * - MetadataExtractor: conversation text -> structured fields (for /save, /ingest)
+ * - DigestSummarizer: conversation batch -> summary (for compaction)
+ *
+ * All implementations must include retry with exponential backoff.
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 10_000,
+};
+// --- PRD enum vocabularies ---
+export const CONVERSATION_SOURCES = [
+    "claude_code",
+    "gemini_cli",
+    "codex_cli",
+    "grok_cli",
+    // Native Cursor composer/agent/chat sessions (Cursor's own vscdb store).
+    // Claude-Code- and Codex-in-Cursor are NOT this source — those write to
+    // ~/.claude / ~/.codex and are already captured as claude_code / codex_cli.
+    "cursor_composer",
+    "chatgpt_web",
+    "claude_web",
+    "grok_web",
+    "gemini_web",
+];
+export const DOMAINS = [
+    "business",
+    "tech",
+    "personal",
+    "travel",
+    "health",
+    "finance",
+    "creative",
+];
+export const INTENTS = [
+    "research",
+    "decision",
+    "brainstorm",
+    "build",
+    "learn",
+    "troubleshoot",
+];
+export const QUALITY_LEVELS = ["high", "medium", "low"];
+export const SOURCE_TYPES = [
+    "filesystem_watched",
+    "filesystem_scheduled_scan",
+    // A write-time index card for an Onadit-owned report (beta.28 retrieval
+    // coverage). A lightweight retrievable pointer — title + summary + topics —
+    // NOT the report body. Only ever written by the explicit report-card
+    // backfill; legacy rows never carry it, and nothing switches exhaustively on
+    // SourceType, so older code degrades safely (treats it as an ordinary doc).
+    "report_card",
+];
+export const SOURCE_SCOPES = ["client", "project", "document"];
+// --- Embedding ---
+export const EMBEDDING_DIMENSIONS = 512; // Voyage-3-lite
+export const LOCAL_EMBEDDING_DIMENSIONS = 768; // nomic-embed-text (Ollama default)
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,gCAAgC;AAEhC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa;IACb,YAAY;IACZ,WAAW;IACX,UAAU;IACV,yEAAyE;IACzE,wEAAwE;IACxE,4EAA4E;IAC5E,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,UAAU;IACV,YAAY;CACJ,CAAC;AAGX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,UAAU;IACV,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,UAAU;IACV,UAAU;IACV,YAAY;IACZ,OAAO;IACP,OAAO;IACP,cAAc;CACN,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAGjE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB;IACpB,2BAA2B;IAC3B,wEAAwE;IACxE,4EAA4E;IAC5E,qEAAqE;IACrE,6EAA6E;IAC7E,4EAA4E;IAC5E,aAAa;CACL,CAAC;AAGX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAGxE,oBAAoB;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC,CAAC,gBAAgB;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC,CAAC,oCAAoC"}

package/dist/src/providers/voyage.d.ts

@@ -0,0 +1,55 @@
+import type { EmbeddingProvider, EmbedOptions, RetryConfig } from "./types.js";
+/** Voyage's own API. Atlas-issued keys use https://ai.mongodb.com/v1 instead. */
+export declare const VOYAGE_DEFAULT_BASE_URL = "https://api.voyageai.com/v1";
+/** Where to send embeddings, and what to ask for, as set in config.embedding. */
+export interface VoyageEndpoint {
+    model?: string;
+    baseUrl?: string;
+    outputDimension?: number;
+}
+/** Read config.embedding into provider options. Unset fields keep the defaults. */
+export declare function voyageEndpoint(embedding: {
+    model: string;
+    base_url?: string | undefined;
+    output_dimension?: number | undefined;
+}): VoyageEndpoint;
+/** The embeddings URL for a base, tolerating a trailing slash. */
+export declare function voyageEmbeddingsUrl(baseUrl?: string): string;
+export interface VoyageProviderOptions extends VoyageEndpoint {
+    apiKey: string;
+    retry?: Partial<RetryConfig>;
+    /** Directory for disk cache. If unset, caching is disabled. */
+    cachePath?: string;
+    /**
+     * Optional per-attempt HTTP deadline; timed-out attempts count as
+     * transient. Off by default: saves embed whole conversations, and live
+     * save embeddings reach p99 27 s / max 396 s (owner corpus, Aug–Sep 2026),
+     * so a fixed deadline would fail real captures. Interactive retrieval is
+     * bounded separately by the hybrid-search embedding wait.
+     */
+    requestTimeoutMs?: number;
+}
+export declare class VoyageEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "voyage";
+    private readonly apiKey;
+    readonly model: string;
+    private readonly url;
+    private readonly outputDimension;
+    private readonly retry;
+    private readonly cachePath;
+    private readonly requestTimeoutMs;
+    /**
+     * Concurrent identical texts share one API call. It is cancelled only when
+     * every caller has aborted; a caller without a signal keeps it alive.
+     */
+    private readonly inflight;
+    constructor(opts: VoyageProviderOptions);
+    embed(text: string, opts?: EmbedOptions): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /** Call Voyage API with retry + exponential backoff. `signal` stops it, including between retries. */
+    private callApi;
+    private cacheKey;
+    private readCache;
+    private writeCache;
+}
+//# sourceMappingURL=voyage.d.ts.map

package/dist/src/providers/voyage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyage.d.ts","sourceRoot":"","sources":["../../../src/providers/voyage.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI/E,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,SAAS,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GAAG,cAAc,CAMjB;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAgC,GAAG,MAAM,CAErF;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEpD,IAAI,EAAE,qBAAqB;IAcjC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiB/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAwBtD,sGAAsG;YACxF,OAAO;IA2DrB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,UAAU;CASnB"}