mcp-adr-analysis-server 2.1.9 → 2.1.20

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

@@ -0,0 +1,184 @@
+/**
+ * Conversation Memory Types
+ *
+ * Phase 3 of context decay mitigation: Structured external memory
+ * for conversation persistence, expandable content storage, and resumption.
+ */
+import type { ExpandableContent } from './tiered-response.js';
+/**
+ * A single turn in the conversation
+ */
+export interface ConversationTurn {
+    /** Unique turn ID */
+    id: string;
+    /** Turn number in sequence */
+    turnNumber: number;
+    /** Timestamp of the turn */
+    timestamp: string;
+    /** User request or tool invocation */
+    request: {
+        type: 'tool_call' | 'user_message';
+        toolName?: string;
+        toolArgs?: any;
+        message?: string;
+    };
+    /** Response provided */
+    response: {
+        content: string;
+        tokenCount: number;
+        contextInjected?: boolean;
+        expandableId?: string;
+    };
+    /** Metadata */
+    metadata: {
+        duration?: number;
+        model?: string;
+        cacheHit?: boolean;
+        errorOccurred?: boolean;
+    };
+}
+/**
+ * Complete conversation session
+ */
+export interface ConversationSession {
+    /** Unique session ID */
+    sessionId: string;
+    /** Project path this session is for */
+    projectPath: string;
+    /** Session start time */
+    startedAt: string;
+    /** Session last activity time */
+    lastActivityAt: string;
+    /** All conversation turns */
+    turns: ConversationTurn[];
+    /** Session metadata */
+    metadata: {
+        totalTokensUsed: number;
+        averageResponseTime: number;
+        toolsUsed: string[];
+        knowledgeGraphIntents: string[];
+    };
+}
+/**
+ * Conversation memory storage configuration
+ */
+export interface ConversationMemoryConfig {
+    /**
+     * Maximum number of sessions to keep in memory
+     * @default 10
+     */
+    maxSessionsInMemory: number;
+    /**
+     * Persist session to disk after N turns
+     * @default 5
+     */
+    persistAfterTurns: number;
+    /**
+     * Maximum age of session in hours before archival
+     * @default 24
+     */
+    sessionMaxAgeHours: number;
+    /**
+     * Enable automatic cleanup of old sessions
+     * @default true
+     */
+    autoCleanup: boolean;
+    /**
+     * Retention period for archived sessions in days
+     * @default 30
+     */
+    archivedRetentionDays: number;
+}
+/**
+ * Conversation context snapshot for state resumption
+ */
+export interface ConversationContextSnapshot {
+    /** Session ID */
+    sessionId: string;
+    /** Last N turns for context */
+    recentTurns: ConversationTurn[];
+    /** Active knowledge graph intents */
+    activeIntents: Array<{
+        id: string;
+        intent: string;
+        status: string;
+    }>;
+    /** Architectural decisions made in this session */
+    decisionsRecorded: Array<{
+        adrId: string;
+        title: string;
+        timestamp: string;
+    }>;
+    /** Current conversation focus */
+    conversationFocus?: {
+        topic: string;
+        phase: string;
+        nextSteps: string[];
+    };
+}
+/**
+ * Memory expansion request
+ */
+export interface MemoryExpansionRequest {
+    /** Expandable ID from tiered response */
+    expandableId: string;
+    /** Optional: specific section to expand */
+    section?: string;
+    /** Include related context */
+    includeContext?: boolean;
+}
+/**
+ * Memory expansion response
+ */
+export interface MemoryExpansionResponse {
+    /** Request ID */
+    expandableId: string;
+    /** Expanded content */
+    content: ExpandableContent;
+    /** Related conversation turns */
+    relatedTurns?: ConversationTurn[];
+    /** Knowledge graph context */
+    knowledgeGraphContext?: Array<{
+        intent: string;
+        outcome: string;
+        timestamp: string;
+    }>;
+}
+/**
+ * Session query for retrieval
+ */
+export interface SessionQuery {
+    /** Filter by project path */
+    projectPath?: string;
+    /** Filter by date range */
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    /** Filter by tools used */
+    toolsUsed?: string[];
+    /** Filter by keyword in turns */
+    keyword?: string;
+    /** Limit results */
+    limit?: number;
+}
+/**
+ * Conversation memory statistics
+ */
+export interface ConversationMemoryStats {
+    /** Total sessions stored */
+    totalSessions: number;
+    /** Active sessions (< 24h old) */
+    activeSessions: number;
+    /** Archived sessions */
+    archivedSessions: number;
+    /** Total turns across all sessions */
+    totalTurns: number;
+    /** Total expandable content items */
+    totalExpandableContent: number;
+    /** Average turns per session */
+    avgTurnsPerSession: number;
+    /** Total storage size (bytes) */
+    totalStorageBytes: number;
+}
+//# sourceMappingURL=conversation-memory.d.ts.map

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

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

package/dist/src/types/conversation-memory.js

@@ -0,0 +1,8 @@
+/**
+ * Conversation Memory Types
+ *
+ * Phase 3 of context decay mitigation: Structured external memory
+ * for conversation persistence, expandable content storage, and resumption.
+ */
+export {};
+//# sourceMappingURL=conversation-memory.js.map

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

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