@voltagent/server-core 1.0.0-next.1 → 1.0.0-next.2

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { AgentHistoryEntry, WorkflowHistoryEntry, ServerProviderDeps, IServerProvider } from '@voltagent/core';
 import { LogFilter, Logger, LogLevel, LogEntry } from '@voltagent/internal';
 import { z } from 'zod';
+import { ServerProviderDeps, IServerProvider } from '@voltagent/core';
 import jwt from 'jsonwebtoken';
 import { IncomingMessage, Server } from 'node:http';
 import { Socket } from 'node:net';
@@ -96,14 +96,7 @@ interface LogStreamClient {
 /**
  * WebSocket event handlers
  */
-interface WebSocketEventHandlers {
-    onAgentHistoryUpdate?: (agentId: string, historyEntry: AgentHistoryEntry & {
-        _sequenceNumber?: number;
-    }) => void;
-    onAgentHistoryCreated?: (agentId: string, historyEntry: AgentHistoryEntry) => void;
-    onWorkflowHistoryCreated?: (historyEntry: WorkflowHistoryEntry) => void;
-    onWorkflowHistoryUpdate?: (executionId: string, historyEntry: WorkflowHistoryEntry) => void;
-}
+type WebSocketEventHandlers = Record<string, never>;
 
 /**
  * Framework-agnostic route definitions
@@ -205,13 +198,13 @@ declare const AGENT_ROUTES: {
     readonly streamText: {
         readonly method: "post";
         readonly path: "/agents/:id/stream";
-        readonly summary: "Stream text response";
-        readonly description: "Generate a text response from an agent and stream it in real-time via Server-Sent Events (SSE). This endpoint is ideal for interactive applications where you want to display partial responses as they're generated, providing a more responsive user experience. Each event contains incremental text updates, timestamps, and completion status.";
+        readonly summary: "Stream raw text response";
+        readonly description: "Generate a text response from an agent and stream the raw fullStream data via Server-Sent Events (SSE). This endpoint provides direct access to all stream events including text deltas, tool calls, and tool results. Use this for advanced applications that need full control over stream processing.";
         readonly tags: readonly ["Agent Generation"];
         readonly operationId: "streamText";
         readonly responses: {
             readonly 200: {
-                readonly description: "Successfully established SSE stream for text generation";
+                readonly description: "Successfully established SSE stream for raw text generation";
                 readonly contentType: "text/event-stream";
             };
             readonly 400: {
@@ -228,6 +221,32 @@ declare const AGENT_ROUTES: {
             };
         };
     };
+    readonly chatStream: {
+        readonly method: "post";
+        readonly path: "/agents/:id/chat";
+        readonly summary: "Stream chat messages";
+        readonly description: "Generate a text response from an agent and stream it as UI messages via Server-Sent Events (SSE). This endpoint is optimized for chat interfaces and works seamlessly with the AI SDK's useChat hook. It provides a high-level stream format with automatic handling of messages, tool calls, and metadata.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "chatStream";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for chat generation";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters or message format";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream chat due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
     readonly generateObject: {
         readonly method: "post";
         readonly path: "/agents/:id/object";
@@ -451,6 +470,28 @@ declare const WORKFLOW_ROUTES: {
             };
         };
     };
+    readonly getWorkflowState: {
+        readonly method: "get";
+        readonly path: "/workflows/:id/executions/:executionId/state";
+        readonly summary: "Get workflow execution state";
+        readonly description: "Retrieve the workflow execution state including input data, suspension information, context, and current status. This is essential for understanding the current state of a workflow execution, especially for suspended workflows that need to be resumed with the correct context.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "getWorkflowState";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved workflow execution state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflow state due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
 };
 /**
  * Log route definitions
@@ -524,10 +565,351 @@ declare const UPDATE_ROUTES: {
         };
     };
 };
+/**
+ * Observability route definitions
+ */
+declare const OBSERVABILITY_ROUTES: {
+    readonly setupObservability: {
+        readonly method: "post";
+        readonly path: "/setup-observability";
+        readonly summary: "Configure observability settings";
+        readonly description: "Updates the .env file with VoltAgent public and secret keys to enable observability features. This allows automatic tracing and monitoring of agent operations.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "setupObservability";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully configured observability settings";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid request - missing publicKey or secretKey";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to update .env file";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getTraces: {
+        readonly method: "get";
+        readonly path: "/observability/traces";
+        readonly summary: "List all traces";
+        readonly description: "Retrieve all OpenTelemetry traces from the observability store. Each trace represents a complete operation with its spans showing the execution flow.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getTraces";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved traces";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve traces due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getTraceById: {
+        readonly method: "get";
+        readonly path: "/observability/traces/:traceId";
+        readonly summary: "Get trace by ID";
+        readonly description: "Retrieve a specific trace and all its spans by trace ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getTraceById";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved trace";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Trace not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve trace due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getSpanById: {
+        readonly method: "get";
+        readonly path: "/observability/spans/:spanId";
+        readonly summary: "Get span by ID";
+        readonly description: "Retrieve a specific span by its ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getSpanById";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved span";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Span not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve span due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getObservabilityStatus: {
+        readonly method: "get";
+        readonly path: "/observability/status";
+        readonly summary: "Get observability status";
+        readonly description: "Check the status and configuration of the observability system.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getObservabilityStatus";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved observability status";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve status due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getLogsByTraceId: {
+        readonly method: "get";
+        readonly path: "/observability/traces/:traceId/logs";
+        readonly summary: "Get logs by trace ID";
+        readonly description: "Retrieve all logs associated with a specific trace ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getLogsByTraceId";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "No logs found for the trace";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getLogsBySpanId: {
+        readonly method: "get";
+        readonly path: "/observability/spans/:spanId/logs";
+        readonly summary: "Get logs by span ID";
+        readonly description: "Retrieve all logs associated with a specific span ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getLogsBySpanId";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "No logs found for the span";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly queryLogs: {
+        readonly method: "get";
+        readonly path: "/observability/logs";
+        readonly summary: "Query logs";
+        readonly description: "Query logs with filters such as severity, time range, trace ID, etc.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "queryLogs";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid query parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to query logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+};
 /**
  * All route definitions combined
  */
 declare const ALL_ROUTES: {
+    readonly setupObservability: {
+        readonly method: "post";
+        readonly path: "/setup-observability";
+        readonly summary: "Configure observability settings";
+        readonly description: "Updates the .env file with VoltAgent public and secret keys to enable observability features. This allows automatic tracing and monitoring of agent operations.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "setupObservability";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully configured observability settings";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid request - missing publicKey or secretKey";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to update .env file";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getTraces: {
+        readonly method: "get";
+        readonly path: "/observability/traces";
+        readonly summary: "List all traces";
+        readonly description: "Retrieve all OpenTelemetry traces from the observability store. Each trace represents a complete operation with its spans showing the execution flow.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getTraces";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved traces";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve traces due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getTraceById: {
+        readonly method: "get";
+        readonly path: "/observability/traces/:traceId";
+        readonly summary: "Get trace by ID";
+        readonly description: "Retrieve a specific trace and all its spans by trace ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getTraceById";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved trace";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Trace not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve trace due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getSpanById: {
+        readonly method: "get";
+        readonly path: "/observability/spans/:spanId";
+        readonly summary: "Get span by ID";
+        readonly description: "Retrieve a specific span by its ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getSpanById";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved span";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Span not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve span due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getObservabilityStatus: {
+        readonly method: "get";
+        readonly path: "/observability/status";
+        readonly summary: "Get observability status";
+        readonly description: "Check the status and configuration of the observability system.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getObservabilityStatus";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved observability status";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve status due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getLogsByTraceId: {
+        readonly method: "get";
+        readonly path: "/observability/traces/:traceId/logs";
+        readonly summary: "Get logs by trace ID";
+        readonly description: "Retrieve all logs associated with a specific trace ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getLogsByTraceId";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "No logs found for the trace";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getLogsBySpanId: {
+        readonly method: "get";
+        readonly path: "/observability/spans/:spanId/logs";
+        readonly summary: "Get logs by span ID";
+        readonly description: "Retrieve all logs associated with a specific span ID.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "getLogsBySpanId";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "No logs found for the span";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly queryLogs: {
+        readonly method: "get";
+        readonly path: "/observability/logs";
+        readonly summary: "Query logs";
+        readonly description: "Query logs with filters such as severity, time range, trace ID, etc.";
+        readonly tags: readonly ["Observability"];
+        readonly operationId: "queryLogs";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved logs";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid query parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to query logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
     readonly checkUpdates: {
         readonly method: "get";
         readonly path: "/updates";
@@ -734,6 +1116,28 @@ declare const ALL_ROUTES: {
             };
         };
     };
+    readonly getWorkflowState: {
+        readonly method: "get";
+        readonly path: "/workflows/:id/executions/:executionId/state";
+        readonly summary: "Get workflow execution state";
+        readonly description: "Retrieve the workflow execution state including input data, suspension information, context, and current status. This is essential for understanding the current state of a workflow execution, especially for suspended workflows that need to be resumed with the correct context.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "getWorkflowState";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved workflow execution state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflow state due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
     readonly listAgents: {
         readonly method: "get";
         readonly path: "/agents";
@@ -803,13 +1207,13 @@ declare const ALL_ROUTES: {
     readonly streamText: {
         readonly method: "post";
         readonly path: "/agents/:id/stream";
-        readonly summary: "Stream text response";
-        readonly description: "Generate a text response from an agent and stream it in real-time via Server-Sent Events (SSE). This endpoint is ideal for interactive applications where you want to display partial responses as they're generated, providing a more responsive user experience. Each event contains incremental text updates, timestamps, and completion status.";
+        readonly summary: "Stream raw text response";
+        readonly description: "Generate a text response from an agent and stream the raw fullStream data via Server-Sent Events (SSE). This endpoint provides direct access to all stream events including text deltas, tool calls, and tool results. Use this for advanced applications that need full control over stream processing.";
         readonly tags: readonly ["Agent Generation"];
         readonly operationId: "streamText";
         readonly responses: {
             readonly 200: {
-                readonly description: "Successfully established SSE stream for text generation";
+                readonly description: "Successfully established SSE stream for raw text generation";
                 readonly contentType: "text/event-stream";
             };
             readonly 400: {
@@ -826,6 +1230,32 @@ declare const ALL_ROUTES: {
             };
         };
     };
+    readonly chatStream: {
+        readonly method: "post";
+        readonly path: "/agents/:id/chat";
+        readonly summary: "Stream chat messages";
+        readonly description: "Generate a text response from an agent and stream it as UI messages via Server-Sent Events (SSE). This endpoint is optimized for chat interfaces and works seamlessly with the AI SDK's useChat hook. It provides a high-level stream format with automatic handling of messages, tool calls, and metadata.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "chatStream";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for chat generation";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters or message format";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream chat due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
     readonly generateObject: {
         readonly method: "post";
         readonly path: "/agents/:id/object";
@@ -1916,22 +2346,27 @@ declare function handleGetAgents(deps: ServerProviderDeps, logger: Logger): Prom
  * Handler for generating text
  * Returns generated text data
  */
-declare function handleGenerateText(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+declare function handleGenerateText(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<ApiResponse>;
 /**
- * Handler for streaming text generation
- * Returns AI SDK Response or error
+ * Handler for streaming text generation with raw fullStream
+ * Returns raw stream data via SSE
+ */
+declare function handleStreamText(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<Response>;
+/**
+ * Handler for streaming chat messages
+ * Returns AI SDK UI Message Stream Response
  */
-declare function handleStreamText(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<Response>;
+declare function handleChatStream(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<Response>;
 /**
  * Handler for generating objects
  * Returns generated object data
  */
-declare function handleGenerateObject(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+declare function handleGenerateObject(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<ApiResponse>;
 /**
  * Handler for streaming object generation
  * Returns AI SDK Response or error
  */
-declare function handleStreamObject(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<Response>;
+declare function handleStreamObject(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<Response>;
 
 /**
  * Handler for getting a single agent by ID
@@ -1974,6 +2409,11 @@ declare function handleSuspendWorkflow(executionId: string, body: any, deps: Ser
  * Returns resume result
  */
 declare function handleResumeWorkflow(workflowId: string, executionId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for getting workflow execution state
+ * Returns workflow state from Memory V2
+ */
+declare function handleGetWorkflowState(workflowId: string, executionId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
 
 /**
  * Log filter options for querying logs
@@ -2010,6 +2450,47 @@ declare function handleCheckUpdates(_deps: ServerProviderDeps, logger: Logger):
  */
 declare function handleInstallUpdates(packageName: string | undefined, _deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
 
+/**
+ * Observability API handlers
+ * Provides access to OpenTelemetry traces and spans
+ */
+
+/**
+ * Get all traces from the observability store with optional agent filtering
+ */
+declare function getTracesHandler(deps: ServerProviderDeps, query?: Record<string, string>): Promise<any>;
+/**
+ * Get a specific trace by ID
+ */
+declare function getTraceByIdHandler(traceId: string, deps: ServerProviderDeps): Promise<any>;
+/**
+ * Get a specific span by ID
+ */
+declare function getSpanByIdHandler(spanId: string, deps: ServerProviderDeps): Promise<any>;
+/**
+ * Get observability status
+ */
+declare function getObservabilityStatusHandler(deps: ServerProviderDeps): Promise<any>;
+/**
+ * Get logs by trace ID
+ */
+declare function getLogsByTraceIdHandler(traceId: string, deps: ServerProviderDeps): Promise<any>;
+/**
+ * Get logs by span ID
+ */
+declare function getLogsBySpanIdHandler(spanId: string, deps: ServerProviderDeps): Promise<any>;
+/**
+ * Query logs with filters
+ */
+declare function queryLogsHandler(query: any, deps: ServerProviderDeps): Promise<any>;
+/**
+ * Setup observability by updating .env file with VoltAgent keys
+ */
+declare function setupObservabilityHandler(body: {
+    publicKey?: string;
+    secretKey?: string;
+}, deps: ServerProviderDeps): Promise<any>;
+
 /**
  * Authentication provider interface for VoltAgent server
  * Framework-agnostic auth types
@@ -2232,7 +2713,7 @@ interface ProcessedAgentOptions {
     seed?: number;
     stopSequences?: string[];
     maxRetries?: number;
-    signal?: AbortSignal;
+    abortSignal?: AbortSignal;
     onFinish?: (result: unknown) => Promise<void>;
     [key: string]: any;
 }
@@ -2531,6 +3012,24 @@ declare function createWebSocketServer(deps: ServerProviderDeps, logger: Logger)
  */
 declare function setupWebSocketUpgrade(server: any, wss: WebSocketServer, pathPrefix?: string): void;
 
+/**
+ * WebSocket handler for Observability events
+ * Bridges OpenTelemetry span events to the Console UI
+ */
+
+/**
+ * Setup observability event listeners
+ */
+declare function setupObservabilityListeners(): void;
+/**
+ * Handle new WebSocket connection for observability
+ */
+declare function handleObservabilityConnection(ws: IWebSocket, request: any, _deps: ServerProviderDeps): void;
+/**
+ * Close all observability WebSocket connections
+ */
+declare function closeAllObservabilityConnections(): void;
+
 /**
  * Base server provider class
  * Framework-agnostic server implementation base
@@ -2685,4 +3184,4 @@ declare const DEFAULT_CORS_OPTIONS: {
     credentials: boolean;
 };
 
-export { AGENT_ROUTES, ALL_ROUTES, AgentListSchema, AgentParamsSchema, AgentResponseSchema, type ApiResponse, type AppSetupConfig, type AuthFrameworkAdapter, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, CustomEndpointError, type CustomEndpointHandler, DEFAULT_CORS_OPTIONS, DEFAULT_PUBLIC_ROUTES, type ErrorResponse, ErrorSchema, GenerateOptionsSchema, type HttpMethod, type IWebSocket, type JWTAuthOptions, LOG_ROUTES, type LogFilterOptions, type LogHandlerResponse, type LogStreamClient, LogStreamManager, ObjectRequestSchema, ObjectResponseSchema, type OpenApiInfo, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ResponseDefinition, type RouteDefinition, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, type StreamResponse, StreamTextEventSchema, SubAgentResponseSchema, type SuccessResponse, TextRequestSchema, TextResponseSchema, UPDATE_ROUTES, WORKFLOW_ROUTES, type WebSocketAdapter, type WebSocketConnectionHandler, type WebSocketConnectionInfo, type WebSocketEventHandlers, type WebSocketMessage, WebSocketRouter, WorkflowExecutionParamsSchema, WorkflowExecutionRequestSchema, WorkflowExecutionResponseSchema, WorkflowListSchema, WorkflowParamsSchema, WorkflowResponseSchema, WorkflowResumeRequestSchema, WorkflowResumeResponseSchema, WorkflowStreamEventSchema, WorkflowSuspendRequestSchema, WorkflowSuspendResponseSchema, cleanupWebSockets, colors, createAuthErrorResponse, createAuthMiddlewareFactory, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, extractBearerToken, extractToken, formatSSE, getAllRoutesArray, getLandingPageHTML, getOpenApiDoc, getOrCreateLogger, getPortsToTry, getResponseStatus, getRoutesByTag, handleCheckUpdates, handleExecuteWorkflow, handleGenerateObject, handleGenerateText, handleGetAgent, handleGetAgentHistory, handleGetAgents, handleGetLogs, handleGetWorkflow, handleGetWorkflows, handleInstallUpdates, handleResumeWorkflow, handleStreamObject, handleStreamText, handleStreamWorkflow, handleSuspendWorkflow, handleWebSocketConnection, injectUserIntoBody, isErrorResponse, isSuccessResponse, jwtAuth, mapHandlerResponse, mapLogResponse, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, requiresAuth, setupWebSocketUpgrade, shouldEnableSwaggerUI, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };
+export { AGENT_ROUTES, ALL_ROUTES, AgentListSchema, AgentParamsSchema, AgentResponseSchema, type ApiResponse, type AppSetupConfig, type AuthFrameworkAdapter, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, CustomEndpointError, type CustomEndpointHandler, DEFAULT_CORS_OPTIONS, DEFAULT_PUBLIC_ROUTES, type ErrorResponse, ErrorSchema, GenerateOptionsSchema, type HttpMethod, type IWebSocket, type JWTAuthOptions, LOG_ROUTES, type LogFilterOptions, type LogHandlerResponse, type LogStreamClient, LogStreamManager, OBSERVABILITY_ROUTES, ObjectRequestSchema, ObjectResponseSchema, type OpenApiInfo, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ResponseDefinition, type RouteDefinition, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, type StreamResponse, StreamTextEventSchema, SubAgentResponseSchema, type SuccessResponse, TextRequestSchema, TextResponseSchema, UPDATE_ROUTES, WORKFLOW_ROUTES, type WebSocketAdapter, type WebSocketConnectionHandler, type WebSocketConnectionInfo, type WebSocketEventHandlers, type WebSocketMessage, WebSocketRouter, WorkflowExecutionParamsSchema, WorkflowExecutionRequestSchema, WorkflowExecutionResponseSchema, WorkflowListSchema, WorkflowParamsSchema, WorkflowResponseSchema, WorkflowResumeRequestSchema, WorkflowResumeResponseSchema, WorkflowStreamEventSchema, WorkflowSuspendRequestSchema, WorkflowSuspendResponseSchema, cleanupWebSockets, closeAllObservabilityConnections, colors, createAuthErrorResponse, createAuthMiddlewareFactory, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, extractBearerToken, extractToken, formatSSE, getAllRoutesArray, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getOpenApiDoc, getOrCreateLogger, getPortsToTry, getResponseStatus, getRoutesByTag, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleChatStream, handleCheckUpdates, handleExecuteWorkflow, handleGenerateObject, handleGenerateText, handleGetAgent, handleGetAgentHistory, handleGetAgents, handleGetLogs, handleGetWorkflow, handleGetWorkflowState, handleGetWorkflows, handleInstallUpdates, handleObservabilityConnection, handleResumeWorkflow, handleStreamObject, handleStreamText, handleStreamWorkflow, handleSuspendWorkflow, handleWebSocketConnection, injectUserIntoBody, isErrorResponse, isSuccessResponse, jwtAuth, mapHandlerResponse, mapLogResponse, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, shouldEnableSwaggerUI, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };