@principal-ai/subsystems-core 0.29.0 → 0.31.0

package/dist/EventRecorderService.js

@@ -1,467 +0,0 @@
-"use strict";
-/**
- * EventRecorderService - Log ingestion and event recording service
- *
- * This service:
- * 1. Accepts logs via message protocol or direct API
- * 2. Processes logs through PathBasedEventProcessor
- * 3. Manages sessions through SessionManager
- * 4. Emits events to subscribers for visualization
- *
- * The service is transport-agnostic - it handles message parsing and responses
- * but does not implement any specific transport (WebSocket, IPC, etc.).
- * The host application is responsible for the actual transport layer.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventRecorderService = void 0;
-const SessionManager_1 = require("./SessionManager");
-const PathBasedEventProcessor_1 = require("./PathBasedEventProcessor");
-/**
- * EventRecorderService - Main service for log ingestion and event recording
- */
-class EventRecorderService {
-    constructor(config) {
-        this.eventListeners = new Set();
-        this.batchListeners = new Set();
-        this.eventBuffer = [];
-        this.batchTimer = null;
-        this.connections = new Map();
-        this.isRecording = false;
-        this.config = {
-            graphConfig: config.graphConfig,
-            recordingMode: config.recordingMode ?? 'manual',
-            emitImmediately: config.emitImmediately ?? true,
-            batchIntervalMs: config.batchIntervalMs ?? 100,
-        };
-        this.sessionManager = new SessionManager_1.SessionManager(config.sessionConfig);
-        this.eventProcessor = new PathBasedEventProcessor_1.PathBasedEventProcessor(config.graphConfig);
-        // Start batch processing if not emitting immediately
-        if (!this.config.emitImmediately) {
-            this.startBatchProcessing();
-        }
-        // In continuous mode, start recording immediately
-        if (this.config.recordingMode === 'continuous') {
-            this.isRecording = true;
-        }
-    }
-    /**
-     * Process an incoming protocol message
-     */
-    processMessage(message, connectionId) {
-        // Update connection activity
-        const connection = this.connections.get(connectionId);
-        if (connection) {
-            connection.lastActivityAt = Date.now();
-        }
-        switch (message.type) {
-            case 'session_start':
-                return this.handleSessionStart(message, connectionId);
-            case 'session_end':
-                return this.handleSessionEnd(message, connectionId);
-            case 'log':
-                return this.handleLog(message, connectionId);
-            case 'log_batch':
-                return this.handleLogBatch(message, connectionId);
-            case 'ping':
-                return this.handlePing(message);
-            default: {
-                const exhaustiveCheck = message;
-                return this.createError('UNKNOWN_MESSAGE_TYPE', `Unknown message type: ${exhaustiveCheck.type}`);
-            }
-        }
-    }
-    /**
-     * Handle session start message
-     */
-    handleSessionStart(message, connectionId) {
-        try {
-            const session = this.sessionManager.createSession({
-                name: message.payload.name,
-                id: message.payload.id,
-                metadata: message.payload.metadata,
-            });
-            // Associate session with connection
-            const connection = this.connections.get(connectionId);
-            if (connection) {
-                connection.activeSessionId = session.id;
-            }
-            this.isRecording = true;
-            return {
-                type: 'ack',
-                timestamp: Date.now(),
-                payload: {
-                    requestId: message.requestId || '',
-                    sessionId: session.id,
-                },
-            };
-        }
-        catch (error) {
-            return this.createError('SESSION_START_FAILED', error instanceof Error ? error.message : 'Failed to start session', message.requestId);
-        }
-    }
-    /**
-     * Handle session end message
-     */
-    handleSessionEnd(message, connectionId) {
-        try {
-            this.sessionManager.endSession(message.payload.sessionId, {
-                result: message.payload.result,
-                error: message.payload.error,
-            });
-            // Clear session from connection
-            const connection = this.connections.get(connectionId);
-            if (connection && connection.activeSessionId === message.payload.sessionId) {
-                connection.activeSessionId = null;
-            }
-            // In manual mode, stop recording when session ends
-            if (this.config.recordingMode === 'manual') {
-                this.isRecording = false;
-            }
-            return {
-                type: 'ack',
-                timestamp: Date.now(),
-                payload: {
-                    requestId: message.requestId || '',
-                    sessionId: message.payload.sessionId,
-                },
-            };
-        }
-        catch (error) {
-            return this.createError('SESSION_END_FAILED', error instanceof Error ? error.message : 'Failed to end session', message.requestId);
-        }
-    }
-    /**
-     * Handle single log message
-     */
-    handleLog(message, _connectionId) {
-        if (!this.isRecording) {
-            return null; // Silently ignore logs when not recording
-        }
-        const events = this.eventProcessor.processLog(message.payload);
-        // Add events to active session
-        const activeSession = this.sessionManager.getActiveSession();
-        if (activeSession) {
-            for (const event of events) {
-                this.sessionManager.addEvent(activeSession.id, event);
-            }
-        }
-        // Emit events
-        this.emitEvents(events);
-        if (message.requestId) {
-            return {
-                type: 'ack',
-                timestamp: Date.now(),
-                payload: {
-                    requestId: message.requestId,
-                },
-            };
-        }
-        return null;
-    }
-    /**
-     * Handle batch log message
-     */
-    handleLogBatch(message, _connectionId) {
-        if (!this.isRecording) {
-            return null;
-        }
-        const events = this.eventProcessor.processLogs(message.payload.logs);
-        // Add events to active session
-        const activeSession = this.sessionManager.getActiveSession();
-        if (activeSession) {
-            for (const event of events) {
-                this.sessionManager.addEvent(activeSession.id, event);
-            }
-        }
-        // Emit events
-        this.emitEvents(events);
-        if (message.requestId) {
-            return {
-                type: 'ack',
-                timestamp: Date.now(),
-                payload: {
-                    requestId: message.requestId,
-                },
-            };
-        }
-        return null;
-    }
-    /**
-     * Handle ping message
-     */
-    handlePing(_message) {
-        return {
-            type: 'pong',
-            timestamp: Date.now(),
-        };
-    }
-    /**
-     * Create an error response
-     */
-    createError(code, message, requestId) {
-        return {
-            type: 'error',
-            timestamp: Date.now(),
-            payload: {
-                code,
-                message,
-                requestId,
-            },
-        };
-    }
-    /**
-     * Emit events to listeners
-     */
-    emitEvents(events) {
-        if (events.length === 0)
-            return;
-        if (this.config.emitImmediately) {
-            // Emit immediately to all listeners
-            for (const event of events) {
-                for (const listener of this.eventListeners) {
-                    try {
-                        listener(event);
-                    }
-                    catch (error) {
-                        console.error('Event listener error:', error);
-                    }
-                }
-            }
-        }
-        else {
-            // Buffer events for batch emission
-            this.eventBuffer.push(...events);
-        }
-    }
-    /**
-     * Start batch processing timer
-     */
-    startBatchProcessing() {
-        this.batchTimer = setInterval(() => {
-            if (this.eventBuffer.length > 0) {
-                const events = [...this.eventBuffer];
-                this.eventBuffer = [];
-                for (const listener of this.batchListeners) {
-                    try {
-                        listener(events);
-                    }
-                    catch (error) {
-                        console.error('Batch listener error:', error);
-                    }
-                }
-            }
-        }, this.config.batchIntervalMs);
-    }
-    /**
-     * Stop batch processing timer
-     */
-    stopBatchProcessing() {
-        if (this.batchTimer) {
-            clearInterval(this.batchTimer);
-            this.batchTimer = null;
-        }
-    }
-    // === Direct API ===
-    /**
-     * Process a log entry directly (without protocol message wrapper)
-     */
-    processLog(log) {
-        if (!this.isRecording) {
-            return [];
-        }
-        const events = this.eventProcessor.processLog(log);
-        // Add events to active session
-        const activeSession = this.sessionManager.getActiveSession();
-        if (activeSession) {
-            for (const event of events) {
-                this.sessionManager.addEvent(activeSession.id, event);
-            }
-        }
-        // Emit events
-        this.emitEvents(events);
-        return events;
-    }
-    /**
-     * Process multiple log entries directly (without protocol message wrapper)
-     */
-    processLogs(logs) {
-        if (!this.isRecording) {
-            return [];
-        }
-        const events = this.eventProcessor.processLogs(logs);
-        // Add events to active session
-        const activeSession = this.sessionManager.getActiveSession();
-        if (activeSession) {
-            for (const event of events) {
-                this.sessionManager.addEvent(activeSession.id, event);
-            }
-        }
-        // Emit events
-        this.emitEvents(events);
-        return events;
-    }
-    /**
-     * Start a new session directly
-     */
-    startSession(options) {
-        const session = this.sessionManager.createSession(options);
-        this.isRecording = true;
-        return session;
-    }
-    /**
-     * End a session directly
-     */
-    endSession(sessionId, options) {
-        this.sessionManager.endSession(sessionId, options);
-        if (this.config.recordingMode === 'manual') {
-            this.isRecording = false;
-        }
-    }
-    /**
-     * End the active session
-     */
-    endActiveSession(options) {
-        this.sessionManager.endActiveSession(options);
-        if (this.config.recordingMode === 'manual') {
-            this.isRecording = false;
-        }
-    }
-    /**
-     * Start recording (for manual mode)
-     */
-    startRecording() {
-        this.isRecording = true;
-    }
-    /**
-     * Stop recording (for manual mode)
-     */
-    stopRecording() {
-        this.isRecording = false;
-    }
-    /**
-     * Check if currently recording
-     */
-    get recording() {
-        return this.isRecording;
-    }
-    // === Connection Management ===
-    /**
-     * Register a new connection
-     */
-    registerConnection(connectionId) {
-        this.connections.set(connectionId, {
-            id: connectionId,
-            connectedAt: Date.now(),
-            lastActivityAt: Date.now(),
-            activeSessionId: null,
-        });
-    }
-    /**
-     * Unregister a connection
-     */
-    unregisterConnection(connectionId) {
-        const connection = this.connections.get(connectionId);
-        // End any active session for this connection
-        if (connection?.activeSessionId) {
-            try {
-                this.sessionManager.errorSession(connection.activeSessionId, 'Connection closed unexpectedly');
-            }
-            catch {
-                // Session may have already ended
-            }
-        }
-        this.connections.delete(connectionId);
-    }
-    /**
-     * Get connection state
-     */
-    getConnection(connectionId) {
-        return this.connections.get(connectionId);
-    }
-    /**
-     * Get all active connections
-     */
-    getConnections() {
-        return Array.from(this.connections.values());
-    }
-    // === Event Subscription ===
-    /**
-     * Subscribe to individual events
-     */
-    onEvent(callback) {
-        this.eventListeners.add(callback);
-        return () => {
-            this.eventListeners.delete(callback);
-        };
-    }
-    /**
-     * Subscribe to event batches
-     */
-    onEventBatch(callback) {
-        this.batchListeners.add(callback);
-        return () => {
-            this.batchListeners.delete(callback);
-        };
-    }
-    // === Session Access ===
-    /**
-     * Get SessionManager for direct access
-     */
-    getSessionManager() {
-        return this.sessionManager;
-    }
-    /**
-     * Get active session
-     */
-    getActiveSession() {
-        return this.sessionManager.getActiveSession();
-    }
-    /**
-     * Get session by ID
-     */
-    getSession(id) {
-        return this.sessionManager.getSession(id);
-    }
-    /**
-     * List all sessions
-     */
-    listSessions() {
-        return this.sessionManager.listSessions();
-    }
-    // === Statistics ===
-    /**
-     * Get service statistics
-     */
-    getStats() {
-        const sessionStats = this.sessionManager.getStats();
-        const processorStats = this.eventProcessor.getStats();
-        return {
-            isRecording: this.isRecording,
-            recordingMode: this.config.recordingMode,
-            activeConnections: this.connections.size,
-            sessions: {
-                total: sessionStats.totalSessions,
-                active: sessionStats.activeSessions,
-                totalEvents: sessionStats.totalEvents,
-            },
-            processor: {
-                totalComponents: processorStats.totalComponents,
-                componentsWithSources: processorStats.componentsWithSources,
-                totalSourcePatterns: processorStats.totalSourcePatterns,
-            },
-        };
-    }
-    /**
-     * Dispose of the service
-     */
-    dispose() {
-        this.stopBatchProcessing();
-        this.sessionManager.dispose();
-        this.eventListeners.clear();
-        this.batchListeners.clear();
-        this.connections.clear();
-        this.eventBuffer = [];
-    }
-}
-exports.EventRecorderService = EventRecorderService;
-//# sourceMappingURL=EventRecorderService.js.map

package/dist/EventRecorderService.js.map

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

package/dist/LibraryLoader.d.ts

@@ -1,65 +0,0 @@
-/**
- * Library Loader
- *
- * Loads component library files (.yaml, .yml, or .json) from the .principal-views/ folder.
- * Component libraries contain reusable node and edge type definitions.
- */
-import type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
-import type { LibraryLoadResult } from './types/library';
-/**
- * Loader for component library files
- */
-export declare class LibraryLoader {
-    private fsAdapter;
-    constructor(fsAdapter: FileSystemAdapter);
-    /**
-     * Load the component library from the .principal-views/ folder
-     *
-     * Searches for library.yaml, library.yml, or library.json (in that order).
-     *
-     * @param baseDir - Base directory containing .principal-views/ folder
-     * @returns Library load result
-     */
-    load(baseDir: string): Promise<LibraryLoadResult>;
-    /**
-     * Load a library from a specific file path
-     *
-     * @param filePath - Full path to the library file
-     * @returns Library load result
-     */
-    loadFromPath(filePath: string): Promise<LibraryLoadResult>;
-    /**
-     * Check if a library file exists in the .principal-views/ folder
-     *
-     * @param baseDir - Base directory containing .principal-views/ folder
-     * @returns True if a library file exists
-     */
-    hasLibrary(baseDir: string): Promise<boolean>;
-    /**
-     * Get the path where the library file would be located
-     *
-     * @param baseDir - Base directory
-     * @param format - Preferred format ('yaml' or 'json')
-     * @returns Full path to the library file
-     */
-    getLibraryPath(baseDir: string, format?: 'yaml' | 'json'): string;
-    /**
-     * Parse YAML content into a library object
-     */
-    private parseYaml;
-    /**
-     * Parse JSON content into a library object
-     */
-    private parseJson;
-    /**
-     * Validate the library structure
-     *
-     * Uses the shared validateLibraryStructure function from validation module.
-     *
-     * @param library - Parsed library object
-     * @param filePath - File path for error messages
-     * @returns Error message if invalid, undefined if valid
-     */
-    private validate;
-}
-//# sourceMappingURL=LibraryLoader.d.ts.map

package/dist/LibraryLoader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LibraryLoader.d.ts","sourceRoot":"","sources":["../src/LibraryLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAc3E;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAEhD;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BvD;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiChE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBnD;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM;IAKzE;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;CAWjB"}