vesper-memory 0.3.0

package/dist/benchmark/scenarios/index.js

@@ -0,0 +1,230 @@
+/**
+ * Scenario Module Index
+ *
+ * Exports all scenario implementations and factory functions.
+ */
+export { createContextRecallScenario, CONTEXT_RECALL_TEST_DATA } from "./context-recall.js";
+import { createContextRecallScenario } from "./context-recall.js";
+/**
+ * Create a scenario by type
+ *
+ * @param type - The scenario type to create
+ * @param client - MCP client for memory operations
+ * @returns Scenario instance
+ * @throws Error if scenario type is not supported
+ */
+export function createScenario(type, client) {
+    switch (type) {
+        case "context-recall":
+            return createContextRecallScenario(client);
+        case "cross-session":
+            return createCrossSessionScenario(client);
+        case "skill-retrieval":
+            return createSkillRetrievalScenario(client);
+        case "token-efficiency":
+            return createTokenEfficiencyScenario(client);
+        case "semantic-accuracy":
+            return createSemanticAccuracyScenario(client);
+        default:
+            throw new Error(`Unsupported scenario type: ${type}`);
+    }
+}
+// =============================================================================
+// Cross-Session Scenario (Simplified Implementation)
+// =============================================================================
+function createCrossSessionScenario(client) {
+    const testData = [
+        {
+            session1Fact: "In our previous session, we discussed implementing caching with Redis",
+            session2Question: "What did we discuss about caching?",
+            expectedKeywords: ["Redis", "caching"],
+        },
+        {
+            session1Fact: "Yesterday, the user decided to use PostgreSQL for the database",
+            session2Question: "What database did we decide to use?",
+            expectedKeywords: ["PostgreSQL", "database"],
+        },
+        {
+            session1Fact: "Last week, we fixed a critical bug in the authentication system",
+            session2Question: "What bug did we fix recently?",
+            expectedKeywords: ["bug", "authentication"],
+        },
+    ];
+    return createBaseScenario("cross-session", client, testData);
+}
+// =============================================================================
+// Skill Retrieval Scenario (Simplified Implementation)
+// =============================================================================
+function createSkillRetrievalScenario(client) {
+    const testData = [
+        {
+            session1Fact: "Skill: Deploy to production by running 'npm run build && npm run deploy'",
+            session2Question: "How do I deploy to production?",
+            expectedKeywords: ["npm", "build", "deploy"],
+        },
+        {
+            session1Fact: "Skill: Create a new component using 'npm run generate:component ComponentName'",
+            session2Question: "How do I create a new component?",
+            expectedKeywords: ["generate", "component"],
+        },
+        {
+            session1Fact: "Skill: Run tests with coverage using 'npm test -- --coverage'",
+            session2Question: "How do I run tests with coverage?",
+            expectedKeywords: ["test", "coverage"],
+        },
+    ];
+    return createBaseScenario("skill-retrieval", client, testData);
+}
+// =============================================================================
+// Token Efficiency Scenario (Simplified Implementation)
+// =============================================================================
+function createTokenEfficiencyScenario(client) {
+    const testData = [
+        {
+            session1Fact: "Project context: Building a memory system for AI with Redis, Qdrant, and SQLite",
+            session2Question: "What is the project context?",
+            expectedKeywords: ["memory", "Redis", "Qdrant", "SQLite"],
+        },
+        {
+            session1Fact: "User preferences: TypeScript, functional programming, 80% test coverage",
+            session2Question: "What are the user's coding preferences?",
+            expectedKeywords: ["TypeScript", "functional", "test", "coverage"],
+        },
+    ];
+    return createBaseScenario("token-efficiency", client, testData);
+}
+// =============================================================================
+// Semantic Accuracy Scenario (Simplified Implementation)
+// =============================================================================
+function createSemanticAccuracyScenario(client) {
+    const testData = [
+        {
+            session1Fact: "The capital city of France is Paris, known for the Eiffel Tower",
+            session2Question: "What is the capital of France?",
+            expectedKeywords: ["Paris", "capital"],
+        },
+        {
+            session1Fact: "Machine learning is a subset of artificial intelligence focused on learning from data",
+            session2Question: "What is machine learning?",
+            expectedKeywords: ["learning", "data", "artificial intelligence"],
+        },
+        {
+            session1Fact: "REST APIs use HTTP methods like GET, POST, PUT, DELETE for communication",
+            session2Question: "How do REST APIs work?",
+            expectedKeywords: ["HTTP", "GET", "POST"],
+        },
+    ];
+    return createBaseScenario("semantic-accuracy", client, testData);
+}
+function createBaseScenario(type, client, testData) {
+    const errors = [];
+    return {
+        getType() {
+            return type;
+        },
+        getDescription() {
+            const descriptions = {
+                "context-recall": "Tests ability to recall facts from conversations",
+                "cross-session": "Tests persistence of context across sessions",
+                "skill-retrieval": "Tests retrieval of procedural knowledge",
+                "token-efficiency": "Measures token usage reduction",
+                "semantic-accuracy": "Tests semantic search accuracy",
+            };
+            return descriptions[type];
+        },
+        async setup() {
+            errors.length = 0;
+            for (const testCase of testData) {
+                try {
+                    await client.storeMemory(testCase.session1Fact, "semantic", {
+                        scenario: type,
+                        timestamp: Date.now(),
+                    });
+                }
+                catch (err) {
+                    const errorMsg = err instanceof Error ? err.message : String(err);
+                    errors.push(`Setup error: ${errorMsg}`);
+                }
+            }
+        },
+        async run(phase) {
+            const { measureLatency, evaluateResponseQuality, aggregateMetrics } = await import("../metrics-collector.js");
+            const metrics = [];
+            const rawResponses = [];
+            for (const testCase of testData) {
+                if (phase === "vesper-enabled") {
+                    try {
+                        const { result, latencyMs } = await measureLatency(async () => {
+                            return await client.retrieveMemory(testCase.session2Question, {
+                                max_results: 3,
+                            });
+                        });
+                        const memoryHit = result.success && result.results.length > 0;
+                        const responseContent = memoryHit
+                            ? result.results[0].content
+                            : "No relevant memory found";
+                        const retrievalAccuracy = memoryHit
+                            ? evaluateResponseQuality(responseContent, testCase.expectedKeywords, {
+                                mode: "keywords",
+                            })
+                            : 0;
+                        metrics.push({
+                            timestamp: Date.now(),
+                            latencyMs,
+                            memoryHit,
+                            retrievalAccuracy,
+                        });
+                        rawResponses.push(responseContent);
+                    }
+                    catch (err) {
+                        const errorMsg = err instanceof Error ? err.message : String(err);
+                        errors.push(`Run error: ${errorMsg}`);
+                        metrics.push({
+                            timestamp: Date.now(),
+                            latencyMs: 0,
+                            memoryHit: false,
+                            retrievalAccuracy: 0,
+                        });
+                        rawResponses.push(`Error: ${errorMsg}`);
+                    }
+                }
+                else {
+                    const startTime = performance.now();
+                    await new Promise((resolve) => setTimeout(resolve, 1));
+                    const latencyMs = performance.now() - startTime;
+                    metrics.push({
+                        timestamp: Date.now(),
+                        latencyMs,
+                        memoryHit: false,
+                        retrievalAccuracy: 0,
+                    });
+                    rawResponses.push("Memory disabled - cannot recall");
+                }
+            }
+            let aggregates;
+            try {
+                aggregates = aggregateMetrics(metrics);
+            }
+            catch {
+                aggregates = {
+                    latencyP50: 0,
+                    latencyP95: 0,
+                    latencyP99: 0,
+                    memoryHitRate: 0,
+                };
+            }
+            return {
+                scenarioType: type,
+                phase,
+                metrics,
+                aggregates,
+                rawResponses,
+                errors: errors.length > 0 ? [...errors] : undefined,
+            };
+        },
+        async teardown() {
+            errors.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/benchmark/scenarios/index.js.map

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

package/dist/benchmark/statistics.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Statistical Functions for Scientific Benchmarks
+ *
+ * Pure functions for calculating:
+ * - Descriptive statistics (mean, median, percentile)
+ * - Dispersion measures (variance, standard deviation)
+ * - Confidence intervals
+ * - Hypothesis testing (Welch's t-test)
+ * - Effect size (Cohen's d)
+ *
+ * All functions are designed to be accurate, efficient, and safe.
+ */
+/**
+ * Custom error class for statistics-related errors
+ */
+export declare class StatisticsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Calculate arithmetic mean of an array
+ *
+ * @param values - Array of numbers
+ * @returns The arithmetic mean
+ * @throws StatisticsError if array is empty or contains non-finite values
+ */
+export declare function mean(values: number[]): number;
+/**
+ * Calculate median of an array
+ *
+ * @param values - Array of numbers
+ * @returns The median value
+ * @throws StatisticsError if array is empty
+ */
+export declare function median(values: number[]): number;
+/**
+ * Calculate percentile using linear interpolation
+ *
+ * @param values - Array of numbers
+ * @param p - Percentile to calculate (0-100)
+ * @returns The percentile value
+ * @throws StatisticsError if array is empty or percentile is out of range
+ */
+export declare function percentile(values: number[], p: number): number;
+/**
+ * Calculate variance of an array
+ *
+ * @param values - Array of numbers
+ * @param sample - If true, calculate sample variance (n-1 denominator); default is population variance
+ * @returns The variance
+ * @throws StatisticsError if array is empty or too small for sample variance
+ */
+export declare function variance(values: number[], sample?: boolean): number;
+/**
+ * Calculate standard deviation of an array
+ *
+ * @param values - Array of numbers
+ * @param sample - If true, calculate sample standard deviation
+ * @returns The standard deviation
+ * @throws StatisticsError if array is empty or too small for sample SD
+ */
+export declare function standardDeviation(values: number[], sample?: boolean): number;
+/**
+ * Result of confidence interval calculation
+ */
+export interface ConfidenceIntervalResult {
+    mean: number;
+    lower: number;
+    upper: number;
+    confidenceLevel: number;
+    marginOfError: number;
+    standardError: number;
+}
+/**
+ * Calculate confidence interval using t-distribution
+ *
+ * @param values - Array of sample values
+ * @param confidenceLevel - Confidence level (0 < level < 1), e.g., 0.95 for 95% CI
+ * @returns ConfidenceIntervalResult with mean, lower, upper bounds
+ * @throws StatisticsError if array has less than 2 elements or invalid confidence level
+ */
+export declare function confidenceInterval(values: number[], confidenceLevel: number): ConfidenceIntervalResult;
+/**
+ * Result of Welch's t-test
+ */
+export interface WelchTTestResult {
+    tStatistic: number;
+    pValue: number;
+    degreesOfFreedom: number;
+    significant: boolean;
+    alpha: number;
+    meanDifference: number;
+}
+/**
+ * Perform Welch's t-test for two independent samples
+ *
+ * Welch's t-test is more robust than Student's t-test when
+ * variances are unequal between groups.
+ *
+ * @param groupA - First sample
+ * @param groupB - Second sample
+ * @param alpha - Significance level (default 0.05)
+ * @returns WelchTTestResult with test statistics and significance
+ * @throws StatisticsError if either group has less than 2 elements
+ */
+export declare function welchTTest(groupA: number[], groupB: number[], alpha?: number): WelchTTestResult;
+/**
+ * Calculate Cohen's d effect size
+ *
+ * Cohen's d measures the standardized difference between two means.
+ * Guidelines: |d| < 0.2 negligible, 0.2-0.5 small, 0.5-0.8 medium, > 0.8 large
+ *
+ * @param groupA - First sample
+ * @param groupB - Second sample
+ * @returns Cohen's d (positive if A > B, negative if A < B)
+ * @throws StatisticsError if either group has less than 2 elements
+ */
+export declare function cohensD(groupA: number[], groupB: number[]): number;
+/**
+ * Interpret Cohen's d effect size
+ *
+ * @param d - Cohen's d value
+ * @returns String interpretation
+ */
+export declare function interpretEffectSize(d: number): string;
+//# sourceMappingURL=statistics.d.ts.map

package/dist/benchmark/statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../../src/benchmark/statistics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAkBD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB7C;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB/C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,OAAe,GAAG,MAAM,CAoB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,GAAE,OAAe,GACtB,MAAM,CAER;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,eAAe,EAAE,MAAM,GACtB,wBAAwB,CAiC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,GAAE,MAAa,GACnB,gBAAgB,CAmDlB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CA4BlE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAYrD"}