@voltagent/server-core 1.0.8 → 1.0.10

package/dist/index.d.mts

@@ -1,6 +1,10 @@
 import { LogFilter, Logger, LogLevel, LogEntry } from '@voltagent/internal';
 import { z } from 'zod';
-import { ServerProviderDeps, IServerProvider } from '@voltagent/core';
+import { MCPServerRegistry, A2AServerRegistry, ServerProviderDeps, IServerProvider } from '@voltagent/core';
+import { Tool, CallToolResult, Prompt, GetPromptRequest, GetPromptResult, Resource, ResourceContents, ResourceTemplate } from '@modelcontextprotocol/sdk/types.js';
+export { CallToolResult, GetPromptRequest, GetPromptResult, Prompt, Resource, ResourceContents, ResourceTemplate } from '@modelcontextprotocol/sdk/types.js';
+import { MCPServerLike as MCPServerLike$1, MCPServerDeps, MCPServerMetadata as MCPServerMetadata$1 } from '@voltagent/internal/mcp';
+import { A2AServerLike, A2AServerMetadata } from '@voltagent/internal/a2a';
 import jwt from 'jsonwebtoken';
 import { IncomingMessage, Server } from 'node:http';
 import { Socket } from 'node:net';
@@ -35,13 +39,15 @@ interface PortConfig {
 /**
  * Options for server startup display
  */
+interface ServerEndpointSummary {
+    path: string;
+    method: string;
+    description?: string;
+    group?: string;
+}
 interface ServerStartupOptions {
     enableSwaggerUI?: boolean;
-    customEndpoints?: Array<{
-        path: string;
-        method: string;
-        description?: string;
-    }>;
+    customEndpoints?: ServerEndpointSummary[];
 }
 /**
  * Common server configuration that all implementations should support
@@ -444,6 +450,32 @@ declare const WORKFLOW_ROUTES: {
             };
         };
     };
+    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";
@@ -1090,6 +1122,32 @@ declare const ALL_ROUTES: {
             };
         };
     };
+    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";
@@ -1335,6 +1393,277 @@ declare const ALL_ROUTES: {
  * 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
  */
@@ -2190,14 +2519,14 @@ declare const WorkflowStreamEventSchema: z.ZodObject<{
     from: z.ZodString;
     input: z.ZodOptional<z.ZodAny>;
     output: z.ZodOptional<z.ZodAny>;
-    status: z.ZodEnum<["pending", "running", "success", "error", "suspended"]>;
+    status: z.ZodEnum<["pending", "running", "success", "error", "suspended", "cancelled"]>;
     timestamp: z.ZodString;
     stepIndex: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     error: z.ZodOptional<z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
     type: string;
-    status: "success" | "error" | "running" | "pending" | "suspended";
+    status: "success" | "error" | "running" | "pending" | "suspended" | "cancelled";
     executionId: string;
     timestamp: string;
     from: string;
@@ -2208,7 +2537,7 @@ declare const WorkflowStreamEventSchema: z.ZodObject<{
     metadata?: Record<string, any> | undefined;
 }, {
     type: string;
-    status: "success" | "error" | "running" | "pending" | "suspended";
+    status: "success" | "error" | "running" | "pending" | "suspended" | "cancelled";
     executionId: string;
     timestamp: string;
     from: string;
@@ -2276,6 +2605,48 @@ declare const WorkflowSuspendResponseSchema: z.ZodObject<{
         };
     };
 }>;
+declare const WorkflowCancelRequestSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reason?: string | undefined;
+}, {
+    reason?: string | undefined;
+}>;
+declare const WorkflowCancelResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        executionId: z.ZodString;
+        status: z.ZodLiteral<"cancelled">;
+        cancelledAt: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "cancelled";
+        executionId: string;
+        cancelledAt: string;
+        reason?: string | undefined;
+    }, {
+        status: "cancelled";
+        executionId: string;
+        cancelledAt: string;
+        reason?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        status: "cancelled";
+        executionId: string;
+        cancelledAt: string;
+        reason?: string | undefined;
+    };
+}, {
+    success: true;
+    data: {
+        status: "cancelled";
+        executionId: string;
+        cancelledAt: string;
+        reason?: string | undefined;
+    };
+}>;
 declare const WorkflowResumeRequestSchema: z.ZodOptional<z.ZodObject<{
     resumeData: z.ZodOptional<z.ZodAny>;
     options: z.ZodOptional<z.ZodObject<{
@@ -2337,6 +2708,277 @@ declare const WorkflowResumeResponseSchema: z.ZodObject<{
     };
 }>;
 
+declare const DEFAULT_MCP_ROUTE_PREFIX: "/mcp";
+declare const DEFAULT_MCP_SSE_SEGMENT: "sse";
+declare const DEFAULT_MCP_MESSAGES_SEGMENT: "messages";
+declare const DEFAULT_MCP_HTTP_SEGMENT: "mcp";
+declare const MCP_SESSION_QUERY_PARAM: "sessionId";
+
+interface McpRouteOptions {
+    basePath?: string;
+    httpSegment?: string;
+    sseSegment?: string;
+    messageSegment?: string;
+}
+interface McpRoutePaths {
+    basePath: string;
+    httpPath: string;
+    ssePath: string;
+    messagePath: string;
+}
+declare function buildMcpRoutePaths(serverId: string, options?: McpRouteOptions): McpRoutePaths;
+
+interface FilterContext {
+    transport: "stdio" | "sse" | "http";
+    sessionId?: string;
+    userRole?: string;
+    metadata?: Record<string, unknown>;
+}
+interface MCPAgentMetadata {
+    id: string;
+    name: string;
+    description?: string;
+    purpose?: string;
+    instructions?: string;
+}
+interface MCPToolMetadata {
+    id?: string;
+    name: string;
+    description?: string;
+}
+interface MCPWorkflowSummary {
+    id: string;
+    name: string;
+    purpose?: string;
+    metadata?: Record<string, unknown>;
+}
+interface MCPServerPackageInfo {
+    name: string;
+    version: string;
+    description?: string;
+    installCommand?: string[];
+    homepage?: string;
+}
+interface MCPServerRemoteInfo {
+    environment: string;
+    url: string;
+    headers?: Record<string, string>;
+    description?: string;
+}
+interface ProtocolConfig {
+    stdio?: boolean;
+    sse?: boolean;
+    http?: boolean;
+    [key: string]: unknown;
+}
+type ProtocolRecord = ProtocolConfig & Record<string, unknown>;
+interface MCPServerCapabilitiesConfig {
+    logging?: boolean;
+    prompts?: boolean;
+    resources?: boolean;
+    elicitation?: boolean;
+    [key: string]: unknown;
+}
+type CapabilityRecord = MCPServerCapabilitiesConfig & Record<string, unknown>;
+interface MCPServerMetadata extends MCPServerMetadata$1 {
+    protocols?: ProtocolRecord;
+    capabilities?: CapabilityRecord;
+    agents?: MCPAgentMetadata[];
+    workflows?: MCPWorkflowSummary[];
+    tools?: MCPToolMetadata[];
+    releaseDate?: string;
+    packages?: MCPServerPackageInfo[];
+    remotes?: MCPServerRemoteInfo[];
+}
+type MCPToolOrigin = "tool" | "agent" | "workflow";
+interface MCPListedTool {
+    name: string;
+    type: MCPToolOrigin;
+    definition: Tool;
+}
+interface MCPServerLike extends MCPServerLike$1 {
+    initialize(deps: MCPServerDeps): void;
+    listTools?(contextOverrides?: Partial<Omit<FilterContext, "transport">>): MCPListedTool[];
+    executeTool?(name: string, args: unknown, contextOverrides?: Partial<Omit<FilterContext, "transport">>): Promise<CallToolResult>;
+    setLogLevel?(level: string): Promise<void> | void;
+    listPrompts?(): Promise<Prompt[]>;
+    getPrompt?(params: GetPromptRequest["params"]): Promise<GetPromptResult>;
+    listResources?(): Promise<Resource[]>;
+    readResource?(uri: string): Promise<ResourceContents | ResourceContents[]>;
+    listResourceTemplates?(): Promise<ResourceTemplate[]>;
+}
+
+interface McpServerLookupResult {
+    server?: MCPServerLike;
+    metadata?: MCPServerMetadata;
+}
+declare function listMcpServers(registry: MCPServerRegistry): MCPServerMetadata[];
+declare function lookupMcpServer(registry: MCPServerRegistry, serverId: string): McpServerLookupResult;
+
+declare class McpSessionStore<T> {
+    private readonly sessions;
+    set(sessionId: string, value: T): void;
+    get(sessionId: string): T | undefined;
+    delete(sessionId: string): void;
+    has(sessionId: string): boolean;
+    ids(): string[];
+    values(): T[];
+    clear(): void;
+}
+
+interface McpServerListResponse {
+    servers: MCPServerMetadata[];
+}
+interface McpServerDetailResponse extends MCPServerMetadata {
+}
+interface McpToolListResponse {
+    server: MCPServerMetadata;
+    tools: MCPListedTool[];
+}
+interface McpInvokeToolRequest {
+    arguments?: unknown;
+    context?: Partial<Omit<FilterContext, "transport">>;
+}
+type McpInvokeToolResponse = CallToolResult;
+interface McpSetLogLevelRequest {
+    level: string;
+}
+type McpSetLogLevelResponse = {
+    success: true;
+};
+interface McpPromptListResponse {
+    prompts: Prompt[];
+}
+type McpPromptDetailResponse = GetPromptResult;
+interface McpResourceListResponse {
+    resources: Resource[];
+}
+type McpResourceDetailResponse = ResourceContents | ResourceContents[];
+interface McpResourceTemplateListResponse {
+    resourceTemplates: ResourceTemplate[];
+}
+declare function handleListMcpServers(registry: MCPServerRegistry): ApiResponse<McpServerListResponse>;
+declare function handleGetMcpServer(registry: MCPServerRegistry, serverId: string): ApiResponse<McpServerDetailResponse>;
+declare function handleListMcpServerTools(registry: MCPServerRegistry, logger: Logger, serverId: string): ApiResponse<McpToolListResponse>;
+declare function handleInvokeMcpServerTool(registry: MCPServerRegistry, logger: Logger, serverId: string, toolName: string, request: McpInvokeToolRequest): Promise<ApiResponse<McpInvokeToolResponse>>;
+declare function handleSetMcpLogLevel(registry: MCPServerRegistry, logger: Logger, serverId: string, request: McpSetLogLevelRequest): Promise<ApiResponse<McpSetLogLevelResponse>>;
+declare function handleListMcpPrompts(registry: MCPServerRegistry, logger: Logger, serverId: string): Promise<ApiResponse<McpPromptListResponse>>;
+declare function handleGetMcpPrompt(registry: MCPServerRegistry, logger: Logger, serverId: string, params: GetPromptRequest["params"]): Promise<ApiResponse<McpPromptDetailResponse>>;
+declare function handleListMcpResources(registry: MCPServerRegistry, logger: Logger, serverId: string): Promise<ApiResponse<McpResourceListResponse>>;
+declare function handleGetMcpResource(registry: MCPServerRegistry, logger: Logger, serverId: string, uri: string): Promise<ApiResponse<McpResourceDetailResponse>>;
+declare function handleListMcpResourceTemplates(registry: MCPServerRegistry, logger: Logger, serverId: string): Promise<ApiResponse<McpResourceTemplateListResponse>>;
+
+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;
+
+interface A2AServerLookupResult {
+    server?: A2AServerLikeWithHandlers;
+    metadata?: A2AServerMetadata;
+}
+declare function listA2AServers(registry: A2AServerRegistry<A2AServerLikeWithHandlers>): A2AServerMetadata[];
+declare function lookupA2AServer(registry: A2AServerRegistry<A2AServerLikeWithHandlers>, serverId: string): A2AServerLookupResult;
+
+declare const DEFAULT_A2A_ROUTE_PREFIX: "/a2a";
+declare const DEFAULT_A2A_WELL_KNOWN_PREFIX: "/.well-known";
+declare function buildAgentCardPath(agentId: string): string;
+declare function buildA2AEndpointPath(serverId: string): string;
+
+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>;
+
 /**
  * Handler for listing all agents
  * Returns agent data array
@@ -2404,6 +3046,11 @@ declare function handleStreamWorkflow(workflowId: string, body: any, deps: Serve
  * 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
@@ -2773,6 +3420,7 @@ declare const portManager: PortManager;
 /**
  * Shared server utilities for all server implementations
  */
+
 declare const colors: {
     reset: string;
     bright: string;
@@ -2805,13 +3453,7 @@ declare const preferredPorts: {
 /**
  * Print server startup message with formatted console output
  */
-declare function printServerStartup(port: number, options?: {
-    enableSwaggerUI?: boolean;
-    customEndpoints?: Array<{
-        path: string;
-        method: string;
-    }>;
-}): void;
+declare function printServerStartup(port: number, options?: ServerStartupOptions): void;
 /**
  * Get all ports to try in order
  */
@@ -3106,6 +3748,7 @@ declare abstract class BaseServerProvider implements IServerProvider {
      * Handle graceful shutdown
      */
     protected setupGracefulShutdown(): void;
+    private collectFeatureEndpoints;
 }
 
 /**
@@ -3184,4 +3827,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, 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 };
+export { A2AErrorCode, type A2AJsonRpcId, type A2ARequestContext, type A2AServerLikeWithHandlers, type A2AServerLookupResult, A2A_ROUTES, AGENT_ROUTES, ALL_ROUTES, type AgentCard, type AgentCardCapabilities, type AgentCardProviderInfo, type AgentCardSkill, AgentListSchema, AgentParamsSchema, AgentResponseSchema, type ApiResponse, type AppSetupConfig, type AuthFrameworkAdapter, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, type CapabilityRecord, CustomEndpointError, type CustomEndpointHandler, DEFAULT_A2A_ROUTE_PREFIX, DEFAULT_A2A_WELL_KNOWN_PREFIX, DEFAULT_CORS_OPTIONS, DEFAULT_MCP_HTTP_SEGMENT, DEFAULT_MCP_MESSAGES_SEGMENT, DEFAULT_MCP_ROUTE_PREFIX, DEFAULT_MCP_SSE_SEGMENT, DEFAULT_PUBLIC_ROUTES, type ErrorResponse, ErrorSchema, type FilterContext, GenerateOptionsSchema, type HttpMethod, type IWebSocket, type JWTAuthOptions, type JsonRpcError, type JsonRpcHandlerResult, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcStream, LOG_ROUTES, type LogFilterOptions, type LogHandlerResponse, type LogStreamClient, LogStreamManager, type MCPAgentMetadata, type MCPListedTool, type MCPServerCapabilitiesConfig, type MCPServerLike, type MCPServerMetadata, type MCPServerPackageInfo, type MCPServerRemoteInfo, type MCPToolMetadata, type MCPToolOrigin, type MCPWorkflowSummary, MCP_ROUTES, MCP_SESSION_QUERY_PARAM, type McpInvokeToolRequest, type McpInvokeToolResponse, type McpPromptDetailResponse, type McpPromptListResponse, type McpResourceDetailResponse, type McpResourceListResponse, type McpResourceTemplateListResponse, type McpRouteOptions, type McpRoutePaths, type McpServerDetailResponse, type McpServerListResponse, type McpServerLookupResult, McpSessionStore, type McpSetLogLevelRequest, type McpSetLogLevelResponse, type McpToolListResponse, OBSERVABILITY_ROUTES, ObjectRequestSchema, ObjectResponseSchema, type OpenApiInfo, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ProtocolConfig, type ProtocolRecord, type ResponseDefinition, type RouteDefinition, type ServerEndpointSummary, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, type StreamResponse, StreamTextEventSchema, SubAgentResponseSchema, type SuccessResponse, TextRequestSchema, TextResponseSchema, UPDATE_ROUTES, VoltA2AError, WORKFLOW_ROUTES, type WebSocketAdapter, type WebSocketConnectionHandler, type WebSocketConnectionInfo, type WebSocketEventHandlers, type WebSocketMessage, WebSocketRouter, WorkflowCancelRequestSchema, WorkflowCancelResponseSchema, WorkflowExecutionParamsSchema, WorkflowExecutionRequestSchema, WorkflowExecutionResponseSchema, WorkflowListSchema, WorkflowParamsSchema, WorkflowResponseSchema, WorkflowResumeRequestSchema, WorkflowResumeResponseSchema, WorkflowStreamEventSchema, WorkflowSuspendRequestSchema, WorkflowSuspendResponseSchema, buildA2AEndpointPath, buildAgentCardPath, buildMcpRoutePaths, cleanupWebSockets, closeAllObservabilityConnections, colors, createAuthErrorResponse, createAuthMiddlewareFactory, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, executeA2ARequest, extractBearerToken, extractToken, formatSSE, getAllRoutesArray, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getOpenApiDoc, getOrCreateLogger, getPortsToTry, getResponseStatus, getRoutesByTag, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleCancelWorkflow, handleChatStream, handleCheckUpdates, handleExecuteWorkflow, handleGenerateObject, handleGenerateText, handleGetAgent, handleGetAgentHistory, handleGetAgents, handleGetLogs, handleGetMcpPrompt, handleGetMcpResource, handleGetMcpServer, handleGetWorkflow, handleGetWorkflowState, handleGetWorkflows, handleInstallUpdates, handleInvokeMcpServerTool, handleListMcpPrompts, handleListMcpResourceTemplates, handleListMcpResources, handleListMcpServerTools, handleListMcpServers, handleObservabilityConnection, handleResumeWorkflow, handleSetMcpLogLevel, handleStreamObject, handleStreamText, handleStreamWorkflow, handleSuspendWorkflow, handleWebSocketConnection, injectUserIntoBody, isErrorResponse, isJsonRpcRequest, isSuccessResponse, jwtAuth, listA2AServers, listMcpServers, lookupA2AServer, lookupMcpServer, mapHandlerResponse, mapLogResponse, normalizeError, parseJsonRpcRequest, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, resolveAgentCard, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, shouldEnableSwaggerUI, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };