@nexus-cortex/core 4.26.0

package/dist/session/SessionTimeline.js

@@ -0,0 +1,396 @@
+/**
+ * Session Timeline System
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md Part 3
+ *
+ * Provides:
+ * - Timeline event tracking
+ * - Conversation management with branching
+ * - Checkpoint creation and resume
+ * - Model switch tracking
+ */
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Session Timeline - Main timeline management class
+ */
+export class SessionTimeline {
+    sessionId;
+    createdAt;
+    lastActiveAt;
+    // Timeline events (chronological)
+    events = [];
+    // Conversations
+    conversations = new Map();
+    // Markers (indexed for fast lookup)
+    checkpoints = new Map();
+    compactionPoints = new Map();
+    modelSwitches = [];
+    resumePoints = [];
+    // Current state
+    current;
+    constructor(sessionId, initialModelId) {
+        this.sessionId = sessionId;
+        this.createdAt = new Date().toISOString();
+        this.lastActiveAt = this.createdAt;
+        // Create initial conversation
+        const conversationId = uuidv4();
+        const conversation = {
+            id: conversationId,
+            startTime: this.createdAt,
+            lastActiveTime: this.createdAt,
+            turnCount: 0,
+            messageIds: [],
+            modelId: initialModelId,
+            tokenCount: 0,
+            isActive: true,
+        };
+        this.conversations.set(conversationId, conversation);
+        this.current = {
+            conversationId,
+            modelId: initialModelId,
+            turnNumber: 0,
+            tokenCount: 0,
+        };
+        // Record conversation start event
+        this.addEvent({
+            id: uuidv4(),
+            type: 'conversation_start',
+            timestamp: this.createdAt,
+            conversationId,
+            turnNumber: 0,
+            metadata: {
+                modelId: initialModelId,
+            },
+        });
+    }
+    /**
+     * Add a timeline event
+     */
+    addEvent(event) {
+        this.events.push(event);
+        this.lastActiveAt = event.timestamp;
+        // Update conversation
+        const conversation = this.conversations.get(event.conversationId);
+        if (conversation) {
+            conversation.lastActiveTime = event.timestamp;
+        }
+    }
+    /**
+     * Record a message in the timeline
+     */
+    recordMessage(messageId, role, conversationId) {
+        const convId = conversationId || this.current.conversationId;
+        const conversation = this.conversations.get(convId);
+        if (!conversation) {
+            throw new Error(`Conversation ${convId} not found`);
+        }
+        // Increment turn number for user messages
+        if (role === 'user') {
+            this.current.turnNumber++;
+            conversation.turnCount++;
+        }
+        conversation.messageIds.push(messageId);
+        const event = {
+            id: uuidv4(),
+            type: 'message',
+            timestamp: new Date().toISOString(),
+            conversationId: convId,
+            turnNumber: this.current.turnNumber,
+            messageId,
+            metadata: {
+                role,
+            },
+        };
+        this.addEvent(event);
+        return event;
+    }
+    /**
+     * Create a checkpoint
+     */
+    createCheckpoint(description, messageIds) {
+        const conversation = this.conversations.get(this.current.conversationId);
+        if (!conversation) {
+            throw new Error(`Current conversation ${this.current.conversationId} not found`);
+        }
+        const checkpointId = uuidv4();
+        const checkpoint = {
+            id: checkpointId,
+            conversationId: this.current.conversationId,
+            turnNumber: this.current.turnNumber,
+            timestamp: new Date().toISOString(),
+            description,
+            snapshot: {
+                messageIds: messageIds || [...conversation.messageIds],
+                tokenCount: this.current.tokenCount,
+                modelId: this.current.modelId,
+                contextMetadata: {
+                    totalTokens: this.current.tokenCount,
+                    criticalTokens: 0, // TODO: Calculate
+                    compactableTokens: 0, // TODO: Calculate
+                },
+            },
+            resumable: true,
+            resumeCount: 0,
+        };
+        this.checkpoints.set(checkpointId, checkpoint);
+        // Record checkpoint event
+        this.addEvent({
+            id: uuidv4(),
+            type: 'checkpoint',
+            timestamp: checkpoint.timestamp,
+            conversationId: this.current.conversationId,
+            turnNumber: this.current.turnNumber,
+            metadata: {
+                checkpointId,
+                description,
+                messageCount: checkpoint.snapshot.messageIds.length,
+                tokenCount: checkpoint.snapshot.tokenCount,
+                modelId: checkpoint.snapshot.modelId,
+            },
+        });
+        return checkpoint;
+    }
+    /**
+     * Resume from a checkpoint
+     */
+    resumeFromCheckpoint(checkpointId, newModelId) {
+        const checkpoint = this.checkpoints.get(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${checkpointId} not found`);
+        }
+        if (!checkpoint.resumable) {
+            throw new Error(`Checkpoint ${checkpointId} is not resumable`);
+        }
+        // Create new conversation as a branch
+        const newConversationId = uuidv4();
+        const modelId = newModelId || checkpoint.snapshot.modelId;
+        const conversation = {
+            id: newConversationId,
+            startTime: new Date().toISOString(),
+            lastActiveTime: new Date().toISOString(),
+            turnCount: checkpoint.turnNumber,
+            messageIds: [...checkpoint.snapshot.messageIds],
+            parentConversationId: checkpoint.conversationId,
+            branchPoint: checkpoint.turnNumber,
+            modelId,
+            tokenCount: checkpoint.snapshot.tokenCount,
+            isActive: true,
+        };
+        // Deactivate current conversation
+        const currentConv = this.conversations.get(this.current.conversationId);
+        if (currentConv) {
+            currentConv.isActive = false;
+        }
+        this.conversations.set(newConversationId, conversation);
+        // Update current state
+        this.current = {
+            conversationId: newConversationId,
+            modelId,
+            turnNumber: checkpoint.turnNumber,
+            tokenCount: checkpoint.snapshot.tokenCount,
+        };
+        // Increment resume count
+        checkpoint.resumeCount++;
+        // Record resume event
+        this.addEvent({
+            id: uuidv4(),
+            type: 'resume',
+            timestamp: conversation.startTime,
+            conversationId: newConversationId,
+            turnNumber: checkpoint.turnNumber,
+            metadata: {
+                checkpointId,
+                resumedModel: modelId,
+                originalModel: checkpoint.snapshot.modelId,
+            },
+        });
+        return { conversation, checkpoint };
+    }
+    /**
+     * Record a model switch
+     */
+    recordModelSwitch(fromModel, toModel, reason) {
+        const modelSwitch = {
+            id: uuidv4(),
+            conversationId: this.current.conversationId,
+            timestamp: new Date().toISOString(),
+            turnNumber: this.current.turnNumber,
+            fromModel,
+            toModel,
+            reason,
+        };
+        this.modelSwitches.push(modelSwitch);
+        this.current.modelId = toModel;
+        // Update conversation model
+        const conversation = this.conversations.get(this.current.conversationId);
+        if (conversation) {
+            conversation.modelId = toModel;
+        }
+        // Record model switch event
+        this.addEvent({
+            id: uuidv4(),
+            type: 'model_switch',
+            timestamp: modelSwitch.timestamp,
+            conversationId: this.current.conversationId,
+            turnNumber: this.current.turnNumber,
+            metadata: {
+                fromModel,
+                toModel,
+                reason,
+            },
+        });
+        return modelSwitch;
+    }
+    /**
+     * Record a compaction
+     */
+    recordCompaction(compactionId, startTurn, endTurn, messageCount, originalTokens, compressedTokens, trigger, helperModel) {
+        const compactionPoint = {
+            id: compactionId,
+            conversationId: this.current.conversationId,
+            timestamp: new Date().toISOString(),
+            range: {
+                startTurn,
+                endTurn,
+                messageCount,
+            },
+            tokens: {
+                original: originalTokens,
+                compressed: compressedTokens,
+                savings: originalTokens - compressedTokens,
+            },
+            trigger,
+        };
+        this.compactionPoints.set(compactionId, compactionPoint);
+        // Record compaction event
+        this.addEvent({
+            id: uuidv4(),
+            type: 'compaction',
+            timestamp: compactionPoint.timestamp,
+            conversationId: this.current.conversationId,
+            turnNumber: this.current.turnNumber,
+            metadata: {
+                compactionId,
+                trigger,
+                originalTokens,
+                compressedTokens,
+                tokensSaved: compactionPoint.tokens.savings,
+                mainModel: this.current.modelId,
+                helperModel,
+            },
+        });
+        return compactionPoint;
+    }
+    /**
+     * Update token count
+     */
+    updateTokenCount(tokenCount) {
+        this.current.tokenCount = tokenCount;
+        const conversation = this.conversations.get(this.current.conversationId);
+        if (conversation) {
+            conversation.tokenCount = tokenCount;
+        }
+    }
+    /**
+     * Get all events
+     */
+    getEvents() {
+        return [...this.events];
+    }
+    /**
+     * Get events by type
+     */
+    getEventsByType(type) {
+        return this.events.filter(e => e.type === type);
+    }
+    /**
+     * Get current conversation
+     */
+    getCurrentConversation() {
+        return this.conversations.get(this.current.conversationId);
+    }
+    /**
+     * Get conversation by ID
+     */
+    getConversation(conversationId) {
+        return this.conversations.get(conversationId);
+    }
+    /**
+     * Get all conversations
+     */
+    getAllConversations() {
+        return Array.from(this.conversations.values());
+    }
+    /**
+     * Get checkpoint by ID
+     */
+    getCheckpoint(checkpointId) {
+        return this.checkpoints.get(checkpointId);
+    }
+    /**
+     * Get all checkpoints
+     */
+    getAllCheckpoints() {
+        return Array.from(this.checkpoints.values());
+    }
+    /**
+     * Get compaction point by ID
+     */
+    getCompactionPoint(compactionId) {
+        return this.compactionPoints.get(compactionId);
+    }
+    /**
+     * Get all compaction points
+     */
+    getAllCompactionPoints() {
+        return Array.from(this.compactionPoints.values());
+    }
+    /**
+     * Get all model switches
+     */
+    getModelSwitches() {
+        return [...this.modelSwitches];
+    }
+    /**
+     * Get all resume points
+     */
+    getResumePoints() {
+        return [...this.resumePoints];
+    }
+    /**
+     * Serialize to JSON for storage
+     */
+    toJSON() {
+        return {
+            sessionId: this.sessionId,
+            createdAt: this.createdAt,
+            lastActiveAt: this.lastActiveAt,
+            events: this.events,
+            conversations: Array.from(this.conversations.entries()),
+            checkpoints: Array.from(this.checkpoints.entries()),
+            compactionPoints: Array.from(this.compactionPoints.entries()),
+            modelSwitches: this.modelSwitches,
+            resumePoints: this.resumePoints,
+            current: this.current,
+        };
+    }
+    /**
+     * Deserialize from JSON
+     */
+    static fromJSON(data) {
+        const timeline = Object.create(SessionTimeline.prototype);
+        Object.assign(timeline, {
+            sessionId: data.sessionId,
+            createdAt: data.createdAt,
+            lastActiveAt: data.lastActiveAt,
+            events: data.events || [],
+            conversations: new Map(data.conversations || []),
+            checkpoints: new Map(data.checkpoints || []),
+            compactionPoints: new Map(data.compactionPoints || []),
+            modelSwitches: data.modelSwitches || [],
+            resumePoints: data.resumePoints || [],
+            current: data.current,
+        });
+        return timeline;
+    }
+}
+//# sourceMappingURL=SessionTimeline.js.map

package/dist/session/SessionTimeline.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Session management and message types
+ * JSONL-based session storage following Claude CLI format
+ */
+export * from './MessageTypes.js';
+export * from './JSONLHistoryStore.js';
+export * from './SessionTimeline.js';
+export * from './CheckpointManager.js';
+export * from './CacheMetricsAccumulator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,10 @@
+/**
+ * Session management and message types
+ * JSONL-based session storage following Claude CLI format
+ */
+export * from './MessageTypes.js';
+export * from './JSONLHistoryStore.js';
+export * from './SessionTimeline.js';
+export * from './CheckpointManager.js';
+export * from './CacheMetricsAccumulator.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/system-messages/MessageValidator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Message Validator
+ *
+ * Validates system message files before loading/hot-reloading.
+ * Ensures messages are safe and well-formed.
+ */
+import type { ValidationResult } from './types.js';
+/**
+ * Validation configuration
+ */
+export interface ValidatorConfig {
+    /** Maximum file size in bytes (default: 1MB) */
+    maxFileSize?: number;
+    /** Maximum line length (default: 10000) */
+    maxLineLength?: number;
+    /** Enable strict mode (more checks) */
+    strict?: boolean;
+    /** Enable security checks */
+    enableSecurityChecks?: boolean;
+}
+/**
+ * Message Validator
+ *
+ * Validates message files for:
+ * - File size limits
+ * - Valid UTF-8 encoding
+ * - No dangerous injection patterns
+ * - Optional frontmatter parsing
+ * - Markdown syntax validation
+ */
+export declare class MessageValidator {
+    private config;
+    constructor(config?: ValidatorConfig);
+    /**
+     * Validate a message file
+     */
+    validate(filePath: string): Promise<ValidationResult>;
+    /**
+     * Validate content string (without file I/O)
+     */
+    validateContent(content: string): ValidationResult;
+    /**
+     * Check if string is valid UTF-8
+     */
+    private isValidUTF8;
+    /**
+     * Find control characters (except \n, \r, \t)
+     */
+    private findControlCharacters;
+    /**
+     * Parse frontmatter (YAML between --- markers)
+     */
+    private parseFrontmatter;
+    /**
+     * Find potential security issues
+     */
+    private findSecurityIssues;
+    /**
+     * Find lines exceeding max length
+     */
+    private findLongLines;
+    /**
+     * Calculate content statistics
+     */
+    private calculateStats;
+    /**
+     * Format byte size for display
+     */
+    private formatSize;
+}
+//# sourceMappingURL=MessageValidator.d.ts.map

package/dist/system-messages/MessageValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageValidator.d.ts","sourceRoot":"","sources":["../../src/system-messages/MessageValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,GAAE,eAAoB;IASxC;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsH3D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA8ClD;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,UAAU;CAKnB"}