@agentionai/agents 0.3.0-beta

package/dist/viz/VizReporter.d.ts

@@ -0,0 +1,127 @@
+/**
+ * VizReporter - Singleton for sending visualization events to @agention/viz.
+ *
+ * This class manages WebSocket connections and event reporting for agent monitoring.
+ * Events are queued when disconnected and flushed on reconnection.
+ */
+import { EventEmitter } from "events";
+import { VizSource, VizVendor, VizTokenUsage, VizStopReason, VizPipelineStructure, VizExecutorType } from "./types";
+export declare class VizReporter extends EventEmitter {
+    private static instance;
+    private ws;
+    private queue;
+    private currentSessionId;
+    private currentPipelineId;
+    private eventStack;
+    private eventTimings;
+    private connecting;
+    private reconnectTimer;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): VizReporter;
+    /**
+     * Reset the singleton (for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Initialize WebSocket connection
+     */
+    private initWebSocket;
+    /**
+     * Attempt to connect to the visualization server
+     */
+    private tryConnect;
+    /**
+     * Schedule a reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Flush queued events
+     */
+    private flushQueue;
+    /**
+     * Disconnect from the visualization server
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the visualization server
+     */
+    isConnected(): boolean;
+    /**
+     * Send an event to the visualization server
+     */
+    private send;
+    /**
+     * Start a new session
+     */
+    startSession(name?: string): string;
+    /**
+     * End the current session
+     */
+    endSession(reason?: "completed" | "error" | "timeout"): void;
+    /**
+     * Get or create a session ID
+     */
+    getSessionId(): string;
+    /**
+     * Set the current session ID (for external session management)
+     */
+    setSessionId(sessionId: string): void;
+    /**
+     * Start a pipeline execution
+     */
+    pipelineStart(name: string, structure: VizPipelineStructure, input: string, source: VizSource): string;
+    /**
+     * End a pipeline execution
+     */
+    pipelineEnd(eventId: string, success: boolean, totalTokens: VizTokenUsage, nodeCount: number, output?: string, error?: string): void;
+    /**
+     * Start an executor (sequential, parallel, map, voting, router)
+     */
+    executorStart(name: string, type: VizExecutorType, childCount: number, input: string, source: VizSource): string;
+    /**
+     * End an executor
+     */
+    executorEnd(eventId: string, success: boolean, totalTokens: VizTokenUsage, output?: string, error?: string): void;
+    /**
+     * Report agent execution start
+     */
+    agentStart(agentId: string, agentName: string, model: string, vendor: VizVendor, input: string): string;
+    /**
+     * Report agent execution complete
+     */
+    agentComplete(eventId: string, tokens: VizTokenUsage, stopReason: VizStopReason, hasToolCalls: boolean, toolCallCount: number, output: string): void;
+    /**
+     * Report agent execution error
+     */
+    agentError(eventId: string, errorType: string, errorMessage: string, retryable?: boolean): void;
+    /**
+     * Report tool execution start
+     */
+    toolStart(toolName: string, toolId: string, input: unknown, agentSource: VizSource): string;
+    /**
+     * Report tool execution complete
+     */
+    toolComplete(eventId: string, toolName: string, toolId: string, success: boolean, result: unknown): void;
+    /**
+     * Report tool execution error
+     */
+    toolError(eventId: string, toolName: string, toolId: string, errorMessage: string): void;
+    /**
+     * Pop an event from the stack
+     */
+    private popEventStack;
+    /**
+     * Get current event stack depth
+     */
+    getStackDepth(): number;
+    /**
+     * Get queued event count
+     */
+    getQueueSize(): number;
+}
+/** Global VizReporter instance */
+export declare const vizReporter: VizReporter;
+//# sourceMappingURL=VizReporter.d.ts.map