@voltagent/server-core 1.0.24 → 1.0.25

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { H as HttpMethod, A as ApiResponse, a as A2AServerLikeWithHandlers } fro
 export { P as A2AErrorCode, y as A2AJsonRpcId, F as A2ARequestContext, t as A2A_ROUTES, o as AGENT_ROUTES, q as ALL_ROUTES, N as AgentCard, K as AgentCardCapabilities, I as AgentCardProviderInfo, G as AgentCardSkill, an as AppSetupConfig, ar as DEFAULT_CORS_OPTIONS, E as ErrorResponse, J as JsonRpcError, C as JsonRpcHandlerResult, D as JsonRpcRequest, z as JsonRpcResponse, B as JsonRpcStream, L as LOG_ROUTES, ab as LogFilterOptions, ac as LogHandlerResponse, s as MCP_ROUTES, f as MemoryConversationMessagesResult, g as MemoryConversationStepsResult, e as MemoryConversationSummary, l as MemoryGetMessagesQuery, m as MemoryGetStepsQuery, k as MemoryListConversationsQuery, j as MemoryListUsersQuery, d as MemoryUserAgentSummary, M as MemoryUserSummary, h as MemoryWorkingMemoryResult, p as OBSERVABILITY_MEMORY_ROUTES, O as OBSERVABILITY_ROUTES, am as OpenApiInfo, R as ResponseDefinition, n as RouteDefinition, b as StreamResponse, S as SuccessResponse, U as UPDATE_ROUTES, V as VoltA2AError, W as WORKFLOW_ROUTES, x as executeA2ARequest, r as getAllRoutesArray, ag as getConversationMessagesHandler, ah as getConversationStepsHandler, aq as getOpenApiDoc, ao as getOrCreateLogger, al as getResponseStatus, u as getRoutesByTag, ai as getWorkingMemoryHandler, a8 as handleCancelWorkflow, _ as handleChatStream, a5 as handleExecuteWorkflow, $ as handleGenerateObject, Y as handleGenerateText, a1 as handleGetAgent, a2 as handleGetAgentHistory, X as handleGetAgents, ad as handleGetLogs, a4 as handleGetWorkflow, aa as handleGetWorkflowState, a3 as handleGetWorkflows, a9 as handleResumeWorkflow, a0 as handleStreamObject, Z as handleStreamText, a6 as handleStreamWorkflow, a7 as handleSuspendWorkflow, i as isErrorResponse, T as isJsonRpcRequest, c as isSuccessResponse, af as listMemoryConversationsHandler, ae as listMemoryUsersHandler, ak as mapHandlerResponse, aj as mapLogResponse, Q as normalizeError, v as parseJsonRpcRequest, w as resolveAgentCard, ap as shouldEnableSwaggerUI } from './edge-CtOnFGMl.mjs';
 import { LogFilter, Logger } from '@voltagent/internal';
 import { z } from 'zod';
-import { MCPServerRegistry, A2AServerRegistry, ServerProviderDeps, IServerProvider } from '@voltagent/core';
+import { MCPServerRegistry, A2AServerRegistry, ServerProviderDeps, RegisteredTrigger, 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';
@@ -31,6 +31,7 @@ interface ServerEndpointSummary {
     method: string;
     description?: string;
     group?: string;
+    name?: string;
 }
 interface ServerStartupOptions {
     enableSwaggerUI?: boolean;
@@ -1702,6 +1703,19 @@ declare function getLogsBySpanIdHandler(spanId: string, deps: ServerProviderDeps
  */
 declare function queryLogsHandler(query: any, deps: ServerProviderDeps): Promise<any>;
 
+interface TriggerHttpRequestContext {
+    body: unknown;
+    headers: Record<string, string>;
+    query?: Record<string, string | string[]>;
+    raw?: unknown;
+}
+interface TriggerHandlerHttpResponse {
+    status: number;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+declare function executeTriggerHandler(registration: RegisteredTrigger, request: TriggerHttpRequestContext, deps: ServerProviderDeps, logger: Logger): Promise<TriggerHandlerHttpResponse>;
+
 declare function setupObservabilityHandler(body: {
     publicKey?: string;
     secretKey?: string;
@@ -2267,4 +2281,4 @@ declare abstract class BaseServerProvider implements IServerProvider {
     private collectFeatureEndpoints;
 }
 
-export { A2AServerLikeWithHandlers, type A2AServerLookupResult, AgentListSchema, AgentParamsSchema, AgentResponseSchema, ApiResponse, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, type CapabilityRecord, CustomEndpointError, type CustomEndpointHandler, DEFAULT_A2A_ROUTE_PREFIX, DEFAULT_A2A_WELL_KNOWN_PREFIX, DEFAULT_MCP_HTTP_SEGMENT, DEFAULT_MCP_MESSAGES_SEGMENT, DEFAULT_MCP_ROUTE_PREFIX, DEFAULT_MCP_SSE_SEGMENT, DEFAULT_PUBLIC_ROUTES, ErrorSchema, type FilterContext, GenerateOptionsSchema, HttpMethod, type IWebSocket, type JWTAuthOptions, type LogStreamClient, LogStreamManager, type MCPAgentMetadata, type MCPListedTool, type MCPServerCapabilitiesConfig, type MCPServerLike, type MCPServerMetadata, type MCPServerPackageInfo, type MCPServerRemoteInfo, type MCPToolMetadata, type MCPToolOrigin, type MCPWorkflowSummary, 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, ObjectRequestSchema, ObjectResponseSchema, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ProtocolConfig, type ProtocolRecord, type ServerEndpointSummary, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, StreamTextEventSchema, SubAgentResponseSchema, TextRequestSchema, TextResponseSchema, 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, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, extractBearerToken, extractToken, formatSSE, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getPortsToTry, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleCheckUpdates, handleGetMcpPrompt, handleGetMcpResource, handleGetMcpServer, handleInstallUpdates, handleInvokeMcpServerTool, handleListMcpPrompts, handleListMcpResourceTemplates, handleListMcpResources, handleListMcpServerTools, handleListMcpServers, handleObservabilityConnection, handleSetMcpLogLevel, handleWebSocketConnection, injectUserIntoBody, jwtAuth, listA2AServers, listMcpServers, lookupA2AServer, lookupMcpServer, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };
+export { A2AServerLikeWithHandlers, type A2AServerLookupResult, AgentListSchema, AgentParamsSchema, AgentResponseSchema, ApiResponse, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, type CapabilityRecord, CustomEndpointError, type CustomEndpointHandler, DEFAULT_A2A_ROUTE_PREFIX, DEFAULT_A2A_WELL_KNOWN_PREFIX, DEFAULT_MCP_HTTP_SEGMENT, DEFAULT_MCP_MESSAGES_SEGMENT, DEFAULT_MCP_ROUTE_PREFIX, DEFAULT_MCP_SSE_SEGMENT, DEFAULT_PUBLIC_ROUTES, ErrorSchema, type FilterContext, GenerateOptionsSchema, HttpMethod, type IWebSocket, type JWTAuthOptions, type LogStreamClient, LogStreamManager, type MCPAgentMetadata, type MCPListedTool, type MCPServerCapabilitiesConfig, type MCPServerLike, type MCPServerMetadata, type MCPServerPackageInfo, type MCPServerRemoteInfo, type MCPToolMetadata, type MCPToolOrigin, type MCPWorkflowSummary, 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, ObjectRequestSchema, ObjectResponseSchema, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ProtocolConfig, type ProtocolRecord, type ServerEndpointSummary, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, StreamTextEventSchema, SubAgentResponseSchema, TextRequestSchema, TextResponseSchema, type TriggerHandlerHttpResponse, type TriggerHttpRequestContext, 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, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, executeTriggerHandler, extractBearerToken, extractToken, formatSSE, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getPortsToTry, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleCheckUpdates, handleGetMcpPrompt, handleGetMcpResource, handleGetMcpServer, handleInstallUpdates, handleInvokeMcpServerTool, handleListMcpPrompts, handleListMcpResourceTemplates, handleListMcpResources, handleListMcpServerTools, handleListMcpServers, handleObservabilityConnection, handleSetMcpLogLevel, handleWebSocketConnection, injectUserIntoBody, jwtAuth, listA2AServers, listMcpServers, lookupA2AServer, lookupMcpServer, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { H as HttpMethod, A as ApiResponse, a as A2AServerLikeWithHandlers } fro
 export { P as A2AErrorCode, y as A2AJsonRpcId, F as A2ARequestContext, t as A2A_ROUTES, o as AGENT_ROUTES, q as ALL_ROUTES, N as AgentCard, K as AgentCardCapabilities, I as AgentCardProviderInfo, G as AgentCardSkill, an as AppSetupConfig, ar as DEFAULT_CORS_OPTIONS, E as ErrorResponse, J as JsonRpcError, C as JsonRpcHandlerResult, D as JsonRpcRequest, z as JsonRpcResponse, B as JsonRpcStream, L as LOG_ROUTES, ab as LogFilterOptions, ac as LogHandlerResponse, s as MCP_ROUTES, f as MemoryConversationMessagesResult, g as MemoryConversationStepsResult, e as MemoryConversationSummary, l as MemoryGetMessagesQuery, m as MemoryGetStepsQuery, k as MemoryListConversationsQuery, j as MemoryListUsersQuery, d as MemoryUserAgentSummary, M as MemoryUserSummary, h as MemoryWorkingMemoryResult, p as OBSERVABILITY_MEMORY_ROUTES, O as OBSERVABILITY_ROUTES, am as OpenApiInfo, R as ResponseDefinition, n as RouteDefinition, b as StreamResponse, S as SuccessResponse, U as UPDATE_ROUTES, V as VoltA2AError, W as WORKFLOW_ROUTES, x as executeA2ARequest, r as getAllRoutesArray, ag as getConversationMessagesHandler, ah as getConversationStepsHandler, aq as getOpenApiDoc, ao as getOrCreateLogger, al as getResponseStatus, u as getRoutesByTag, ai as getWorkingMemoryHandler, a8 as handleCancelWorkflow, _ as handleChatStream, a5 as handleExecuteWorkflow, $ as handleGenerateObject, Y as handleGenerateText, a1 as handleGetAgent, a2 as handleGetAgentHistory, X as handleGetAgents, ad as handleGetLogs, a4 as handleGetWorkflow, aa as handleGetWorkflowState, a3 as handleGetWorkflows, a9 as handleResumeWorkflow, a0 as handleStreamObject, Z as handleStreamText, a6 as handleStreamWorkflow, a7 as handleSuspendWorkflow, i as isErrorResponse, T as isJsonRpcRequest, c as isSuccessResponse, af as listMemoryConversationsHandler, ae as listMemoryUsersHandler, ak as mapHandlerResponse, aj as mapLogResponse, Q as normalizeError, v as parseJsonRpcRequest, w as resolveAgentCard, ap as shouldEnableSwaggerUI } from './edge-CtOnFGMl.js';
 import { LogFilter, Logger } from '@voltagent/internal';
 import { z } from 'zod';
-import { MCPServerRegistry, A2AServerRegistry, ServerProviderDeps, IServerProvider } from '@voltagent/core';
+import { MCPServerRegistry, A2AServerRegistry, ServerProviderDeps, RegisteredTrigger, 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';
@@ -31,6 +31,7 @@ interface ServerEndpointSummary {
     method: string;
     description?: string;
     group?: string;
+    name?: string;
 }
 interface ServerStartupOptions {
     enableSwaggerUI?: boolean;
@@ -1702,6 +1703,19 @@ declare function getLogsBySpanIdHandler(spanId: string, deps: ServerProviderDeps
  */
 declare function queryLogsHandler(query: any, deps: ServerProviderDeps): Promise<any>;
 
+interface TriggerHttpRequestContext {
+    body: unknown;
+    headers: Record<string, string>;
+    query?: Record<string, string | string[]>;
+    raw?: unknown;
+}
+interface TriggerHandlerHttpResponse {
+    status: number;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+declare function executeTriggerHandler(registration: RegisteredTrigger, request: TriggerHttpRequestContext, deps: ServerProviderDeps, logger: Logger): Promise<TriggerHandlerHttpResponse>;
+
 declare function setupObservabilityHandler(body: {
     publicKey?: string;
     secretKey?: string;
@@ -2267,4 +2281,4 @@ declare abstract class BaseServerProvider implements IServerProvider {
     private collectFeatureEndpoints;
 }
 
-export { A2AServerLikeWithHandlers, type A2AServerLookupResult, AgentListSchema, AgentParamsSchema, AgentResponseSchema, ApiResponse, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, type CapabilityRecord, CustomEndpointError, type CustomEndpointHandler, DEFAULT_A2A_ROUTE_PREFIX, DEFAULT_A2A_WELL_KNOWN_PREFIX, DEFAULT_MCP_HTTP_SEGMENT, DEFAULT_MCP_MESSAGES_SEGMENT, DEFAULT_MCP_ROUTE_PREFIX, DEFAULT_MCP_SSE_SEGMENT, DEFAULT_PUBLIC_ROUTES, ErrorSchema, type FilterContext, GenerateOptionsSchema, HttpMethod, type IWebSocket, type JWTAuthOptions, type LogStreamClient, LogStreamManager, type MCPAgentMetadata, type MCPListedTool, type MCPServerCapabilitiesConfig, type MCPServerLike, type MCPServerMetadata, type MCPServerPackageInfo, type MCPServerRemoteInfo, type MCPToolMetadata, type MCPToolOrigin, type MCPWorkflowSummary, 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, ObjectRequestSchema, ObjectResponseSchema, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ProtocolConfig, type ProtocolRecord, type ServerEndpointSummary, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, StreamTextEventSchema, SubAgentResponseSchema, TextRequestSchema, TextResponseSchema, 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, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, extractBearerToken, extractToken, formatSSE, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getPortsToTry, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleCheckUpdates, handleGetMcpPrompt, handleGetMcpResource, handleGetMcpServer, handleInstallUpdates, handleInvokeMcpServerTool, handleListMcpPrompts, handleListMcpResourceTemplates, handleListMcpResources, handleListMcpServerTools, handleListMcpServers, handleObservabilityConnection, handleSetMcpLogLevel, handleWebSocketConnection, injectUserIntoBody, jwtAuth, listA2AServers, listMcpServers, lookupA2AServer, lookupMcpServer, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };
+export { A2AServerLikeWithHandlers, type A2AServerLookupResult, AgentListSchema, AgentParamsSchema, AgentResponseSchema, ApiResponse, type AuthProvider, type BaseCustomEndpointDefinition, type BaseServerConfig, BaseServerProvider, BasicJsonSchema, type CapabilityRecord, CustomEndpointError, type CustomEndpointHandler, DEFAULT_A2A_ROUTE_PREFIX, DEFAULT_A2A_WELL_KNOWN_PREFIX, DEFAULT_MCP_HTTP_SEGMENT, DEFAULT_MCP_MESSAGES_SEGMENT, DEFAULT_MCP_ROUTE_PREFIX, DEFAULT_MCP_SSE_SEGMENT, DEFAULT_PUBLIC_ROUTES, ErrorSchema, type FilterContext, GenerateOptionsSchema, HttpMethod, type IWebSocket, type JWTAuthOptions, type LogStreamClient, LogStreamManager, type MCPAgentMetadata, type MCPListedTool, type MCPServerCapabilitiesConfig, type MCPServerLike, type MCPServerMetadata, type MCPServerPackageInfo, type MCPServerRemoteInfo, type MCPToolMetadata, type MCPToolOrigin, type MCPWorkflowSummary, 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, ObjectRequestSchema, ObjectResponseSchema, PROTECTED_ROUTES, ParamsSchema, type PortConfig, type ProcessedAgentOptions, type ProtocolConfig, type ProtocolRecord, type ServerEndpointSummary, type ServerProviderConfig, type ServerStartupOptions, StreamObjectEventSchema, StreamTextEventSchema, SubAgentResponseSchema, TextRequestSchema, TextResponseSchema, type TriggerHandlerHttpResponse, type TriggerHttpRequestContext, 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, createJWT, createSSEHeaders, createSSEResponse, createSSEStream, createUserContext, createWebSocketRouter, createWebSocketServer, executeTriggerHandler, extractBearerToken, extractToken, formatSSE, getLandingPageHTML, getLogsBySpanIdHandler, getLogsByTraceIdHandler, getObservabilityStatusHandler, getPortsToTry, getSpanByIdHandler, getTraceByIdHandler, getTracesHandler, handleCheckUpdates, handleGetMcpPrompt, handleGetMcpResource, handleGetMcpServer, handleInstallUpdates, handleInvokeMcpServerTool, handleListMcpPrompts, handleListMcpResourceTemplates, handleListMcpResources, handleListMcpServerTools, handleListMcpServers, handleObservabilityConnection, handleSetMcpLogLevel, handleWebSocketConnection, injectUserIntoBody, jwtAuth, listA2AServers, listMcpServers, lookupA2AServer, lookupMcpServer, pathMatches, portManager, preferredPorts, printServerStartup, processAgentOptions, processWorkflowOptions, queryLogsHandler, requiresAuth, setupObservabilityHandler, setupObservabilityListeners, setupWebSocketUpgrade, transformToSSE, validateBaseCustomEndpoint, validateEndpointMethod, validateEndpointPath };

package/dist/index.js

@@ -99,6 +99,7 @@ __export(index_exports, {
   createWebSocketRouter: () => createWebSocketRouter,
   createWebSocketServer: () => createWebSocketServer,
   executeA2ARequest: () => executeA2ARequest,
+  executeTriggerHandler: () => executeTriggerHandler,
   extractBearerToken: () => extractBearerToken,
   extractToken: () => extractToken,
   formatSSE: () => formatSSE,
@@ -3067,6 +3068,247 @@ async function queryLogsHandler(query, deps) {
 }
 __name(queryLogsHandler, "queryLogsHandler");
 
+// src/handlers/trigger.handlers.ts
+var import_core7 = require("@voltagent/core");
+var import_utils = require("@voltagent/internal/utils");
+var hasOwn = /* @__PURE__ */ __name((value, key) => Object.prototype.hasOwnProperty.call(value, key), "hasOwn");
+var hasResponseMetadata = /* @__PURE__ */ __name((value) => hasOwn(value, "status") || hasOwn(value, "body") || hasOwn(value, "headers"), "hasResponseMetadata");
+function extractPayload(body) {
+  if (!(0, import_utils.isPlainObject)(body)) {
+    return body;
+  }
+  if ("input" in body) {
+    return body.input;
+  }
+  if ("payload" in body) {
+    return body.payload;
+  }
+  if ("record" in body) {
+    return body.record;
+  }
+  if ("data" in body) {
+    return body.data;
+  }
+  return body;
+}
+__name(extractPayload, "extractPayload");
+function buildEnvelope(registration, body) {
+  if ((0, import_utils.isPlainObject)(body)) {
+    return {
+      trigger: registration.name,
+      provider: registration.definition?.provider,
+      ...body
+    };
+  }
+  return {
+    trigger: registration.name,
+    provider: registration.definition?.provider,
+    payload: body
+  };
+}
+__name(buildEnvelope, "buildEnvelope");
+function normalizeResult(result) {
+  if (typeof result === "undefined") {
+    return { status: 200, body: { success: true } };
+  }
+  if ((0, import_utils.isPlainObject)(result) && hasResponseMetadata(result)) {
+    const status = result.status ?? 200;
+    const bodyProvided = hasOwn(result, "body");
+    return {
+      status,
+      body: bodyProvided ? result.body : { success: true },
+      headers: result.headers
+    };
+  }
+  if (typeof result === "string" || typeof result === "number" || typeof result === "boolean" || result === null || Array.isArray(result) || (0, import_utils.isPlainObject)(result)) {
+    return { status: 200, body: result };
+  }
+  return { status: 200, body: result };
+}
+__name(normalizeResult, "normalizeResult");
+function extractMetadata(body) {
+  if (!(0, import_utils.isPlainObject)(body)) {
+    return void 0;
+  }
+  const metadata = body.metadata;
+  return (0, import_utils.isPlainObject)(metadata) ? metadata : void 0;
+}
+__name(extractMetadata, "extractMetadata");
+function buildTriggerAttributeMap(registration, event, metadata) {
+  const attributes = {
+    "trigger.triggerId": event.trigger ?? registration.name,
+    "trigger.provider": event.provider ?? registration.definition?.provider,
+    "trigger.eventId": metadata?.eventId ?? (typeof event.event === "string" ? event.event : void 0) ?? event.deliveryId,
+    "trigger.bindingId": event.bindingId ?? metadata?.bindingId,
+    "trigger.bindingName": metadata?.bindingName,
+    "trigger.bindingDisplayName": metadata?.bindingDisplayName,
+    "trigger.bindingTargetId": event.targetId ?? metadata?.bindingTargetId,
+    "trigger.bindingTargetName": metadata?.bindingTargetName,
+    "trigger.service": metadata?.service ?? event.provider ?? registration.definition?.provider,
+    "trigger.catalogId": event.catalogId ?? metadata?.catalogId,
+    "trigger.targetEndpoint": metadata?.targetEndpoint,
+    "trigger.targetName": metadata?.targetName,
+    "trigger.targetType": metadata?.targetType,
+    "trigger.status": metadata?.status,
+    "trigger.latencyMs": metadata?.latencyMs,
+    "trigger.hasTarget": metadata?.hasTarget,
+    "trigger.occurredAt": metadata?.occurredAt
+  };
+  if (registration.definition?.summary) {
+    attributes["trigger.summary"] = registration.definition.summary;
+  }
+  if (registration.definition?.description) {
+    attributes["trigger.description"] = registration.definition.description;
+  }
+  if (metadata) {
+    attributes["trigger.metadata"] = metadata;
+  }
+  return attributes;
+}
+__name(buildTriggerAttributeMap, "buildTriggerAttributeMap");
+var TRIGGER_AWARE_METHODS = {
+  generateText: 1,
+  streamText: 1,
+  generateObject: 2,
+  streamObject: 2
+};
+function mergeOptionsWithTriggerContext(options, triggerContext) {
+  const contextMap = options?.context instanceof Map ? new Map(options.context) : options?.context ? new Map(Object.entries(options.context)) : /* @__PURE__ */ new Map();
+  for (const [key, value] of triggerContext.entries()) {
+    if (!contextMap.has(key)) {
+      contextMap.set(key, value);
+    }
+  }
+  if (options && typeof options === "object") {
+    return {
+      ...options,
+      context: contextMap
+    };
+  }
+  return {
+    context: contextMap
+  };
+}
+__name(mergeOptionsWithTriggerContext, "mergeOptionsWithTriggerContext");
+function createTriggerAwareAgents(agents, triggerContext) {
+  if (!agents) {
+    return {};
+  }
+  const wrapped = {};
+  for (const [key, agent] of Object.entries(agents)) {
+    if (!agent) {
+      continue;
+    }
+    wrapped[key] = new Proxy(agent, {
+      get(target, prop, receiver) {
+        const value = Reflect.get(target, prop, receiver);
+        if (typeof prop === "string" && typeof value === "function" && Object.prototype.hasOwnProperty.call(TRIGGER_AWARE_METHODS, prop)) {
+          const optionsIndex = TRIGGER_AWARE_METHODS[prop];
+          return (...args) => {
+            const updatedArgs = [...args];
+            if (updatedArgs.length > optionsIndex) {
+              updatedArgs[optionsIndex] = mergeOptionsWithTriggerContext(
+                updatedArgs[optionsIndex],
+                triggerContext
+              );
+            } else {
+              while (updatedArgs.length < optionsIndex) {
+                updatedArgs.push(void 0);
+              }
+              updatedArgs.push(mergeOptionsWithTriggerContext(void 0, triggerContext));
+            }
+            return value.apply(target, updatedArgs);
+          };
+        }
+        if (typeof value === "function") {
+          return value.bind(target);
+        }
+        return value;
+      }
+    });
+  }
+  return wrapped;
+}
+__name(createTriggerAwareAgents, "createTriggerAwareAgents");
+async function executeTriggerHandler(registration, request, deps, logger) {
+  let triggerSpan;
+  try {
+    const payload = extractPayload(request.body);
+    const event = buildEnvelope(registration, request.body);
+    const handlerLogger = logger.child({ trigger: registration.name });
+    const metadata = extractMetadata(request.body);
+    const triggerAttributes = buildTriggerAttributeMap(registration, event, metadata);
+    const triggerContext = /* @__PURE__ */ new Map();
+    for (const [key, value] of Object.entries(triggerAttributes)) {
+      if (value !== void 0 && value !== null && value !== "") {
+        triggerContext.set(key, value);
+      }
+    }
+    if (metadata) {
+      for (const [key, value] of Object.entries(metadata)) {
+        const contextKey = `trigger.metadata.${key}`;
+        if (!triggerContext.has(contextKey)) {
+          triggerContext.set(contextKey, value);
+        }
+      }
+    }
+    const tracer = deps.observability?.getTracer();
+    triggerSpan = tracer?.startSpan(
+      `Trigger ${registration.definition?.summary ?? registration.name}`,
+      {
+        kind: import_core7.SpanKind.SERVER,
+        attributes: {
+          "span.type": "trigger",
+          ...triggerAttributes
+        }
+      },
+      import_core7.context.active()
+    );
+    const agentsWithContext = createTriggerAwareAgents(
+      registration.metadata?.agents ?? {},
+      triggerContext
+    );
+    const contextWithTrigger = import_core7.context.active().setValue(import_core7.TRIGGER_CONTEXT_KEY, triggerContext);
+    const executeHandler = /* @__PURE__ */ __name(() => registration.handler({
+      payload,
+      event,
+      trigger: registration,
+      logger: handlerLogger,
+      headers: request.headers,
+      agentRegistry: deps.agentRegistry,
+      workflowRegistry: deps.workflowRegistry,
+      voltOpsClient: deps.voltOpsClient,
+      agents: agentsWithContext,
+      rawRequest: request.raw,
+      triggerContext
+    }), "executeHandler");
+    const response = triggerSpan ? await import_core7.context.with(import_core7.trace.setSpan(contextWithTrigger, triggerSpan), executeHandler) : await import_core7.context.with(contextWithTrigger, executeHandler);
+    triggerSpan?.setStatus({ code: import_core7.SpanStatusCode.OK });
+    triggerSpan?.end();
+    return normalizeResult(response);
+  } catch (error) {
+    if (triggerSpan) {
+      triggerSpan.setStatus({
+        code: import_core7.SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : "Trigger handler failed"
+      });
+      if (error instanceof Error) {
+        triggerSpan.recordException(error);
+      }
+      triggerSpan.end();
+    }
+    logger.error(`Trigger handler failed for ${registration.name}`, { error });
+    return {
+      status: 500,
+      body: {
+        success: false,
+        error: "Trigger handler failed"
+      }
+    };
+  }
+}
+__name(executeTriggerHandler, "executeTriggerHandler");
+
 // src/handlers/memory-observability.handlers.ts
 var import_internal3 = require("@voltagent/internal");
 var DEFAULT_LIMIT = 50;
@@ -3949,13 +4191,34 @@ function printServerStartup(port, options = {}) {
       `${colors.green}  \u2713 ${colors.bright}Swagger UI:   ${colors.reset}${colors.white}http://localhost:${port}/ui${colors.reset}`
     );
   }
-  if (options.customEndpoints && options.customEndpoints.length > 0) {
+  const allEndpoints = options.customEndpoints ?? [];
+  const triggerEndpoints = allEndpoints.filter(
+    (endpoint) => endpoint.group === "Trigger Endpoints"
+  );
+  const otherEndpoints = allEndpoints.filter((endpoint) => endpoint.group !== "Trigger Endpoints");
+  if (triggerEndpoints.length > 0) {
     console.log();
     console.log(
-      `${colors.green}  \u2713 ${colors.bright}Registered Endpoints: ${colors.reset}${colors.dim}${options.customEndpoints.length} total${colors.reset}`
+      `${colors.magenta}  \u26A1 ${colors.bright}Trigger Routes:${colors.reset} ${colors.dim}${triggerEndpoints.length} registered${colors.reset}`
+    );
+    triggerEndpoints.forEach((endpoint) => {
+      const nameText = endpoint.name ? `${colors.white}${endpoint.name}${colors.reset}` : `${colors.white}${endpoint.path}${colors.reset}`;
+      const pathText = endpoint.name ? `${colors.dim}${endpoint.path}${colors.reset}` : "";
+      console.log(
+        `${colors.dim}      ${(endpoint.method || "POST").toUpperCase().padEnd(6)} ${colors.reset}${nameText} ${pathText}`
+      );
+      if (endpoint.description) {
+        console.log(`${colors.dim}                ${endpoint.description}${colors.reset}`);
+      }
+    });
+  }
+  if (otherEndpoints.length > 0) {
+    console.log();
+    console.log(
+      `${colors.green}  \u2713 ${colors.bright}Registered Endpoints: ${colors.reset}${colors.dim}${otherEndpoints.length} total${colors.reset}`
     );
     const groupMap = /* @__PURE__ */ new Map();
-    options.customEndpoints.forEach((endpoint) => {
+    otherEndpoints.forEach((endpoint) => {
       const groupLabel = endpoint.group?.trim() || "Custom Endpoints";
       if (!groupMap.has(groupLabel)) {
         groupMap.set(groupLabel, []);
@@ -3965,7 +4228,9 @@ function printServerStartup(port, options = {}) {
     const methodOrder = ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"];
     groupMap.forEach((endpoints, groupLabel) => {
       console.log();
-      console.log(`${colors.bright}${colors.white}    ${groupLabel}${colors.reset}`);
+      console.log(
+        `${colors.bright}${colors.white}    ${groupLabel}${colors.reset}${colors.dim} (${endpoints.length})${colors.reset}`
+      );
       const methodGroups = {};
       endpoints.forEach((endpoint) => {
         const method = (endpoint.method ?? "").toUpperCase();
@@ -3973,14 +4238,19 @@ function printServerStartup(port, options = {}) {
         if (!methodGroups[normalizedMethod]) {
           methodGroups[normalizedMethod] = [];
         }
-        methodGroups[normalizedMethod].push(endpoint.path);
+        methodGroups[normalizedMethod].push(endpoint);
       });
       methodOrder.forEach((method) => {
         if (methodGroups[method]) {
-          methodGroups[method].forEach((path2) => {
+          methodGroups[method].forEach((endpoint) => {
+            const pathText = `${colors.white}${endpoint.path}${colors.reset}`;
+            const nameText = endpoint.name ? `${colors.dim} (${endpoint.name})${colors.reset}` : "";
             console.log(
-              `${colors.dim}      ${method.padEnd(6)} ${colors.reset}${colors.white}${path2}${colors.reset}`
+              `${colors.dim}      ${method.padEnd(6)} ${colors.reset}${pathText}${nameText}`
             );
+            if (endpoint.description) {
+              console.log(`${colors.dim}                ${endpoint.description}${colors.reset}`);
+            }
           });
         }
       });
@@ -4203,8 +4473,8 @@ __name(createSSEResponse, "createSSEResponse");
 var import_internal6 = require("@voltagent/internal");
 
 // src/websocket/log-stream.ts
-var import_core7 = require("@voltagent/core");
-var import_utils = require("@voltagent/internal/utils");
+var import_core8 = require("@voltagent/core");
+var import_utils2 = require("@voltagent/internal/utils");
 var LogStreamManager = class {
   static {
     __name(this, "LogStreamManager");
@@ -4213,8 +4483,8 @@ var LogStreamManager = class {
   logBuffer;
   logger;
   constructor() {
-    this.logBuffer = (0, import_core7.getGlobalLogBuffer)();
-    this.logger = (0, import_core7.getGlobalLogger)().child({ component: "log-stream-manager" });
+    this.logBuffer = (0, import_core8.getGlobalLogBuffer)();
+    this.logger = (0, import_core8.getGlobalLogger)().child({ component: "log-stream-manager" });
     this.setupEventListeners();
   }
   addClient(ws, filter) {
@@ -4238,7 +4508,7 @@ var LogStreamManager = class {
     this.logger.trace(`Log stream client connected. Active clients: ${this.clients.size}`);
   }
   sendInitialLogs(client) {
-    const logBuffer = (0, import_core7.getGlobalLogBuffer)();
+    const logBuffer = (0, import_core8.getGlobalLogBuffer)();
     const logs = logBuffer.query({
       ...client.filter,
       limit: client.filter?.limit || 100
@@ -4299,7 +4569,7 @@ var LogStreamManager = class {
   sendToClient(client, data) {
     if (client.ws.readyState === 1) {
       try {
-        client.ws.send((0, import_utils.safeStringify)(data));
+        client.ws.send((0, import_utils2.safeStringify)(data));
       } catch (error) {
         this.logger.error("Failed to send log to client", { error });
         this.clients.delete(client);
@@ -4315,13 +4585,13 @@ var LogStreamManager = class {
 };
 
 // src/websocket/observability-handler.ts
-var import_core8 = require("@voltagent/core");
+var import_core9 = require("@voltagent/core");
 var import_internal5 = require("@voltagent/internal");
 var observabilityConnections = /* @__PURE__ */ new Map();
 var observabilityListenersInitialized = false;
 var logUnsubscribe = null;
 function getWebSocketEventEmitter() {
-  return import_core8.WebSocketEventEmitter.getInstance();
+  return import_core9.WebSocketEventEmitter.getInstance();
 }
 __name(getWebSocketEventEmitter, "getWebSocketEventEmitter");
 function setupObservabilityListeners() {
@@ -4342,10 +4612,12 @@ function setupObservabilityListeners() {
           if (isRootSpan) {
             const eventEntityId = event.span?.attributes?.["entity.id"];
             const eventEntityType = event.span?.attributes?.["entity.type"];
-            if (eventEntityId !== connection.entityId) {
+            const spanType = event.span?.attributes?.["span.type"];
+            const isTriggerSpan = spanType === "trigger";
+            if (!isTriggerSpan && eventEntityId !== connection.entityId) {
               return;
             }
-            if (connection.entityType && eventEntityType !== connection.entityType) {
+            if (!isTriggerSpan && connection.entityType && eventEntityType !== connection.entityType) {
               return;
             }
           }
@@ -4354,7 +4626,7 @@ function setupObservabilityListeners() {
       }
     });
   });
-  logUnsubscribe = import_core8.WebSocketLogProcessor.subscribe((logRecord) => {
+  logUnsubscribe = import_core9.WebSocketLogProcessor.subscribe((logRecord) => {
     const message = (0, import_internal5.safeStringify)({
       type: "OBSERVABILITY_LOG",
       success: true,
@@ -4734,14 +5006,28 @@ var BaseServerProvider = class {
     if (registeredA2AServers.length > 0) {
       addRoutes(A2A_ROUTES, "A2A Endpoints");
     }
+    const registeredTriggers = this.deps.triggerRegistry?.list?.() ?? [];
+    if (registeredTriggers.length > 0) {
+      registeredTriggers.forEach((trigger) => {
+        endpoints.push({
+          method: trigger.method.toUpperCase(),
+          path: trigger.path,
+          group: "Trigger Endpoints",
+          name: trigger.name,
+          description: trigger.summary ?? trigger.description ?? trigger.definition?.description
+        });
+      });
+    } else {
+      this.logger.info("[volt] No trigger endpoints discovered during startup");
+    }
     return endpoints;
   }
 };
 
 // src/server/app-setup.ts
-var import_core9 = require("@voltagent/core");
+var import_core10 = require("@voltagent/core");
 function getOrCreateLogger(deps, component = "api-server") {
-  return deps.logger?.child({ component }) ?? (0, import_core9.getGlobalLogger)().child({ component });
+  return deps.logger?.child({ component }) ?? (0, import_core10.getGlobalLogger)().child({ component });
 }
 __name(getOrCreateLogger, "getOrCreateLogger");
 function shouldEnableSwaggerUI(config) {
@@ -4842,6 +5128,7 @@ var DEFAULT_CORS_OPTIONS = {
   createWebSocketRouter,
   createWebSocketServer,
   executeA2ARequest,
+  executeTriggerHandler,
   extractBearerToken,
   extractToken,
   formatSSE,