@aeriondyseti/vector-memory-mcp 1.1.0-dev.5 → 2.0.0-rc

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

@@ -1,99 +0,0 @@
-/** A single parsed message from a session log */
-export interface ParsedMessage {
-    uuid: string;
-    role: "user" | "assistant";
-    content: string;
-    timestamp: Date;
-    messageIndex: number;
-    sessionId: string;
-    project: string;
-    gitBranch?: string;
-    isSubagent: boolean;
-    agentId?: string;
-}
-/** Metadata stored per conversation chunk in the database */
-export interface ConversationChunkMetadata {
-    session_id: string;
-    timestamp: string;
-    role: string;
-    message_index_start: number;
-    message_index_end: number;
-    project: string;
-    git_branch?: string;
-    is_subagent: boolean;
-    agent_id?: string;
-}
-/** A chunk of conversation ready for indexing */
-export interface ConversationChunk {
-    id: string;
-    content: string;
-    sessionId: string;
-    timestamp: Date;
-    endTimestamp: Date;
-    role: string;
-    messageIndexStart: number;
-    messageIndexEnd: number;
-    project: string;
-    metadata: ConversationChunkMetadata;
-}
-/** Tracking record for an indexed session */
-export interface IndexedSession {
-    sessionId: string;
-    filePath: string;
-    project: string;
-    lastModified: number;
-    chunkCount: number;
-    messageCount: number;
-    indexedAt: Date;
-    firstMessageAt: Date;
-    lastMessageAt: Date;
-}
-/** Raw row from conversation_history table with RRF score */
-export interface ConversationHybridRow {
-    id: string;
-    content: string;
-    metadata: Record<string, unknown>;
-    createdAt: Date;
-    rrfScore: number;
-}
-/** Unified search result with source provenance */
-export interface SearchResult {
-    id: string;
-    content: string;
-    metadata: Record<string, unknown>;
-    createdAt: Date;
-    updatedAt: Date;
-    source: "memory" | "conversation_history";
-    score: number;
-    supersededBy?: string | null;
-    usefulness?: number;
-    accessCount?: number;
-    lastAccessed?: Date | null;
-    sessionId?: string;
-    role?: string;
-    messageIndexStart?: number;
-    messageIndexEnd?: number;
-}
-/** Session file info returned by the parser's file discovery */
-export interface SessionFileInfo {
-    filePath: string;
-    sessionId: string;
-    project: string;
-    lastModified: Date;
-}
-/** Search filter options for conversation history */
-export interface HistoryFilters {
-    sessionId?: string;
-    role?: string;
-    project?: string;
-    after?: Date;
-    before?: Date;
-}
-/** Options for the integrated search across both sources */
-export interface SearchOptions {
-    includeHistory?: boolean;
-    historyOnly?: boolean;
-    historyWeight?: number;
-    historyFilters?: HistoryFilters;
-}
-//# sourceMappingURL=conversation.d.ts.map

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

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

package/dist/src/types/conversation.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=conversation.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../../src/types/conversation.ts"],"names":[],"mappings":""}

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

@@ -1,30 +0,0 @@
-export declare const DELETED_TOMBSTONE = "DELETED";
-export interface Memory {
-    id: string;
-    content: string;
-    embedding: number[];
-    metadata: Record<string, unknown>;
-    createdAt: Date;
-    updatedAt: Date;
-    supersededBy: string | null;
-    usefulness: number;
-    accessCount: number;
-    lastAccessed: Date | null;
-}
-export declare function isDeleted(memory: Memory): boolean;
-export declare function memoryToDict(memory: Memory): Record<string, unknown>;
-export type SearchIntent = 'continuity' | 'fact_check' | 'frequent' | 'associative' | 'explore';
-export interface IntentProfile {
-    weights: {
-        relevance: number;
-        recency: number;
-        utility: number;
-    };
-    jitter: number;
-}
-/** Augments any entity type with an RRF score from hybrid search. */
-export type WithRrfScore<T> = T & {
-    rrfScore: number;
-};
-export type HybridRow = WithRrfScore<Memory>;
-//# sourceMappingURL=memory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYpE;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/dist/src/types/memory.js

@@ -1,18 +0,0 @@
-export const DELETED_TOMBSTONE = "DELETED";
-export function isDeleted(memory) {
-    return memory.supersededBy === DELETED_TOMBSTONE;
-}
-export function memoryToDict(memory) {
-    return {
-        id: memory.id,
-        content: memory.content,
-        metadata: memory.metadata,
-        createdAt: memory.createdAt.toISOString(),
-        updatedAt: memory.updatedAt.toISOString(),
-        supersededBy: memory.supersededBy,
-        usefulness: memory.usefulness,
-        accessCount: memory.accessCount,
-        lastAccessed: memory.lastAccessed?.toISOString() ?? null,
-    };
-}
-//# sourceMappingURL=memory.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAe3C,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,MAAM,CAAC,YAAY,KAAK,iBAAiB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI;KACzD,CAAC;AACJ,CAAC"}

package/src/db/conversation.schema.ts

@@ -1,33 +0,0 @@
-import {
-  Schema,
-  Field,
-  FixedSizeList,
-  Float32,
-  Utf8,
-  Timestamp,
-  TimeUnit,
-  Int32,
-} from "apache-arrow";
-
-export const CONVERSATION_TABLE_NAME = "conversation_history";
-
-export const conversationSchema = new Schema([
-  new Field("id", new Utf8(), false),
-  new Field(
-    "vector",
-    new FixedSizeList(384, new Field("item", new Float32(), false)),
-    false
-  ),
-  new Field("content", new Utf8(), false),
-  new Field("metadata", new Utf8(), false), // JSON string
-  new Field(
-    "created_at",
-    new Timestamp(TimeUnit.MILLISECOND),
-    false
-  ),
-  new Field("session_id", new Utf8(), false),
-  new Field("role", new Utf8(), false),
-  new Field("message_index_start", new Int32(), false),
-  new Field("message_index_end", new Int32(), false),
-  new Field("project", new Utf8(), false),
-]);

package/src/db/lancedb-utils.ts

@@ -1,125 +0,0 @@
-import * as lancedb from "@lancedb/lancedb";
-import { Index, rerankers, type Table } from "@lancedb/lancedb";
-import type { Schema } from "apache-arrow";
-
-/**
- * Escape a string value for safe interpolation into LanceDB/DataFusion SQL WHERE clauses.
- *
- * DataFusion uses ANSI SQL string literal rules:
- * - String literals are delimited by single quotes
- * - Single quotes within strings are escaped by doubling: ' -> ''
- * - Backslashes are NOT escape characters (treated literally)
- */
-export function escapeSql(value: string): string {
-  return value.replace(/'/g, "''");
-}
-
-/** Default k parameter for Reciprocal Rank Fusion reranking. */
-export const RRF_K = 60;
-
-/**
- * Converts LanceDB's Arrow Vector type to a plain number[].
- * LanceDB returns an Arrow Vector object which is iterable but not an array.
- */
-export function arrowVectorToArray(value: unknown): number[] {
-  return Array.isArray(value)
-    ? value
-    : (Array.from(value as Iterable<number>) as number[]);
-}
-
-/**
- * Safely parse a JSON string into an object, returning an empty object on failure.
- */
-export function safeParseJsonObject(raw: string): Record<string, unknown> {
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-
-/**
- * Opens an existing table or creates it with the given schema.
- * Does NOT cache — callers should cache the returned Table if desired.
- */
-export async function getOrCreateTable(
-  db: lancedb.Connection,
-  name: string,
-  schema: Schema
-): Promise<Table> {
-  try {
-    return await db.openTable(name);
-  } catch (err: unknown) {
-    // Only proceed to create if the table was not found
-    const message = err instanceof Error ? err.message : String(err);
-    if (!message.includes("was not found") && !message.includes("does not exist")) {
-      throw err;
-    }
-  }
-  try {
-    return await db.createTable(name, [], { schema });
-  } catch {
-    // Another caller may have created it concurrently
-    return await db.openTable(name);
-  }
-}
-
-/**
- * Creates a mutex-guarded function that ensures an FTS index exists on a table's content column.
- *
- * Once the FTS index is confirmed/created, the promise is retained for the lifetime of the
- * caller — the index persists in LanceDB, so re-checking is unnecessary. On error, the
- * mutex resets so the next call can retry.
- *
- * The key design constraint: the promise must be captured synchronously (before any await)
- * to prevent concurrent callers from racing past the guard.
- */
-export function createFtsMutex(
-  getTable: () => Promise<Table>
-): () => Promise<void> {
-  let promise: Promise<void> | null = null;
-
-  return () => {
-    if (promise) return promise;
-
-    promise = (async () => {
-      const table = await getTable();
-      const indices = await table.listIndices();
-      const hasFtsIndex = indices.some(
-        (idx) => idx.columns.includes("content") && idx.indexType === "FTS"
-      );
-
-      if (!hasFtsIndex) {
-        await table.createIndex("content", {
-          config: Index.fts(),
-        });
-        await table.waitForIndex(["content_idx"], 30);
-      }
-    })().catch((error) => {
-      promise = null;
-      throw error;
-    });
-
-    return promise;
-  };
-}
-
-/**
- * Creates a promise-mutex for RRFReranker instantiation.
- * Same pattern as createFtsMutex: create once, cache forever, reset on error.
- */
-export function createRerankerMutex(
-  k: number = RRF_K
-): () => Promise<rerankers.RRFReranker> {
-  let promise: Promise<rerankers.RRFReranker> | null = null;
-
-  return () => {
-    if (!promise) {
-      promise = rerankers.RRFReranker.create(k).catch((e) => {
-        promise = null;
-        throw e;
-      });
-    }
-    return promise;
-  };
-}

package/src/db/schema.ts

@@ -1,38 +0,0 @@
-import {
-  Schema,
-  Field,
-  FixedSizeList,
-  Float32,
-  Utf8,
-  Timestamp,
-  TimeUnit,
-  Int32,
-} from "apache-arrow";
-
-// Shared field helpers — used by both memory and conversation history schemas
-export const EMBEDDING_DIMENSION = 384;
-
-export const vectorField = () =>
-  new Field(
-    "vector",
-    new FixedSizeList(EMBEDDING_DIMENSION, new Field("item", new Float32())),
-    false
-  );
-
-export const timestampField = (name: string, nullable = false) =>
-  new Field(name, new Timestamp(TimeUnit.MILLISECOND), nullable);
-
-export const TABLE_NAME = "memories";
-
-export const memorySchema = new Schema([
-  new Field("id", new Utf8(), false),
-  vectorField(),
-  new Field("content", new Utf8(), false),
-  new Field("metadata", new Utf8(), false), // JSON string
-  timestampField("created_at"),
-  timestampField("updated_at"),
-  new Field("superseded_by", new Utf8(), true), // Nullable
-  new Field("usefulness", new Float32(), false),
-  new Field("access_count", new Int32(), false),
-  timestampField("last_accessed", true),
-]);