@voltagent/server-core 2.1.2 → 2.1.4

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,4 +1,4 @@
1
- import { ServerProviderDeps, ConversationStepRecord, A2AServerRegistry } from '@voltagent/core';
1
+ import { ServerProviderDeps, ConversationStepRecord, Conversation, A2AServerRegistry } from '@voltagent/core';
2
2
  import { Logger, LogLevel, LogEntry, LogFilter } from '@voltagent/internal';
3
3
  import { UIMessage } from 'ai';
4
4
  import { A2AServerLike } from '@voltagent/internal/a2a';
@@ -332,6 +332,124 @@ declare const AGENT_ROUTES: {
332
332
  };
333
333
  };
334
334
  };
335
+ readonly getWorkspace: {
336
+ readonly method: "get";
337
+ readonly path: "/agents/:id/workspace";
338
+ readonly summary: "Get agent workspace info";
339
+ readonly description: "Retrieve workspace configuration metadata for an agent, including capabilities (filesystem, sandbox, search, skills).";
340
+ readonly tags: readonly ["Agent Workspace"];
341
+ readonly operationId: "getAgentWorkspace";
342
+ readonly responses: {
343
+ readonly 200: {
344
+ readonly description: "Successfully retrieved workspace info";
345
+ readonly contentType: "application/json";
346
+ };
347
+ readonly 404: {
348
+ readonly description: "Agent or workspace not found";
349
+ readonly contentType: "application/json";
350
+ };
351
+ readonly 500: {
352
+ readonly description: "Failed to retrieve workspace info due to server error";
353
+ readonly contentType: "application/json";
354
+ };
355
+ };
356
+ };
357
+ readonly listWorkspaceFiles: {
358
+ readonly method: "get";
359
+ readonly path: "/agents/:id/workspace/ls";
360
+ readonly summary: "List workspace files";
361
+ readonly description: "List files and directories under a workspace path.";
362
+ readonly tags: readonly ["Agent Workspace"];
363
+ readonly operationId: "listWorkspaceFiles";
364
+ readonly responses: {
365
+ readonly 200: {
366
+ readonly description: "Successfully listed workspace files";
367
+ readonly contentType: "application/json";
368
+ };
369
+ readonly 400: {
370
+ readonly description: "Invalid request parameters";
371
+ readonly contentType: "application/json";
372
+ };
373
+ readonly 404: {
374
+ readonly description: "Agent or workspace not found";
375
+ readonly contentType: "application/json";
376
+ };
377
+ readonly 500: {
378
+ readonly description: "Failed to list workspace files due to server error";
379
+ readonly contentType: "application/json";
380
+ };
381
+ };
382
+ };
383
+ readonly readWorkspaceFile: {
384
+ readonly method: "get";
385
+ readonly path: "/agents/:id/workspace/read";
386
+ readonly summary: "Read workspace file";
387
+ readonly description: "Read a file from the workspace filesystem.";
388
+ readonly tags: readonly ["Agent Workspace"];
389
+ readonly operationId: "readWorkspaceFile";
390
+ readonly responses: {
391
+ readonly 200: {
392
+ readonly description: "Successfully read workspace file";
393
+ readonly contentType: "application/json";
394
+ };
395
+ readonly 400: {
396
+ readonly description: "Invalid request parameters";
397
+ readonly contentType: "application/json";
398
+ };
399
+ readonly 404: {
400
+ readonly description: "Agent or workspace not found";
401
+ readonly contentType: "application/json";
402
+ };
403
+ readonly 500: {
404
+ readonly description: "Failed to read workspace file due to server error";
405
+ readonly contentType: "application/json";
406
+ };
407
+ };
408
+ };
409
+ readonly listWorkspaceSkills: {
410
+ readonly method: "get";
411
+ readonly path: "/agents/:id/workspace/skills";
412
+ readonly summary: "List workspace skills";
413
+ readonly description: "List available workspace skills for an agent.";
414
+ readonly tags: readonly ["Agent Workspace"];
415
+ readonly operationId: "listWorkspaceSkills";
416
+ readonly responses: {
417
+ readonly 200: {
418
+ readonly description: "Successfully listed workspace skills";
419
+ readonly contentType: "application/json";
420
+ };
421
+ readonly 404: {
422
+ readonly description: "Agent, workspace, or skills not found";
423
+ readonly contentType: "application/json";
424
+ };
425
+ readonly 500: {
426
+ readonly description: "Failed to list workspace skills due to server error";
427
+ readonly contentType: "application/json";
428
+ };
429
+ };
430
+ };
431
+ readonly getWorkspaceSkill: {
432
+ readonly method: "get";
433
+ readonly path: "/agents/:id/workspace/skills/:skillId";
434
+ readonly summary: "Get workspace skill";
435
+ readonly description: "Retrieve a specific workspace skill including its instructions.";
436
+ readonly tags: readonly ["Agent Workspace"];
437
+ readonly operationId: "getWorkspaceSkill";
438
+ readonly responses: {
439
+ readonly 200: {
440
+ readonly description: "Successfully retrieved workspace skill";
441
+ readonly contentType: "application/json";
442
+ };
443
+ readonly 404: {
444
+ readonly description: "Agent, workspace, or skill not found";
445
+ readonly contentType: "application/json";
446
+ };
447
+ readonly 500: {
448
+ readonly description: "Failed to retrieve workspace skill due to server error";
449
+ readonly contentType: "application/json";
450
+ };
451
+ };
452
+ };
335
453
  };
336
454
  /**
337
455
  * Workflow route definitions
@@ -848,7 +966,7 @@ declare const OBSERVABILITY_MEMORY_ROUTES: {
848
966
  readonly summary: "List memory conversations";
849
967
  readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
850
968
  readonly tags: readonly ["Observability", "Memory"];
851
- readonly operationId: "listMemoryConversations";
969
+ readonly operationId: "listObservabilityMemoryConversations";
852
970
  readonly responses: {
853
971
  readonly 200: {
854
972
  readonly description: "Successfully retrieved conversations";
@@ -976,6 +1094,291 @@ declare const TOOL_ROUTES: {
976
1094
  };
977
1095
  };
978
1096
  };
1097
+ /**
1098
+ * Memory route definitions
1099
+ */
1100
+ declare const MEMORY_ROUTES: {
1101
+ readonly listConversations: {
1102
+ readonly method: "get";
1103
+ readonly path: "/api/memory/conversations";
1104
+ readonly summary: "List memory conversations";
1105
+ readonly description: "Retrieve conversations stored in memory with optional filtering by resource or user.";
1106
+ readonly tags: readonly ["Memory"];
1107
+ readonly operationId: "listMemoryConversations";
1108
+ readonly responses: {
1109
+ readonly 200: {
1110
+ readonly description: "Successfully retrieved memory conversations";
1111
+ readonly contentType: "application/json";
1112
+ };
1113
+ readonly 400: {
1114
+ readonly description: "Invalid query parameters";
1115
+ readonly contentType: "application/json";
1116
+ };
1117
+ readonly 500: {
1118
+ readonly description: "Failed to list memory conversations";
1119
+ readonly contentType: "application/json";
1120
+ };
1121
+ };
1122
+ };
1123
+ readonly getConversation: {
1124
+ readonly method: "get";
1125
+ readonly path: "/api/memory/conversations/:conversationId";
1126
+ readonly summary: "Get conversation by ID";
1127
+ readonly description: "Retrieve a single conversation by ID from memory storage.";
1128
+ readonly tags: readonly ["Memory"];
1129
+ readonly operationId: "getMemoryConversation";
1130
+ readonly responses: {
1131
+ readonly 200: {
1132
+ readonly description: "Successfully retrieved conversation";
1133
+ readonly contentType: "application/json";
1134
+ };
1135
+ readonly 404: {
1136
+ readonly description: "Conversation not found";
1137
+ readonly contentType: "application/json";
1138
+ };
1139
+ readonly 500: {
1140
+ readonly description: "Failed to retrieve conversation";
1141
+ readonly contentType: "application/json";
1142
+ };
1143
+ };
1144
+ };
1145
+ readonly listMessages: {
1146
+ readonly method: "get";
1147
+ readonly path: "/api/memory/conversations/:conversationId/messages";
1148
+ readonly summary: "List conversation messages";
1149
+ readonly description: "Retrieve messages for a conversation with optional filtering.";
1150
+ readonly tags: readonly ["Memory"];
1151
+ readonly operationId: "listMemoryConversationMessages";
1152
+ readonly responses: {
1153
+ readonly 200: {
1154
+ readonly description: "Successfully retrieved conversation messages";
1155
+ readonly contentType: "application/json";
1156
+ };
1157
+ readonly 404: {
1158
+ readonly description: "Conversation not found";
1159
+ readonly contentType: "application/json";
1160
+ };
1161
+ readonly 500: {
1162
+ readonly description: "Failed to retrieve conversation messages";
1163
+ readonly contentType: "application/json";
1164
+ };
1165
+ };
1166
+ };
1167
+ readonly getMemoryWorkingMemory: {
1168
+ readonly method: "get";
1169
+ readonly path: "/api/memory/conversations/:conversationId/working-memory";
1170
+ readonly summary: "Get working memory";
1171
+ readonly description: "Retrieve working memory content for a conversation.";
1172
+ readonly tags: readonly ["Memory"];
1173
+ readonly operationId: "getMemoryWorkingMemory";
1174
+ readonly responses: {
1175
+ readonly 200: {
1176
+ readonly description: "Successfully retrieved working memory";
1177
+ readonly contentType: "application/json";
1178
+ };
1179
+ readonly 404: {
1180
+ readonly description: "Working memory not found";
1181
+ readonly contentType: "application/json";
1182
+ };
1183
+ readonly 500: {
1184
+ readonly description: "Failed to retrieve working memory";
1185
+ readonly contentType: "application/json";
1186
+ };
1187
+ };
1188
+ };
1189
+ readonly saveMessages: {
1190
+ readonly method: "post";
1191
+ readonly path: "/api/memory/save-messages";
1192
+ readonly summary: "Save messages";
1193
+ readonly description: "Persist new messages into memory storage.";
1194
+ readonly tags: readonly ["Memory"];
1195
+ readonly operationId: "saveMemoryMessages";
1196
+ readonly responses: {
1197
+ readonly 200: {
1198
+ readonly description: "Successfully saved messages";
1199
+ readonly contentType: "application/json";
1200
+ };
1201
+ readonly 400: {
1202
+ readonly description: "Invalid request body";
1203
+ readonly contentType: "application/json";
1204
+ };
1205
+ readonly 500: {
1206
+ readonly description: "Failed to save messages";
1207
+ readonly contentType: "application/json";
1208
+ };
1209
+ };
1210
+ };
1211
+ readonly createConversation: {
1212
+ readonly method: "post";
1213
+ readonly path: "/api/memory/conversations";
1214
+ readonly summary: "Create conversation";
1215
+ readonly description: "Create a new conversation in memory storage.";
1216
+ readonly tags: readonly ["Memory"];
1217
+ readonly operationId: "createMemoryConversation";
1218
+ readonly responses: {
1219
+ readonly 200: {
1220
+ readonly description: "Successfully created conversation";
1221
+ readonly contentType: "application/json";
1222
+ };
1223
+ readonly 400: {
1224
+ readonly description: "Invalid request body";
1225
+ readonly contentType: "application/json";
1226
+ };
1227
+ readonly 409: {
1228
+ readonly description: "Conversation already exists";
1229
+ readonly contentType: "application/json";
1230
+ };
1231
+ readonly 500: {
1232
+ readonly description: "Failed to create conversation";
1233
+ readonly contentType: "application/json";
1234
+ };
1235
+ };
1236
+ };
1237
+ readonly updateConversation: {
1238
+ readonly method: "patch";
1239
+ readonly path: "/api/memory/conversations/:conversationId";
1240
+ readonly summary: "Update conversation";
1241
+ readonly description: "Update an existing conversation in memory storage.";
1242
+ readonly tags: readonly ["Memory"];
1243
+ readonly operationId: "updateMemoryConversation";
1244
+ readonly responses: {
1245
+ readonly 200: {
1246
+ readonly description: "Successfully updated conversation";
1247
+ readonly contentType: "application/json";
1248
+ };
1249
+ readonly 400: {
1250
+ readonly description: "Invalid request body";
1251
+ readonly contentType: "application/json";
1252
+ };
1253
+ readonly 404: {
1254
+ readonly description: "Conversation not found";
1255
+ readonly contentType: "application/json";
1256
+ };
1257
+ readonly 500: {
1258
+ readonly description: "Failed to update conversation";
1259
+ readonly contentType: "application/json";
1260
+ };
1261
+ };
1262
+ };
1263
+ readonly deleteConversation: {
1264
+ readonly method: "delete";
1265
+ readonly path: "/api/memory/conversations/:conversationId";
1266
+ readonly summary: "Delete conversation";
1267
+ readonly description: "Delete a conversation and its messages from memory storage.";
1268
+ readonly tags: readonly ["Memory"];
1269
+ readonly operationId: "deleteMemoryConversation";
1270
+ readonly responses: {
1271
+ readonly 200: {
1272
+ readonly description: "Successfully deleted conversation";
1273
+ readonly contentType: "application/json";
1274
+ };
1275
+ readonly 404: {
1276
+ readonly description: "Conversation not found";
1277
+ readonly contentType: "application/json";
1278
+ };
1279
+ readonly 500: {
1280
+ readonly description: "Failed to delete conversation";
1281
+ readonly contentType: "application/json";
1282
+ };
1283
+ };
1284
+ };
1285
+ readonly cloneConversation: {
1286
+ readonly method: "post";
1287
+ readonly path: "/api/memory/conversations/:conversationId/clone";
1288
+ readonly summary: "Clone conversation";
1289
+ readonly description: "Create a copy of a conversation, optionally including messages.";
1290
+ readonly tags: readonly ["Memory"];
1291
+ readonly operationId: "cloneMemoryConversation";
1292
+ readonly responses: {
1293
+ readonly 200: {
1294
+ readonly description: "Successfully cloned conversation";
1295
+ readonly contentType: "application/json";
1296
+ };
1297
+ readonly 404: {
1298
+ readonly description: "Conversation not found";
1299
+ readonly contentType: "application/json";
1300
+ };
1301
+ readonly 409: {
1302
+ readonly description: "Conversation already exists";
1303
+ readonly contentType: "application/json";
1304
+ };
1305
+ readonly 500: {
1306
+ readonly description: "Failed to clone conversation";
1307
+ readonly contentType: "application/json";
1308
+ };
1309
+ };
1310
+ };
1311
+ readonly updateWorkingMemory: {
1312
+ readonly method: "post";
1313
+ readonly path: "/api/memory/conversations/:conversationId/working-memory";
1314
+ readonly summary: "Update working memory";
1315
+ readonly description: "Update working memory content for a conversation.";
1316
+ readonly tags: readonly ["Memory"];
1317
+ readonly operationId: "updateMemoryWorkingMemory";
1318
+ readonly responses: {
1319
+ readonly 200: {
1320
+ readonly description: "Successfully updated working memory";
1321
+ readonly contentType: "application/json";
1322
+ };
1323
+ readonly 400: {
1324
+ readonly description: "Invalid request body";
1325
+ readonly contentType: "application/json";
1326
+ };
1327
+ readonly 404: {
1328
+ readonly description: "Conversation not found";
1329
+ readonly contentType: "application/json";
1330
+ };
1331
+ readonly 500: {
1332
+ readonly description: "Failed to update working memory";
1333
+ readonly contentType: "application/json";
1334
+ };
1335
+ };
1336
+ };
1337
+ readonly deleteMessages: {
1338
+ readonly method: "post";
1339
+ readonly path: "/api/memory/messages/delete";
1340
+ readonly summary: "Delete messages";
1341
+ readonly description: "Delete specific messages from memory storage.";
1342
+ readonly tags: readonly ["Memory"];
1343
+ readonly operationId: "deleteMemoryMessages";
1344
+ readonly responses: {
1345
+ readonly 200: {
1346
+ readonly description: "Successfully deleted messages";
1347
+ readonly contentType: "application/json";
1348
+ };
1349
+ readonly 400: {
1350
+ readonly description: "Invalid request body";
1351
+ readonly contentType: "application/json";
1352
+ };
1353
+ readonly 500: {
1354
+ readonly description: "Failed to delete messages";
1355
+ readonly contentType: "application/json";
1356
+ };
1357
+ };
1358
+ };
1359
+ readonly searchMemory: {
1360
+ readonly method: "get";
1361
+ readonly path: "/api/memory/search";
1362
+ readonly summary: "Search memory";
1363
+ readonly description: "Search memory using semantic search when available.";
1364
+ readonly tags: readonly ["Memory"];
1365
+ readonly operationId: "searchMemory";
1366
+ readonly responses: {
1367
+ readonly 200: {
1368
+ readonly description: "Successfully searched memory";
1369
+ readonly contentType: "application/json";
1370
+ };
1371
+ readonly 400: {
1372
+ readonly description: "Invalid query parameters";
1373
+ readonly contentType: "application/json";
1374
+ };
1375
+ readonly 500: {
1376
+ readonly description: "Failed to search memory";
1377
+ readonly contentType: "application/json";
1378
+ };
1379
+ };
1380
+ };
1381
+ };
979
1382
  /**
980
1383
  * All route definitions combined
981
1384
  */
@@ -1004,7 +1407,7 @@ declare const ALL_ROUTES: {
1004
1407
  readonly summary: "List memory conversations";
1005
1408
  readonly description: "Retrieve conversations stored in memory with optional filtering by agent or user. Results are paginated and sorted by last update by default.";
1006
1409
  readonly tags: readonly ["Observability", "Memory"];
1007
- readonly operationId: "listMemoryConversations";
1410
+ readonly operationId: "listObservabilityMemoryConversations";
1008
1411
  readonly responses: {
1009
1412
  readonly 200: {
1010
1413
  readonly description: "Successfully retrieved conversations";
@@ -1060,13 +1463,269 @@ declare const ALL_ROUTES: {
1060
1463
  };
1061
1464
  };
1062
1465
  };
1063
- readonly getWorkingMemory: {
1466
+ readonly getWorkingMemory: {
1467
+ readonly method: "get";
1468
+ readonly path: "/observability/memory/working-memory";
1469
+ readonly summary: "Get working memory";
1470
+ readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
1471
+ readonly tags: readonly ["Observability", "Memory"];
1472
+ readonly operationId: "getWorkingMemory";
1473
+ readonly responses: {
1474
+ readonly 200: {
1475
+ readonly description: "Successfully retrieved working memory";
1476
+ readonly contentType: "application/json";
1477
+ };
1478
+ readonly 404: {
1479
+ readonly description: "Working memory not found";
1480
+ readonly contentType: "application/json";
1481
+ };
1482
+ readonly 500: {
1483
+ readonly description: "Failed to retrieve working memory due to server error";
1484
+ readonly contentType: "application/json";
1485
+ };
1486
+ };
1487
+ };
1488
+ readonly setupObservability: {
1489
+ readonly method: "post";
1490
+ readonly path: "/setup-observability";
1491
+ readonly summary: "Configure observability settings";
1492
+ readonly description: "Updates the .env file with VoltAgent public and secret keys to enable observability features. This allows automatic tracing and monitoring of agent operations.";
1493
+ readonly tags: readonly ["Observability"];
1494
+ readonly operationId: "setupObservability";
1495
+ readonly responses: {
1496
+ readonly 200: {
1497
+ readonly description: "Successfully configured observability settings";
1498
+ readonly contentType: "application/json";
1499
+ };
1500
+ readonly 400: {
1501
+ readonly description: "Invalid request - missing publicKey or secretKey";
1502
+ readonly contentType: "application/json";
1503
+ };
1504
+ readonly 500: {
1505
+ readonly description: "Failed to update .env file";
1506
+ readonly contentType: "application/json";
1507
+ };
1508
+ };
1509
+ };
1510
+ readonly getTraces: {
1511
+ readonly method: "get";
1512
+ readonly path: "/observability/traces";
1513
+ readonly summary: "List all traces";
1514
+ readonly description: "Retrieve all OpenTelemetry traces from the observability store. Each trace represents a complete operation with its spans showing the execution flow.";
1515
+ readonly tags: readonly ["Observability"];
1516
+ readonly operationId: "getTraces";
1517
+ readonly responses: {
1518
+ readonly 200: {
1519
+ readonly description: "Successfully retrieved traces";
1520
+ readonly contentType: "application/json";
1521
+ };
1522
+ readonly 500: {
1523
+ readonly description: "Failed to retrieve traces due to server error";
1524
+ readonly contentType: "application/json";
1525
+ };
1526
+ };
1527
+ };
1528
+ readonly getTraceById: {
1529
+ readonly method: "get";
1530
+ readonly path: "/observability/traces/:traceId";
1531
+ readonly summary: "Get trace by ID";
1532
+ readonly description: "Retrieve a specific trace and all its spans by trace ID.";
1533
+ readonly tags: readonly ["Observability"];
1534
+ readonly operationId: "getTraceById";
1535
+ readonly responses: {
1536
+ readonly 200: {
1537
+ readonly description: "Successfully retrieved trace";
1538
+ readonly contentType: "application/json";
1539
+ };
1540
+ readonly 404: {
1541
+ readonly description: "Trace not found";
1542
+ readonly contentType: "application/json";
1543
+ };
1544
+ readonly 500: {
1545
+ readonly description: "Failed to retrieve trace due to server error";
1546
+ readonly contentType: "application/json";
1547
+ };
1548
+ };
1549
+ };
1550
+ readonly getSpanById: {
1551
+ readonly method: "get";
1552
+ readonly path: "/observability/spans/:spanId";
1553
+ readonly summary: "Get span by ID";
1554
+ readonly description: "Retrieve a specific span by its ID.";
1555
+ readonly tags: readonly ["Observability"];
1556
+ readonly operationId: "getSpanById";
1557
+ readonly responses: {
1558
+ readonly 200: {
1559
+ readonly description: "Successfully retrieved span";
1560
+ readonly contentType: "application/json";
1561
+ };
1562
+ readonly 404: {
1563
+ readonly description: "Span not found";
1564
+ readonly contentType: "application/json";
1565
+ };
1566
+ readonly 500: {
1567
+ readonly description: "Failed to retrieve span due to server error";
1568
+ readonly contentType: "application/json";
1569
+ };
1570
+ };
1571
+ };
1572
+ readonly getObservabilityStatus: {
1573
+ readonly method: "get";
1574
+ readonly path: "/observability/status";
1575
+ readonly summary: "Get observability status";
1576
+ readonly description: "Check the status and configuration of the observability system.";
1577
+ readonly tags: readonly ["Observability"];
1578
+ readonly operationId: "getObservabilityStatus";
1579
+ readonly responses: {
1580
+ readonly 200: {
1581
+ readonly description: "Successfully retrieved observability status";
1582
+ readonly contentType: "application/json";
1583
+ };
1584
+ readonly 500: {
1585
+ readonly description: "Failed to retrieve status due to server error";
1586
+ readonly contentType: "application/json";
1587
+ };
1588
+ };
1589
+ };
1590
+ readonly getLogsByTraceId: {
1591
+ readonly method: "get";
1592
+ readonly path: "/observability/traces/:traceId/logs";
1593
+ readonly summary: "Get logs by trace ID";
1594
+ readonly description: "Retrieve all logs associated with a specific trace ID.";
1595
+ readonly tags: readonly ["Observability"];
1596
+ readonly operationId: "getLogsByTraceId";
1597
+ readonly responses: {
1598
+ readonly 200: {
1599
+ readonly description: "Successfully retrieved logs";
1600
+ readonly contentType: "application/json";
1601
+ };
1602
+ readonly 404: {
1603
+ readonly description: "No logs found for the trace";
1604
+ readonly contentType: "application/json";
1605
+ };
1606
+ readonly 500: {
1607
+ readonly description: "Failed to retrieve logs due to server error";
1608
+ readonly contentType: "application/json";
1609
+ };
1610
+ };
1611
+ };
1612
+ readonly getLogsBySpanId: {
1613
+ readonly method: "get";
1614
+ readonly path: "/observability/spans/:spanId/logs";
1615
+ readonly summary: "Get logs by span ID";
1616
+ readonly description: "Retrieve all logs associated with a specific span ID.";
1617
+ readonly tags: readonly ["Observability"];
1618
+ readonly operationId: "getLogsBySpanId";
1619
+ readonly responses: {
1620
+ readonly 200: {
1621
+ readonly description: "Successfully retrieved logs";
1622
+ readonly contentType: "application/json";
1623
+ };
1624
+ readonly 404: {
1625
+ readonly description: "No logs found for the span";
1626
+ readonly contentType: "application/json";
1627
+ };
1628
+ readonly 500: {
1629
+ readonly description: "Failed to retrieve logs due to server error";
1630
+ readonly contentType: "application/json";
1631
+ };
1632
+ };
1633
+ };
1634
+ readonly queryLogs: {
1635
+ readonly method: "get";
1636
+ readonly path: "/observability/logs";
1637
+ readonly summary: "Query logs";
1638
+ readonly description: "Query logs with filters such as severity, time range, trace ID, etc.";
1639
+ readonly tags: readonly ["Observability"];
1640
+ readonly operationId: "queryLogs";
1641
+ readonly responses: {
1642
+ readonly 200: {
1643
+ readonly description: "Successfully retrieved logs";
1644
+ readonly contentType: "application/json";
1645
+ };
1646
+ readonly 400: {
1647
+ readonly description: "Invalid query parameters";
1648
+ readonly contentType: "application/json";
1649
+ };
1650
+ readonly 500: {
1651
+ readonly description: "Failed to query logs due to server error";
1652
+ readonly contentType: "application/json";
1653
+ };
1654
+ };
1655
+ };
1656
+ readonly listConversations: {
1657
+ readonly method: "get";
1658
+ readonly path: "/api/memory/conversations";
1659
+ readonly summary: "List memory conversations";
1660
+ readonly description: "Retrieve conversations stored in memory with optional filtering by resource or user.";
1661
+ readonly tags: readonly ["Memory"];
1662
+ readonly operationId: "listMemoryConversations";
1663
+ readonly responses: {
1664
+ readonly 200: {
1665
+ readonly description: "Successfully retrieved memory conversations";
1666
+ readonly contentType: "application/json";
1667
+ };
1668
+ readonly 400: {
1669
+ readonly description: "Invalid query parameters";
1670
+ readonly contentType: "application/json";
1671
+ };
1672
+ readonly 500: {
1673
+ readonly description: "Failed to list memory conversations";
1674
+ readonly contentType: "application/json";
1675
+ };
1676
+ };
1677
+ };
1678
+ readonly getConversation: {
1679
+ readonly method: "get";
1680
+ readonly path: "/api/memory/conversations/:conversationId";
1681
+ readonly summary: "Get conversation by ID";
1682
+ readonly description: "Retrieve a single conversation by ID from memory storage.";
1683
+ readonly tags: readonly ["Memory"];
1684
+ readonly operationId: "getMemoryConversation";
1685
+ readonly responses: {
1686
+ readonly 200: {
1687
+ readonly description: "Successfully retrieved conversation";
1688
+ readonly contentType: "application/json";
1689
+ };
1690
+ readonly 404: {
1691
+ readonly description: "Conversation not found";
1692
+ readonly contentType: "application/json";
1693
+ };
1694
+ readonly 500: {
1695
+ readonly description: "Failed to retrieve conversation";
1696
+ readonly contentType: "application/json";
1697
+ };
1698
+ };
1699
+ };
1700
+ readonly listMessages: {
1701
+ readonly method: "get";
1702
+ readonly path: "/api/memory/conversations/:conversationId/messages";
1703
+ readonly summary: "List conversation messages";
1704
+ readonly description: "Retrieve messages for a conversation with optional filtering.";
1705
+ readonly tags: readonly ["Memory"];
1706
+ readonly operationId: "listMemoryConversationMessages";
1707
+ readonly responses: {
1708
+ readonly 200: {
1709
+ readonly description: "Successfully retrieved conversation messages";
1710
+ readonly contentType: "application/json";
1711
+ };
1712
+ readonly 404: {
1713
+ readonly description: "Conversation not found";
1714
+ readonly contentType: "application/json";
1715
+ };
1716
+ readonly 500: {
1717
+ readonly description: "Failed to retrieve conversation messages";
1718
+ readonly contentType: "application/json";
1719
+ };
1720
+ };
1721
+ };
1722
+ readonly getMemoryWorkingMemory: {
1064
1723
  readonly method: "get";
1065
- readonly path: "/observability/memory/working-memory";
1724
+ readonly path: "/api/memory/conversations/:conversationId/working-memory";
1066
1725
  readonly summary: "Get working memory";
1067
- readonly description: "Retrieve working memory content for a conversation or user. Specify the scope and relevant identifiers in query parameters.";
1068
- readonly tags: readonly ["Observability", "Memory"];
1069
- readonly operationId: "getWorkingMemory";
1726
+ readonly description: "Retrieve working memory content for a conversation.";
1727
+ readonly tags: readonly ["Memory"];
1728
+ readonly operationId: "getMemoryWorkingMemory";
1070
1729
  readonly responses: {
1071
1730
  readonly 200: {
1072
1731
  readonly description: "Successfully retrieved working memory";
@@ -1077,167 +1736,191 @@ declare const ALL_ROUTES: {
1077
1736
  readonly contentType: "application/json";
1078
1737
  };
1079
1738
  readonly 500: {
1080
- readonly description: "Failed to retrieve working memory due to server error";
1739
+ readonly description: "Failed to retrieve working memory";
1081
1740
  readonly contentType: "application/json";
1082
1741
  };
1083
1742
  };
1084
1743
  };
1085
- readonly setupObservability: {
1744
+ readonly saveMessages: {
1086
1745
  readonly method: "post";
1087
- readonly path: "/setup-observability";
1088
- readonly summary: "Configure observability settings";
1089
- readonly description: "Updates the .env file with VoltAgent public and secret keys to enable observability features. This allows automatic tracing and monitoring of agent operations.";
1090
- readonly tags: readonly ["Observability"];
1091
- readonly operationId: "setupObservability";
1746
+ readonly path: "/api/memory/save-messages";
1747
+ readonly summary: "Save messages";
1748
+ readonly description: "Persist new messages into memory storage.";
1749
+ readonly tags: readonly ["Memory"];
1750
+ readonly operationId: "saveMemoryMessages";
1092
1751
  readonly responses: {
1093
1752
  readonly 200: {
1094
- readonly description: "Successfully configured observability settings";
1753
+ readonly description: "Successfully saved messages";
1095
1754
  readonly contentType: "application/json";
1096
1755
  };
1097
1756
  readonly 400: {
1098
- readonly description: "Invalid request - missing publicKey or secretKey";
1757
+ readonly description: "Invalid request body";
1099
1758
  readonly contentType: "application/json";
1100
1759
  };
1101
1760
  readonly 500: {
1102
- readonly description: "Failed to update .env file";
1761
+ readonly description: "Failed to save messages";
1103
1762
  readonly contentType: "application/json";
1104
1763
  };
1105
1764
  };
1106
1765
  };
1107
- readonly getTraces: {
1108
- readonly method: "get";
1109
- readonly path: "/observability/traces";
1110
- readonly summary: "List all traces";
1111
- readonly description: "Retrieve all OpenTelemetry traces from the observability store. Each trace represents a complete operation with its spans showing the execution flow.";
1112
- readonly tags: readonly ["Observability"];
1113
- readonly operationId: "getTraces";
1766
+ readonly createConversation: {
1767
+ readonly method: "post";
1768
+ readonly path: "/api/memory/conversations";
1769
+ readonly summary: "Create conversation";
1770
+ readonly description: "Create a new conversation in memory storage.";
1771
+ readonly tags: readonly ["Memory"];
1772
+ readonly operationId: "createMemoryConversation";
1114
1773
  readonly responses: {
1115
1774
  readonly 200: {
1116
- readonly description: "Successfully retrieved traces";
1775
+ readonly description: "Successfully created conversation";
1776
+ readonly contentType: "application/json";
1777
+ };
1778
+ readonly 400: {
1779
+ readonly description: "Invalid request body";
1780
+ readonly contentType: "application/json";
1781
+ };
1782
+ readonly 409: {
1783
+ readonly description: "Conversation already exists";
1117
1784
  readonly contentType: "application/json";
1118
1785
  };
1119
1786
  readonly 500: {
1120
- readonly description: "Failed to retrieve traces due to server error";
1787
+ readonly description: "Failed to create conversation";
1121
1788
  readonly contentType: "application/json";
1122
1789
  };
1123
1790
  };
1124
1791
  };
1125
- readonly getTraceById: {
1126
- readonly method: "get";
1127
- readonly path: "/observability/traces/:traceId";
1128
- readonly summary: "Get trace by ID";
1129
- readonly description: "Retrieve a specific trace and all its spans by trace ID.";
1130
- readonly tags: readonly ["Observability"];
1131
- readonly operationId: "getTraceById";
1792
+ readonly updateConversation: {
1793
+ readonly method: "patch";
1794
+ readonly path: "/api/memory/conversations/:conversationId";
1795
+ readonly summary: "Update conversation";
1796
+ readonly description: "Update an existing conversation in memory storage.";
1797
+ readonly tags: readonly ["Memory"];
1798
+ readonly operationId: "updateMemoryConversation";
1132
1799
  readonly responses: {
1133
1800
  readonly 200: {
1134
- readonly description: "Successfully retrieved trace";
1801
+ readonly description: "Successfully updated conversation";
1802
+ readonly contentType: "application/json";
1803
+ };
1804
+ readonly 400: {
1805
+ readonly description: "Invalid request body";
1135
1806
  readonly contentType: "application/json";
1136
1807
  };
1137
1808
  readonly 404: {
1138
- readonly description: "Trace not found";
1809
+ readonly description: "Conversation not found";
1139
1810
  readonly contentType: "application/json";
1140
1811
  };
1141
1812
  readonly 500: {
1142
- readonly description: "Failed to retrieve trace due to server error";
1813
+ readonly description: "Failed to update conversation";
1143
1814
  readonly contentType: "application/json";
1144
1815
  };
1145
1816
  };
1146
1817
  };
1147
- readonly getSpanById: {
1148
- readonly method: "get";
1149
- readonly path: "/observability/spans/:spanId";
1150
- readonly summary: "Get span by ID";
1151
- readonly description: "Retrieve a specific span by its ID.";
1152
- readonly tags: readonly ["Observability"];
1153
- readonly operationId: "getSpanById";
1818
+ readonly deleteConversation: {
1819
+ readonly method: "delete";
1820
+ readonly path: "/api/memory/conversations/:conversationId";
1821
+ readonly summary: "Delete conversation";
1822
+ readonly description: "Delete a conversation and its messages from memory storage.";
1823
+ readonly tags: readonly ["Memory"];
1824
+ readonly operationId: "deleteMemoryConversation";
1154
1825
  readonly responses: {
1155
1826
  readonly 200: {
1156
- readonly description: "Successfully retrieved span";
1827
+ readonly description: "Successfully deleted conversation";
1157
1828
  readonly contentType: "application/json";
1158
1829
  };
1159
1830
  readonly 404: {
1160
- readonly description: "Span not found";
1831
+ readonly description: "Conversation not found";
1161
1832
  readonly contentType: "application/json";
1162
1833
  };
1163
1834
  readonly 500: {
1164
- readonly description: "Failed to retrieve span due to server error";
1835
+ readonly description: "Failed to delete conversation";
1165
1836
  readonly contentType: "application/json";
1166
1837
  };
1167
1838
  };
1168
1839
  };
1169
- readonly getObservabilityStatus: {
1170
- readonly method: "get";
1171
- readonly path: "/observability/status";
1172
- readonly summary: "Get observability status";
1173
- readonly description: "Check the status and configuration of the observability system.";
1174
- readonly tags: readonly ["Observability"];
1175
- readonly operationId: "getObservabilityStatus";
1840
+ readonly cloneConversation: {
1841
+ readonly method: "post";
1842
+ readonly path: "/api/memory/conversations/:conversationId/clone";
1843
+ readonly summary: "Clone conversation";
1844
+ readonly description: "Create a copy of a conversation, optionally including messages.";
1845
+ readonly tags: readonly ["Memory"];
1846
+ readonly operationId: "cloneMemoryConversation";
1176
1847
  readonly responses: {
1177
1848
  readonly 200: {
1178
- readonly description: "Successfully retrieved observability status";
1849
+ readonly description: "Successfully cloned conversation";
1850
+ readonly contentType: "application/json";
1851
+ };
1852
+ readonly 404: {
1853
+ readonly description: "Conversation not found";
1854
+ readonly contentType: "application/json";
1855
+ };
1856
+ readonly 409: {
1857
+ readonly description: "Conversation already exists";
1179
1858
  readonly contentType: "application/json";
1180
1859
  };
1181
1860
  readonly 500: {
1182
- readonly description: "Failed to retrieve status due to server error";
1861
+ readonly description: "Failed to clone conversation";
1183
1862
  readonly contentType: "application/json";
1184
1863
  };
1185
1864
  };
1186
1865
  };
1187
- readonly getLogsByTraceId: {
1188
- readonly method: "get";
1189
- readonly path: "/observability/traces/:traceId/logs";
1190
- readonly summary: "Get logs by trace ID";
1191
- readonly description: "Retrieve all logs associated with a specific trace ID.";
1192
- readonly tags: readonly ["Observability"];
1193
- readonly operationId: "getLogsByTraceId";
1866
+ readonly updateWorkingMemory: {
1867
+ readonly method: "post";
1868
+ readonly path: "/api/memory/conversations/:conversationId/working-memory";
1869
+ readonly summary: "Update working memory";
1870
+ readonly description: "Update working memory content for a conversation.";
1871
+ readonly tags: readonly ["Memory"];
1872
+ readonly operationId: "updateMemoryWorkingMemory";
1194
1873
  readonly responses: {
1195
1874
  readonly 200: {
1196
- readonly description: "Successfully retrieved logs";
1875
+ readonly description: "Successfully updated working memory";
1876
+ readonly contentType: "application/json";
1877
+ };
1878
+ readonly 400: {
1879
+ readonly description: "Invalid request body";
1197
1880
  readonly contentType: "application/json";
1198
1881
  };
1199
1882
  readonly 404: {
1200
- readonly description: "No logs found for the trace";
1883
+ readonly description: "Conversation not found";
1201
1884
  readonly contentType: "application/json";
1202
1885
  };
1203
1886
  readonly 500: {
1204
- readonly description: "Failed to retrieve logs due to server error";
1887
+ readonly description: "Failed to update working memory";
1205
1888
  readonly contentType: "application/json";
1206
1889
  };
1207
1890
  };
1208
1891
  };
1209
- readonly getLogsBySpanId: {
1210
- readonly method: "get";
1211
- readonly path: "/observability/spans/:spanId/logs";
1212
- readonly summary: "Get logs by span ID";
1213
- readonly description: "Retrieve all logs associated with a specific span ID.";
1214
- readonly tags: readonly ["Observability"];
1215
- readonly operationId: "getLogsBySpanId";
1892
+ readonly deleteMessages: {
1893
+ readonly method: "post";
1894
+ readonly path: "/api/memory/messages/delete";
1895
+ readonly summary: "Delete messages";
1896
+ readonly description: "Delete specific messages from memory storage.";
1897
+ readonly tags: readonly ["Memory"];
1898
+ readonly operationId: "deleteMemoryMessages";
1216
1899
  readonly responses: {
1217
1900
  readonly 200: {
1218
- readonly description: "Successfully retrieved logs";
1901
+ readonly description: "Successfully deleted messages";
1219
1902
  readonly contentType: "application/json";
1220
1903
  };
1221
- readonly 404: {
1222
- readonly description: "No logs found for the span";
1904
+ readonly 400: {
1905
+ readonly description: "Invalid request body";
1223
1906
  readonly contentType: "application/json";
1224
1907
  };
1225
1908
  readonly 500: {
1226
- readonly description: "Failed to retrieve logs due to server error";
1909
+ readonly description: "Failed to delete messages";
1227
1910
  readonly contentType: "application/json";
1228
1911
  };
1229
1912
  };
1230
1913
  };
1231
- readonly queryLogs: {
1914
+ readonly searchMemory: {
1232
1915
  readonly method: "get";
1233
- readonly path: "/observability/logs";
1234
- readonly summary: "Query logs";
1235
- readonly description: "Query logs with filters such as severity, time range, trace ID, etc.";
1236
- readonly tags: readonly ["Observability"];
1237
- readonly operationId: "queryLogs";
1916
+ readonly path: "/api/memory/search";
1917
+ readonly summary: "Search memory";
1918
+ readonly description: "Search memory using semantic search when available.";
1919
+ readonly tags: readonly ["Memory"];
1920
+ readonly operationId: "searchMemory";
1238
1921
  readonly responses: {
1239
1922
  readonly 200: {
1240
- readonly description: "Successfully retrieved logs";
1923
+ readonly description: "Successfully searched memory";
1241
1924
  readonly contentType: "application/json";
1242
1925
  };
1243
1926
  readonly 400: {
@@ -1245,7 +1928,7 @@ declare const ALL_ROUTES: {
1245
1928
  readonly contentType: "application/json";
1246
1929
  };
1247
1930
  readonly 500: {
1248
- readonly description: "Failed to query logs due to server error";
1931
+ readonly description: "Failed to search memory";
1249
1932
  readonly contentType: "application/json";
1250
1933
  };
1251
1934
  };
@@ -1818,6 +2501,124 @@ declare const ALL_ROUTES: {
1818
2501
  };
1819
2502
  };
1820
2503
  };
2504
+ readonly getWorkspace: {
2505
+ readonly method: "get";
2506
+ readonly path: "/agents/:id/workspace";
2507
+ readonly summary: "Get agent workspace info";
2508
+ readonly description: "Retrieve workspace configuration metadata for an agent, including capabilities (filesystem, sandbox, search, skills).";
2509
+ readonly tags: readonly ["Agent Workspace"];
2510
+ readonly operationId: "getAgentWorkspace";
2511
+ readonly responses: {
2512
+ readonly 200: {
2513
+ readonly description: "Successfully retrieved workspace info";
2514
+ readonly contentType: "application/json";
2515
+ };
2516
+ readonly 404: {
2517
+ readonly description: "Agent or workspace not found";
2518
+ readonly contentType: "application/json";
2519
+ };
2520
+ readonly 500: {
2521
+ readonly description: "Failed to retrieve workspace info due to server error";
2522
+ readonly contentType: "application/json";
2523
+ };
2524
+ };
2525
+ };
2526
+ readonly listWorkspaceFiles: {
2527
+ readonly method: "get";
2528
+ readonly path: "/agents/:id/workspace/ls";
2529
+ readonly summary: "List workspace files";
2530
+ readonly description: "List files and directories under a workspace path.";
2531
+ readonly tags: readonly ["Agent Workspace"];
2532
+ readonly operationId: "listWorkspaceFiles";
2533
+ readonly responses: {
2534
+ readonly 200: {
2535
+ readonly description: "Successfully listed workspace files";
2536
+ readonly contentType: "application/json";
2537
+ };
2538
+ readonly 400: {
2539
+ readonly description: "Invalid request parameters";
2540
+ readonly contentType: "application/json";
2541
+ };
2542
+ readonly 404: {
2543
+ readonly description: "Agent or workspace not found";
2544
+ readonly contentType: "application/json";
2545
+ };
2546
+ readonly 500: {
2547
+ readonly description: "Failed to list workspace files due to server error";
2548
+ readonly contentType: "application/json";
2549
+ };
2550
+ };
2551
+ };
2552
+ readonly readWorkspaceFile: {
2553
+ readonly method: "get";
2554
+ readonly path: "/agents/:id/workspace/read";
2555
+ readonly summary: "Read workspace file";
2556
+ readonly description: "Read a file from the workspace filesystem.";
2557
+ readonly tags: readonly ["Agent Workspace"];
2558
+ readonly operationId: "readWorkspaceFile";
2559
+ readonly responses: {
2560
+ readonly 200: {
2561
+ readonly description: "Successfully read workspace file";
2562
+ readonly contentType: "application/json";
2563
+ };
2564
+ readonly 400: {
2565
+ readonly description: "Invalid request parameters";
2566
+ readonly contentType: "application/json";
2567
+ };
2568
+ readonly 404: {
2569
+ readonly description: "Agent or workspace not found";
2570
+ readonly contentType: "application/json";
2571
+ };
2572
+ readonly 500: {
2573
+ readonly description: "Failed to read workspace file due to server error";
2574
+ readonly contentType: "application/json";
2575
+ };
2576
+ };
2577
+ };
2578
+ readonly listWorkspaceSkills: {
2579
+ readonly method: "get";
2580
+ readonly path: "/agents/:id/workspace/skills";
2581
+ readonly summary: "List workspace skills";
2582
+ readonly description: "List available workspace skills for an agent.";
2583
+ readonly tags: readonly ["Agent Workspace"];
2584
+ readonly operationId: "listWorkspaceSkills";
2585
+ readonly responses: {
2586
+ readonly 200: {
2587
+ readonly description: "Successfully listed workspace skills";
2588
+ readonly contentType: "application/json";
2589
+ };
2590
+ readonly 404: {
2591
+ readonly description: "Agent, workspace, or skills not found";
2592
+ readonly contentType: "application/json";
2593
+ };
2594
+ readonly 500: {
2595
+ readonly description: "Failed to list workspace skills due to server error";
2596
+ readonly contentType: "application/json";
2597
+ };
2598
+ };
2599
+ };
2600
+ readonly getWorkspaceSkill: {
2601
+ readonly method: "get";
2602
+ readonly path: "/agents/:id/workspace/skills/:skillId";
2603
+ readonly summary: "Get workspace skill";
2604
+ readonly description: "Retrieve a specific workspace skill including its instructions.";
2605
+ readonly tags: readonly ["Agent Workspace"];
2606
+ readonly operationId: "getWorkspaceSkill";
2607
+ readonly responses: {
2608
+ readonly 200: {
2609
+ readonly description: "Successfully retrieved workspace skill";
2610
+ readonly contentType: "application/json";
2611
+ };
2612
+ readonly 404: {
2613
+ readonly description: "Agent, workspace, or skill not found";
2614
+ readonly contentType: "application/json";
2615
+ };
2616
+ readonly 500: {
2617
+ readonly description: "Failed to retrieve workspace skill due to server error";
2618
+ readonly contentType: "application/json";
2619
+ };
2620
+ };
2621
+ };
1821
2622
  };
1822
2623
  /**
1823
2624
  * Helper to get all routes as an array
@@ -2229,6 +3030,34 @@ declare function handleGetAgent(agentId: string, deps: ServerProviderDeps, logge
2229
3030
  * Returns agent history data
2230
3031
  */
2231
3032
  declare function handleGetAgentHistory(agentId: string, page: number, limit: number, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
3033
+ /**
3034
+ * Handler for getting agent workspace info
3035
+ */
3036
+ declare function handleGetAgentWorkspaceInfo(agentId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
3037
+ /**
3038
+ * Handler for listing workspace files
3039
+ */
3040
+ declare function handleListAgentWorkspaceFiles(agentId: string, options: {
3041
+ path?: string;
3042
+ }, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
3043
+ /**
3044
+ * Handler for reading a workspace file
3045
+ */
3046
+ declare function handleReadAgentWorkspaceFile(agentId: string, options: {
3047
+ path?: string;
3048
+ offset?: unknown;
3049
+ limit?: unknown;
3050
+ }, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
3051
+ /**
3052
+ * Handler for listing workspace skills
3053
+ */
3054
+ declare function handleListAgentWorkspaceSkills(agentId: string, options: {
3055
+ refresh?: unknown;
3056
+ }, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
3057
+ /**
3058
+ * Handler for reading a workspace skill
3059
+ */
3060
+ declare function handleGetAgentWorkspaceSkill(agentId: string, skillId: string, deps: ServerProviderDeps, logger: Logger): Promise<ApiResponse>;
2232
3061
 
2233
3062
  /**
2234
3063
  * Log filter options for querying logs
@@ -2327,6 +3156,127 @@ declare function getWorkingMemoryHandler(deps: ServerProviderDeps, params: {
2327
3156
  scope: "conversation" | "user";
2328
3157
  }): Promise<ApiResponse<MemoryWorkingMemoryResult>>;
2329
3158
 
3159
+ declare function handleListMemoryConversations(deps: ServerProviderDeps, query: {
3160
+ agentId?: string;
3161
+ resourceId?: string;
3162
+ userId?: string;
3163
+ limit?: number;
3164
+ offset?: number;
3165
+ orderBy?: "created_at" | "updated_at" | "title";
3166
+ orderDirection?: "ASC" | "DESC";
3167
+ }): Promise<ApiResponse<{
3168
+ conversations: Conversation[];
3169
+ total: number;
3170
+ limit: number;
3171
+ offset: number;
3172
+ }>>;
3173
+ declare function handleGetMemoryConversation(deps: ServerProviderDeps, conversationId: string, query: {
3174
+ agentId?: string;
3175
+ }): Promise<ApiResponse<{
3176
+ conversation: Conversation;
3177
+ }>>;
3178
+ declare function handleListMemoryConversationMessages(deps: ServerProviderDeps, conversationId: string, query: {
3179
+ agentId?: string;
3180
+ limit?: number;
3181
+ before?: Date;
3182
+ after?: Date;
3183
+ roles?: string[];
3184
+ userId?: string;
3185
+ }): Promise<ApiResponse<{
3186
+ conversation: Conversation;
3187
+ messages: UIMessage[];
3188
+ }>>;
3189
+ declare function handleGetMemoryWorkingMemory(deps: ServerProviderDeps, conversationId: string, query: {
3190
+ agentId?: string;
3191
+ scope?: "conversation" | "user";
3192
+ userId?: string;
3193
+ }): Promise<ApiResponse<{
3194
+ content: string | null;
3195
+ format: "markdown" | "json" | null;
3196
+ template: string | null;
3197
+ scope: "conversation" | "user";
3198
+ }>>;
3199
+ type SaveMessageEntry = (UIMessage & {
3200
+ userId?: string;
3201
+ conversationId?: string;
3202
+ }) | {
3203
+ message: UIMessage;
3204
+ userId?: string;
3205
+ conversationId?: string;
3206
+ };
3207
+ declare function handleSaveMemoryMessages(deps: ServerProviderDeps, body: {
3208
+ agentId?: string;
3209
+ userId?: string;
3210
+ conversationId?: string;
3211
+ messages?: SaveMessageEntry[];
3212
+ }): Promise<ApiResponse<{
3213
+ saved: number;
3214
+ }>>;
3215
+ declare function handleCreateMemoryConversation(deps: ServerProviderDeps, body: {
3216
+ agentId?: string;
3217
+ conversationId?: string;
3218
+ resourceId?: string;
3219
+ userId?: string;
3220
+ title?: string;
3221
+ metadata?: Record<string, unknown>;
3222
+ }): Promise<ApiResponse<{
3223
+ conversation: Conversation;
3224
+ }>>;
3225
+ declare function handleUpdateMemoryConversation(deps: ServerProviderDeps, conversationId: string, body: {
3226
+ agentId?: string;
3227
+ resourceId?: string;
3228
+ userId?: string;
3229
+ title?: string;
3230
+ metadata?: Record<string, unknown>;
3231
+ }): Promise<ApiResponse<{
3232
+ conversation: Conversation;
3233
+ }>>;
3234
+ declare function handleDeleteMemoryConversation(deps: ServerProviderDeps, conversationId: string, query: {
3235
+ agentId?: string;
3236
+ }): Promise<ApiResponse<{
3237
+ deleted: boolean;
3238
+ }>>;
3239
+ declare function handleCloneMemoryConversation(deps: ServerProviderDeps, conversationId: string, body: {
3240
+ agentId?: string;
3241
+ newConversationId?: string;
3242
+ resourceId?: string;
3243
+ userId?: string;
3244
+ title?: string;
3245
+ metadata?: Record<string, unknown>;
3246
+ includeMessages?: boolean;
3247
+ }): Promise<ApiResponse<{
3248
+ conversation: Conversation;
3249
+ messageCount: number;
3250
+ }>>;
3251
+ declare function handleUpdateMemoryWorkingMemory(deps: ServerProviderDeps, conversationId: string, body: {
3252
+ agentId?: string;
3253
+ userId?: string;
3254
+ content?: string | Record<string, unknown>;
3255
+ mode?: "replace" | "append";
3256
+ }): Promise<ApiResponse<{
3257
+ updated: boolean;
3258
+ }>>;
3259
+ declare function handleDeleteMemoryMessages(deps: ServerProviderDeps, body: {
3260
+ agentId?: string;
3261
+ conversationId?: string;
3262
+ userId?: string;
3263
+ messageIds?: string[];
3264
+ }): Promise<ApiResponse<{
3265
+ deleted: number;
3266
+ }>>;
3267
+ declare function handleSearchMemory(deps: ServerProviderDeps, query: {
3268
+ agentId?: string;
3269
+ searchQuery?: string;
3270
+ limit?: number;
3271
+ threshold?: number;
3272
+ conversationId?: string;
3273
+ userId?: string;
3274
+ }): Promise<ApiResponse<{
3275
+ results: unknown[];
3276
+ count: number;
3277
+ query: string;
3278
+ }>>;
3279
+
2330
3280
  type A2AJsonRpcId = string | number | null;
2331
3281
  interface JsonRpcError<Data = unknown> {
2332
3282
  code: number;
@@ -2447,4 +3397,4 @@ declare function mapHandlerResponse(response: ApiResponse, type?: string): ApiRe
2447
3397
  */
2448
3398
  declare function getResponseStatus(response: ApiResponse): number;
2449
3399
 
2450
- export { handleChatStream as $, type ApiResponse as A, type JsonRpcStream as B, type JsonRpcHandlerResult as C, type JsonRpcRequest as D, type ErrorResponse as E, type A2ARequestContext as F, type AgentCardSkill as G, type HttpMethod as H, type AgentCardProviderInfo as I, type JsonRpcError as J, type AgentCardCapabilities as K, LOG_ROUTES as L, type MemoryUserSummary as M, type AgentCard as N, OBSERVABILITY_ROUTES as O, A2AErrorCode as P, normalizeError as Q, type ResponseDefinition as R, type SuccessResponse as S, TOOL_ROUTES as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, isJsonRpcRequest as X, handleGetAgents as Y, handleGenerateText as Z, handleStreamText as _, type A2AServerLikeWithHandlers as a, handleResumeChatStream as a0, handleGenerateObject as a1, handleStreamObject as a2, handleGetAgent as a3, handleGetAgentHistory as a4, handleGetWorkflows as a5, handleGetWorkflow as a6, handleExecuteWorkflow as a7, handleStreamWorkflow as a8, handleSuspendWorkflow as a9, handleCancelWorkflow as aa, handleResumeWorkflow as ab, handleListWorkflowRuns as ac, handleGetWorkflowState as ad, type LogFilterOptions as ae, type LogHandlerResponse as af, handleGetLogs as ag, listMemoryUsersHandler as ah, listMemoryConversationsHandler as ai, getConversationMessagesHandler as aj, getConversationStepsHandler as ak, getWorkingMemoryHandler as al, mapLogResponse as am, mapHandlerResponse as an, getResponseStatus as ao, type OpenApiInfo as ap, type AppSetupConfig as aq, getOrCreateLogger as ar, shouldEnableSwaggerUI as as, getOpenApiDoc as at, DEFAULT_CORS_OPTIONS as au, type StreamResponse as b, isSuccessResponse as c, type MemoryUserAgentSummary as d, type MemoryConversationSummary as e, type MemoryConversationMessagesResult as f, type MemoryConversationStepsResult as g, type MemoryWorkingMemoryResult as h, isErrorResponse as i, type MemoryListUsersQuery as j, type MemoryListConversationsQuery as k, type MemoryGetMessagesQuery as l, type MemoryGetStepsQuery as m, type RouteDefinition as n, AGENT_ROUTES as o, OBSERVABILITY_MEMORY_ROUTES as p, ALL_ROUTES as q, getAllRoutesArray as r, MCP_ROUTES as s, A2A_ROUTES as t, getRoutesByTag as u, parseJsonRpcRequest as v, resolveAgentCard as w, executeA2ARequest as x, type A2AJsonRpcId as y, type JsonRpcResponse as z };
3400
+ export { handleStreamText as $, type ApiResponse as A, type JsonRpcResponse as B, type JsonRpcStream as C, type JsonRpcHandlerResult as D, type ErrorResponse as E, type JsonRpcRequest as F, type A2ARequestContext as G, type HttpMethod as H, type AgentCardSkill as I, type JsonRpcError as J, type AgentCardProviderInfo as K, LOG_ROUTES as L, type MemoryUserSummary as M, type AgentCardCapabilities as N, OBSERVABILITY_ROUTES as O, type AgentCard as P, A2AErrorCode as Q, type ResponseDefinition as R, type SuccessResponse as S, TOOL_ROUTES as T, UPDATE_ROUTES as U, VoltA2AError as V, WORKFLOW_ROUTES as W, normalizeError as X, isJsonRpcRequest as Y, handleGetAgents as Z, handleGenerateText as _, type A2AServerLikeWithHandlers as a, handleChatStream as a0, handleResumeChatStream as a1, handleGenerateObject as a2, handleStreamObject as a3, handleGetAgent as a4, handleGetAgentHistory as a5, handleGetAgentWorkspaceInfo as a6, handleListAgentWorkspaceFiles as a7, handleReadAgentWorkspaceFile as a8, handleListAgentWorkspaceSkills as a9, listMemoryConversationsHandler as aA, getConversationMessagesHandler as aB, getConversationStepsHandler as aC, getWorkingMemoryHandler as aD, mapLogResponse as aE, mapHandlerResponse as aF, getResponseStatus as aG, type OpenApiInfo as aH, type AppSetupConfig as aI, getOrCreateLogger as aJ, shouldEnableSwaggerUI as aK, getOpenApiDoc as aL, DEFAULT_CORS_OPTIONS as aM, handleGetAgentWorkspaceSkill as aa, handleGetWorkflows as ab, handleGetWorkflow as ac, handleExecuteWorkflow as ad, handleStreamWorkflow as ae, handleSuspendWorkflow as af, handleCancelWorkflow as ag, handleResumeWorkflow as ah, handleListWorkflowRuns as ai, handleGetWorkflowState as aj, type LogFilterOptions as ak, type LogHandlerResponse as al, handleGetLogs as am, handleListMemoryConversations as an, handleGetMemoryConversation as ao, handleListMemoryConversationMessages as ap, handleGetMemoryWorkingMemory as aq, handleSaveMemoryMessages as ar, handleCreateMemoryConversation as as, handleUpdateMemoryConversation as at, handleDeleteMemoryConversation as au, handleCloneMemoryConversation as av, handleUpdateMemoryWorkingMemory as aw, handleDeleteMemoryMessages as ax, handleSearchMemory as ay, listMemoryUsersHandler as az, type StreamResponse as b, isSuccessResponse as c, type MemoryUserAgentSummary as d, type MemoryConversationSummary as e, type MemoryConversationMessagesResult as f, type MemoryConversationStepsResult as g, type MemoryWorkingMemoryResult as h, isErrorResponse as i, type MemoryListUsersQuery as j, type MemoryListConversationsQuery as k, type MemoryGetMessagesQuery as l, type MemoryGetStepsQuery as m, type RouteDefinition as n, AGENT_ROUTES as o, OBSERVABILITY_MEMORY_ROUTES as p, MEMORY_ROUTES as q, ALL_ROUTES as r, getAllRoutesArray as s, MCP_ROUTES as t, A2A_ROUTES as u, getRoutesByTag as v, parseJsonRpcRequest as w, resolveAgentCard as x, executeA2ARequest as y, type A2AJsonRpcId as z };