@principal-ai/subsystems-core 0.29.0

package/dist/EventProcessor.d.ts

@@ -0,0 +1,49 @@
+import type { GraphEvent, GraphConfiguration, GraphState, ValidationResult } from './types';
+export interface ProcessingResult {
+    success: boolean;
+    state: GraphState;
+    validation: ValidationResult;
+    error?: string;
+}
+/**
+ * EventProcessor handles the ingestion and processing of graph events
+ */
+export declare class EventProcessor {
+    private state;
+    private validationEngine;
+    private eventHistory;
+    constructor(configuration: GraphConfiguration, options?: {
+        validateConfig?: boolean;
+    });
+    /**
+     * Process a single graph event
+     */
+    processEvent(event: GraphEvent): ProcessingResult;
+    /**
+     * Validate an event against configuration rules
+     */
+    validateEvent(event: GraphEvent): ValidationResult;
+    /**
+     * Get the current graph state
+     */
+    getGraphState(): GraphState;
+    /**
+     * Get event history
+     */
+    getEventHistory(): GraphEvent[];
+    /**
+     * Reset processor state
+     */
+    reset(): void;
+    /**
+     * Apply event to internal state
+     */
+    private applyEvent;
+    private handleNodeEvent;
+    private handleEdgeEvent;
+    private handleStateEvent;
+    private handleDataEvent;
+    private handleSystemEvent;
+    private getEmptyMetrics;
+}
+//# sourceMappingURL=EventProcessor.d.ts.map

package/dist/EventProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventProcessor.d.ts","sourceRoot":"","sources":["../src/EventProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAQjB,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAoB;gBAE5B,aAAa,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE;IAcrF;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB;IA+BjD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB;IAIlD;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,eAAe,IAAI,UAAU,EAAE;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,eAAe;CAUxB"}

package/dist/EventProcessor.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventProcessor = void 0;
+const ValidationEngine_1 = require("./ValidationEngine");
+const ConfigurationValidator_1 = require("./ConfigurationValidator");
+/**
+ * EventProcessor handles the ingestion and processing of graph events
+ */
+class EventProcessor {
+    constructor(configuration, options) {
+        this.eventHistory = [];
+        // Validate configuration by default (can be disabled for performance)
+        if (options?.validateConfig !== false) {
+            ConfigurationValidator_1.ConfigurationValidator.validateOrThrow(configuration);
+        }
+        this.state = {
+            nodes: new Map(),
+            edges: new Map(),
+            configuration,
+        };
+        this.validationEngine = new ValidationEngine_1.ValidationEngine(configuration.validation || {});
+    }
+    /**
+     * Process a single graph event
+     */
+    processEvent(event) {
+        try {
+            // Validate event first
+            const validation = this.validateEvent(event);
+            // Apply the event to state
+            this.applyEvent(event);
+            // Store in history
+            this.eventHistory.push(event);
+            return {
+                success: true,
+                state: this.state,
+                validation,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                state: this.state,
+                validation: {
+                    valid: false,
+                    violations: [],
+                    warnings: [],
+                    metrics: this.getEmptyMetrics(),
+                },
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Validate an event against configuration rules
+     */
+    validateEvent(event) {
+        return this.validationEngine.validate(event, this.state);
+    }
+    /**
+     * Get the current graph state
+     */
+    getGraphState() {
+        return this.state;
+    }
+    /**
+     * Get event history
+     */
+    getEventHistory() {
+        return [...this.eventHistory];
+    }
+    /**
+     * Reset processor state
+     */
+    reset() {
+        this.state.nodes.clear();
+        this.state.edges.clear();
+        this.eventHistory = [];
+    }
+    /**
+     * Apply event to internal state
+     */
+    applyEvent(event) {
+        const timestamp = event.timestamp;
+        switch (event.category) {
+            case 'node':
+                this.handleNodeEvent(event, timestamp);
+                break;
+            case 'edge':
+                this.handleEdgeEvent(event, timestamp);
+                break;
+            case 'state':
+                this.handleStateEvent(event, timestamp);
+                break;
+            case 'data':
+                this.handleDataEvent(event);
+                break;
+            case 'system':
+                this.handleSystemEvent(event);
+                break;
+        }
+    }
+    handleNodeEvent(event, timestamp) {
+        const payload = event.payload;
+        switch (payload.operation) {
+            case 'create':
+                this.state.nodes.set(payload.nodeId, {
+                    id: payload.nodeId,
+                    type: payload.nodeType,
+                    name: typeof payload.data?.name === 'string' ? payload.data.name : payload.nodeId,
+                    data: payload.data || {},
+                    position: payload.position,
+                    createdAt: timestamp,
+                    updatedAt: timestamp,
+                });
+                break;
+            case 'update': {
+                const existingNode = this.state.nodes.get(payload.nodeId);
+                if (existingNode) {
+                    this.state.nodes.set(payload.nodeId, {
+                        ...existingNode,
+                        data: { ...existingNode.data, ...payload.data },
+                        position: payload.position || existingNode.position,
+                        updatedAt: timestamp,
+                    });
+                }
+                break;
+            }
+            case 'delete':
+                this.state.nodes.delete(payload.nodeId);
+                break;
+        }
+    }
+    handleEdgeEvent(event, timestamp) {
+        const payload = event.payload;
+        switch (payload.operation) {
+            case 'create':
+                this.state.edges.set(payload.edgeId, {
+                    id: payload.edgeId,
+                    type: payload.edgeType,
+                    from: payload.from,
+                    to: payload.to,
+                    data: payload.data,
+                    createdAt: timestamp,
+                    updatedAt: timestamp,
+                });
+                break;
+            case 'update': {
+                const existingEdge = this.state.edges.get(payload.edgeId);
+                if (existingEdge) {
+                    this.state.edges.set(payload.edgeId, {
+                        ...existingEdge,
+                        data: { ...existingEdge.data, ...payload.data },
+                        updatedAt: timestamp,
+                    });
+                }
+                break;
+            }
+            case 'delete':
+                this.state.edges.delete(payload.edgeId);
+                break;
+            case 'animate':
+                // Animation is handled by the UI layer
+                break;
+        }
+    }
+    handleStateEvent(event, timestamp) {
+        const payload = event.payload;
+        const node = this.state.nodes.get(payload.nodeId);
+        if (node) {
+            this.state.nodes.set(payload.nodeId, {
+                ...node,
+                state: payload.newState,
+                data: { ...node.data, ...payload.data },
+                updatedAt: timestamp,
+            });
+        }
+    }
+    handleDataEvent(event) {
+        const payload = event.payload;
+        if (payload.targetType === 'node') {
+            const node = this.state.nodes.get(payload.targetId);
+            if (node) {
+                this.state.nodes.set(payload.targetId, {
+                    ...node,
+                    data: { ...node.data, ...payload.updates },
+                    updatedAt: event.timestamp,
+                });
+            }
+        }
+        else {
+            const edge = this.state.edges.get(payload.targetId);
+            if (edge) {
+                this.state.edges.set(payload.targetId, {
+                    ...edge,
+                    data: { ...edge.data, ...payload.updates },
+                    updatedAt: event.timestamp,
+                });
+            }
+        }
+    }
+    handleSystemEvent(event) {
+        const payload = event.payload;
+        if (payload.action === 'reset') {
+            this.reset();
+        }
+    }
+    getEmptyMetrics() {
+        return {
+            totalEvents: 0,
+            validEvents: 0,
+            violations: 0,
+            warnings: 0,
+            unexpectedEvents: 0,
+            expectedEventsMissing: 0,
+        };
+    }
+}
+exports.EventProcessor = EventProcessor;
+//# sourceMappingURL=EventProcessor.js.map

package/dist/EventProcessor.js.map

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

package/dist/EventRecorderService.d.ts

@@ -0,0 +1,305 @@
+/**
+ * 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 type { EventSession, CreateSessionOptions, EndSessionOptions } from './SessionManager';
+import type { LogEntry } from './PathBasedEventProcessor';
+import type { PathBasedGraphConfiguration, PathBasedEvent } from './types/path-based-config';
+import type { GraphEvent } from './types';
+/**
+ * Protocol message types for log ingestion
+ */
+export type ProtocolMessageType = 'session_start' | 'session_end' | 'log' | 'log_batch' | 'ping' | 'pong' | 'error' | 'ack';
+/**
+ * Base protocol message structure
+ */
+export interface ProtocolMessage {
+    type: ProtocolMessageType;
+    timestamp: number;
+    requestId?: string;
+}
+/**
+ * Session start message
+ */
+export interface SessionStartMessage extends ProtocolMessage {
+    type: 'session_start';
+    payload: {
+        name: string;
+        id?: string;
+        metadata?: {
+            testFile?: string;
+            testName?: string;
+            testSuite?: string;
+            tags?: string[];
+        };
+    };
+}
+/**
+ * Session end message
+ */
+export interface SessionEndMessage extends ProtocolMessage {
+    type: 'session_end';
+    payload: {
+        sessionId: string;
+        result?: 'pass' | 'fail' | 'skip';
+        error?: string;
+    };
+}
+/**
+ * Single log message
+ */
+export interface LogMessage extends ProtocolMessage {
+    type: 'log';
+    payload: LogEntry;
+}
+/**
+ * Batch log message
+ */
+export interface LogBatchMessage extends ProtocolMessage {
+    type: 'log_batch';
+    payload: {
+        logs: LogEntry[];
+    };
+}
+/**
+ * Ping message for keepalive
+ */
+export interface PingMessage extends ProtocolMessage {
+    type: 'ping';
+}
+/**
+ * Pong response
+ */
+export interface PongMessage extends ProtocolMessage {
+    type: 'pong';
+}
+/**
+ * Error response
+ */
+export interface ErrorMessage extends ProtocolMessage {
+    type: 'error';
+    payload: {
+        code: string;
+        message: string;
+        requestId?: string;
+    };
+}
+/**
+ * Acknowledgment response
+ */
+export interface AckMessage extends ProtocolMessage {
+    type: 'ack';
+    payload: {
+        requestId: string;
+        sessionId?: string;
+    };
+}
+/**
+ * Union type for all incoming messages
+ */
+export type IncomingMessage = SessionStartMessage | SessionEndMessage | LogMessage | LogBatchMessage | PingMessage;
+/**
+ * Union type for all outgoing messages
+ */
+export type OutgoingMessage = PongMessage | ErrorMessage | AckMessage;
+/**
+ * Recording mode
+ */
+export type RecordingMode = 'auto' | 'manual' | 'continuous';
+/**
+ * Event callback for processed events
+ */
+export type EventCallback = (event: PathBasedEvent | GraphEvent) => void;
+/**
+ * Event batch callback
+ */
+export type EventBatchCallback = (events: Array<PathBasedEvent | GraphEvent>) => void;
+/**
+ * Connection state
+ */
+export interface ConnectionState {
+    id: string;
+    connectedAt: number;
+    lastActivityAt: number;
+    activeSessionId: string | null;
+}
+/**
+ * EventRecorderService configuration
+ */
+export interface EventRecorderServiceConfig {
+    /** Graph configuration for PathBasedEventProcessor */
+    graphConfig: PathBasedGraphConfiguration;
+    /** Recording mode (default: 'manual') */
+    recordingMode?: RecordingMode;
+    /** Whether to emit events immediately or batch them (default: true) */
+    emitImmediately?: boolean;
+    /** Batch interval in ms when emitImmediately is false (default: 100) */
+    batchIntervalMs?: number;
+    /** SessionManager configuration */
+    sessionConfig?: {
+        maxEventsPerSession?: number;
+        maxSessions?: number;
+        sessionRetention?: number;
+        autoCleanup?: boolean;
+    };
+}
+/**
+ * EventRecorderService - Main service for log ingestion and event recording
+ */
+export declare class EventRecorderService {
+    private sessionManager;
+    private eventProcessor;
+    private config;
+    private eventListeners;
+    private batchListeners;
+    private eventBuffer;
+    private batchTimer;
+    private connections;
+    private isRecording;
+    constructor(config: EventRecorderServiceConfig);
+    /**
+     * Process an incoming protocol message
+     */
+    processMessage(message: IncomingMessage, connectionId: string): OutgoingMessage | null;
+    /**
+     * Handle session start message
+     */
+    private handleSessionStart;
+    /**
+     * Handle session end message
+     */
+    private handleSessionEnd;
+    /**
+     * Handle single log message
+     */
+    private handleLog;
+    /**
+     * Handle batch log message
+     */
+    private handleLogBatch;
+    /**
+     * Handle ping message
+     */
+    private handlePing;
+    /**
+     * Create an error response
+     */
+    private createError;
+    /**
+     * Emit events to listeners
+     */
+    private emitEvents;
+    /**
+     * Start batch processing timer
+     */
+    private startBatchProcessing;
+    /**
+     * Stop batch processing timer
+     */
+    private stopBatchProcessing;
+    /**
+     * Process a log entry directly (without protocol message wrapper)
+     */
+    processLog(log: LogEntry): PathBasedEvent[];
+    /**
+     * Process multiple log entries directly (without protocol message wrapper)
+     */
+    processLogs(logs: LogEntry[]): PathBasedEvent[];
+    /**
+     * Start a new session directly
+     */
+    startSession(options: CreateSessionOptions): EventSession;
+    /**
+     * End a session directly
+     */
+    endSession(sessionId: string, options?: EndSessionOptions): void;
+    /**
+     * End the active session
+     */
+    endActiveSession(options?: EndSessionOptions): void;
+    /**
+     * Start recording (for manual mode)
+     */
+    startRecording(): void;
+    /**
+     * Stop recording (for manual mode)
+     */
+    stopRecording(): void;
+    /**
+     * Check if currently recording
+     */
+    get recording(): boolean;
+    /**
+     * Register a new connection
+     */
+    registerConnection(connectionId: string): void;
+    /**
+     * Unregister a connection
+     */
+    unregisterConnection(connectionId: string): void;
+    /**
+     * Get connection state
+     */
+    getConnection(connectionId: string): ConnectionState | undefined;
+    /**
+     * Get all active connections
+     */
+    getConnections(): ConnectionState[];
+    /**
+     * Subscribe to individual events
+     */
+    onEvent(callback: EventCallback): () => void;
+    /**
+     * Subscribe to event batches
+     */
+    onEventBatch(callback: EventBatchCallback): () => void;
+    /**
+     * Get SessionManager for direct access
+     */
+    getSessionManager(): SessionManager;
+    /**
+     * Get active session
+     */
+    getActiveSession(): EventSession | undefined;
+    /**
+     * Get session by ID
+     */
+    getSession(id: string): EventSession | undefined;
+    /**
+     * List all sessions
+     */
+    listSessions(): EventSession[];
+    /**
+     * Get service statistics
+     */
+    getStats(): {
+        isRecording: boolean;
+        recordingMode: RecordingMode;
+        activeConnections: number;
+        sessions: {
+            total: number;
+            active: number;
+            totalEvents: number;
+        };
+        processor: {
+            totalComponents: number;
+            componentsWithSources: number;
+            totalSourcePatterns: number;
+        };
+    };
+    /**
+     * Dispose of the service
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=EventRecorderService.d.ts.map

package/dist/EventRecorderService.d.ts.map

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