onadit 0.0.1 → 1.0.0

package/dist/src/mcp/tools/search.js

@@ -0,0 +1,95 @@
+/**
+ * onadit_search MCP tool — delegates to POST /search.
+ *
+ * Slice 1 contract: the daemon already returns the compact DTO. The MCP
+ * tool forwards the payload unchanged via `structuredContent` and renders
+ * a compact markdown view on the text channel (no raw JSON dump).
+ */
+import { z } from "zod";
+import { formatError } from "../errors.js";
+import { renderCompactMarkdown, } from "../../retrieval/compact.js";
+import { buildSearchReceipt, withReceipt } from "../../retrieval/receipt.js";
+export const searchSchema = {
+    query: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Search query. Required for ranked retrieval; optional in exact-ID mode (detail='full' + id)."),
+    scope: z
+        .enum(["all", "clients", "projects", "conversations", "documents"])
+        .optional()
+        .describe("Scope of search (default: all)"),
+    client: z.string().optional().describe("Filter to a specific client name"),
+    since: z
+        .string()
+        .optional()
+        .describe("Only return results indexed after this ISO-8601 timestamp"),
+    top_k: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Maximum number of results (default: 10)"),
+    cwd: z
+        .string()
+        .optional()
+        .describe("Current working directory — scopes file results to the matching project"),
+    detail: z
+        .enum(["summary", "middle", "full"])
+        .optional()
+        .describe("Output detail level. 'summary' (default) is the compact DTO; 'middle' returns a bounded head+tail excerpt (~2k-4k tokens, evidence-focused) — use this for fact-checking large rows without spending full context on them; 'full' adds the raw content. With 'middle' or 'full', supplying `id` triggers exact-ID mode and bypasses ranking."),
+    id: z
+        .string()
+        .optional()
+        .describe("With detail='middle' or 'full', fetch exactly this row by id. Never falls back to ranked search — returns 404 (id_not_found) or 409 (ambiguous_id) if the id is missing or duplicated across tables."),
+    tier: z
+        .enum(["hot", "cold", "digest", "document", "structured_doc"])
+        .optional()
+        .describe("With detail='middle' or 'full' + id, scope the lookup to a tier (matches the value carried in compact-hit expand pointers)."),
+    source_table: z
+        .enum([
+        "structured_docs",
+        "conversations_hot",
+        "conversations_cold",
+        "digests",
+        "structured_docs_local",
+    ])
+        .optional()
+        .describe("With detail='middle' or 'full' + id, the authoritative backing table. Disambiguates rows that share an id across cloud/local structured-doc tables."),
+    content_bytes: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Advisory size of the row's `content` in UTF-8 bytes, as carried on `expand.params`. Accepted so callers can paste an expansion pointer verbatim; ignored by retrieval."),
+    content_tokens_estimate: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Advisory token estimate (~content_bytes/4), as carried on `expand.params`. Accepted so callers can paste an expansion pointer verbatim; ignored by retrieval."),
+};
+export async function handleRiftSearch(args, client) {
+    try {
+        const { data } = await client.post("/search", args);
+        const resp = data;
+        const text = renderCompactMarkdown(resp.results, {
+            degraded: resp.degraded,
+            ...(resp.degraded_reason ? { degradedReason: resp.degraded_reason } : {}),
+            ...(resp.mode === "lexical" ? { lexical: true } : {}),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: withReceipt(buildSearchReceipt(resp.results), text),
+                },
+            ],
+            structuredContent: resp,
+        };
+    }
+    catch (err) {
+        return formatError(err);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/src/mcp/tools/search.js.map

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

package/dist/src/mcp/tools/status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * onadit_status MCP tool — capability map (GET /status) + capture diagnostics.
+ *
+ * The capability map is the documented contract and always leads. We then
+ * fetch the structured `/status/friend` payload and append a leak-free
+ * capture/preflight diagnosis so an agent can self-diagnose a stalled
+ * auto-capture (preflight worker, error class, summary, next action, recent
+ * capture-error count) without a human dropping to the CLI. The friend payload
+ * carries only canned summaries + counts — never raw stderr or conversation
+ * content — so surfacing it here cannot leak.
+ */
+import type { HttpClient } from "../../cli/http-client.js";
+import { type CaptureDiagnostics } from "../capture-diagnostics.js";
+import type { MemoryCoverageDiagnostics } from "../../diagnostics/memory-coverage.js";
+export declare function handleRiftStatus(_args: Record<string, unknown>, client: HttpClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+} | {
+    structuredContent?: {
+        capture_diagnostics?: CaptureDiagnostics;
+        memory_diagnostics?: MemoryCoverageDiagnostics;
+    };
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/mcp/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAkBtF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU;;;;;;;;8BAgBY,kBAAkB;6BACnB,yBAAyB;;;;;;GAmCvD"}

package/dist/src/mcp/tools/status.js

@@ -0,0 +1,63 @@
+import { formatError } from "../errors.js";
+import { buildCaptureDiagnostics, renderCaptureDiagnostics, } from "../capture-diagnostics.js";
+import { renderMemoryDiagnostics } from "../memory-diagnostics.js";
+/**
+ * Narrow an arbitrary `/status/friend` response to the payload shape before we
+ * trust it. Guards against an older daemon, a non-JSON body, or a transient
+ * read returning something we cannot diagnose — in those cases we degrade to
+ * the capability map alone rather than rendering a half-empty block.
+ */
+function isFriendStatusPayload(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        "codex" in value &&
+        "capture" in value &&
+        "daemon" in value);
+}
+export async function handleRiftStatus(_args, client) {
+    try {
+        // Capability map first — this is the tool's documented contract and must
+        // always be returned, even if diagnostics are unavailable.
+        const data = await client.get("/status");
+        const capabilityMap = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+        // Capture diagnostics — best-effort. A failure to read /status/friend (an
+        // older daemon without the route, an auth or transient error) must never
+        // break the capability map, so it degrades silently to map-only (the
+        // prior behavior).
+        let diagnosticsSection = "";
+        let structuredContent;
+        try {
+            const friend = await client.get("/status/friend");
+            if (isFriendStatusPayload(friend)) {
+                const diag = buildCaptureDiagnostics(friend, Date.now());
+                diagnosticsSection = `\n\n${renderCaptureDiagnostics(diag)}`;
+                structuredContent = { capture_diagnostics: diag };
+                if (friend.memory) {
+                    diagnosticsSection += `\n\n${renderMemoryDiagnostics(friend.memory, {
+                        ...(friend.daemon.config_path
+                            ? { configPath: friend.daemon.config_path }
+                            : {}),
+                        dataDir: friend.daemon.data_dir,
+                    })}`;
+                    structuredContent.memory_diagnostics = friend.memory;
+                }
+            }
+        }
+        catch {
+            // Degrade to capability map only.
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${capabilityMap}${diagnosticsSection}`,
+                },
+            ],
+            ...(structuredContent ? { structuredContent } : {}),
+        };
+    }
+    catch (err) {
+        return formatError(err);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/src/mcp/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,IAAI,KAAK;QAChB,SAAS,IAAI,KAAK;QAClB,QAAQ,IAAI,KAAK,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA8B,EAC9B,MAAkB;IAElB,IAAI,CAAC;QACH,yEAAyE;QACzE,2DAA2D;QAC3D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,aAAa,GACjB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElE,0EAA0E;QAC1E,yEAAyE;QACzE,qEAAqE;QACrE,mBAAmB;QACnB,IAAI,kBAAkB,GAAG,EAAE,CAAC;QAC5B,IAAI,iBAKS,CAAC;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAClD,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzD,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,iBAAiB,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;gBAClD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,kBAAkB,IAAI,OAAO,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE;wBAClE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW;4BAC3B,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;4BAC3C,CAAC,CAAC,EAAE,CAAC;wBACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;qBAChC,CAAC,EAAE,CAAC;oBACL,iBAAiB,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,GAAG,aAAa,GAAG,kBAAkB,EAAE;iBAC9C;aACF;YACD,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/observability/coverage.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Observability coverage module — queries LanceDB tables and runtime
+ * state to produce the full /stats response per PRD Section 4.
+ *
+ * All time-based evaluations use `effectiveNow` which is frozen
+ * at `maintenanceState.startedAt` during active maintenance.
+ */
+import type { Config } from "../config/schema.js";
+import type { Scanner } from "../ingestion/scanner.js";
+import type { Watcher } from "../ingestion/watcher.js";
+import type { ConversationSource } from "../providers/types.js";
+export interface MaintenanceState {
+    active: boolean;
+    startedAt: Date | null;
+}
+export interface ObservabilityCapabilities {
+    watchEnabled: boolean;
+    scanEnabled: boolean;
+    supportedSources: ReadonlySet<ConversationSource>;
+    inboxEnabled: boolean;
+}
+export interface ObservabilityDeps {
+    config: Config;
+    scanner: Scanner | null;
+    watchers: Watcher[];
+    capabilities: ObservabilityCapabilities;
+    getMaintenanceState: () => MaintenanceState;
+}
+export interface TableStats {
+    structured_docs: {
+        count: number;
+        last_indexed: string | null;
+    };
+    conversations_hot: {
+        count: number;
+    };
+    conversations_cold: {
+        count: number;
+    };
+    digests: {
+        count: number;
+    };
+    conversation_artifacts_total: number;
+}
+export interface VerifiedWatchedStatus {
+    indexed_files: number;
+    healthy: boolean;
+}
+export interface VerifiedScanStatus {
+    indexed_files: number;
+    last_scan_at: string | null;
+    next_scan_at: string | null;
+    scan_schedule: string;
+    freshness_slo_met: boolean;
+}
+export interface UnverifiedSourceStatus {
+    last_save: string | null;
+    healthy: boolean;
+    warning?: string;
+}
+export interface InboxStatus {
+    last_processed: string | null;
+    healthy: boolean;
+    warning?: string;
+}
+export interface ManualSourceStatus {
+    last_ingest: string | null;
+    stale: boolean;
+}
+export interface SourceCoverage {
+    verified_autonomous: {
+        filesystem_watched: VerifiedWatchedStatus;
+        filesystem_scheduled_scan: VerifiedScanStatus;
+    };
+    unverified_autonomous: {
+        claude_code: UnverifiedSourceStatus;
+        gemini_cli: UnverifiedSourceStatus;
+        codex_cli: UnverifiedSourceStatus;
+        inbox: InboxStatus;
+    };
+    manual: {
+        claude_web: ManualSourceStatus;
+        grok_web: ManualSourceStatus;
+        gemini_web: ManualSourceStatus;
+    };
+}
+export interface AutomationGate {
+    verified_sources_healthy: boolean;
+    note: string;
+}
+export interface StatsResponse {
+    tables: TableStats;
+    source_coverage: SourceCoverage;
+    automation_gate: AutomationGate;
+}
+export declare function getTableStats(): Promise<TableStats>;
+export declare function getSourceCoverage(deps: ObservabilityDeps): Promise<SourceCoverage>;
+export declare function computeAutomationGate(coverage: SourceCoverage): AutomationGate;
+export declare function buildFullStats(deps: ObservabilityDeps): Promise<StatsResponse>;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/src/observability/coverage.d.ts.map

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

package/dist/src/observability/coverage.js

@@ -0,0 +1,178 @@
+import { getTable, TABLE_NAMES } from "../storage/tables.js";
+import { isReportCardRowId } from "../ingestion/report-cards.js";
+import { isUnverifiedHealthy, isManualStale, isScanFreshnessMet, isWatcherHealthy, } from "./staleness.js";
+// --- Table stats ---
+export async function getTableStats() {
+    const countEntries = await Promise.all(TABLE_NAMES.map(async (name) => [name, await getTable(name).countRows()]));
+    const countMap = Object.fromEntries(countEntries);
+    // beta.28: index cards are catalog pointers, not documents. Exclude them from
+    // both the doc count and `last_indexed` (regardless of RIFT_INDEX_CARDS) so a
+    // backfill can't make `onadit status` over-report docs or pose as a fresh index.
+    const notCard = (r) => !isReportCardRowId(String(r.id));
+    const sdTable = getTable("structured_docs");
+    const sdRows = (await sdTable.query().select(["id", "indexed_at"]).toArray()).filter(notCard);
+    // Also check structured_docs_local for last_indexed
+    const sdLocalTable = getTable("structured_docs_local");
+    const sdLocalRows = (await sdLocalTable.query().select(["id", "indexed_at"]).toArray()).filter(notCard);
+    let lastIndexed = null;
+    for (const row of [...sdRows, ...sdLocalRows]) {
+        if (row.indexed_at && (!lastIndexed || row.indexed_at > lastIndexed)) {
+            lastIndexed = row.indexed_at;
+        }
+    }
+    const sdCount = sdRows.length + sdLocalRows.length;
+    const hotCount = countMap["conversations_hot"] ?? 0;
+    const coldCount = countMap["conversations_cold"] ?? 0;
+    const digestCount = countMap["digests"] ?? 0;
+    return {
+        structured_docs: { count: sdCount, last_indexed: lastIndexed },
+        conversations_hot: { count: hotCount },
+        conversations_cold: { count: coldCount },
+        digests: { count: digestCount },
+        conversation_artifacts_total: hotCount + coldCount + digestCount,
+    };
+}
+// --- Source coverage ---
+const SAVE_SOURCES = ["claude_code", "gemini_cli", "codex_cli"];
+const MANUAL_SOURCES = ["claude_web", "grok_web", "gemini_web"];
+export async function getSourceCoverage(deps) {
+    const { config, scanner, watchers, capabilities } = deps;
+    const maintenanceState = deps.getMaintenanceState();
+    const effectiveNow = maintenanceState.active && maintenanceState.startedAt
+        ? maintenanceState.startedAt
+        : new Date();
+    // --- Verified: filesystem_watched ---
+    let watchedStatus;
+    if (!capabilities.watchEnabled) {
+        watchedStatus = { indexed_files: 0, healthy: true };
+    }
+    else {
+        const cloudCount = await getTable("structured_docs")
+            .countRows("source_type = 'filesystem_watched'");
+        const localCount = await getTable("structured_docs_local")
+            .countRows("source_type = 'filesystem_watched'");
+        watchedStatus = {
+            indexed_files: cloudCount + localCount,
+            healthy: isWatcherHealthy(watchers, maintenanceState.active),
+        };
+    }
+    // --- Verified: filesystem_scheduled_scan ---
+    let scanStatus;
+    if (!capabilities.scanEnabled) {
+        scanStatus = {
+            indexed_files: 0,
+            last_scan_at: null,
+            next_scan_at: null,
+            scan_schedule: "none",
+            freshness_slo_met: true,
+        };
+    }
+    else {
+        const cloudScanCount = await getTable("structured_docs")
+            .countRows("source_type = 'filesystem_scheduled_scan'");
+        const localScanCount = await getTable("structured_docs_local")
+            .countRows("source_type = 'filesystem_scheduled_scan'");
+        const scanState = scanner?.scanState ?? {
+            last_scan_at: null,
+            next_scan_at: null,
+        };
+        scanStatus = {
+            indexed_files: cloudScanCount + localScanCount,
+            last_scan_at: scanState.last_scan_at,
+            next_scan_at: scanState.next_scan_at,
+            scan_schedule: `every ${config.scan.interval_seconds}s`,
+            freshness_slo_met: isScanFreshnessMet(scanState.last_scan_at, config.scan.interval_seconds, effectiveNow),
+        };
+    }
+    // --- Conversation source timestamps ---
+    const hotRows = (await getTable("conversations_hot")
+        .query()
+        .select(["source", "indexed_at"])
+        .toArray());
+    const coldRows = (await getTable("conversations_cold")
+        .query()
+        .select(["source", "indexed_at"])
+        .toArray());
+    const allConvRows = [...hotRows, ...coldRows];
+    const lastTimestampBySource = new Map();
+    for (const row of allConvRows) {
+        const src = row.source;
+        const existing = lastTimestampBySource.get(src);
+        if (!existing || row.indexed_at > existing) {
+            lastTimestampBySource.set(src, row.indexed_at);
+        }
+    }
+    // --- Unverified sources ---
+    function buildUnverifiedStatus(source) {
+        if (!capabilities.supportedSources.has(source)) {
+            return { last_save: null, healthy: true };
+        }
+        const lastSave = lastTimestampBySource.get(source) ?? null;
+        const result = isUnverifiedHealthy(lastSave, effectiveNow);
+        return {
+            last_save: lastSave,
+            healthy: result.healthy,
+            ...(result.warning ? { warning: result.warning } : {}),
+        };
+    }
+    // --- Manual sources ---
+    function buildManualStatus(source) {
+        if (!capabilities.supportedSources.has(source)) {
+            return { last_ingest: null, stale: false };
+        }
+        const lastIngest = lastTimestampBySource.get(source) ?? null;
+        return {
+            last_ingest: lastIngest,
+            stale: isManualStale(lastIngest, effectiveNow),
+        };
+    }
+    // --- Inbox ---
+    let inboxStatus;
+    if (!capabilities.inboxEnabled) {
+        inboxStatus = { last_processed: null, healthy: true };
+    }
+    else {
+        const lastProcessed = lastTimestampBySource.get("inbox") ?? null;
+        const result = isUnverifiedHealthy(lastProcessed, effectiveNow);
+        inboxStatus = {
+            last_processed: lastProcessed,
+            healthy: result.healthy,
+            ...(result.warning
+                ? { warning: result.warning.replace("saves", "inbox activity") }
+                : {}),
+        };
+    }
+    return {
+        verified_autonomous: {
+            filesystem_watched: watchedStatus,
+            filesystem_scheduled_scan: scanStatus,
+        },
+        unverified_autonomous: {
+            claude_code: buildUnverifiedStatus("claude_code"),
+            gemini_cli: buildUnverifiedStatus("gemini_cli"),
+            codex_cli: buildUnverifiedStatus("codex_cli"),
+            inbox: inboxStatus,
+        },
+        manual: {
+            claude_web: buildManualStatus("claude_web"),
+            grok_web: buildManualStatus("grok_web"),
+            gemini_web: buildManualStatus("gemini_web"),
+        },
+    };
+}
+// --- Automation gate ---
+export function computeAutomationGate(coverage) {
+    return {
+        verified_sources_healthy: coverage.verified_autonomous.filesystem_watched.healthy &&
+            coverage.verified_autonomous.filesystem_scheduled_scan.freshness_slo_met,
+        note: "Includes both filesystem_watched and filesystem_scheduled_scan types.",
+    };
+}
+// --- Full stats orchestrator ---
+export async function buildFullStats(deps) {
+    const tables = await getTableStats();
+    const source_coverage = await getSourceCoverage(deps);
+    const automation_gate = computeAutomationGate(source_coverage);
+    return { tables, source_coverage, automation_gate };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/src/observability/coverage.js.map

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

package/dist/src/observability/embedding-events.d.ts

@@ -0,0 +1,52 @@
+import type { EmbeddingProvider } from "../providers/types.js";
+export declare const EMBEDDING_PIPELINES: readonly ["watcher", "scheduled_scan", "reconcile", "ingest_job", "compact", "backfill", "capture", "reindex"];
+export type EmbeddingPipeline = (typeof EMBEDDING_PIPELINES)[number];
+export type EmbeddingOutcome = "success" | "error";
+export interface EmbeddingEvent {
+    ts: string;
+    provider: string;
+    model: string;
+    pipeline: EmbeddingPipeline;
+    /**
+     * Free-form caller label (e.g. "document_embedding", "conversation",
+     * "digest", "reindex_conversation"). Helps debug "which write path"
+     * when scanning the log; does not gate any status logic today.
+     */
+    operation: string;
+    outcome: EmbeddingOutcome;
+    input_count: number;
+    ms: number;
+    /** Compact error class (e.g. "provider_400"). Present when outcome === "error". */
+    error_class?: string;
+    /** Truncated error message (≤ 512 chars). Present when outcome === "error". */
+    error_message?: string;
+}
+export interface EmbedContext {
+    pipeline: EmbeddingPipeline;
+    operation: string;
+    /** Number of inputs in this call (1 for embed, N for embedBatch). */
+    input_count: number;
+}
+export declare function eventsFilePath(dataDir: string): string;
+/**
+ * Append a single event to the lane. Never throws — telemetry must not
+ * break embedding. On filesystem error, writes a single stderr line so
+ * the failure is at least visible to operators tailing logs.
+ */
+export declare function appendEmbeddingEvent(dataDir: string, event: EmbeddingEvent): void;
+/**
+ * Run an embedding call and record one event. Re-throws errors so the
+ * caller's existing failure-handling path is unchanged; logging is a
+ * pure side effect.
+ *
+ * Use this at every ingest call site. Do NOT use it for search-time
+ * embedding — keeping search out of the lane is what makes
+ * `last_embed_at` meaningful.
+ */
+export declare function recordEmbed<T>(dataDir: string, provider: EmbeddingProvider, ctx: EmbedContext, fn: () => Promise<T>): Promise<T>;
+/**
+ * Tolerant reader. One bad JSON line is skipped; the rest are returned.
+ * Returns [] if the file is missing.
+ */
+export declare function readEmbeddingEvents(dataDir: string): EmbeddingEvent[];
+//# sourceMappingURL=embedding-events.d.ts.map

package/dist/src/observability/embedding-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-events.d.ts","sourceRoot":"","sources":["../../../src/observability/embedding-events.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,mBAAmB,gHAStB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,IAAI,CAUN;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CA+BZ;AAkBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAoBrE"}