@vivantel/virage-core 0.2.19 → 0.2.22

package/dist/telemetry/session.d.ts

@@ -0,0 +1,30 @@
+import type { VirageDb } from "../core/virage-db.js";
+import { type TelemetryConfig, type SessionMetadata } from "./types.js";
+export interface FeedbackPayload {
+    wasUseful: boolean;
+    contextRelevance?: number;
+    contextCompleteness?: number;
+    noiseRatio?: number;
+    missingCategory?: string;
+}
+export declare class TelemetrySession {
+    private readonly db;
+    private readonly config;
+    readonly id: string;
+    private searchCount;
+    private feedbackCallCount;
+    private recentEmbeddings;
+    private static readonly REDUNDANCY_WINDOW_MS;
+    private static readonly REDUNDANCY_THRESHOLD;
+    private static readonly MAX_FEEDBACK_CALLS;
+    constructor(db: VirageDb, config: TelemetryConfig, sessionId: string, metadata: SessionMetadata);
+    recordSearch(searchId: string, resultCount: number, queryEmbedding: number[]): void;
+    recordLatency(phase: string, durationMs: number): void;
+    recordError(errorType: string, retryCount: number, recovered: boolean): void;
+    recordFeedback(searchId: string, payload: FeedbackPayload): void;
+    recordCacheStats(fileHitRate: number, semanticHitRate: number): void;
+    shouldSampleFeedback(resultCount: number): boolean;
+    end(): void;
+    private isRedundant;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/telemetry/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/telemetry/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAgBD,qBAAa,gBAAgB;IAazB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CACnB;IAEL,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAiB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAO;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;gBAG7B,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,eAAe,EACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe;IAoB3B,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,GACvB,IAAI;IAsCP,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAWtD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAY5E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAkBhE,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAWpE,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAclD,GAAG,IAAI,IAAI;IAOX,OAAO,CAAC,WAAW;CAUpB"}

package/dist/telemetry/session.js

@@ -0,0 +1,158 @@
+import { createHash } from "crypto";
+import { resultCountBucket, normalizeMissingCategory, } from "./types.js";
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    const len = Math.min(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+export class TelemetrySession {
+    db;
+    config;
+    id;
+    searchCount = 0;
+    feedbackCallCount = 0;
+    recentEmbeddings = [];
+    static REDUNDANCY_WINDOW_MS = 5 * 60 * 1000;
+    static REDUNDANCY_THRESHOLD = 0.8;
+    static MAX_FEEDBACK_CALLS = 20;
+    constructor(db, config, sessionId, metadata) {
+        this.db = db;
+        this.config = config;
+        this.id = sessionId;
+        if (config.enabled) {
+            db.insertTelemetrySession({
+                id: sessionId,
+                started_at: new Date().toISOString(),
+                embedding_model: metadata.embeddingModel,
+                chunking_strategy: metadata.chunkingStrategy,
+                store_type: metadata.storeType,
+                node_version: metadata.nodeVersion,
+                os: metadata.os,
+                total_searches: 0,
+                total_tool_calls: 0,
+                tools_used_json: "[]",
+                flushed: 0,
+            });
+        }
+    }
+    recordSearch(searchId, resultCount, queryEmbedding) {
+        if (!this.config.enabled || !this.config.tiers.implicit)
+            return;
+        const now = Date.now();
+        const redundant = this.isRedundant(queryEmbedding, now);
+        this.recentEmbeddings.push({ embedding: queryEmbedding, timestamp: now });
+        const cutoff = now - TelemetrySession.REDUNDANCY_WINDOW_MS;
+        this.recentEmbeddings = this.recentEmbeddings.filter((e) => e.timestamp >= cutoff);
+        const queryHash = resultCount === 0
+            ? createHash("sha256")
+                .update(Buffer.from(new Float32Array(queryEmbedding).buffer))
+                .digest("hex")
+                .slice(0, 16)
+            : undefined;
+        this.db.insertTelemetrySearch({
+            id: searchId,
+            session_id: this.id,
+            occurred_at: new Date(now).toISOString(),
+            result_count: resultCount,
+            result_count_bucket: resultCountBucket(resultCount),
+            empty: resultCount === 0 ? 1 : 0,
+            query_hash: queryHash,
+            redundancy_detected: redundant ? 1 : 0,
+            flushed: 0,
+        });
+        this.searchCount++;
+        this.db.updateTelemetrySession(this.id, {
+            total_searches: this.searchCount,
+        });
+    }
+    recordLatency(phase, durationMs) {
+        if (!this.config.enabled || !this.config.tiers.implicit)
+            return;
+        this.db.insertTelemetryLatency({
+            session_id: this.id,
+            occurred_at: new Date().toISOString(),
+            phase,
+            duration_ms: durationMs,
+            flushed: 0,
+        });
+    }
+    recordError(errorType, retryCount, recovered) {
+        if (!this.config.enabled || !this.config.tiers.implicit)
+            return;
+        this.db.insertTelemetryError({
+            session_id: this.id,
+            occurred_at: new Date().toISOString(),
+            error_type: errorType,
+            retry_count: retryCount,
+            recovered: recovered ? 1 : 0,
+            flushed: 0,
+        });
+    }
+    recordFeedback(searchId, payload) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.tiers.explicit_feedback.enabled)
+            return;
+        if (this.feedbackCallCount >= TelemetrySession.MAX_FEEDBACK_CALLS)
+            return;
+        this.feedbackCallCount++;
+        this.db.insertTelemetryFeedback({
+            session_id: this.id,
+            search_id: searchId,
+            occurred_at: new Date().toISOString(),
+            was_useful: payload.wasUseful ? 1 : 0,
+            context_relevance: payload.contextRelevance,
+            context_completeness: payload.contextCompleteness,
+            noise_ratio: payload.noiseRatio,
+            missing_category: normalizeMissingCategory(payload.missingCategory),
+            flushed: 0,
+        });
+    }
+    recordCacheStats(fileHitRate, semanticHitRate) {
+        if (!this.config.enabled || !this.config.tiers.implicit)
+            return;
+        this.db.insertTelemetryCacheStats({
+            session_id: this.id,
+            recorded_at: new Date().toISOString(),
+            file_hit_rate: fileHitRate,
+            semantic_hit_rate: semanticHitRate,
+            flushed: 0,
+        });
+    }
+    shouldSampleFeedback(resultCount) {
+        if (!this.config.enabled)
+            return false;
+        if (!this.config.tiers.explicit_feedback.enabled)
+            return false;
+        if (this.feedbackCallCount >= TelemetrySession.MAX_FEEDBACK_CALLS)
+            return false;
+        if (this.config.tiers.explicit_feedback.always_on_anomaly &&
+            (resultCount === 0 || resultCount > 10)) {
+            return true;
+        }
+        return Math.random() < this.config.tiers.explicit_feedback.sampling_rate;
+    }
+    end() {
+        if (!this.config.enabled)
+            return;
+        this.db.updateTelemetrySession(this.id, {
+            ended_at: new Date().toISOString(),
+        });
+    }
+    isRedundant(embedding, now) {
+        const cutoff = now - TelemetrySession.REDUNDANCY_WINDOW_MS;
+        return this.recentEmbeddings
+            .filter((e) => e.timestamp >= cutoff)
+            .some((e) => cosineSimilarity(e.embedding, embedding) >
+            TelemetrySession.REDUNDANCY_THRESHOLD);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/telemetry/session.js.map

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

package/dist/telemetry/types.d.ts

@@ -0,0 +1,97 @@
+export interface TelemetryConfig {
+    enabled: boolean;
+    endpoint?: string;
+    api_key?: string;
+    tiers: {
+        implicit: boolean;
+        explicit_feedback: {
+            enabled: boolean;
+            sampling_rate: number;
+            always_on_anomaly: boolean;
+            max_token_budget_percent: number;
+        };
+    };
+    privacy: {
+        query_hashing: boolean;
+        file_path_anonymization: boolean;
+        aggregation_window_minutes: number;
+        max_local_buffer_mb: number;
+        max_retry_hours: number;
+    };
+}
+export declare const DEFAULT_TELEMETRY_CONFIG: TelemetryConfig;
+export interface SessionMetadata {
+    embeddingModel?: string;
+    chunkingStrategy?: string;
+    storeType?: string;
+    nodeVersion: string;
+    os: string;
+}
+export interface TelemetrySessionRow {
+    id: string;
+    started_at: string;
+    ended_at?: string;
+    embedding_model?: string;
+    chunking_strategy?: string;
+    store_type?: string;
+    node_version: string;
+    os: string;
+    total_searches: number;
+    total_tool_calls: number;
+    tools_used_json: string;
+    flushed: number;
+}
+export interface TelemetrySearchRow {
+    id: string;
+    session_id: string;
+    occurred_at: string;
+    result_count: number;
+    result_count_bucket: string;
+    empty: number;
+    query_hash?: string;
+    redundancy_detected: number;
+    flushed: number;
+}
+export interface TelemetryLatencyRow {
+    id?: number;
+    session_id: string;
+    occurred_at: string;
+    phase: string;
+    duration_ms: number;
+    flushed: number;
+}
+export interface TelemetryErrorRow {
+    id?: number;
+    session_id: string;
+    occurred_at: string;
+    error_type: string;
+    retry_count: number;
+    recovered: number;
+    flushed: number;
+}
+export interface TelemetryFeedbackRow {
+    id?: number;
+    session_id: string;
+    search_id: string;
+    occurred_at: string;
+    was_useful: number;
+    context_relevance?: number;
+    context_completeness?: number;
+    noise_ratio?: number;
+    missing_category?: string;
+    flushed: number;
+}
+export interface TelemetryCacheStatsRow {
+    id?: number;
+    session_id: string;
+    recorded_at: string;
+    file_hit_rate?: number;
+    semantic_hit_rate?: number;
+    flushed: number;
+}
+export type ResultCountBucket = "0" | "1-3" | "4-10" | "11-20" | "20+";
+export declare function resultCountBucket(n: number): ResultCountBucket;
+export declare const MISSING_CATEGORY_VALUES: readonly ["missing_error_handling", "missing_config_example", "missing_api_reference", "missing_type_signature", "missing_test_coverage", "other"];
+export type MissingCategory = (typeof MISSING_CATEGORY_VALUES)[number];
+export declare function normalizeMissingCategory(value: string | undefined): MissingCategory | undefined;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/telemetry/types.js

@@ -0,0 +1,46 @@
+export const DEFAULT_TELEMETRY_CONFIG = {
+    enabled: true,
+    tiers: {
+        implicit: true,
+        explicit_feedback: {
+            enabled: false,
+            sampling_rate: 0.2,
+            always_on_anomaly: true,
+            max_token_budget_percent: 3,
+        },
+    },
+    privacy: {
+        query_hashing: true,
+        file_path_anonymization: true,
+        aggregation_window_minutes: 60,
+        max_local_buffer_mb: 10,
+        max_retry_hours: 48,
+    },
+};
+export function resultCountBucket(n) {
+    if (n === 0)
+        return "0";
+    if (n <= 3)
+        return "1-3";
+    if (n <= 10)
+        return "4-10";
+    if (n <= 20)
+        return "11-20";
+    return "20+";
+}
+export const MISSING_CATEGORY_VALUES = [
+    "missing_error_handling",
+    "missing_config_example",
+    "missing_api_reference",
+    "missing_type_signature",
+    "missing_test_coverage",
+    "other",
+];
+export function normalizeMissingCategory(value) {
+    if (!value)
+        return undefined;
+    return MISSING_CATEGORY_VALUES.includes(value)
+        ? value
+        : "other";
+}
+//# sourceMappingURL=types.js.map

package/dist/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,OAAO,EAAE,IAAI;IACb,KAAK,EAAE;QACL,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE;YACjB,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,GAAG;YAClB,iBAAiB,EAAE,IAAI;YACvB,wBAAwB,EAAE,CAAC;SAC5B;KACF;IACD,OAAO,EAAE;QACP,aAAa,EAAE,IAAI;QACnB,uBAAuB,EAAE,IAAI;QAC7B,0BAA0B,EAAE,EAAE;QAC9B,mBAAmB,EAAE,EAAE;QACvB,eAAe,EAAE,EAAE;KACpB;CACF,CAAC;AAgFF,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,OAAO;CACC,CAAC;AAIX,MAAM,UAAU,wBAAwB,CACtC,KAAyB;IAEzB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnE,CAAC,CAAE,KAAyB;QAC5B,CAAC,CAAC,OAAO,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivantel/virage-core",
-  "version": "0.2.19",
+  "version": "0.2.22",
   "type": "module",
   "description": "Core RAG pipeline tools - universal chunking, embedding, vector store interfaces",
   "repository": {
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc && echo \"✅ Build completed successfully\"",
+    "build": "rimraf dist && tsc && echo \"✅ Build completed successfully\"",
     "dev": "tsx watch src/index.ts",
     "type-check": "tsc --noEmit",
     "lint": "eslint src/",
@@ -59,14 +59,15 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@supabase/supabase-js": "^2.106.2",
+    "@supabase/supabase-js": "^2.107.0",
     "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.2",
     "eslint": "^10.4.1",
     "prettier": "^3.8.3",
+    "rimraf": "^6.0.1",
     "tsx": "^4.22.4",
     "typedoc": "^0.28.19",
-    "typedoc-plugin-markdown": "^4.11.0",
+    "typedoc-plugin-markdown": "^4.12.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.1",
     "vitest": "^4.1.8"

package/dist/core/embeddings-db.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embeddings-db.d.ts","sourceRoot":"","sources":["../../src/core/embeddings-db.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmD5E,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAuB1B,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,0BAA0B;IAkElC,OAAO,IAAI,cAAc,GAAG,IAAI;IAYhC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAQnC,wFAAwF;IACxF,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAgB/B,2DAA2D;IAC3D,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAoBnC,2DAA2D;IAC3D,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,IAAI;IAQP,4DAA4D;IAC5D,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC,sFAAsF;IACtF,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAsBxD,6EAA6E;IAC7E,qBAAqB,IAAI,KAAK,EAAE;IAsBhC,2EAA2E;IAC3E,sBAAsB,IAAI,aAAa,EAAE;IAMzC,yFAAyF;IACzF,YAAY,IAAI,KAAK,EAAE;IAsBvB,uEAAuE;IACvE,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAYpC,2EAA2E;IAC3E,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAsBrC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOjC,6EAA6E;IAC7E,MAAM,IAAI,aAAa,EAAE;IAMzB,sEAAsE;IACtE,UAAU,IAAI,aAAa,EAAE;IAI7B,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IAU3C,iDAAiD;IACjD,YAAY,IAAI,MAAM;IAStB,QAAQ,IAAI,IAAI;IAKhB,aAAa,IAAI,IAAI;IAIrB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuDvC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,oBAAoB;CAqB7B"}