@nexus-cortex/core 4.26.0

package/dist/tools/historical/HistoricalContextService.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Historical Context Service
+ *
+ * Coordinates the 4 historical retrieval tools to provide unified access
+ * to conversation history across compaction boundaries.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4.3
+ */
+import type { Message } from '../../session/MessageTypes.js';
+/**
+ * Options for historical context operations
+ */
+export interface HistoricalContextOptions {
+    /** Session ID for the conversation */
+    sessionId: string;
+    /** Recent messages in current context */
+    recentMessages: Message[];
+    /** Workspace root for storage */
+    workspaceRoot?: string;
+}
+/**
+ * Unified historical context response
+ */
+export interface HistoricalContext {
+    /** Type of context retrieved */
+    type: 'search' | 'segment' | 'boundaries' | 'context';
+    /** Content of the response */
+    content: any;
+    /** Metadata about the retrieval */
+    metadata: {
+        /** Number of sources used */
+        sourceCount: number;
+        /** Time range covered */
+        timeRange?: {
+            start: Date;
+            end: Date;
+        };
+        /** Tokens used for retrieval */
+        tokensUsed?: number;
+        /** Model used (if applicable) */
+        modelUsed?: string;
+        /** Processing time in milliseconds */
+        processingTime: number;
+    };
+}
+/**
+ * Service for coordinating historical context retrieval
+ */
+export declare class HistoricalContextService {
+    private searchTool;
+    private segmentTool;
+    private boundariesTool;
+    private contextTool;
+    constructor(workspaceRoot?: string);
+    /**
+     * Get all tool definitions for registration
+     */
+    static getToolDefinitions(): ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                timeRange: {
+                    type: string;
+                    properties: {
+                        start: {
+                            type: string;
+                            format: string;
+                        };
+                        end: {
+                            type: string;
+                            format: string;
+                        };
+                    };
+                    description: string;
+                };
+                includeCompacted: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                turnRange: {
+                    type: string;
+                    properties: {
+                        start: {
+                            type: string;
+                            description: string;
+                        };
+                        end: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    description: string;
+                };
+                checkpointId: {
+                    type: string;
+                    description: string;
+                };
+                format: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+            };
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                includeMetadata: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                detailLevel: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+                maxTokens: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                useHelperModel: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+            required: string[];
+        };
+    })[];
+    /**
+     * Search conversation history
+     */
+    searchHistory(query: string, options: HistoricalContextOptions, searchOptions?: {
+        maxResults?: number;
+        timeRange?: {
+            start: Date;
+            end: Date;
+        };
+        includeCompacted?: boolean;
+    }): Promise<HistoricalContext>;
+    /**
+     * Get a specific conversation segment
+     */
+    getSegment(options: HistoricalContextOptions, segmentOptions: {
+        turnRange?: {
+            start: number;
+            end: number;
+        };
+        checkpointId?: string;
+        format?: 'full' | 'summary' | 'compressed';
+    }): Promise<HistoricalContext>;
+    /**
+     * List all compaction boundaries
+     */
+    listBoundaries(options: HistoricalContextOptions, includeMetadata?: boolean): Promise<HistoricalContext>;
+    /**
+     * Request historical context via helper model
+     */
+    requestContext(query: string, options: HistoricalContextOptions, contextOptions?: {
+        detailLevel?: 'brief' | 'standard' | 'detailed';
+        maxTokens?: number;
+        useHelperModel?: boolean;
+    }): Promise<HistoricalContext>;
+    /**
+     * Smart retrieval - automatically choose best tool based on query
+     */
+    smartRetrieval(query: string, options: HistoricalContextOptions): Promise<HistoricalContext>;
+    /**
+     * Get comprehensive overview of conversation history
+     */
+    getHistoryOverview(options: HistoricalContextOptions): Promise<{
+        totalMessages: number;
+        compactionBoundaries: number;
+        totalTokensSaved: number;
+        oldestMessage: Date | null;
+        newestMessage: Date | null;
+        summary: string;
+    }>;
+    /**
+     * Execute a tool by name (for dynamic tool calling)
+     */
+    executeTool(toolName: string, input: any, options: HistoricalContextOptions): Promise<any>;
+    /**
+     * Extract time range from search results
+     */
+    private extractTimeRange;
+}
+//# sourceMappingURL=HistoricalContextService.d.ts.map

package/dist/tools/historical/HistoricalContextService.d.ts.map

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

package/dist/tools/historical/HistoricalContextService.js

@@ -0,0 +1,206 @@
+/**
+ * Historical Context Service
+ *
+ * Coordinates the 4 historical retrieval tools to provide unified access
+ * to conversation history across compaction boundaries.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4.3
+ */
+import { SearchConversationHistoryTool } from './SearchConversationHistory.js';
+import { GetConversationSegmentTool } from './GetConversationSegment.js';
+import { ListCompactionBoundariesTool } from './ListCompactionBoundaries.js';
+import { RequestHistoricalContextTool } from './RequestHistoricalContext.js';
+/**
+ * Service for coordinating historical context retrieval
+ */
+export class HistoricalContextService {
+    searchTool;
+    segmentTool;
+    boundariesTool;
+    contextTool;
+    constructor(workspaceRoot) {
+        this.searchTool = new SearchConversationHistoryTool(workspaceRoot);
+        this.segmentTool = new GetConversationSegmentTool(workspaceRoot);
+        this.boundariesTool = new ListCompactionBoundariesTool(workspaceRoot);
+        this.contextTool = new RequestHistoricalContextTool(workspaceRoot);
+    }
+    /**
+     * Get all tool definitions for registration
+     */
+    static getToolDefinitions() {
+        return [
+            SearchConversationHistoryTool.definition,
+            GetConversationSegmentTool.definition,
+            ListCompactionBoundariesTool.definition,
+            RequestHistoricalContextTool.definition
+        ];
+    }
+    /**
+     * Search conversation history
+     */
+    async searchHistory(query, options, searchOptions) {
+        const startTime = Date.now();
+        const results = await this.searchTool.execute({
+            query,
+            maxResults: searchOptions?.maxResults,
+            timeRange: searchOptions?.timeRange,
+            includeCompacted: searchOptions?.includeCompacted
+        }, options.sessionId, options.recentMessages);
+        const processingTime = Date.now() - startTime;
+        return {
+            type: 'search',
+            content: results,
+            metadata: {
+                sourceCount: results.length,
+                timeRange: this.extractTimeRange(results),
+                processingTime
+            }
+        };
+    }
+    /**
+     * Get a specific conversation segment
+     */
+    async getSegment(options, segmentOptions) {
+        const startTime = Date.now();
+        const segment = await this.segmentTool.execute(segmentOptions, options.sessionId, options.recentMessages);
+        const processingTime = Date.now() - startTime;
+        return {
+            type: 'segment',
+            content: segment,
+            metadata: {
+                sourceCount: segment.metadata.messageCount,
+                tokensUsed: segment.metadata.totalTokens,
+                processingTime
+            }
+        };
+    }
+    /**
+     * List all compaction boundaries
+     */
+    async listBoundaries(options, includeMetadata = true) {
+        const startTime = Date.now();
+        const boundaries = await this.boundariesTool.execute({ includeMetadata }, options.sessionId);
+        const processingTime = Date.now() - startTime;
+        // Calculate total tokens saved
+        const totalTokensSaved = boundaries.reduce((sum, b) => sum + b.tokens.saved, 0);
+        return {
+            type: 'boundaries',
+            content: boundaries,
+            metadata: {
+                sourceCount: boundaries.length,
+                tokensUsed: totalTokensSaved,
+                processingTime
+            }
+        };
+    }
+    /**
+     * Request historical context via helper model
+     */
+    async requestContext(query, options, contextOptions) {
+        const startTime = Date.now();
+        const result = await this.contextTool.execute({
+            query,
+            detailLevel: contextOptions?.detailLevel,
+            maxTokens: contextOptions?.maxTokens,
+            useHelperModel: contextOptions?.useHelperModel
+        }, options.sessionId, options.recentMessages);
+        const processingTime = Date.now() - startTime;
+        return {
+            type: 'context',
+            content: result,
+            metadata: {
+                sourceCount: result.sources.length,
+                tokensUsed: result.tokensUsed,
+                modelUsed: result.modelUsed,
+                processingTime
+            }
+        };
+    }
+    /**
+     * Smart retrieval - automatically choose best tool based on query
+     */
+    async smartRetrieval(query, options) {
+        const queryLower = query.toLowerCase();
+        // Determine best tool based on query patterns
+        if (queryLower.includes('boundary') || queryLower.includes('compaction') || queryLower.includes('summaries')) {
+            return this.listBoundaries(options);
+        }
+        if (queryLower.includes('turn') || queryLower.includes('checkpoint') || queryLower.includes('segment')) {
+            // Extract turn range if mentioned
+            const turnMatch = query.match(/turns?\s+(\d+)(?:\s*-\s*(\d+))?/i);
+            if (turnMatch && turnMatch[1]) {
+                const start = parseInt(turnMatch[1]);
+                const end = turnMatch[2] ? parseInt(turnMatch[2]) : start + 10;
+                return this.getSegment(options, {
+                    turnRange: { start, end },
+                    format: 'summary'
+                });
+            }
+        }
+        if (queryLower.includes('search') || queryLower.includes('find') || queryLower.includes('when')) {
+            return this.searchHistory(query, options);
+        }
+        // Default to requesting context via helper model
+        return this.requestContext(query, options);
+    }
+    /**
+     * Get comprehensive overview of conversation history
+     */
+    async getHistoryOverview(options) {
+        // Get boundaries
+        const boundaries = await this.boundariesTool.execute({ includeMetadata: false }, options.sessionId);
+        // Calculate statistics
+        const totalTokensSaved = boundaries.reduce((sum, b) => sum + b.tokens.saved, 0);
+        // Get message timestamps
+        const timestamps = options.recentMessages.map(m => new Date(m.timestamp));
+        const oldestMessage = timestamps.length > 0 ? new Date(Math.min(...timestamps.map(d => d.getTime()))) : null;
+        const newestMessage = timestamps.length > 0 ? new Date(Math.max(...timestamps.map(d => d.getTime()))) : null;
+        // Generate summary
+        const summary = `Conversation with ${options.recentMessages.length} messages` +
+            ` and ${boundaries.length} compaction boundaries. ` +
+            `${totalTokensSaved} tokens saved through compaction.`;
+        return {
+            totalMessages: options.recentMessages.length,
+            compactionBoundaries: boundaries.length,
+            totalTokensSaved,
+            oldestMessage,
+            newestMessage,
+            summary
+        };
+    }
+    /**
+     * Execute a tool by name (for dynamic tool calling)
+     */
+    async executeTool(toolName, input, options) {
+        switch (toolName) {
+            case 'SearchConversationHistory':
+                return this.searchTool.execute(input, options.sessionId, options.recentMessages);
+            case 'GetConversationSegment':
+                return this.segmentTool.execute(input, options.sessionId, options.recentMessages);
+            case 'ListCompactionBoundaries':
+                return this.boundariesTool.execute(input, options.sessionId);
+            case 'RequestHistoricalContext':
+                return this.contextTool.execute(input, options.sessionId, options.recentMessages);
+            default:
+                throw new Error(`Unknown historical tool: ${toolName}`);
+        }
+    }
+    // ============================================
+    // PRIVATE HELPER METHODS
+    // ============================================
+    /**
+     * Extract time range from search results
+     */
+    extractTimeRange(results) {
+        if (results.length === 0) {
+            return undefined;
+        }
+        const timestamps = results.map(r => r.timestamp.getTime());
+        return {
+            start: new Date(Math.min(...timestamps)),
+            end: new Date(Math.max(...timestamps))
+        };
+    }
+}
+//# sourceMappingURL=HistoricalContextService.js.map

package/dist/tools/historical/HistoricalContextService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalContextService.js","sourceRoot":"","sources":["../../../src/tools/historical/HistoricalContextService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,6BAA6B,EAAqB,MAAM,gCAAgC,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAgD7E;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAC3B,UAAU,CAAgC;IAC1C,WAAW,CAA6B;IACxC,cAAc,CAA+B;IAC7C,WAAW,CAA+B;IAElD,YAAY,aAAsB;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,6BAA6B,CAAC,aAAa,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,0BAA0B,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,IAAI,4BAA4B,CAAC,aAAa,CAAC,CAAC;QACtE,IAAI,CAAC,WAAW,GAAG,IAAI,4BAA4B,CAAC,aAAa,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB;QACvB,OAAO;YACL,6BAA6B,CAAC,UAAU;YACxC,0BAA0B,CAAC,UAAU;YACrC,4BAA4B,CAAC,UAAU;YACvC,4BAA4B,CAAC,UAAU;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,OAAiC,EACjC,aAIC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC3C;YACE,KAAK;YACL,UAAU,EAAE,aAAa,EAAE,UAAU;YACrC,SAAS,EAAE,aAAa,EAAE,SAAS;YACnC,gBAAgB,EAAE,aAAa,EAAE,gBAAgB;SAClD,EACD,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE;gBACR,WAAW,EAAE,OAAO,CAAC,MAAM;gBAC3B,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;gBACzC,cAAc;aACf;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,OAAiC,EACjC,cAIC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAC5C,cAAc,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE;gBACR,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAC1C,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW;gBACxC,cAAc;aACf;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,OAAiC,EACjC,kBAA2B,IAAI;QAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAClD,EAAE,eAAe,EAAE,EACnB,OAAO,CAAC,SAAS,CAClB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CACxC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAChC,CAAC,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE;gBACR,WAAW,EAAE,UAAU,CAAC,MAAM;gBAC9B,UAAU,EAAE,gBAAgB;gBAC5B,cAAc;aACf;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,OAAiC,EACjC,cAIC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAC3C;YACE,KAAK;YACL,WAAW,EAAE,cAAc,EAAE,WAAW;YACxC,SAAS,EAAE,cAAc,EAAE,SAAS;YACpC,cAAc,EAAE,cAAc,EAAE,cAAc;SAC/C,EACD,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE;gBACR,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAClC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc;aACf;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,OAAiC;QAEjC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,8CAA8C;QAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7G,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACvG,kCAAkC;YAClC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClE,IAAI,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC/D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;oBAC9B,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;oBACzB,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChG,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,iDAAiD;QACjD,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAiC;QASjC,iBAAiB;QACjB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAClD,EAAE,eAAe,EAAE,KAAK,EAAE,EAC1B,OAAO,CAAC,SAAS,CAClB,CAAC;QAEF,uBAAuB;QACvB,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CACxC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAChC,CAAC,CACF,CAAC;QAEF,yBAAyB;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7G,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE7G,mBAAmB;QACnB,MAAM,OAAO,GAAG,qBAAqB,OAAO,CAAC,cAAc,CAAC,MAAM,WAAW;YAC3E,QAAQ,UAAU,CAAC,MAAM,0BAA0B;YACnD,GAAG,gBAAgB,mCAAmC,CAAC;QAEzD,OAAO;YACL,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM;YAC5C,oBAAoB,EAAE,UAAU,CAAC,MAAM;YACvC,gBAAgB;YAChB,aAAa;YACb,aAAa;YACb,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,KAAU,EACV,OAAiC;QAEjC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,2BAA2B;gBAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;YAEnF,KAAK,wBAAwB;gBAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;YAEpF,KAAK,0BAA0B;gBAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAE/D,KAAK,0BAA0B;gBAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;YAEpF;gBACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,yBAAyB;IACzB,+CAA+C;IAE/C;;OAEG;IACK,gBAAgB,CAAC,OAAuB;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;YACxC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/historical/ListCompactionBoundaries.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ListCompactionBoundaries Tool
+ *
+ * Lists all compaction boundaries (conversation summaries) with metadata.
+ * Provides an overview of the compaction history for the session.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4
+ */
+/**
+ * Input schema for ListCompactionBoundaries tool
+ */
+export interface ListCompactionBoundariesInput {
+    /** Include detailed metadata in response */
+    includeMetadata?: boolean;
+}
+/**
+ * Compaction boundary information
+ */
+export interface CompactionBoundary {
+    /** Unique identifier for the compaction */
+    id: string;
+    /** Timestamp when compaction occurred */
+    timestamp: Date;
+    /** Turn range that was compacted */
+    turnRange: {
+        start: number;
+        end: number;
+    };
+    /** Token counts */
+    tokens: {
+        /** Original token count before compaction */
+        original: number;
+        /** Compressed token count after compaction */
+        compressed: number;
+        /** Tokens saved by compaction */
+        saved: number;
+    };
+    /** Type of compaction */
+    type: 'auto' | 'manual' | 'helper-fallback';
+    /** Optional metadata if requested */
+    metadata?: {
+        /** Topics covered in this segment */
+        topics: string[];
+        /** Decisions made in this segment */
+        decisions: string[];
+        /** Tools used in this segment */
+        toolsUsed: string[];
+        /** Files modified in this segment */
+        filesModified: string[];
+        /** Models involved in this segment */
+        modelsInvolved: string[];
+        /** Helper model used for compaction */
+        helperModel: string;
+        /** Cost of compaction */
+        cost: number;
+        /** Brief summary */
+        summary: string;
+    };
+}
+/**
+ * Tool for listing compaction boundaries
+ */
+export declare class ListCompactionBoundariesTool {
+    private compactionManager;
+    constructor(workspaceRoot?: string);
+    /**
+     * Tool definition for registration
+     */
+    static get definition(): {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                includeMetadata: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+        };
+    };
+    /**
+     * Execute the boundary listing
+     */
+    execute(input: ListCompactionBoundariesInput, sessionId: string): Promise<CompactionBoundary[]>;
+    /**
+     * Get summary statistics about compactions
+     */
+    getSummaryStatistics(sessionId: string): Promise<{
+        totalCompactions: number;
+        totalTokensSaved: number;
+        totalCost: number;
+        averageCompressionRatio: number;
+        mostUsedHelperModel: string;
+        largestCompaction: {
+            id: string;
+            tokens: number;
+        };
+    }>;
+    /**
+     * Find compaction by turn number
+     */
+    findCompactionByTurn(sessionId: string, turnNumber: number): Promise<CompactionBoundary | null>;
+}
+//# sourceMappingURL=ListCompactionBoundaries.d.ts.map

package/dist/tools/historical/ListCompactionBoundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListCompactionBoundaries.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/ListCompactionBoundaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,SAAS,EAAE,IAAI,CAAC;IAEhB,oCAAoC;IACpC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,mBAAmB;IACnB,MAAM,EAAE;QACN,6CAA6C;QAC7C,QAAQ,EAAE,MAAM,CAAC;QAEjB,8CAA8C;QAC9C,UAAU,EAAE,MAAM,CAAC;QAEnB,iCAAiC;QACjC,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IAE5C,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QACT,qCAAqC;QACrC,MAAM,EAAE,MAAM,EAAE,CAAC;QAEjB,qCAAqC;QACrC,SAAS,EAAE,MAAM,EAAE,CAAC;QAEpB,iCAAiC;QACjC,SAAS,EAAE,MAAM,EAAE,CAAC;QAEpB,qCAAqC;QACrC,aAAa,EAAE,MAAM,EAAE,CAAC;QAExB,sCAAsC;QACtC,cAAc,EAAE,MAAM,EAAE,CAAC;QAEzB,uCAAuC;QACvC,WAAW,EAAE,MAAM,CAAC;QAEpB,yBAAyB;QACzB,IAAI,EAAE,MAAM,CAAC;QAEb,oBAAoB;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,iBAAiB,CAA0B;gBAEvC,aAAa,CAAC,EAAE,MAAM;IAIlC;;OAEG;IACH,MAAM,KAAK,UAAU;;;;;;;;;;;;;MAepB;IAED;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,6BAA6B,EACpC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA8ChC;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACrD,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,uBAAuB,EAAE,MAAM,CAAC;QAChC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,iBAAiB,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACnD,CAAC;IA+DF;;OAEG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAsCtC"}