@voltagent/server-core 1.0.11 → 1.0.12

package/dist/edge-wNCsUs1i.d.mts

@@ -0,0 +1,1889 @@
+import { ServerProviderDeps, A2AServerRegistry } from '@voltagent/core';
+import { Logger, LogLevel, LogEntry, LogFilter } from '@voltagent/internal';
+import { A2AServerLike } from '@voltagent/internal/a2a';
+
+/**
+ * Common app setup utilities
+ * Framework-agnostic application configuration helpers
+ */
+
+/**
+ * OpenAPI documentation info
+ */
+interface OpenApiInfo {
+    version?: string;
+    title?: string;
+    description?: string;
+}
+/**
+ * Common app setup configuration
+ */
+interface AppSetupConfig {
+    /**
+     * Enable Swagger UI
+     */
+    enableSwaggerUI?: boolean;
+    /**
+     * CORS options
+     */
+    corsOptions?: any;
+    /**
+     * OpenAPI documentation info
+     */
+    openApiInfo?: OpenApiInfo;
+    /**
+     * Server port for documentation
+     */
+    port?: number;
+}
+/**
+ * Get or create a logger instance
+ * @param deps Server provider dependencies
+ * @param component Component name for logger
+ * @returns Logger instance
+ */
+declare function getOrCreateLogger(deps: ServerProviderDeps, component?: string): Logger;
+/**
+ * Check if Swagger UI should be enabled
+ * @param config App configuration
+ * @returns Whether Swagger UI should be enabled
+ */
+declare function shouldEnableSwaggerUI(config: {
+    enableSwaggerUI?: boolean;
+}): boolean;
+/**
+ * Get default OpenAPI documentation info
+ * @param port Server port
+ * @returns OpenAPI documentation object
+ */
+declare function getOpenApiDoc(port: number, info?: OpenApiInfo): {
+    openapi: "3.1.0";
+    info: {
+        version: string;
+        title: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+        description: string;
+    }[];
+};
+/**
+ * Default CORS configuration
+ */
+declare const DEFAULT_CORS_OPTIONS: {
+    origin: string;
+    methods: string[];
+    allowedHeaders: string[];
+    credentials: boolean;
+};
+
+/**
+ * Framework-agnostic route definitions
+ * These can be used by any server implementation (Hono, Fastify, Express, etc.)
+ */
+/**
+ * HTTP methods
+ */
+type HttpMethod = "get" | "post" | "put" | "patch" | "delete" | "options" | "head";
+/**
+ * Response definition for a specific status code
+ */
+interface ResponseDefinition {
+    description: string;
+    contentType?: string;
+}
+/**
+ * Base route definition that can be used by any framework
+ */
+interface RouteDefinition {
+    method: HttpMethod;
+    path: string;
+    summary: string;
+    description: string;
+    tags: string[];
+    operationId?: string;
+    responses?: Record<number, ResponseDefinition>;
+}
+/**
+ * Agent route definitions
+ */
+declare const AGENT_ROUTES: {
+    readonly listAgents: {
+        readonly method: "get";
+        readonly path: "/agents";
+        readonly summary: "List all registered agents";
+        readonly description: "Retrieve a comprehensive list of all agents registered in the system. Each agent includes its configuration, status, model information, tools, sub-agents, and memory settings. Use this endpoint to discover available agents and their capabilities.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "listAgents";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved list of all registered agents";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agents due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getAgent: {
+        readonly method: "get";
+        readonly path: "/agents/:id";
+        readonly summary: "Get agent by ID";
+        readonly description: "Retrieve detailed information about a specific agent by its ID.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "getAgent";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved agent details";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agent due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly generateText: {
+        readonly method: "post";
+        readonly path: "/agents/:id/text";
+        readonly summary: "Generate text response";
+        readonly description: "Generate a text response from an agent using the provided conversation history. This endpoint processes messages synchronously and returns the complete response once generation is finished. Use this for traditional request-response interactions where you need the full response before proceeding.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "generateText";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully generated text response from the agent";
+                readonly contentType: "application/json";
+            };
+            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 generate text due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamText: {
+        readonly method: "post";
+        readonly path: "/agents/:id/stream";
+        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 raw text 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 text due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    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";
+        readonly summary: "Generate structured object";
+        readonly description: "Generate a structured object that conforms to a specified JSON schema. This endpoint is perfect for extracting structured data from unstructured input, generating form data, or creating API responses with guaranteed structure. The agent will ensure the output matches the provided schema exactly.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "generateObject";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully generated structured object matching the provided schema";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters, message format, or schema";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to generate object due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamObject: {
+        readonly method: "post";
+        readonly path: "/agents/:id/stream-object";
+        readonly summary: "Stream structured object generation";
+        readonly description: "Generate a structured object and stream partial updates via Server-Sent Events (SSE). This allows you to display incremental object construction in real-time, useful for complex object generation where you want to show progress. Events may contain partial object updates or the complete final object, depending on the agent's implementation.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "streamObject";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for object generation";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters, message format, or schema";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream object due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getAgentHistory: {
+        readonly method: "get";
+        readonly path: "/agents/:id/history";
+        readonly summary: "Get agent history";
+        readonly description: "Retrieve the execution history for a specific agent with pagination support.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "getAgentHistory";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved agent execution history";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agent history due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+};
+/**
+ * Workflow route definitions
+ */
+declare const WORKFLOW_ROUTES: {
+    readonly listWorkflows: {
+        readonly method: "get";
+        readonly path: "/workflows";
+        readonly summary: "List all registered workflows";
+        readonly description: "Retrieve a list of all workflows registered in the system. Each workflow includes its ID, name, purpose, step count, and current status. Use this endpoint to discover available workflows and understand their capabilities before execution.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "listWorkflows";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved list of all registered workflows";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflows due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getWorkflow: {
+        readonly method: "get";
+        readonly path: "/workflows/:id";
+        readonly summary: "Get workflow by ID";
+        readonly description: "Retrieve detailed information about a specific workflow by its ID.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "getWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved workflow details";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly executeWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/execute";
+        readonly summary: "Execute workflow synchronously";
+        readonly description: "Execute a workflow and wait for it to complete. This endpoint runs the workflow to completion and returns the final result. Use this for workflows that complete quickly or when you need the complete result before proceeding. For long-running workflows, consider using the streaming endpoint instead.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "executeWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully executed workflow and returned final result";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid workflow input or parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to execute workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/stream";
+        readonly summary: "Stream workflow execution events";
+        readonly description: "Execute a workflow and stream real-time events via Server-Sent Events (SSE). The stream remains open during suspension and continues after resume.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "streamWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for workflow execution";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid workflow input or parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly suspendWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/suspend";
+        readonly summary: "Suspend workflow execution";
+        readonly description: "Suspend a running workflow execution at its current step. This allows you to pause long-running workflows, perform external validations, wait for human approval, or handle rate limits. The workflow state is preserved and can be resumed later with the resume endpoint. Only workflows in 'running' state can be suspended.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "suspendWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully suspended workflow execution";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Workflow is not in a suspendable state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to suspend workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly cancelWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/cancel";
+        readonly summary: "Cancel workflow execution";
+        readonly description: "Cancel a running workflow execution immediately. The workflow stops execution and the state is marked as cancelled. Cancelled workflows cannot be resumed.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "cancelWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully cancelled workflow execution";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 409: {
+                readonly description: "Workflow execution already completed or not cancellable";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to cancel workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly resumeWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/resume";
+        readonly summary: "Resume suspended workflow";
+        readonly description: "Resume a previously suspended workflow execution from where it left off. You can optionally provide resume data that will be passed to the suspended step for processing. This is commonly used after human approval, external system responses, or scheduled resumptions. The workflow continues execution and returns the final result.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "resumeWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully resumed workflow execution and returned final result";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Workflow is not in a suspended state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to resume workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    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
+ */
+declare const LOG_ROUTES: {
+    readonly getLogs: {
+        readonly method: "get";
+        readonly path: "/api/logs";
+        readonly summary: "Get logs with filters";
+        readonly description: "Retrieve system logs with optional filtering by level, agent ID, workflow ID, conversation ID, execution ID, and time range.";
+        readonly tags: readonly ["Logging"];
+        readonly operationId: "getLogs";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved filtered log entries";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid filter parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+};
+/**
+ * Update route definitions
+ */
+declare const UPDATE_ROUTES: {
+    readonly checkUpdates: {
+        readonly method: "get";
+        readonly path: "/updates";
+        readonly summary: "Check for updates";
+        readonly description: "Check for available package updates in the VoltAgent ecosystem.";
+        readonly tags: readonly ["System"];
+        readonly operationId: "checkUpdates";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully checked for available updates";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to check updates due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly installUpdates: {
+        readonly method: "post";
+        readonly path: "/updates/install";
+        readonly summary: "Install updates";
+        readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
+        readonly tags: readonly ["System"];
+        readonly operationId: "installUpdates";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully installed requested updates";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid update request or package not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to install updates due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+};
+/**
+ * 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";
+        readonly summary: "Check for updates";
+        readonly description: "Check for available package updates in the VoltAgent ecosystem.";
+        readonly tags: readonly ["System"];
+        readonly operationId: "checkUpdates";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully checked for available updates";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to check updates due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly installUpdates: {
+        readonly method: "post";
+        readonly path: "/updates/install";
+        readonly summary: "Install updates";
+        readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
+        readonly tags: readonly ["System"];
+        readonly operationId: "installUpdates";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully installed requested updates";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid update request or package not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to install updates due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getLogs: {
+        readonly method: "get";
+        readonly path: "/api/logs";
+        readonly summary: "Get logs with filters";
+        readonly description: "Retrieve system logs with optional filtering by level, agent ID, workflow ID, conversation ID, execution ID, and time range.";
+        readonly tags: readonly ["Logging"];
+        readonly operationId: "getLogs";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved filtered log entries";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid filter parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve logs due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly listWorkflows: {
+        readonly method: "get";
+        readonly path: "/workflows";
+        readonly summary: "List all registered workflows";
+        readonly description: "Retrieve a list of all workflows registered in the system. Each workflow includes its ID, name, purpose, step count, and current status. Use this endpoint to discover available workflows and understand their capabilities before execution.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "listWorkflows";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved list of all registered workflows";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflows due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getWorkflow: {
+        readonly method: "get";
+        readonly path: "/workflows/:id";
+        readonly summary: "Get workflow by ID";
+        readonly description: "Retrieve detailed information about a specific workflow by its ID.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "getWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved workflow details";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly executeWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/execute";
+        readonly summary: "Execute workflow synchronously";
+        readonly description: "Execute a workflow and wait for it to complete. This endpoint runs the workflow to completion and returns the final result. Use this for workflows that complete quickly or when you need the complete result before proceeding. For long-running workflows, consider using the streaming endpoint instead.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "executeWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully executed workflow and returned final result";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid workflow input or parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to execute workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/stream";
+        readonly summary: "Stream workflow execution events";
+        readonly description: "Execute a workflow and stream real-time events via Server-Sent Events (SSE). The stream remains open during suspension and continues after resume.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "streamWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for workflow execution";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid workflow input or parameters";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly suspendWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/suspend";
+        readonly summary: "Suspend workflow execution";
+        readonly description: "Suspend a running workflow execution at its current step. This allows you to pause long-running workflows, perform external validations, wait for human approval, or handle rate limits. The workflow state is preserved and can be resumed later with the resume endpoint. Only workflows in 'running' state can be suspended.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "suspendWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully suspended workflow execution";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Workflow is not in a suspendable state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to suspend workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly cancelWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/cancel";
+        readonly summary: "Cancel workflow execution";
+        readonly description: "Cancel a running workflow execution immediately. The workflow stops execution and the state is marked as cancelled. Cancelled workflows cannot be resumed.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "cancelWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully cancelled workflow execution";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 409: {
+                readonly description: "Workflow execution already completed or not cancellable";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to cancel workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly resumeWorkflow: {
+        readonly method: "post";
+        readonly path: "/workflows/:id/executions/:executionId/resume";
+        readonly summary: "Resume suspended workflow";
+        readonly description: "Resume a previously suspended workflow execution from where it left off. You can optionally provide resume data that will be passed to the suspended step for processing. This is commonly used after human approval, external system responses, or scheduled resumptions. The workflow continues execution and returns the final result.";
+        readonly tags: readonly ["Workflow Management"];
+        readonly operationId: "resumeWorkflow";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully resumed workflow execution and returned final result";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Workflow is not in a suspended state";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Workflow or execution not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to resume workflow due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    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";
+        readonly summary: "List all registered agents";
+        readonly description: "Retrieve a comprehensive list of all agents registered in the system. Each agent includes its configuration, status, model information, tools, sub-agents, and memory settings. Use this endpoint to discover available agents and their capabilities.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "listAgents";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved list of all registered agents";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agents due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getAgent: {
+        readonly method: "get";
+        readonly path: "/agents/:id";
+        readonly summary: "Get agent by ID";
+        readonly description: "Retrieve detailed information about a specific agent by its ID.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "getAgent";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved agent details";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agent due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly generateText: {
+        readonly method: "post";
+        readonly path: "/agents/:id/text";
+        readonly summary: "Generate text response";
+        readonly description: "Generate a text response from an agent using the provided conversation history. This endpoint processes messages synchronously and returns the complete response once generation is finished. Use this for traditional request-response interactions where you need the full response before proceeding.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "generateText";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully generated text response from the agent";
+                readonly contentType: "application/json";
+            };
+            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 generate text due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamText: {
+        readonly method: "post";
+        readonly path: "/agents/:id/stream";
+        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 raw text 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 text due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    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";
+        readonly summary: "Generate structured object";
+        readonly description: "Generate a structured object that conforms to a specified JSON schema. This endpoint is perfect for extracting structured data from unstructured input, generating form data, or creating API responses with guaranteed structure. The agent will ensure the output matches the provided schema exactly.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "generateObject";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully generated structured object matching the provided schema";
+                readonly contentType: "application/json";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters, message format, or schema";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to generate object due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly streamObject: {
+        readonly method: "post";
+        readonly path: "/agents/:id/stream-object";
+        readonly summary: "Stream structured object generation";
+        readonly description: "Generate a structured object and stream partial updates via Server-Sent Events (SSE). This allows you to display incremental object construction in real-time, useful for complex object generation where you want to show progress. Events may contain partial object updates or the complete final object, depending on the agent's implementation.";
+        readonly tags: readonly ["Agent Generation"];
+        readonly operationId: "streamObject";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully established SSE stream for object generation";
+                readonly contentType: "text/event-stream";
+            };
+            readonly 400: {
+                readonly description: "Invalid request parameters, message format, or schema";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to stream object due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+    readonly getAgentHistory: {
+        readonly method: "get";
+        readonly path: "/agents/:id/history";
+        readonly summary: "Get agent history";
+        readonly description: "Retrieve the execution history for a specific agent with pagination support.";
+        readonly tags: readonly ["Agent Management"];
+        readonly operationId: "getAgentHistory";
+        readonly responses: {
+            readonly 200: {
+                readonly description: "Successfully retrieved agent execution history";
+                readonly contentType: "application/json";
+            };
+            readonly 404: {
+                readonly description: "Agent not found";
+                readonly contentType: "application/json";
+            };
+            readonly 500: {
+                readonly description: "Failed to retrieve agent history due to server error";
+                readonly contentType: "application/json";
+            };
+        };
+    };
+};
+/**
+ * Helper to get all routes as an array
+ */
+declare function getAllRoutesArray(): RouteDefinition[];
+/**
+ * MCP route definitions
+ */
+declare const MCP_ROUTES: {
+    listServers: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    getServer: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    listTools: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    invokeTool: {
+        method: "post";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    setLogLevel: {
+        method: "post";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    listPrompts: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    getPrompt: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            400: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    listResources: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    readResource: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            400: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    listResourceTemplates: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            500: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+};
+declare const A2A_ROUTES: {
+    agentCard: {
+        method: "get";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+            400: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+    jsonRpc: {
+        method: "post";
+        path: string;
+        summary: string;
+        description: string;
+        tags: string[];
+        operationId: string;
+        responses: {
+            200: {
+                description: string;
+                contentType: string;
+            };
+            400: {
+                description: string;
+                contentType: string;
+            };
+            404: {
+                description: string;
+                contentType: string;
+            };
+        };
+    };
+};
+/**
+ * Helper to get routes by tag
+ */
+declare function getRoutesByTag(tag: string): RouteDefinition[];
+
+/**
+ * Framework-agnostic response types for server handlers
+ */
+interface SuccessResponse<T = any> {
+    success: true;
+    data: T;
+}
+interface ErrorResponse {
+    success: false;
+    error: string;
+}
+type ApiResponse<T = any> = SuccessResponse<T> | ErrorResponse;
+type StreamResponse = Response | ReadableStream | ErrorResponse;
+declare function isErrorResponse(response: any): response is ErrorResponse;
+declare function isSuccessResponse<T>(response: any): response is SuccessResponse<T>;
+
+/**
+ * Handler for listing all agents
+ * Returns agent data array
+ */
+declare function handleGetAgents(deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for generating text
+ * Returns generated text data
+ */
+declare function handleGenerateText(agentId: string, body: any, deps: ServerProviderDeps, logger: Logger, signal?: AbortSignal): Promise<ApiResponse>;
+/**
+ * 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 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, 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, signal?: AbortSignal): Promise<Response>;
+
+/**
+ * Handler for getting a single agent by ID
+ * Returns agent data
+ */
+declare function handleGetAgent(agentId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for getting agent history
+ * Returns agent history data
+ */
+declare function handleGetAgentHistory(agentId: string, page: number, limit: number, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+
+/**
+ * Log filter options for querying logs
+ */
+interface LogFilterOptions {
+    limit?: number;
+    level?: LogLevel;
+    agentId?: string;
+    conversationId?: string;
+    workflowId?: string;
+    executionId?: string;
+    since?: string | Date;
+    until?: string | Date;
+}
+interface LogHandlerResponse {
+    logs: LogEntry[];
+    total: number;
+    query: LogFilter;
+}
+/**
+ * Handler for getting logs with filters
+ * Returns filtered log entries
+ */
+declare function handleGetLogs(options: LogFilterOptions, _deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse<LogHandlerResponse>>;
+
+/**
+ * Handler for listing all workflows
+ * Returns workflow list data
+ */
+declare function handleGetWorkflows(deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for getting a single workflow
+ * Returns workflow detail data with inferred schemas
+ */
+declare function handleGetWorkflow(workflowId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for executing a workflow
+ * Returns workflow execution result
+ */
+declare function handleExecuteWorkflow(workflowId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for streaming workflow execution
+ * Returns a ReadableStream for SSE
+ */
+declare function handleStreamWorkflow(workflowId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ReadableStream | ErrorResponse>;
+/**
+ * Handler for suspending a workflow
+ * Returns suspension result
+ */
+declare function handleSuspendWorkflow(executionId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for cancelling a workflow
+ * Returns cancellation result
+ */
+declare function handleCancelWorkflow(executionId: string, body: any, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
+/**
+ * Handler for resuming a workflow
+ * 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>;
+
+type A2AJsonRpcId = string | number | null;
+interface JsonRpcError<Data = unknown> {
+    code: number;
+    message: string;
+    data?: Data;
+}
+interface JsonRpcResponse<Result = unknown, ErrorData = unknown> {
+    jsonrpc: "2.0";
+    id: A2AJsonRpcId;
+    result?: Result;
+    error?: JsonRpcError<ErrorData> | null;
+}
+interface JsonRpcStream<Result = unknown, ErrorData = unknown> {
+    kind: "stream";
+    id: A2AJsonRpcId;
+    stream: AsyncGenerator<JsonRpcResponse<Result, ErrorData>>;
+}
+type JsonRpcHandlerResult<Result = unknown, ErrorData = unknown> = JsonRpcResponse<Result, ErrorData> | JsonRpcStream<Result, ErrorData>;
+interface JsonRpcRequest<Params = unknown> {
+    jsonrpc: "2.0";
+    id: A2AJsonRpcId;
+    method: string;
+    params?: Params;
+}
+interface A2ARequestContext {
+    userId?: string;
+    sessionId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AgentCardSkill {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+}
+interface AgentCardProviderInfo {
+    organization?: string;
+    url?: string;
+}
+interface AgentCardCapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+}
+interface AgentCard {
+    name: string;
+    description?: string;
+    url: string;
+    provider?: AgentCardProviderInfo;
+    version: string;
+    capabilities: AgentCardCapabilities;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: AgentCardSkill[];
+}
+interface A2AServerLikeWithHandlers extends A2AServerLike {
+    getAgentCard?(agentId: string, context?: A2ARequestContext): AgentCard;
+    handleRequest?(agentId: string, request: JsonRpcRequest, context?: A2ARequestContext): Promise<JsonRpcHandlerResult>;
+}
+declare const A2AErrorCode: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly TASK_NOT_FOUND: -32001;
+    readonly TASK_NOT_CANCELABLE: -32002;
+    readonly PUSH_NOTIFICATION_UNSUPPORTED: -32003;
+    readonly UNSUPPORTED_OPERATION: -32004;
+};
+type A2AErrorCode = (typeof A2AErrorCode)[keyof typeof A2AErrorCode];
+declare class VoltA2AError extends Error {
+    code: A2AErrorCode;
+    data?: unknown | undefined;
+    taskId?: string | undefined;
+    constructor(code: A2AErrorCode, message: string, data?: unknown | undefined, taskId?: string | undefined);
+    toJsonRpcError(): JsonRpcError;
+    static parseError(details?: unknown): VoltA2AError;
+    static invalidRequest(message?: string, details?: unknown): VoltA2AError;
+    static methodNotFound(method: string): VoltA2AError;
+    static invalidParams(message?: string, details?: unknown): VoltA2AError;
+    static taskNotFound(taskId: string): VoltA2AError;
+    static taskNotCancelable(taskId: string): VoltA2AError;
+    static unsupportedOperation(message?: string): VoltA2AError;
+    static internal(message?: string, details?: unknown): VoltA2AError;
+}
+declare function normalizeError(id: A2AJsonRpcId, cause: unknown): JsonRpcResponse<never>;
+declare function isJsonRpcRequest(value: unknown): value is JsonRpcRequest;
+
+declare function parseJsonRpcRequest(payload: unknown): JsonRpcRequest;
+declare function resolveAgentCard(registry: A2AServerRegistry<A2AServerLikeWithHandlers>, serverId: string, agentId: string, context?: A2ARequestContext): AgentCard;
+declare function executeA2ARequest(params: {
+    registry: A2AServerRegistry<A2AServerLikeWithHandlers>;
+    serverId: string;
+    request: JsonRpcRequest;
+    context?: A2ARequestContext;
+    logger?: Logger;
+}): Promise<JsonRpcHandlerResult>;
+
+interface LogResponseData {
+    success: true;
+    data: LogEntry[];
+    total: number;
+    query: LogFilter;
+}
+/**
+ * Maps a log handler response to match OpenAPI schema expectations
+ * Extracts nested data properties to root level
+ */
+declare function mapLogResponse(response: ApiResponse<LogHandlerResponse>): LogResponseData | ErrorResponse;
+/**
+ * Maps a generic handler response to framework-specific format
+ * Can be extended for other response types as needed
+ */
+declare function mapHandlerResponse(response: ApiResponse, type?: string): ApiResponse;
+/**
+ * Extracts HTTP status code from response
+ */
+declare function getResponseStatus(response: ApiResponse): number;
+
+export { handleGetWorkflowState as $, type ApiResponse as A, handleGetAgents as B, handleGenerateText as C, handleStreamText as D, type ErrorResponse as E, handleChatStream as F, handleGenerateObject as G, type HttpMethod as H, handleStreamObject as I, type JsonRpcError as J, handleGetAgent as K, LOG_ROUTES as L, MCP_ROUTES as M, handleGetAgentHistory as N, OBSERVABILITY_ROUTES as O, handleGetWorkflows as P, handleGetWorkflow as Q, type ResponseDefinition as R, type SuccessResponse as S, handleExecuteWorkflow as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, handleStreamWorkflow as X, handleSuspendWorkflow as Y, handleCancelWorkflow as Z, handleResumeWorkflow as _, type A2AServerLikeWithHandlers as a, type LogFilterOptions as a0, type LogHandlerResponse as a1, handleGetLogs as a2, mapLogResponse as a3, mapHandlerResponse as a4, getResponseStatus as a5, type OpenApiInfo as a6, type AppSetupConfig as a7, getOrCreateLogger as a8, shouldEnableSwaggerUI as a9, getOpenApiDoc as aa, DEFAULT_CORS_OPTIONS as ab, type StreamResponse as b, isSuccessResponse as c, type RouteDefinition as d, AGENT_ROUTES as e, ALL_ROUTES as f, getAllRoutesArray as g, A2A_ROUTES as h, isErrorResponse as i, getRoutesByTag as j, executeA2ARequest as k, type A2AJsonRpcId as l, type JsonRpcResponse as m, type JsonRpcStream as n, type JsonRpcHandlerResult as o, parseJsonRpcRequest as p, type JsonRpcRequest as q, resolveAgentCard as r, type A2ARequestContext as s, type AgentCardSkill as t, type AgentCardProviderInfo as u, type AgentCardCapabilities as v, type AgentCard as w, A2AErrorCode as x, normalizeError as y, isJsonRpcRequest as z };