@principal-ai/subsystems-core 0.29.0 → 0.30.0

package/dist/EventRecorderService.d.ts

@@ -1,305 +0,0 @@
-/**
- * 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

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