@voltagent/server-core 1.0.12 → 1.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,6 @@
1
1
  import { ServerProviderDeps, A2AServerRegistry } from '@voltagent/core';
2
2
  import { Logger, LogLevel, LogEntry, LogFilter } from '@voltagent/internal';
3
+ import { UIMessage } from 'ai';
3
4
  import { A2AServerLike } from '@voltagent/internal/a2a';
4
5
 
5
6
  /**
@@ -550,7 +551,7 @@ declare const UPDATE_ROUTES: {
550
551
  };
551
552
  readonly installUpdates: {
552
553
  readonly method: "post";
553
- readonly path: "/updates/install";
554
+ readonly path: "/updates";
554
555
  readonly summary: "Install updates";
555
556
  readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
556
557
  readonly tags: readonly ["System"];
@@ -744,10 +745,172 @@ declare const OBSERVABILITY_ROUTES: {
744
745
  };
745
746
  };
746
747
  };
748
+ declare const OBSERVABILITY_MEMORY_ROUTES: {
749
+ readonly listMemoryUsers: {
750
+ readonly method: "get";
751
+ readonly path: "/observability/memory/users";
752
+ readonly summary: "List memory users";
753
+ readonly description: "Retrieve all users who have associated memory records. Supports optional filtering by agent and pagination controls.";
754
+ readonly tags: readonly ["Observability", "Memory"];
755
+ readonly operationId: "listMemoryUsers";
756
+ readonly responses: {
757
+ readonly 200: {
758
+ readonly description: "Successfully retrieved users";
759
+ readonly contentType: "application/json";
760
+ };
761
+ readonly 500: {
762
+ readonly description: "Failed to retrieve memory users due to server error";
763
+ readonly contentType: "application/json";
764
+ };
765
+ };
766
+ };
767
+ readonly listMemoryConversations: {
768
+ readonly method: "get";
769
+ readonly path: "/observability/memory/conversations";
770
+ readonly summary: "List memory conversations";
771
+ readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
772
+ readonly tags: readonly ["Observability", "Memory"];
773
+ readonly operationId: "listMemoryConversations";
774
+ readonly responses: {
775
+ readonly 200: {
776
+ readonly description: "Successfully retrieved conversations";
777
+ readonly contentType: "application/json";
778
+ };
779
+ readonly 500: {
780
+ readonly description: "Failed to retrieve conversations due to server error";
781
+ readonly contentType: "application/json";
782
+ };
783
+ };
784
+ };
785
+ readonly getMemoryConversationMessages: {
786
+ readonly method: "get";
787
+ readonly path: "/observability/memory/conversations/:conversationId/messages";
788
+ readonly summary: "Get conversation messages";
789
+ readonly description: "Fetch the messages for a specific conversation stored in memory. Supports optional role filtering and windowing via before/after parameters.";
790
+ readonly tags: readonly ["Observability", "Memory"];
791
+ readonly operationId: "getMemoryConversationMessages";
792
+ readonly responses: {
793
+ readonly 200: {
794
+ readonly description: "Successfully retrieved messages";
795
+ readonly contentType: "application/json";
796
+ };
797
+ readonly 404: {
798
+ readonly description: "Conversation not found";
799
+ readonly contentType: "application/json";
800
+ };
801
+ readonly 500: {
802
+ readonly description: "Failed to retrieve messages due to server error";
803
+ readonly contentType: "application/json";
804
+ };
805
+ };
806
+ };
807
+ readonly getWorkingMemory: {
808
+ readonly method: "get";
809
+ readonly path: "/observability/memory/working-memory";
810
+ readonly summary: "Get working memory";
811
+ readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
812
+ readonly tags: readonly ["Observability", "Memory"];
813
+ readonly operationId: "getWorkingMemory";
814
+ readonly responses: {
815
+ readonly 200: {
816
+ readonly description: "Successfully retrieved working memory";
817
+ readonly contentType: "application/json";
818
+ };
819
+ readonly 404: {
820
+ readonly description: "Working memory not found";
821
+ readonly contentType: "application/json";
822
+ };
823
+ readonly 500: {
824
+ readonly description: "Failed to retrieve working memory due to server error";
825
+ readonly contentType: "application/json";
826
+ };
827
+ };
828
+ };
829
+ };
747
830
  /**
748
831
  * All route definitions combined
749
832
  */
750
833
  declare const ALL_ROUTES: {
834
+ readonly listMemoryUsers: {
835
+ readonly method: "get";
836
+ readonly path: "/observability/memory/users";
837
+ readonly summary: "List memory users";
838
+ readonly description: "Retrieve all users who have associated memory records. Supports optional filtering by agent and pagination controls.";
839
+ readonly tags: readonly ["Observability", "Memory"];
840
+ readonly operationId: "listMemoryUsers";
841
+ readonly responses: {
842
+ readonly 200: {
843
+ readonly description: "Successfully retrieved users";
844
+ readonly contentType: "application/json";
845
+ };
846
+ readonly 500: {
847
+ readonly description: "Failed to retrieve memory users due to server error";
848
+ readonly contentType: "application/json";
849
+ };
850
+ };
851
+ };
852
+ readonly listMemoryConversations: {
853
+ readonly method: "get";
854
+ readonly path: "/observability/memory/conversations";
855
+ readonly summary: "List memory conversations";
856
+ readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
857
+ readonly tags: readonly ["Observability", "Memory"];
858
+ readonly operationId: "listMemoryConversations";
859
+ readonly responses: {
860
+ readonly 200: {
861
+ readonly description: "Successfully retrieved conversations";
862
+ readonly contentType: "application/json";
863
+ };
864
+ readonly 500: {
865
+ readonly description: "Failed to retrieve conversations due to server error";
866
+ readonly contentType: "application/json";
867
+ };
868
+ };
869
+ };
870
+ readonly getMemoryConversationMessages: {
871
+ readonly method: "get";
872
+ readonly path: "/observability/memory/conversations/:conversationId/messages";
873
+ readonly summary: "Get conversation messages";
874
+ readonly description: "Fetch the messages for a specific conversation stored in memory. Supports optional role filtering and windowing via before/after parameters.";
875
+ readonly tags: readonly ["Observability", "Memory"];
876
+ readonly operationId: "getMemoryConversationMessages";
877
+ readonly responses: {
878
+ readonly 200: {
879
+ readonly description: "Successfully retrieved messages";
880
+ readonly contentType: "application/json";
881
+ };
882
+ readonly 404: {
883
+ readonly description: "Conversation not found";
884
+ readonly contentType: "application/json";
885
+ };
886
+ readonly 500: {
887
+ readonly description: "Failed to retrieve messages due to server error";
888
+ readonly contentType: "application/json";
889
+ };
890
+ };
891
+ };
892
+ readonly getWorkingMemory: {
893
+ readonly method: "get";
894
+ readonly path: "/observability/memory/working-memory";
895
+ readonly summary: "Get working memory";
896
+ readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
897
+ readonly tags: readonly ["Observability", "Memory"];
898
+ readonly operationId: "getWorkingMemory";
899
+ readonly responses: {
900
+ readonly 200: {
901
+ readonly description: "Successfully retrieved working memory";
902
+ readonly contentType: "application/json";
903
+ };
904
+ readonly 404: {
905
+ readonly description: "Working memory not found";
906
+ readonly contentType: "application/json";
907
+ };
908
+ readonly 500: {
909
+ readonly description: "Failed to retrieve working memory due to server error";
910
+ readonly contentType: "application/json";
911
+ };
912
+ };
913
+ };
751
914
  readonly setupObservability: {
752
915
  readonly method: "post";
753
916
  readonly path: "/setup-observability";
@@ -936,7 +1099,7 @@ declare const ALL_ROUTES: {
936
1099
  };
937
1100
  readonly installUpdates: {
938
1101
  readonly method: "post";
939
- readonly path: "/updates/install";
1102
+ readonly path: "/updates";
940
1103
  readonly summary: "Install updates";
941
1104
  readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
942
1105
  readonly tags: readonly ["System"];
@@ -1659,6 +1822,62 @@ type StreamResponse = Response | ReadableStream | ErrorResponse;
1659
1822
  declare function isErrorResponse(response: any): response is ErrorResponse;
1660
1823
  declare function isSuccessResponse<T>(response: any): response is SuccessResponse<T>;
1661
1824
 
1825
+ interface MemoryUserSummary {
1826
+ userId: string;
1827
+ conversationCount: number;
1828
+ agents: MemoryUserAgentSummary[];
1829
+ lastInteractionAt?: string;
1830
+ }
1831
+ interface MemoryUserAgentSummary {
1832
+ agentId: string;
1833
+ agentName?: string;
1834
+ conversationCount: number;
1835
+ lastInteractionAt?: string;
1836
+ }
1837
+ interface MemoryConversationSummary {
1838
+ id: string;
1839
+ userId: string;
1840
+ agentId: string;
1841
+ agentName?: string;
1842
+ title: string;
1843
+ createdAt: string;
1844
+ updatedAt: string;
1845
+ metadata?: Record<string, unknown>;
1846
+ }
1847
+ interface MemoryConversationMessagesResult {
1848
+ conversation: MemoryConversationSummary;
1849
+ messages: UIMessage[];
1850
+ }
1851
+ interface MemoryWorkingMemoryResult {
1852
+ agentId: string | null;
1853
+ agentName?: string | null;
1854
+ scope: "conversation" | "user";
1855
+ content: string | null;
1856
+ format: "markdown" | "json" | null;
1857
+ template?: string | null;
1858
+ }
1859
+ interface MemoryListUsersQuery {
1860
+ agentId?: string;
1861
+ limit?: number;
1862
+ offset?: number;
1863
+ search?: string;
1864
+ }
1865
+ interface MemoryListConversationsQuery {
1866
+ agentId?: string;
1867
+ userId?: string;
1868
+ limit?: number;
1869
+ offset?: number;
1870
+ orderBy?: "created_at" | "updated_at" | "title";
1871
+ orderDirection?: "ASC" | "DESC";
1872
+ }
1873
+ interface MemoryGetMessagesQuery {
1874
+ agentId?: string;
1875
+ limit?: number;
1876
+ before?: Date;
1877
+ after?: Date;
1878
+ roles?: string[];
1879
+ }
1880
+
1662
1881
  /**
1663
1882
  * Handler for listing all agents
1664
1883
  * Returns agent data array
@@ -1766,6 +1985,26 @@ declare function handleResumeWorkflow(workflowId: string, executionId: string, b
1766
1985
  */
1767
1986
  declare function handleGetWorkflowState(workflowId: string, executionId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
1768
1987
 
1988
+ declare function listMemoryUsersHandler(deps: ServerProviderDeps, query: MemoryListUsersQuery): Promise<ApiResponse<{
1989
+ users: MemoryUserSummary[];
1990
+ total: number;
1991
+ limit: number;
1992
+ offset: number;
1993
+ }>>;
1994
+ declare function listMemoryConversationsHandler(deps: ServerProviderDeps, query: MemoryListConversationsQuery): Promise<ApiResponse<{
1995
+ conversations: MemoryConversationSummary[];
1996
+ total: number;
1997
+ limit: number;
1998
+ offset: number;
1999
+ }>>;
2000
+ declare function getConversationMessagesHandler(deps: ServerProviderDeps, conversationId: string, query: MemoryGetMessagesQuery): Promise<ApiResponse<MemoryConversationMessagesResult>>;
2001
+ declare function getWorkingMemoryHandler(deps: ServerProviderDeps, params: {
2002
+ agentId?: string;
2003
+ conversationId?: string;
2004
+ userId?: string;
2005
+ scope: "conversation" | "user";
2006
+ }): Promise<ApiResponse<MemoryWorkingMemoryResult>>;
2007
+
1769
2008
  type A2AJsonRpcId = string | number | null;
1770
2009
  interface JsonRpcError<Data = unknown> {
1771
2010
  code: number;
@@ -1886,4 +2125,4 @@ declare function mapHandlerResponse(response: ApiResponse, type?: string): ApiRe
1886
2125
  */
1887
2126
  declare function getResponseStatus(response: ApiResponse): number;
1888
2127
 
1889
- export { handleGetWorkflowState as $, type ApiResponse as A, handleGetAgents as B, handleGenerateText as C, handleStreamText as D, type ErrorResponse as E, handleChatStream as F, handleGenerateObject as G, type HttpMethod as H, handleStreamObject as I, type JsonRpcError as J, handleGetAgent as K, LOG_ROUTES as L, MCP_ROUTES as M, handleGetAgentHistory as N, OBSERVABILITY_ROUTES as O, handleGetWorkflows as P, handleGetWorkflow as Q, type ResponseDefinition as R, type SuccessResponse as S, handleExecuteWorkflow as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, handleStreamWorkflow as X, handleSuspendWorkflow as Y, handleCancelWorkflow as Z, handleResumeWorkflow as _, type A2AServerLikeWithHandlers as a, type LogFilterOptions as a0, type LogHandlerResponse as a1, handleGetLogs as a2, mapLogResponse as a3, mapHandlerResponse as a4, getResponseStatus as a5, type OpenApiInfo as a6, type AppSetupConfig as a7, getOrCreateLogger as a8, shouldEnableSwaggerUI as a9, getOpenApiDoc as aa, DEFAULT_CORS_OPTIONS as ab, type StreamResponse as b, isSuccessResponse as c, type RouteDefinition as d, AGENT_ROUTES as e, ALL_ROUTES as f, getAllRoutesArray as g, A2A_ROUTES as h, isErrorResponse as i, getRoutesByTag as j, executeA2ARequest as k, type A2AJsonRpcId as l, type JsonRpcResponse as m, type JsonRpcStream as n, type JsonRpcHandlerResult as o, parseJsonRpcRequest as p, type JsonRpcRequest as q, resolveAgentCard as r, type A2ARequestContext as s, type AgentCardSkill as t, type AgentCardProviderInfo as u, type AgentCardCapabilities as v, type AgentCard as w, A2AErrorCode as x, normalizeError as y, isJsonRpcRequest as z };
2128
+ export { handleGetAgent as $, type ApiResponse as A, type JsonRpcRequest as B, type A2ARequestContext as C, type AgentCardSkill as D, type ErrorResponse as E, type AgentCardProviderInfo as F, type AgentCardCapabilities as G, type HttpMethod as H, type AgentCard as I, type JsonRpcError as J, A2AErrorCode as K, LOG_ROUTES as L, type MemoryUserSummary as M, normalizeError as N, OBSERVABILITY_ROUTES as O, isJsonRpcRequest as P, handleGetAgents as Q, type ResponseDefinition as R, type SuccessResponse as S, handleGenerateText as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, handleStreamText as X, handleChatStream as Y, handleGenerateObject as Z, handleStreamObject as _, type A2AServerLikeWithHandlers as a, handleGetAgentHistory as a0, handleGetWorkflows as a1, handleGetWorkflow as a2, handleExecuteWorkflow as a3, handleStreamWorkflow as a4, handleSuspendWorkflow as a5, handleCancelWorkflow as a6, handleResumeWorkflow as a7, handleGetWorkflowState as a8, type LogFilterOptions as a9, type LogHandlerResponse as aa, handleGetLogs as ab, listMemoryUsersHandler as ac, listMemoryConversationsHandler as ad, getConversationMessagesHandler as ae, getWorkingMemoryHandler as af, mapLogResponse as ag, mapHandlerResponse as ah, getResponseStatus as ai, type OpenApiInfo as aj, type AppSetupConfig as ak, getOrCreateLogger as al, shouldEnableSwaggerUI as am, getOpenApiDoc as an, DEFAULT_CORS_OPTIONS as ao, type StreamResponse as b, isSuccessResponse as c, type MemoryUserAgentSummary as d, type MemoryConversationSummary as e, type MemoryConversationMessagesResult as f, type MemoryWorkingMemoryResult as g, type MemoryListUsersQuery as h, isErrorResponse as i, type MemoryListConversationsQuery as j, type MemoryGetMessagesQuery as k, type RouteDefinition as l, AGENT_ROUTES as m, OBSERVABILITY_MEMORY_ROUTES as n, ALL_ROUTES as o, getAllRoutesArray as p, MCP_ROUTES as q, A2A_ROUTES as r, getRoutesByTag as s, parseJsonRpcRequest as t, resolveAgentCard as u, executeA2ARequest as v, type A2AJsonRpcId as w, type JsonRpcResponse as x, type JsonRpcStream as y, type JsonRpcHandlerResult as z };
@@ -1,5 +1,6 @@
1
1
  import { ServerProviderDeps, A2AServerRegistry } from '@voltagent/core';
2
2
  import { Logger, LogLevel, LogEntry, LogFilter } from '@voltagent/internal';
3
+ import { UIMessage } from 'ai';
3
4
  import { A2AServerLike } from '@voltagent/internal/a2a';
4
5
 
5
6
  /**
@@ -550,7 +551,7 @@ declare const UPDATE_ROUTES: {
550
551
  };
551
552
  readonly installUpdates: {
552
553
  readonly method: "post";
553
- readonly path: "/updates/install";
554
+ readonly path: "/updates";
554
555
  readonly summary: "Install updates";
555
556
  readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
556
557
  readonly tags: readonly ["System"];
@@ -744,10 +745,172 @@ declare const OBSERVABILITY_ROUTES: {
744
745
  };
745
746
  };
746
747
  };
748
+ declare const OBSERVABILITY_MEMORY_ROUTES: {
749
+ readonly listMemoryUsers: {
750
+ readonly method: "get";
751
+ readonly path: "/observability/memory/users";
752
+ readonly summary: "List memory users";
753
+ readonly description: "Retrieve all users who have associated memory records. Supports optional filtering by agent and pagination controls.";
754
+ readonly tags: readonly ["Observability", "Memory"];
755
+ readonly operationId: "listMemoryUsers";
756
+ readonly responses: {
757
+ readonly 200: {
758
+ readonly description: "Successfully retrieved users";
759
+ readonly contentType: "application/json";
760
+ };
761
+ readonly 500: {
762
+ readonly description: "Failed to retrieve memory users due to server error";
763
+ readonly contentType: "application/json";
764
+ };
765
+ };
766
+ };
767
+ readonly listMemoryConversations: {
768
+ readonly method: "get";
769
+ readonly path: "/observability/memory/conversations";
770
+ readonly summary: "List memory conversations";
771
+ readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
772
+ readonly tags: readonly ["Observability", "Memory"];
773
+ readonly operationId: "listMemoryConversations";
774
+ readonly responses: {
775
+ readonly 200: {
776
+ readonly description: "Successfully retrieved conversations";
777
+ readonly contentType: "application/json";
778
+ };
779
+ readonly 500: {
780
+ readonly description: "Failed to retrieve conversations due to server error";
781
+ readonly contentType: "application/json";
782
+ };
783
+ };
784
+ };
785
+ readonly getMemoryConversationMessages: {
786
+ readonly method: "get";
787
+ readonly path: "/observability/memory/conversations/:conversationId/messages";
788
+ readonly summary: "Get conversation messages";
789
+ readonly description: "Fetch the messages for a specific conversation stored in memory. Supports optional role filtering and windowing via before/after parameters.";
790
+ readonly tags: readonly ["Observability", "Memory"];
791
+ readonly operationId: "getMemoryConversationMessages";
792
+ readonly responses: {
793
+ readonly 200: {
794
+ readonly description: "Successfully retrieved messages";
795
+ readonly contentType: "application/json";
796
+ };
797
+ readonly 404: {
798
+ readonly description: "Conversation not found";
799
+ readonly contentType: "application/json";
800
+ };
801
+ readonly 500: {
802
+ readonly description: "Failed to retrieve messages due to server error";
803
+ readonly contentType: "application/json";
804
+ };
805
+ };
806
+ };
807
+ readonly getWorkingMemory: {
808
+ readonly method: "get";
809
+ readonly path: "/observability/memory/working-memory";
810
+ readonly summary: "Get working memory";
811
+ readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
812
+ readonly tags: readonly ["Observability", "Memory"];
813
+ readonly operationId: "getWorkingMemory";
814
+ readonly responses: {
815
+ readonly 200: {
816
+ readonly description: "Successfully retrieved working memory";
817
+ readonly contentType: "application/json";
818
+ };
819
+ readonly 404: {
820
+ readonly description: "Working memory not found";
821
+ readonly contentType: "application/json";
822
+ };
823
+ readonly 500: {
824
+ readonly description: "Failed to retrieve working memory due to server error";
825
+ readonly contentType: "application/json";
826
+ };
827
+ };
828
+ };
829
+ };
747
830
  /**
748
831
  * All route definitions combined
749
832
  */
750
833
  declare const ALL_ROUTES: {
834
+ readonly listMemoryUsers: {
835
+ readonly method: "get";
836
+ readonly path: "/observability/memory/users";
837
+ readonly summary: "List memory users";
838
+ readonly description: "Retrieve all users who have associated memory records. Supports optional filtering by agent and pagination controls.";
839
+ readonly tags: readonly ["Observability", "Memory"];
840
+ readonly operationId: "listMemoryUsers";
841
+ readonly responses: {
842
+ readonly 200: {
843
+ readonly description: "Successfully retrieved users";
844
+ readonly contentType: "application/json";
845
+ };
846
+ readonly 500: {
847
+ readonly description: "Failed to retrieve memory users due to server error";
848
+ readonly contentType: "application/json";
849
+ };
850
+ };
851
+ };
852
+ readonly listMemoryConversations: {
853
+ readonly method: "get";
854
+ readonly path: "/observability/memory/conversations";
855
+ readonly summary: "List memory conversations";
856
+ readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
857
+ readonly tags: readonly ["Observability", "Memory"];
858
+ readonly operationId: "listMemoryConversations";
859
+ readonly responses: {
860
+ readonly 200: {
861
+ readonly description: "Successfully retrieved conversations";
862
+ readonly contentType: "application/json";
863
+ };
864
+ readonly 500: {
865
+ readonly description: "Failed to retrieve conversations due to server error";
866
+ readonly contentType: "application/json";
867
+ };
868
+ };
869
+ };
870
+ readonly getMemoryConversationMessages: {
871
+ readonly method: "get";
872
+ readonly path: "/observability/memory/conversations/:conversationId/messages";
873
+ readonly summary: "Get conversation messages";
874
+ readonly description: "Fetch the messages for a specific conversation stored in memory. Supports optional role filtering and windowing via before/after parameters.";
875
+ readonly tags: readonly ["Observability", "Memory"];
876
+ readonly operationId: "getMemoryConversationMessages";
877
+ readonly responses: {
878
+ readonly 200: {
879
+ readonly description: "Successfully retrieved messages";
880
+ readonly contentType: "application/json";
881
+ };
882
+ readonly 404: {
883
+ readonly description: "Conversation not found";
884
+ readonly contentType: "application/json";
885
+ };
886
+ readonly 500: {
887
+ readonly description: "Failed to retrieve messages due to server error";
888
+ readonly contentType: "application/json";
889
+ };
890
+ };
891
+ };
892
+ readonly getWorkingMemory: {
893
+ readonly method: "get";
894
+ readonly path: "/observability/memory/working-memory";
895
+ readonly summary: "Get working memory";
896
+ readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
897
+ readonly tags: readonly ["Observability", "Memory"];
898
+ readonly operationId: "getWorkingMemory";
899
+ readonly responses: {
900
+ readonly 200: {
901
+ readonly description: "Successfully retrieved working memory";
902
+ readonly contentType: "application/json";
903
+ };
904
+ readonly 404: {
905
+ readonly description: "Working memory not found";
906
+ readonly contentType: "application/json";
907
+ };
908
+ readonly 500: {
909
+ readonly description: "Failed to retrieve working memory due to server error";
910
+ readonly contentType: "application/json";
911
+ };
912
+ };
913
+ };
751
914
  readonly setupObservability: {
752
915
  readonly method: "post";
753
916
  readonly path: "/setup-observability";
@@ -936,7 +1099,7 @@ declare const ALL_ROUTES: {
936
1099
  };
937
1100
  readonly installUpdates: {
938
1101
  readonly method: "post";
939
- readonly path: "/updates/install";
1102
+ readonly path: "/updates";
940
1103
  readonly summary: "Install updates";
941
1104
  readonly description: "Install available updates for VoltAgent packages. Can install a single package or all packages.";
942
1105
  readonly tags: readonly ["System"];
@@ -1659,6 +1822,62 @@ type StreamResponse = Response | ReadableStream | ErrorResponse;
1659
1822
  declare function isErrorResponse(response: any): response is ErrorResponse;
1660
1823
  declare function isSuccessResponse<T>(response: any): response is SuccessResponse<T>;
1661
1824
 
1825
+ interface MemoryUserSummary {
1826
+ userId: string;
1827
+ conversationCount: number;
1828
+ agents: MemoryUserAgentSummary[];
1829
+ lastInteractionAt?: string;
1830
+ }
1831
+ interface MemoryUserAgentSummary {
1832
+ agentId: string;
1833
+ agentName?: string;
1834
+ conversationCount: number;
1835
+ lastInteractionAt?: string;
1836
+ }
1837
+ interface MemoryConversationSummary {
1838
+ id: string;
1839
+ userId: string;
1840
+ agentId: string;
1841
+ agentName?: string;
1842
+ title: string;
1843
+ createdAt: string;
1844
+ updatedAt: string;
1845
+ metadata?: Record<string, unknown>;
1846
+ }
1847
+ interface MemoryConversationMessagesResult {
1848
+ conversation: MemoryConversationSummary;
1849
+ messages: UIMessage[];
1850
+ }
1851
+ interface MemoryWorkingMemoryResult {
1852
+ agentId: string | null;
1853
+ agentName?: string | null;
1854
+ scope: "conversation" | "user";
1855
+ content: string | null;
1856
+ format: "markdown" | "json" | null;
1857
+ template?: string | null;
1858
+ }
1859
+ interface MemoryListUsersQuery {
1860
+ agentId?: string;
1861
+ limit?: number;
1862
+ offset?: number;
1863
+ search?: string;
1864
+ }
1865
+ interface MemoryListConversationsQuery {
1866
+ agentId?: string;
1867
+ userId?: string;
1868
+ limit?: number;
1869
+ offset?: number;
1870
+ orderBy?: "created_at" | "updated_at" | "title";
1871
+ orderDirection?: "ASC" | "DESC";
1872
+ }
1873
+ interface MemoryGetMessagesQuery {
1874
+ agentId?: string;
1875
+ limit?: number;
1876
+ before?: Date;
1877
+ after?: Date;
1878
+ roles?: string[];
1879
+ }
1880
+
1662
1881
  /**
1663
1882
  * Handler for listing all agents
1664
1883
  * Returns agent data array
@@ -1766,6 +1985,26 @@ declare function handleResumeWorkflow(workflowId: string, executionId: string, b
1766
1985
  */
1767
1986
  declare function handleGetWorkflowState(workflowId: string, executionId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
1768
1987
 
1988
+ declare function listMemoryUsersHandler(deps: ServerProviderDeps, query: MemoryListUsersQuery): Promise<ApiResponse<{
1989
+ users: MemoryUserSummary[];
1990
+ total: number;
1991
+ limit: number;
1992
+ offset: number;
1993
+ }>>;
1994
+ declare function listMemoryConversationsHandler(deps: ServerProviderDeps, query: MemoryListConversationsQuery): Promise<ApiResponse<{
1995
+ conversations: MemoryConversationSummary[];
1996
+ total: number;
1997
+ limit: number;
1998
+ offset: number;
1999
+ }>>;
2000
+ declare function getConversationMessagesHandler(deps: ServerProviderDeps, conversationId: string, query: MemoryGetMessagesQuery): Promise<ApiResponse<MemoryConversationMessagesResult>>;
2001
+ declare function getWorkingMemoryHandler(deps: ServerProviderDeps, params: {
2002
+ agentId?: string;
2003
+ conversationId?: string;
2004
+ userId?: string;
2005
+ scope: "conversation" | "user";
2006
+ }): Promise<ApiResponse<MemoryWorkingMemoryResult>>;
2007
+
1769
2008
  type A2AJsonRpcId = string | number | null;
1770
2009
  interface JsonRpcError<Data = unknown> {
1771
2010
  code: number;
@@ -1886,4 +2125,4 @@ declare function mapHandlerResponse(response: ApiResponse, type?: string): ApiRe
1886
2125
  */
1887
2126
  declare function getResponseStatus(response: ApiResponse): number;
1888
2127
 
1889
- export { handleGetWorkflowState as $, type ApiResponse as A, handleGetAgents as B, handleGenerateText as C, handleStreamText as D, type ErrorResponse as E, handleChatStream as F, handleGenerateObject as G, type HttpMethod as H, handleStreamObject as I, type JsonRpcError as J, handleGetAgent as K, LOG_ROUTES as L, MCP_ROUTES as M, handleGetAgentHistory as N, OBSERVABILITY_ROUTES as O, handleGetWorkflows as P, handleGetWorkflow as Q, type ResponseDefinition as R, type SuccessResponse as S, handleExecuteWorkflow as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, handleStreamWorkflow as X, handleSuspendWorkflow as Y, handleCancelWorkflow as Z, handleResumeWorkflow as _, type A2AServerLikeWithHandlers as a, type LogFilterOptions as a0, type LogHandlerResponse as a1, handleGetLogs as a2, mapLogResponse as a3, mapHandlerResponse as a4, getResponseStatus as a5, type OpenApiInfo as a6, type AppSetupConfig as a7, getOrCreateLogger as a8, shouldEnableSwaggerUI as a9, getOpenApiDoc as aa, DEFAULT_CORS_OPTIONS as ab, type StreamResponse as b, isSuccessResponse as c, type RouteDefinition as d, AGENT_ROUTES as e, ALL_ROUTES as f, getAllRoutesArray as g, A2A_ROUTES as h, isErrorResponse as i, getRoutesByTag as j, executeA2ARequest as k, type A2AJsonRpcId as l, type JsonRpcResponse as m, type JsonRpcStream as n, type JsonRpcHandlerResult as o, parseJsonRpcRequest as p, type JsonRpcRequest as q, resolveAgentCard as r, type A2ARequestContext as s, type AgentCardSkill as t, type AgentCardProviderInfo as u, type AgentCardCapabilities as v, type AgentCard as w, A2AErrorCode as x, normalizeError as y, isJsonRpcRequest as z };
2128
+ export { handleGetAgent as $, type ApiResponse as A, type JsonRpcRequest as B, type A2ARequestContext as C, type AgentCardSkill as D, type ErrorResponse as E, type AgentCardProviderInfo as F, type AgentCardCapabilities as G, type HttpMethod as H, type AgentCard as I, type JsonRpcError as J, A2AErrorCode as K, LOG_ROUTES as L, type MemoryUserSummary as M, normalizeError as N, OBSERVABILITY_ROUTES as O, isJsonRpcRequest as P, handleGetAgents as Q, type ResponseDefinition as R, type SuccessResponse as S, handleGenerateText as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, handleStreamText as X, handleChatStream as Y, handleGenerateObject as Z, handleStreamObject as _, type A2AServerLikeWithHandlers as a, handleGetAgentHistory as a0, handleGetWorkflows as a1, handleGetWorkflow as a2, handleExecuteWorkflow as a3, handleStreamWorkflow as a4, handleSuspendWorkflow as a5, handleCancelWorkflow as a6, handleResumeWorkflow as a7, handleGetWorkflowState as a8, type LogFilterOptions as a9, type LogHandlerResponse as aa, handleGetLogs as ab, listMemoryUsersHandler as ac, listMemoryConversationsHandler as ad, getConversationMessagesHandler as ae, getWorkingMemoryHandler as af, mapLogResponse as ag, mapHandlerResponse as ah, getResponseStatus as ai, type OpenApiInfo as aj, type AppSetupConfig as ak, getOrCreateLogger as al, shouldEnableSwaggerUI as am, getOpenApiDoc as an, DEFAULT_CORS_OPTIONS as ao, type StreamResponse as b, isSuccessResponse as c, type MemoryUserAgentSummary as d, type MemoryConversationSummary as e, type MemoryConversationMessagesResult as f, type MemoryWorkingMemoryResult as g, type MemoryListUsersQuery as h, isErrorResponse as i, type MemoryListConversationsQuery as j, type MemoryGetMessagesQuery as k, type RouteDefinition as l, AGENT_ROUTES as m, OBSERVABILITY_MEMORY_ROUTES as n, ALL_ROUTES as o, getAllRoutesArray as p, MCP_ROUTES as q, A2A_ROUTES as r, getRoutesByTag as s, parseJsonRpcRequest as t, resolveAgentCard as u, executeA2ARequest as v, type A2AJsonRpcId as w, type JsonRpcResponse as x, type JsonRpcStream as y, type JsonRpcHandlerResult as z };
package/dist/edge.d.mts CHANGED
@@ -1,4 +1,5 @@
1
- export { s as A2ARequestContext, h as A2A_ROUTES, e as AGENT_ROUTES, L as LOG_ROUTES, O as OBSERVABILITY_ROUTES, W as WORKFLOW_ROUTES, k as executeA2ARequest, a8 as getOrCreateLogger, F as handleChatStream, T as handleExecuteWorkflow, G as handleGenerateObject, C as handleGenerateText, K as handleGetAgent, N as handleGetAgentHistory, B as handleGetAgents, a2 as handleGetLogs, Q as handleGetWorkflow, $ as handleGetWorkflowState, P as handleGetWorkflows, _ as handleResumeWorkflow, I as handleStreamObject, D as handleStreamText, X as handleStreamWorkflow, Y as handleSuspendWorkflow, i as isErrorResponse, a3 as mapLogResponse, p as parseJsonRpcRequest, r as resolveAgentCard } from './edge-wNCsUs1i.mjs';
1
+ export { C as A2ARequestContext, r as A2A_ROUTES, m as AGENT_ROUTES, L as LOG_ROUTES, n as OBSERVABILITY_MEMORY_ROUTES, O as OBSERVABILITY_ROUTES, W as WORKFLOW_ROUTES, v as executeA2ARequest, ae as getConversationMessagesHandler, al as getOrCreateLogger, af as getWorkingMemoryHandler, Y as handleChatStream, a3 as handleExecuteWorkflow, Z as handleGenerateObject, T as handleGenerateText, $ as handleGetAgent, a0 as handleGetAgentHistory, Q as handleGetAgents, ab as handleGetLogs, a2 as handleGetWorkflow, a8 as handleGetWorkflowState, a1 as handleGetWorkflows, a7 as handleResumeWorkflow, _ as handleStreamObject, X as handleStreamText, a4 as handleStreamWorkflow, a5 as handleSuspendWorkflow, i as isErrorResponse, ad as listMemoryConversationsHandler, ac as listMemoryUsersHandler, ag as mapLogResponse, t as parseJsonRpcRequest, u as resolveAgentCard } from './edge-Dta7YML6.mjs';
2
2
  import '@voltagent/core';
3
3
  import '@voltagent/internal';
4
+ import 'ai';
4
5
  import '@voltagent/internal/a2a';
package/dist/edge.d.ts CHANGED
@@ -1,4 +1,5 @@
1
- export { s as A2ARequestContext, h as A2A_ROUTES, e as AGENT_ROUTES, L as LOG_ROUTES, O as OBSERVABILITY_ROUTES, W as WORKFLOW_ROUTES, k as executeA2ARequest, a8 as getOrCreateLogger, F as handleChatStream, T as handleExecuteWorkflow, G as handleGenerateObject, C as handleGenerateText, K as handleGetAgent, N as handleGetAgentHistory, B as handleGetAgents, a2 as handleGetLogs, Q as handleGetWorkflow, $ as handleGetWorkflowState, P as handleGetWorkflows, _ as handleResumeWorkflow, I as handleStreamObject, D as handleStreamText, X as handleStreamWorkflow, Y as handleSuspendWorkflow, i as isErrorResponse, a3 as mapLogResponse, p as parseJsonRpcRequest, r as resolveAgentCard } from './edge-wNCsUs1i.js';
1
+ export { C as A2ARequestContext, r as A2A_ROUTES, m as AGENT_ROUTES, L as LOG_ROUTES, n as OBSERVABILITY_MEMORY_ROUTES, O as OBSERVABILITY_ROUTES, W as WORKFLOW_ROUTES, v as executeA2ARequest, ae as getConversationMessagesHandler, al as getOrCreateLogger, af as getWorkingMemoryHandler, Y as handleChatStream, a3 as handleExecuteWorkflow, Z as handleGenerateObject, T as handleGenerateText, $ as handleGetAgent, a0 as handleGetAgentHistory, Q as handleGetAgents, ab as handleGetLogs, a2 as handleGetWorkflow, a8 as handleGetWorkflowState, a1 as handleGetWorkflows, a7 as handleResumeWorkflow, _ as handleStreamObject, X as handleStreamText, a4 as handleStreamWorkflow, a5 as handleSuspendWorkflow, i as isErrorResponse, ad as listMemoryConversationsHandler, ac as listMemoryUsersHandler, ag as mapLogResponse, t as parseJsonRpcRequest, u as resolveAgentCard } from './edge-Dta7YML6.js';
2
2
  import '@voltagent/core';
3
3
  import '@voltagent/internal';
4
+ import 'ai';
4
5
  import '@voltagent/internal/a2a';