onadit 0.0.1 → 0.1.0-beta.45

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"}

package/dist/src/providers/voyage.js

@@ -0,0 +1,179 @@
+/**
+ * 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 { abortableSleep, joinShared } from "./shared-request.js";
+import { DEFAULT_RETRY_CONFIG, EMBEDDING_DIMENSIONS } from "./types.js";
+/** Voyage's own API. Atlas-issued keys use https://ai.mongodb.com/v1 instead. */
+export const VOYAGE_DEFAULT_BASE_URL = "https://api.voyageai.com/v1";
+/** Read config.embedding into provider options. Unset fields keep the defaults. */
+export function voyageEndpoint(embedding) {
+    return {
+        model: embedding.model,
+        ...(embedding.base_url ? { baseUrl: embedding.base_url } : {}),
+        ...(embedding.output_dimension ? { outputDimension: embedding.output_dimension } : {}),
+    };
+}
+/** The embeddings URL for a base, tolerating a trailing slash. */
+export function voyageEmbeddingsUrl(baseUrl = VOYAGE_DEFAULT_BASE_URL) {
+    return `${baseUrl.replace(/\/+$/, "")}/embeddings`;
+}
+export class VoyageEmbeddingProvider {
+    name = "voyage";
+    apiKey;
+    model;
+    url;
+    outputDimension;
+    retry;
+    cachePath;
+    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.
+     */
+    inflight = new Map();
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.model = opts.model ?? "voyage-3-lite";
+        this.url = voyageEmbeddingsUrl(opts.baseUrl);
+        this.outputDimension = opts.outputDimension;
+        this.retry = { ...DEFAULT_RETRY_CONFIG, ...opts.retry };
+        this.cachePath = opts.cachePath;
+        this.requestTimeoutMs = opts.requestTimeoutMs;
+        if (this.cachePath) {
+            fs.mkdirSync(this.cachePath, { recursive: true });
+        }
+    }
+    async embed(text, opts = {}) {
+        const cached = this.readCache(text);
+        if (cached)
+            return cached;
+        return joinShared(this.inflight, this.cacheKey(text), async (signal) => {
+            const [result] = await this.callApi([text], signal);
+            if (!result)
+                throw new Error("Voyage API returned empty embeddings");
+            this.writeCache(text, result);
+            return result;
+        }, opts.signal);
+    }
+    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. `signal` stops it, including between retries. */
+    async callApi(texts, signal) {
+        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 abortableSleep(delay, signal);
+            }
+            signal?.throwIfAborted();
+            try {
+                const res = await fetch(this.url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify({
+                        input: texts,
+                        model: this.model,
+                        ...(this.outputDimension ? { output_dimension: this.outputDimension } : {}),
+                    }),
+                    ...requestSignal(signal, this.requestTimeoutMs),
+                });
+                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) {
+                // Cancelled by the caller: stop, never retry.
+                if (signal?.aborted)
+                    throw signal.reason ?? err;
+                if (err instanceof TypeError || isTimeout(err)) {
+                    // Network error or per-attempt deadline — transient, retry
+                    lastError = err;
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError;
+    }
+    // --- Disk cache ---
+    cacheKey(text) {
+        return crypto
+            .createHash("sha256")
+            // A requested size is part of the key, so vectors of different sizes
+            // never share a cache entry. Default keys are unchanged.
+            .update(this.outputDimension
+            ? `${this.model}:${this.outputDimension}:${text}`
+            : `${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 requestSignal(caller, timeoutMs) {
+    const signals = [caller, timeoutMs ? AbortSignal.timeout(timeoutMs) : undefined].filter((s) => s !== undefined);
+    if (signals.length === 0)
+        return {};
+    return { signal: signals.length === 1 ? signals[0] : AbortSignal.any(signals) };
+}
+function isTimeout(err) {
+    return err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError");
+}
+//# 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/brief.d.ts

@@ -0,0 +1,26 @@
+import { type ProjectIndex } from "./project-index.js";
+export declare const BRIEF_MAX_BYTES = 2048;
+export interface ProjectBrief {
+    root: string;
+    worktree: string;
+    text: string;
+    bytes: number;
+    generated_at: string;
+    fingerprint: string;
+    truncated: boolean;
+}
+export type BriefResult = {
+    available: true;
+    brief: ProjectBrief;
+    cached: boolean;
+} | {
+    available: false;
+    reason: string;
+};
+export declare function getProjectBrief(opts: {
+    cwd: string;
+    dataDir: string;
+    index: ProjectIndex | null;
+    now?: Date;
+}): Promise<BriefResult>;
+//# sourceMappingURL=brief.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../../src/retrieval/brief.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG3E,eAAO,MAAM,eAAe,OAAQ,CAAC;AAMrC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAuNzC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,WAAW,CAAC,CA0CvB"}