@nexus-cortex/core 4.26.0

package/dist/tools/historical/ListCompactionBoundaries.js

@@ -0,0 +1,175 @@
+/**
+ * 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
+ */
+import { StoredCompactionManager } from '../../conversation/StoredCompactionManager.js';
+/**
+ * Tool for listing compaction boundaries
+ */
+export class ListCompactionBoundariesTool {
+    compactionManager;
+    constructor(workspaceRoot) {
+        this.compactionManager = new StoredCompactionManager(workspaceRoot);
+    }
+    /**
+     * Tool definition for registration
+     */
+    static get definition() {
+        return {
+            name: 'ListCompactionBoundaries',
+            description: 'List all compaction boundaries (conversation summaries) with IDs',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    includeMetadata: {
+                        type: 'boolean',
+                        description: 'Include detailed metadata in response',
+                        default: true
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Execute the boundary listing
+     */
+    async execute(input, sessionId) {
+        const includeMetadata = input.includeMetadata !== false;
+        // Query all active compactions for this session
+        const compactions = await this.compactionManager.queryCompactions({
+            sessionId,
+            status: 'active'
+        });
+        // Transform to boundary format
+        const boundaries = compactions.map(compaction => {
+            const boundary = {
+                id: compaction.id,
+                timestamp: new Date(compaction.timestamp),
+                turnRange: compaction.timeline.turnRange,
+                tokens: {
+                    original: compaction.compaction.originalTokens,
+                    compressed: compaction.compaction.compressedTokens,
+                    saved: compaction.compaction.originalTokens - compaction.compaction.compressedTokens
+                },
+                type: compaction.type
+            };
+            // Add metadata if requested
+            if (includeMetadata) {
+                boundary.metadata = {
+                    topics: compaction.summaries.metadata.topics,
+                    decisions: compaction.summaries.metadata.decisions,
+                    toolsUsed: compaction.summaries.metadata.toolsUsed,
+                    filesModified: compaction.summaries.metadata.filesModified,
+                    modelsInvolved: compaction.summaries.metadata.modelsInvolved,
+                    helperModel: compaction.processing.helperModelId,
+                    cost: compaction.processing.cost,
+                    summary: compaction.summaries.compressed
+                };
+            }
+            return boundary;
+        });
+        // Sort by turn range start (chronological order)
+        boundaries.sort((a, b) => a.turnRange.start - b.turnRange.start);
+        return boundaries;
+    }
+    /**
+     * Get summary statistics about compactions
+     */
+    async getSummaryStatistics(sessionId) {
+        const compactions = await this.compactionManager.queryCompactions({
+            sessionId,
+            status: 'active'
+        });
+        if (compactions.length === 0) {
+            return {
+                totalCompactions: 0,
+                totalTokensSaved: 0,
+                totalCost: 0,
+                averageCompressionRatio: 0,
+                mostUsedHelperModel: 'none',
+                largestCompaction: { id: '', tokens: 0 }
+            };
+        }
+        // Calculate statistics
+        let totalTokensSaved = 0;
+        let totalCost = 0;
+        let totalCompressionRatio = 0;
+        const helperModelCounts = new Map();
+        let largestCompaction = { id: '', tokens: 0 };
+        for (const compaction of compactions) {
+            const saved = compaction.compaction.originalTokens - compaction.compaction.compressedTokens;
+            totalTokensSaved += saved;
+            totalCost += compaction.processing.cost;
+            totalCompressionRatio += compaction.compaction.compressionRatio;
+            // Track helper model usage
+            const model = compaction.processing.helperModelId;
+            helperModelCounts.set(model, (helperModelCounts.get(model) || 0) + 1);
+            // Track largest compaction
+            if (compaction.compaction.originalTokens > largestCompaction.tokens) {
+                largestCompaction = {
+                    id: compaction.id,
+                    tokens: compaction.compaction.originalTokens
+                };
+            }
+        }
+        // Find most used helper model
+        let mostUsedHelperModel = 'none';
+        let maxCount = 0;
+        for (const [model, count] of helperModelCounts) {
+            if (count > maxCount) {
+                maxCount = count;
+                mostUsedHelperModel = model;
+            }
+        }
+        return {
+            totalCompactions: compactions.length,
+            totalTokensSaved,
+            totalCost,
+            averageCompressionRatio: totalCompressionRatio / compactions.length,
+            mostUsedHelperModel,
+            largestCompaction
+        };
+    }
+    /**
+     * Find compaction by turn number
+     */
+    async findCompactionByTurn(sessionId, turnNumber) {
+        const compactions = await this.compactionManager.queryCompactions({
+            sessionId,
+            status: 'active'
+        });
+        // Find compaction that contains this turn
+        const compaction = compactions.find(c => turnNumber >= c.timeline.turnRange.start &&
+            turnNumber <= c.timeline.turnRange.end);
+        if (!compaction) {
+            return null;
+        }
+        return {
+            id: compaction.id,
+            timestamp: new Date(compaction.timestamp),
+            turnRange: compaction.timeline.turnRange,
+            tokens: {
+                original: compaction.compaction.originalTokens,
+                compressed: compaction.compaction.compressedTokens,
+                saved: compaction.compaction.originalTokens - compaction.compaction.compressedTokens
+            },
+            type: compaction.type,
+            metadata: {
+                topics: compaction.summaries.metadata.topics,
+                decisions: compaction.summaries.metadata.decisions,
+                toolsUsed: compaction.summaries.metadata.toolsUsed,
+                filesModified: compaction.summaries.metadata.filesModified,
+                modelsInvolved: compaction.summaries.metadata.modelsInvolved,
+                helperModel: compaction.processing.helperModelId,
+                cost: compaction.processing.cost,
+                summary: compaction.summaries.compressed
+            }
+        };
+    }
+}
+//# sourceMappingURL=ListCompactionBoundaries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ListCompactionBoundaries.js","sourceRoot":"","sources":["../../../src/tools/historical/ListCompactionBoundaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAqExF;;GAEG;AACH,MAAM,OAAO,4BAA4B;IAC/B,iBAAiB,CAA0B;IAEnD,YAAY,aAAsB;QAChC,IAAI,CAAC,iBAAiB,GAAG,IAAI,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,UAAU;QACnB,OAAO;YACL,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,kEAAkE;YAC/E,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,eAAe,EAAE;wBACf,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,uCAAuC;wBACpD,OAAO,EAAE,IAAI;qBACd;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAoC,EACpC,SAAiB;QAEjB,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC;QAExD,gDAAgD;QAChD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;YAChE,SAAS;YACT,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,UAAU,GAAyB,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;YACpE,MAAM,QAAQ,GAAuB;gBACnC,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBACzC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS;gBACxC,MAAM,EAAE;oBACN,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc;oBAC9C,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,gBAAgB;oBAClD,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,gBAAgB;iBACrF;gBACD,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB,CAAC;YAEF,4BAA4B;YAC5B,IAAI,eAAe,EAAE,CAAC;gBACpB,QAAQ,CAAC,QAAQ,GAAG;oBAClB,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM;oBAC5C,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS;oBAClD,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS;oBAClD,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa;oBAC1D,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,cAAc;oBAC5D,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,aAAa;oBAChD,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI;oBAChC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU;iBACzC,CAAC;YACJ,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,iDAAiD;QACjD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEjE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAQ1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;YAChE,SAAS;YACT,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,gBAAgB,EAAE,CAAC;gBACnB,gBAAgB,EAAE,CAAC;gBACnB,SAAS,EAAE,CAAC;gBACZ,uBAAuB,EAAE,CAAC;gBAC1B,mBAAmB,EAAE,MAAM;gBAC3B,iBAAiB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;aACzC,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAC9B,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACpD,IAAI,iBAAiB,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAE9C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAC5F,gBAAgB,IAAI,KAAK,CAAC;YAC1B,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YACxC,qBAAqB,IAAI,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAEhE,2BAA2B;YAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC;YAClD,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAEtE,2BAA2B;YAC3B,IAAI,UAAU,CAAC,UAAU,CAAC,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC;gBACpE,iBAAiB,GAAG;oBAClB,EAAE,EAAE,UAAU,CAAC,EAAE;oBACjB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc;iBAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,IAAI,mBAAmB,GAAG,MAAM,CAAC;QACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAC/C,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACrB,QAAQ,GAAG,KAAK,CAAC;gBACjB,mBAAmB,GAAG,KAAK,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO;YACL,gBAAgB,EAAE,WAAW,CAAC,MAAM;YACpC,gBAAgB;YAChB,SAAS;YACT,uBAAuB,EAAE,qBAAqB,GAAG,WAAW,CAAC,MAAM;YACnE,mBAAmB;YACnB,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,UAAkB;QAElB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;YAChE,SAAS;YACT,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,0CAA0C;QAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACtC,UAAU,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK;YACxC,UAAU,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CACvC,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YACzC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS;YACxC,MAAM,EAAE;gBACN,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc;gBAC9C,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,gBAAgB;gBAClD,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,gBAAgB;aACrF;YACD,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE;gBACR,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM;gBAC5C,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS;gBAClD,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS;gBAClD,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa;gBAC1D,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,cAAc;gBAC5D,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,aAAa;gBAChD,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI;gBAChC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU;aACzC;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,50 @@
+/**
+ * ListSessions Tool
+ *
+ * Lists all available sessions with metadata for discovery and navigation.
+ * Allows filtering and sorting to find specific sessions.
+ */
+import type { ListSessionsInput, SessionSummary } from '@nexus-cortex/types';
+/**
+ * Tool for listing available sessions
+ */
+export declare class ListSessionsTool {
+    private historyStore;
+    constructor(storageDir: string);
+    /**
+     * Tool definition for registration
+     */
+    static get definition(): {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                minAgeDays: {
+                    type: string;
+                    description: string;
+                };
+                maxAgeDays: {
+                    type: string;
+                    description: string;
+                };
+                sortBy: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+            };
+        };
+    };
+    /**
+     * Execute the session listing
+     */
+    execute(input: ListSessionsInput): Promise<SessionSummary[]>;
+}
+//# sourceMappingURL=ListSessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ListSessions.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/ListSessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG7E;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAoB;gBAE5B,UAAU,EAAE,MAAM;IAM9B;;OAEG;IACH,MAAM,KAAK,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6BpB;IAED;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CA6CnE"}

package/dist/tools/historical/ListSessions.js

@@ -0,0 +1,93 @@
+/**
+ * ListSessions Tool
+ *
+ * Lists all available sessions with metadata for discovery and navigation.
+ * Allows filtering and sorting to find specific sessions.
+ */
+import { JSONLHistoryStore } from '../../session/JSONLHistoryStore.js';
+/**
+ * Tool for listing available sessions
+ */
+export class ListSessionsTool {
+    historyStore;
+    constructor(storageDir) {
+        this.historyStore = new JSONLHistoryStore({
+            baseDir: storageDir
+        });
+    }
+    /**
+     * Tool definition for registration
+     */
+    static get definition() {
+        return {
+            name: 'ListSessions',
+            description: 'List all available conversation sessions with metadata for discovery',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of sessions to return',
+                        default: 50
+                    },
+                    minAgeDays: {
+                        type: 'number',
+                        description: 'Filter sessions older than N days'
+                    },
+                    maxAgeDays: {
+                        type: 'number',
+                        description: 'Filter sessions newer than N days'
+                    },
+                    sortBy: {
+                        type: 'string',
+                        enum: ['newest', 'oldest'],
+                        description: 'Sort order',
+                        default: 'newest'
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Execute the session listing
+     */
+    async execute(input) {
+        // Get all sessions from storage
+        const sessionInfos = await this.historyStore.listSessions();
+        // Calculate age for each session
+        const now = new Date();
+        const sessionsWithAge = sessionInfos.map(info => {
+            const ageMs = now.getTime() - info.lastModified.getTime();
+            const ageDays = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+            return {
+                sessionId: info.sessionId,
+                createdAt: info.metadata.startTime,
+                lastModified: info.lastModified.toISOString(),
+                messageCount: info.messageCount,
+                fileSize: info.fileSize,
+                compactionCount: info.metadata.compactionCount,
+                ageDays,
+                title: info.metadata.title,
+            };
+        });
+        // Apply filters
+        let filteredSessions = sessionsWithAge;
+        if (input.minAgeDays !== undefined) {
+            filteredSessions = filteredSessions.filter(s => s.ageDays >= input.minAgeDays);
+        }
+        if (input.maxAgeDays !== undefined) {
+            filteredSessions = filteredSessions.filter(s => s.ageDays <= input.maxAgeDays);
+        }
+        // Apply sorting
+        const sortBy = input.sortBy || 'newest';
+        filteredSessions.sort((a, b) => {
+            const dateA = new Date(a.lastModified).getTime();
+            const dateB = new Date(b.lastModified).getTime();
+            return sortBy === 'newest' ? dateB - dateA : dateA - dateB;
+        });
+        // Apply limit
+        const limit = input.limit || 50;
+        return filteredSessions.slice(0, limit);
+    }
+}
+//# sourceMappingURL=ListSessions.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * LoadSession Tool
+ *
+ * Loads messages from a specific session to bring past conversation context
+ * into the current conversation.
+ */
+import type { LoadSessionInput, SessionLoadResult } from '@nexus-cortex/types';
+/**
+ * Tool for loading session messages
+ */
+export declare class LoadSessionTool {
+    private historyStore;
+    constructor(storageDir: string);
+    /**
+     * Tool definition for registration
+     */
+    static get definition(): {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                sessionId: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                offset: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                includeSystemMessages: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+            required: string[];
+        };
+    };
+    /**
+     * Execute the session load
+     */
+    execute(input: LoadSessionInput): Promise<SessionLoadResult>;
+}
+//# sourceMappingURL=LoadSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadSession.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/LoadSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI/E;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAoB;gBAE5B,UAAU,EAAE,MAAM;IAM9B;;OAEG;IACH,MAAM,KAAK,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA8BpB;IAED;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuCnE"}

package/dist/tools/historical/LoadSession.js

@@ -0,0 +1,89 @@
+/**
+ * LoadSession Tool
+ *
+ * Loads messages from a specific session to bring past conversation context
+ * into the current conversation.
+ */
+import { JSONLHistoryStore } from '../../session/JSONLHistoryStore.js';
+import { isSystemMessage } from '../../session/MessageTypes.js';
+/**
+ * Tool for loading session messages
+ */
+export class LoadSessionTool {
+    historyStore;
+    constructor(storageDir) {
+        this.historyStore = new JSONLHistoryStore({
+            baseDir: storageDir
+        });
+    }
+    /**
+     * Tool definition for registration
+     */
+    static get definition() {
+        return {
+            name: 'LoadSession',
+            description: 'Load messages from a specific previous session to access full conversation context',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    sessionId: {
+                        type: 'string',
+                        description: 'Session ID to load (from ListSessions or SearchConversationHistory results)'
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of messages to return',
+                        default: 100
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Start from message offset (for pagination)',
+                        default: 0
+                    },
+                    includeSystemMessages: {
+                        type: 'boolean',
+                        description: 'Include system messages in results',
+                        default: false
+                    }
+                },
+                required: ['sessionId']
+            }
+        };
+    }
+    /**
+     * Execute the session load
+     */
+    async execute(input) {
+        // Get session info for metadata
+        const sessionInfo = await this.historyStore.getSessionInfo(input.sessionId);
+        if (!sessionInfo) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        // Load all messages from session
+        const allMessages = await this.historyStore.loadSession(input.sessionId);
+        // Filter messages
+        let filteredMessages = allMessages;
+        // Optionally exclude system messages
+        if (!input.includeSystemMessages) {
+            filteredMessages = filteredMessages.filter(msg => !isSystemMessage(msg));
+        }
+        const totalCount = filteredMessages.length;
+        // Apply pagination
+        const offset = input.offset || 0;
+        const limit = input.limit || 100;
+        const paginatedMessages = filteredMessages.slice(offset, offset + limit);
+        return {
+            sessionId: input.sessionId,
+            messages: paginatedMessages,
+            totalMessageCount: totalCount,
+            returnedMessageCount: paginatedMessages.length,
+            hasMore: (offset + paginatedMessages.length) < totalCount,
+            metadata: {
+                createdAt: sessionInfo.metadata.startTime,
+                lastModified: sessionInfo.lastModified.toISOString(),
+                compactionCount: sessionInfo.metadata.compactionCount
+            }
+        };
+    }
+}
+//# sourceMappingURL=LoadSession.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadSession.js","sourceRoot":"","sources":["../../../src/tools/historical/LoadSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,YAAY,CAAoB;IAExC,YAAY,UAAkB;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,iBAAiB,CAAC;YACxC,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,UAAU;QACnB,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oFAAoF;YACjG,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6EAA6E;qBAC3F;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sCAAsC;wBACnD,OAAO,EAAE,GAAG;qBACb;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4CAA4C;wBACzD,OAAO,EAAE,CAAC;qBACX;oBACD,qBAAqB,EAAE;wBACrB,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,oCAAoC;wBACjD,OAAO,EAAE,KAAK;qBACf;iBACF;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;aACxB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,gCAAgC;QAChC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE5E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,iCAAiC;QACjC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEzE,kBAAkB;QAClB,IAAI,gBAAgB,GAAG,WAAW,CAAC;QAEnC,qCAAqC;QACrC,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;YACjC,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAE3C,mBAAmB;QACnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;QACjC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;QAEzE,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,iBAAiB;YAC3B,iBAAiB,EAAE,UAAU;YAC7B,oBAAoB,EAAE,iBAAiB,CAAC,MAAM;YAC9C,OAAO,EAAE,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,UAAU;YACzD,QAAQ,EAAE;gBACR,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,SAAS;gBACzC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE;gBACpD,eAAe,EAAE,WAAW,CAAC,QAAQ,CAAC,eAAe;aACtD;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,122 @@
+/**
+ * RequestHistoricalContext Tool
+ *
+ * Requests historical context using a cheap helper model (e.g., FREE Gemma).
+ * Cost-effective way to access archived context outside the main model's window.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4
+ */
+import type { Message } from '../../session/MessageTypes.js';
+import type { HelperMiddlewareAdapter } from '../../middleware/helpers/HelperMiddlewareAdapter.interface.js';
+import type { ModelConfig } from '../../models/ModelConfig.interface.js';
+/**
+ * Input schema for RequestHistoricalContext tool
+ */
+export interface RequestHistoricalContextInput {
+    /** Query describing what historical context is needed */
+    query: string;
+    /** Detail level for the response */
+    detailLevel?: 'brief' | 'standard' | 'detailed';
+    /** Maximum tokens for the response */
+    maxTokens?: number;
+    /** Whether to use helper model (vs main model) */
+    useHelperModel?: boolean;
+}
+/**
+ * Historical context result
+ */
+export interface HistoricalContextResult {
+    /** Generated context based on the query */
+    context: string;
+    /** Sources used to generate the context */
+    sources: Array<{
+        /** Turn number in conversation */
+        turnNumber: number;
+        /** Timestamp of the source */
+        timestamp: Date;
+        /** Whether source is from compacted section */
+        isCompacted: boolean;
+        /** Compaction ID if applicable */
+        compactionId?: string;
+    }>;
+    /** Estimated tokens used */
+    tokensUsed: number;
+    /** Model used to generate context */
+    modelUsed: string;
+    /** Processing cost (usually $0 for Gemma) */
+    cost: number;
+    /** Processing time in milliseconds */
+    processingTime: number;
+}
+/**
+ * Tool for requesting historical context via helper models
+ */
+export declare class RequestHistoricalContextTool {
+    private compactionManager;
+    private helperAdapter?;
+    private helperConfig?;
+    constructor(workspaceRoot?: string, helperAdapter?: HelperMiddlewareAdapter, helperConfig?: ModelConfig);
+    /**
+     * Tool definition for registration
+     */
+    static get definition(): {
+        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[];
+        };
+    };
+    /**
+     * Execute the historical context request
+     */
+    execute(input: RequestHistoricalContextInput, sessionId: string, recentMessages: Message[]): Promise<HistoricalContextResult>;
+    /**
+     * Gather relevant data for the query
+     */
+    private gatherRelevantData;
+    /**
+     * Generate context using configured helper model
+     */
+    private generateContextWithGemma;
+    /**
+     * Generate simple context without helper model
+     */
+    private generateSimpleContext;
+    /**
+     * Truncate content to specified length
+     */
+    private truncateContent;
+    /**
+     * Extract content from any message type
+     */
+    private extractMessageContent;
+    /**
+     * Get role from message
+     */
+    private getMessageRole;
+}
+//# sourceMappingURL=RequestHistoricalContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestHistoricalContext.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/RequestHistoricalContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAC;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAEhD,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,OAAO,EAAE,KAAK,CAAC;QACb,kCAAkC;QAClC,UAAU,EAAE,MAAM,CAAC;QAEnB,8BAA8B;QAC9B,SAAS,EAAE,IAAI,CAAC;QAEhB,+CAA+C;QAC/C,WAAW,EAAE,OAAO,CAAC;QAErB,kCAAkC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IAEH,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,aAAa,CAAC,CAA0B;IAChD,OAAO,CAAC,YAAY,CAAC,CAAc;gBAGjC,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,uBAAuB,EACvC,YAAY,CAAC,EAAE,WAAW;IAO5B;;OAEG;IACH,MAAM,KAAK,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BpB;IAED;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,6BAA6B,EACpC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,OAAO,EAAE,GACxB,OAAO,CAAC,uBAAuB,CAAC;IAqDnC;;OAEG;YACW,kBAAkB;IAqEhC;;OAEG;YACW,wBAAwB;IA4DtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAsCvB"}