@aeriondyseti/vector-memory-mcp 1.0.2-dev.0 → 1.1.0-dev.2

package/src/types/conversation-history.ts

@@ -0,0 +1,82 @@
+import type { WithRrfScore } from "./memory.js";
+
+export type MessageRole = "user" | "assistant";
+
+/**
+ * A single indexed message from a conversation session log.
+ * One entry per user/assistant text message — tool calls and results are excluded.
+ */
+export interface ConversationHistoryEntry {
+  id: string;
+  content: string;
+  embedding: number[];
+  sessionId: string;
+  role: MessageRole;
+  messageIndex: number;
+  timestamp: Date;
+  metadata: Record<string, unknown>;
+  createdAt: Date;
+}
+
+export type ConversationHistoryHybridRow = WithRrfScore<ConversationHistoryEntry>;
+
+/**
+ * Summary of an indexed session for list_indexed_sessions.
+ */
+export interface IndexedSessionSummary {
+  sessionId: string;
+  messageCount: number;
+  firstMessageAt: Date;
+  lastMessageAt: Date;
+  indexedAt: Date;
+  project?: string;
+  gitBranch?: string;
+}
+
+/**
+ * Full indexed session record including storage-level fields (file path, size).
+ * Used by the repository for upsert operations and by the parser for tracking.
+ */
+export interface IndexedSession extends IndexedSessionSummary {
+  filePath: string;
+  fileSize: number;
+}
+
+/**
+ * Discriminated union for merged search results.
+ * Narrow on `source` to access type-specific fields.
+ */
+export interface MemorySearchResult {
+  source: "memory";
+  id: string;
+  content: string;
+  metadata: Record<string, unknown>;
+  score: number;
+  createdAt: Date;
+  updatedAt: Date;
+  supersededBy: string | null;
+}
+
+export interface HistorySearchResult {
+  source: "conversation_history";
+  id: string;
+  content: string;
+  metadata: Record<string, unknown>;
+  score: number;
+  sessionId: string;
+  role: MessageRole;
+  messageIndex: number;
+  timestamp: Date;
+}
+
+export type SearchResult = MemorySearchResult | HistorySearchResult;
+
+/**
+ * Summary returned by indexConversations() and reindexSession().
+ */
+export interface IndexingSummary {
+  sessionsDiscovered: number;
+  sessionsIndexed: number;
+  sessionsSkipped: number;
+  messagesIndexed: number;
+}

package/src/types/memory.ts

@@ -38,6 +38,7 @@ export interface IntentProfile {
   jitter: number;
 }
 
-export interface HybridRow extends Memory {
-  rrfScore: number;
-}
+/** Augments any entity type with an RRF score from hybrid search. */
+export type WithRrfScore<T> = T & { rrfScore: number };
+
+export type HybridRow = WithRrfScore<Memory>;