@voltagent/server-core 1.0.9 → 1.0.10

package/dist/index.d.mts

@@ -450,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";
@@ -1096,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";
@@ -2467,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;
@@ -2485,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;
@@ -2553,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<{
@@ -2952,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
@@ -3728,4 +3827,4 @@ declare const DEFAULT_CORS_OPTIONS: {
     credentials: boolean;
 };
 
-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, 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, 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 };
+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 };

package/dist/index.d.ts

@@ -450,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";
@@ -1096,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";
@@ -2467,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;
@@ -2485,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;
@@ -2553,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<{
@@ -2952,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
@@ -3728,4 +3827,4 @@ declare const DEFAULT_CORS_OPTIONS: {
     credentials: boolean;
 };
 
-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, 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, 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 };
+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 };

package/dist/index.js

@@ -70,6 +70,8 @@ __export(index_exports, {
   VoltA2AError: () => VoltA2AError,
   WORKFLOW_ROUTES: () => WORKFLOW_ROUTES,
   WebSocketRouter: () => WebSocketRouter,
+  WorkflowCancelRequestSchema: () => WorkflowCancelRequestSchema,
+  WorkflowCancelResponseSchema: () => WorkflowCancelResponseSchema,
   WorkflowExecutionParamsSchema: () => WorkflowExecutionParamsSchema,
   WorkflowExecutionRequestSchema: () => WorkflowExecutionRequestSchema,
   WorkflowExecutionResponseSchema: () => WorkflowExecutionResponseSchema,
@@ -113,6 +115,7 @@ __export(index_exports, {
   getSpanByIdHandler: () => getSpanByIdHandler,
   getTraceByIdHandler: () => getTraceByIdHandler,
   getTracesHandler: () => getTracesHandler,
+  handleCancelWorkflow: () => handleCancelWorkflow,
   handleChatStream: () => handleChatStream,
   handleCheckUpdates: () => handleCheckUpdates,
   handleExecuteWorkflow: () => handleExecuteWorkflow,
@@ -366,7 +369,7 @@ var WorkflowStreamEventSchema = import_zod.z.object({
   from: import_zod.z.string().describe("Source of the event"),
   input: import_zod.z.any().optional(),
   output: import_zod.z.any().optional(),
-  status: import_zod.z.enum(["pending", "running", "success", "error", "suspended"]),
+  status: import_zod.z.enum(["pending", "running", "success", "error", "suspended", "cancelled"]),
   timestamp: import_zod.z.string(),
   stepIndex: import_zod.z.number().optional(),
   metadata: import_zod.z.record(import_zod.z.any()).optional(),
@@ -386,6 +389,18 @@ var WorkflowSuspendResponseSchema = import_zod.z.object({
     })
   }).describe("Workflow suspension result")
 });
+var WorkflowCancelRequestSchema = import_zod.z.object({
+  reason: import_zod.z.string().optional().describe("Reason for cancellation")
+});
+var WorkflowCancelResponseSchema = import_zod.z.object({
+  success: import_zod.z.literal(true),
+  data: import_zod.z.object({
+    executionId: import_zod.z.string(),
+    status: import_zod.z.literal("cancelled"),
+    cancelledAt: import_zod.z.string(),
+    reason: import_zod.z.string().optional()
+  }).describe("Workflow cancellation result")
+});
 var WorkflowResumeRequestSchema = import_zod.z.object({
   resumeData: import_zod.z.any().optional().describe("Data to pass to the resumed step (validated against step's resumeSchema)"),
   options: import_zod.z.object({
@@ -717,6 +732,32 @@ var WORKFLOW_ROUTES = {
       }
     }
   },
+  cancelWorkflow: {
+    method: "post",
+    path: "/workflows/:id/executions/:executionId/cancel",
+    summary: "Cancel workflow execution",
+    description: "Cancel a running workflow execution immediately. The workflow stops execution and the state is marked as cancelled. Cancelled workflows cannot be resumed.",
+    tags: ["Workflow Management"],
+    operationId: "cancelWorkflow",
+    responses: {
+      200: {
+        description: "Successfully cancelled workflow execution",
+        contentType: "application/json"
+      },
+      404: {
+        description: "Workflow or execution not found",
+        contentType: "application/json"
+      },
+      409: {
+        description: "Workflow execution already completed or not cancellable",
+        contentType: "application/json"
+      },
+      500: {
+        description: "Failed to cancel workflow due to server error",
+        contentType: "application/json"
+      }
+    }
+  },
   resumeWorkflow: {
     method: "post",
     path: "/workflows/:id/executions/:executionId/resume",
@@ -2356,7 +2397,7 @@ async function handleSuspendWorkflow(executionId, body, deps, logger) {
     if (!suspendController) {
       return {
         success: false,
-        error: "No active execution found or workflow already completed"
+        error: "Workflow execution not found or already completed"
       };
     }
     suspendController.suspend(reason || "API request");
@@ -2382,6 +2423,55 @@ async function handleSuspendWorkflow(executionId, body, deps, logger) {
   }
 }
 __name(handleSuspendWorkflow, "handleSuspendWorkflow");
+async function handleCancelWorkflow(executionId, body, deps, logger) {
+  try {
+    const { reason } = body || {};
+    if (!deps.workflowRegistry.activeExecutions) {
+      return {
+        success: false,
+        error: "Workflow cancellation not supported"
+      };
+    }
+    const suspendController = deps.workflowRegistry.activeExecutions.get(executionId);
+    if (!suspendController) {
+      return {
+        success: false,
+        error: "No active execution found or workflow already completed"
+      };
+    }
+    if (suspendController.isCancelled?.()) {
+      return {
+        success: true,
+        data: {
+          executionId,
+          status: "cancelled",
+          cancelledAt: (/* @__PURE__ */ new Date()).toISOString(),
+          reason: suspendController.getCancelReason?.()
+        }
+      };
+    }
+    const cancellationReason = reason || "API request";
+    suspendController.cancel(cancellationReason);
+    deps.workflowRegistry.activeExecutions.delete(executionId);
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    return {
+      success: true,
+      data: {
+        executionId,
+        status: "cancelled",
+        cancelledAt: (/* @__PURE__ */ new Date()).toISOString(),
+        reason: cancellationReason
+      }
+    };
+  } catch (error) {
+    logger.error("Failed to cancel workflow", { error });
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Failed to cancel workflow"
+    };
+  }
+}
+__name(handleCancelWorkflow, "handleCancelWorkflow");
 async function handleResumeWorkflow(workflowId, executionId, body, deps, logger) {
   try {
     const { resumeData, options } = body || {};
@@ -4186,6 +4276,8 @@ var DEFAULT_CORS_OPTIONS = {
   VoltA2AError,
   WORKFLOW_ROUTES,
   WebSocketRouter,
+  WorkflowCancelRequestSchema,
+  WorkflowCancelResponseSchema,
   WorkflowExecutionParamsSchema,
   WorkflowExecutionRequestSchema,
   WorkflowExecutionResponseSchema,
@@ -4229,6 +4321,7 @@ var DEFAULT_CORS_OPTIONS = {
   getSpanByIdHandler,
   getTraceByIdHandler,
   getTracesHandler,
+  handleCancelWorkflow,
   handleChatStream,
   handleCheckUpdates,
   handleExecuteWorkflow,