@principal-ai/principal-view-core 0.5.6

package/dist/EventRecorderService.js

@@ -0,0 +1,463 @@
+/**
+ * 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.
+ */
+import { SessionManager } from './SessionManager';
+import { PathBasedEventProcessor } from './PathBasedEventProcessor';
+/**
+ * EventRecorderService - Main service for log ingestion and event recording
+ */
+export 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(config.sessionConfig);
+        this.eventProcessor = new 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 = [];
+    }
+}
+//# sourceMappingURL=EventRecorderService.js.map

package/dist/EventRecorderService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRecorderService.js","sourceRoot":"","sources":["../src/EventRecorderService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAgLpE;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAa/B,YAAY,MAAkC;QAPtC,mBAAc,GAAuB,IAAI,GAAG,EAAE,CAAC;QAC/C,mBAAc,GAA4B,IAAI,GAAG,EAAE,CAAC;QACpD,gBAAW,GAAuC,EAAE,CAAC;QACrD,eAAU,GAA0C,IAAI,CAAC;QACzD,gBAAW,GAAiC,IAAI,GAAG,EAAE,CAAC;QACtD,gBAAW,GAAY,KAAK,CAAC;QAGnC,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,QAAQ;YAC/C,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;YAC/C,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,GAAG;SAC/C,CAAC;QAEF,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC/D,IAAI,CAAC,cAAc,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAEtE,qDAAqD;QACrD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACjC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC9B,CAAC;QAED,kDAAkD;QAClD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,YAAY,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,cAAc,CAAC,OAAwB,EAAE,YAAoB;QAClE,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,CAAC;QAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAExD,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAEtD,KAAK,KAAK;gBACR,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAE/C,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAEpD,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAElC,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,eAAe,GAAU,OAAO,CAAC;gBACvC,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE,yBAA0B,eAAmC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,OAA4B,EAC5B,YAAoB;QAEpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;gBAChD,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC1B,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;gBACtB,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ;aACnC,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC;YAC1C,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAExB,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;oBAClC,SAAS,EAAE,OAAO,CAAC,EAAE;iBACtB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CACrB,sBAAsB,EACtB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,EAClE,OAAO,CAAC,SAAS,CAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,OAA0B,EAC1B,YAAoB;QAEpB,IAAI,CAAC;YACH,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE;gBACxD,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;gBAC9B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;aAC7B,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,UAAU,IAAI,UAAU,CAAC,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3E,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC;YACpC,CAAC;YAED,mDAAmD;YACnD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;oBAClC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;iBACrC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CACrB,oBAAoB,EACpB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,EAChE,OAAO,CAAC,SAAS,CAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,OAAmB,EAAE,YAAoB;QACzD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,CAAC,0CAA0C;QACzD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/D,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAC7D,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAA8B,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B;aACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAwB,EAAE,YAAoB;QACnE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAErE,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAC7D,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAA8B,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B;aACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,OAAoB;QACrC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,SAAkB;QACnE,OAAO;YACL,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE;gBACP,IAAI;gBACJ,OAAO;gBACP,SAAS;aACV;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,MAAwB;QACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEhC,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAChC,oCAAoC;YACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBAC3C,IAAI,CAAC;wBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAClB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;oBAChD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mCAAmC;YACnC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;gBACrC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;gBAEtB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBAC3C,IAAI,CAAC;wBACH,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACnB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;oBAChD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,qBAAqB;IAErB;;OAEG;IACI,UAAU,CAAC,GAAa;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAEnD,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAC7D,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAA8B,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,IAAgB;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAErD,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAC7D,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAA8B,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,OAA6B;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,SAAiB,EAAE,OAA2B;QAC9D,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,OAA2B;QACjD,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,aAAa;QAClB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,gCAAgC;IAEhC;;OAEG;IACI,kBAAkB,CAAC,YAAoB;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE;YACjC,EAAE,EAAE,YAAY;YAChB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;YAC1B,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,YAAoB;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEtD,6CAA6C;QAC7C,IAAI,UAAU,EAAE,eAAe,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,CAAC,cAAc,CAAC,YAAY,CAC9B,UAAU,CAAC,eAAe,EAC1B,gCAAgC,CACjC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,YAAoB;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACI,OAAO,CAAC,QAAuB;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,QAA4B;QAC9C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IAED,yBAAyB;IAEzB;;OAEG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,qBAAqB;IAErB;;OAEG;IACI,QAAQ;QAeb,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;QAEtD,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YACxC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACxC,QAAQ,EAAE;gBACR,KAAK,EAAE,YAAY,CAAC,aAAa;gBACjC,MAAM,EAAE,YAAY,CAAC,cAAc;gBACnC,WAAW,EAAE,YAAY,CAAC,WAAW;aACtC;YACD,SAAS,EAAE;gBACT,eAAe,EAAE,cAAc,CAAC,eAAe;gBAC/C,qBAAqB,EAAE,cAAc,CAAC,qBAAqB;gBAC3D,mBAAmB,EAAE,cAAc,CAAC,mBAAmB;aACxD;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/LibraryLoader.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Library Loader
+ *
+ * Loads component library files (.yaml, .yml, or .json) from the .vgc/ 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 .vgc/ folder
+     *
+     * Searches for library.yaml, library.yml, or library.json (in that order).
+     *
+     * @param baseDir - Base directory containing .vgc/ folder
+     * @returns Library load result
+     */
+    load(baseDir: string): LibraryLoadResult;
+    /**
+     * Load a library from a specific file path
+     *
+     * @param filePath - Full path to the library file
+     * @returns Library load result
+     */
+    loadFromPath(filePath: string): LibraryLoadResult;
+    /**
+     * Check if a library file exists in the .vgc/ folder
+     *
+     * @param baseDir - Base directory containing .vgc/ folder
+     * @returns True if a library file exists
+     */
+    hasLibrary(baseDir: string): 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
+     *
+     * @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

@@ -0,0 +1 @@
+{"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;AAa3E;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAEhD;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA4BxC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IA+BjD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAUpC;;;;;;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;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;CAqDjB"}