@robota-sdk/agent-core 3.0.0-beta.4 → 3.0.0-beta.43

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.
Files changed (504) hide show
  1. package/README.md +72 -186
  2. package/dist/browser/index.d.ts +302 -87
  3. package/dist/browser/index.js +10 -4
  4. package/dist/node/index.cjs +10 -4
  5. package/dist/node/index.d.cts +302 -87
  6. package/dist/node/index.d.ts +302 -87
  7. package/dist/node/index.js +10 -4
  8. package/package.json +1 -2
  9. package/dist/abstracts/abstract-agent.d.ts +0 -56
  10. package/dist/abstracts/abstract-agent.d.ts.map +0 -1
  11. package/dist/abstracts/abstract-agent.js +0 -55
  12. package/dist/abstracts/abstract-agent.js.map +0 -1
  13. package/dist/abstracts/abstract-ai-provider.d.ts +0 -187
  14. package/dist/abstracts/abstract-ai-provider.d.ts.map +0 -1
  15. package/dist/abstracts/abstract-ai-provider.js +0 -252
  16. package/dist/abstracts/abstract-ai-provider.js.map +0 -1
  17. package/dist/abstracts/abstract-executor.d.ts +0 -110
  18. package/dist/abstracts/abstract-executor.d.ts.map +0 -1
  19. package/dist/abstracts/abstract-executor.js +0 -156
  20. package/dist/abstracts/abstract-executor.js.map +0 -1
  21. package/dist/abstracts/abstract-manager.d.ts +0 -42
  22. package/dist/abstracts/abstract-manager.d.ts.map +0 -1
  23. package/dist/abstracts/abstract-manager.js +0 -49
  24. package/dist/abstracts/abstract-manager.js.map +0 -1
  25. package/dist/abstracts/abstract-module.d.ts +0 -365
  26. package/dist/abstracts/abstract-module.d.ts.map +0 -1
  27. package/dist/abstracts/abstract-module.js +0 -474
  28. package/dist/abstracts/abstract-module.js.map +0 -1
  29. package/dist/abstracts/abstract-plugin.d.ts +0 -369
  30. package/dist/abstracts/abstract-plugin.d.ts.map +0 -1
  31. package/dist/abstracts/abstract-plugin.js +0 -258
  32. package/dist/abstracts/abstract-plugin.js.map +0 -1
  33. package/dist/abstracts/abstract-tool.d.ts +0 -175
  34. package/dist/abstracts/abstract-tool.d.ts.map +0 -1
  35. package/dist/abstracts/abstract-tool.js +0 -140
  36. package/dist/abstracts/abstract-tool.js.map +0 -1
  37. package/dist/abstracts/abstract-workflow-converter.d.ts +0 -136
  38. package/dist/abstracts/abstract-workflow-converter.d.ts.map +0 -1
  39. package/dist/abstracts/abstract-workflow-converter.js +0 -252
  40. package/dist/abstracts/abstract-workflow-converter.js.map +0 -1
  41. package/dist/abstracts/abstract-workflow-validator.d.ts +0 -203
  42. package/dist/abstracts/abstract-workflow-validator.d.ts.map +0 -1
  43. package/dist/abstracts/abstract-workflow-validator.js +0 -447
  44. package/dist/abstracts/abstract-workflow-validator.js.map +0 -1
  45. package/dist/abstracts/index.d.ts +0 -6
  46. package/dist/abstracts/index.d.ts.map +0 -1
  47. package/dist/abstracts/index.js +0 -9
  48. package/dist/abstracts/index.js.map +0 -1
  49. package/dist/agents/constants.d.ts +0 -23
  50. package/dist/agents/constants.d.ts.map +0 -1
  51. package/dist/agents/constants.js +0 -22
  52. package/dist/agents/constants.js.map +0 -1
  53. package/dist/agents/index.d.ts +0 -1
  54. package/dist/agents/index.d.ts.map +0 -1
  55. package/dist/agents/index.js +0 -4
  56. package/dist/agents/index.js.map +0 -1
  57. package/dist/agents/robota.test.d.ts +0 -2
  58. package/dist/agents/robota.test.d.ts.map +0 -1
  59. package/dist/agents/robota.test.js +0 -416
  60. package/dist/agents/robota.test.js.map +0 -1
  61. package/dist/core/robota.d.ts +0 -694
  62. package/dist/core/robota.d.ts.map +0 -1
  63. package/dist/core/robota.js +0 -1277
  64. package/dist/core/robota.js.map +0 -1
  65. package/dist/executors/local-executor.d.ts +0 -96
  66. package/dist/executors/local-executor.d.ts.map +0 -1
  67. package/dist/executors/local-executor.js +0 -197
  68. package/dist/executors/local-executor.js.map +0 -1
  69. package/dist/executors/local-executor.test.d.ts +0 -2
  70. package/dist/executors/local-executor.test.d.ts.map +0 -1
  71. package/dist/executors/local-executor.test.js +0 -192
  72. package/dist/executors/local-executor.test.js.map +0 -1
  73. package/dist/index.d.ts +0 -274
  74. package/dist/index.d.ts.map +0 -1
  75. package/dist/index.js +0 -235
  76. package/dist/index.js.map +0 -1
  77. package/dist/interfaces/agent.d.ts +0 -198
  78. package/dist/interfaces/agent.d.ts.map +0 -1
  79. package/dist/interfaces/agent.js +0 -2
  80. package/dist/interfaces/agent.js.map +0 -1
  81. package/dist/interfaces/event-service.d.ts +0 -79
  82. package/dist/interfaces/event-service.d.ts.map +0 -1
  83. package/dist/interfaces/event-service.js +0 -2
  84. package/dist/interfaces/event-service.js.map +0 -1
  85. package/dist/interfaces/executor.d.ts +0 -128
  86. package/dist/interfaces/executor.d.ts.map +0 -1
  87. package/dist/interfaces/executor.js +0 -2
  88. package/dist/interfaces/executor.js.map +0 -1
  89. package/dist/interfaces/history-module.d.ts +0 -19
  90. package/dist/interfaces/history-module.d.ts.map +0 -1
  91. package/dist/interfaces/history-module.js +0 -2
  92. package/dist/interfaces/history-module.js.map +0 -1
  93. package/dist/interfaces/index.d.ts +0 -13
  94. package/dist/interfaces/index.d.ts.map +0 -1
  95. package/dist/interfaces/index.js +0 -4
  96. package/dist/interfaces/index.js.map +0 -1
  97. package/dist/interfaces/manager.d.ts +0 -142
  98. package/dist/interfaces/manager.d.ts.map +0 -1
  99. package/dist/interfaces/manager.js +0 -2
  100. package/dist/interfaces/manager.js.map +0 -1
  101. package/dist/interfaces/messages.d.ts +0 -75
  102. package/dist/interfaces/messages.d.ts.map +0 -1
  103. package/dist/interfaces/messages.js +0 -29
  104. package/dist/interfaces/messages.js.map +0 -1
  105. package/dist/interfaces/progress-reporting.d.ts +0 -86
  106. package/dist/interfaces/progress-reporting.d.ts.map +0 -1
  107. package/dist/interfaces/progress-reporting.js +0 -37
  108. package/dist/interfaces/progress-reporting.js.map +0 -1
  109. package/dist/interfaces/provider.d.ts +0 -217
  110. package/dist/interfaces/provider.d.ts.map +0 -1
  111. package/dist/interfaces/provider.js +0 -2
  112. package/dist/interfaces/provider.js.map +0 -1
  113. package/dist/interfaces/service.d.ts +0 -205
  114. package/dist/interfaces/service.d.ts.map +0 -1
  115. package/dist/interfaces/service.js +0 -6
  116. package/dist/interfaces/service.js.map +0 -1
  117. package/dist/interfaces/tool.d.ts +0 -248
  118. package/dist/interfaces/tool.d.ts.map +0 -1
  119. package/dist/interfaces/tool.js +0 -2
  120. package/dist/interfaces/tool.js.map +0 -1
  121. package/dist/interfaces/types.d.ts +0 -71
  122. package/dist/interfaces/types.d.ts.map +0 -1
  123. package/dist/interfaces/types.js +0 -33
  124. package/dist/interfaces/types.js.map +0 -1
  125. package/dist/interfaces/workflow-converter.d.ts +0 -193
  126. package/dist/interfaces/workflow-converter.d.ts.map +0 -1
  127. package/dist/interfaces/workflow-converter.js +0 -11
  128. package/dist/interfaces/workflow-converter.js.map +0 -1
  129. package/dist/interfaces/workflow-validator.d.ts +0 -209
  130. package/dist/interfaces/workflow-validator.d.ts.map +0 -1
  131. package/dist/interfaces/workflow-validator.js +0 -16
  132. package/dist/interfaces/workflow-validator.js.map +0 -1
  133. package/dist/managers/agent-factory.d.ts +0 -132
  134. package/dist/managers/agent-factory.d.ts.map +0 -1
  135. package/dist/managers/agent-factory.js +0 -284
  136. package/dist/managers/agent-factory.js.map +0 -1
  137. package/dist/managers/agent-factory.test.d.ts +0 -2
  138. package/dist/managers/agent-factory.test.d.ts.map +0 -1
  139. package/dist/managers/agent-factory.test.js +0 -249
  140. package/dist/managers/agent-factory.test.js.map +0 -1
  141. package/dist/managers/agent-templates.d.ts +0 -84
  142. package/dist/managers/agent-templates.d.ts.map +0 -1
  143. package/dist/managers/agent-templates.js +0 -159
  144. package/dist/managers/agent-templates.js.map +0 -1
  145. package/dist/managers/ai-provider-manager.d.ts +0 -80
  146. package/dist/managers/ai-provider-manager.d.ts.map +0 -1
  147. package/dist/managers/ai-provider-manager.js +0 -226
  148. package/dist/managers/ai-provider-manager.js.map +0 -1
  149. package/dist/managers/conversation-history-manager.d.ts +0 -455
  150. package/dist/managers/conversation-history-manager.d.ts.map +0 -1
  151. package/dist/managers/conversation-history-manager.js +0 -578
  152. package/dist/managers/conversation-history-manager.js.map +0 -1
  153. package/dist/managers/conversation-history-manager.test.d.ts +0 -2
  154. package/dist/managers/conversation-history-manager.test.d.ts.map +0 -1
  155. package/dist/managers/conversation-history-manager.test.js +0 -374
  156. package/dist/managers/conversation-history-manager.test.js.map +0 -1
  157. package/dist/managers/index.d.ts +0 -8
  158. package/dist/managers/index.d.ts.map +0 -1
  159. package/dist/managers/index.js +0 -8
  160. package/dist/managers/index.js.map +0 -1
  161. package/dist/managers/module-registry.d.ts +0 -161
  162. package/dist/managers/module-registry.d.ts.map +0 -1
  163. package/dist/managers/module-registry.js +0 -519
  164. package/dist/managers/module-registry.js.map +0 -1
  165. package/dist/managers/module-type-registry.d.ts +0 -113
  166. package/dist/managers/module-type-registry.d.ts.map +0 -1
  167. package/dist/managers/module-type-registry.js +0 -439
  168. package/dist/managers/module-type-registry.js.map +0 -1
  169. package/dist/managers/plugins.d.ts +0 -166
  170. package/dist/managers/plugins.d.ts.map +0 -1
  171. package/dist/managers/plugins.js +0 -339
  172. package/dist/managers/plugins.js.map +0 -1
  173. package/dist/managers/tool-manager.d.ts +0 -70
  174. package/dist/managers/tool-manager.d.ts.map +0 -1
  175. package/dist/managers/tool-manager.js +0 -138
  176. package/dist/managers/tool-manager.js.map +0 -1
  177. package/dist/managers/tool-manager.test.d.ts +0 -2
  178. package/dist/managers/tool-manager.test.d.ts.map +0 -1
  179. package/dist/managers/tool-manager.test.js +0 -186
  180. package/dist/managers/tool-manager.test.js.map +0 -1
  181. package/dist/plugins/conversation-history/conversation-history-plugin.d.ts +0 -67
  182. package/dist/plugins/conversation-history/conversation-history-plugin.d.ts.map +0 -1
  183. package/dist/plugins/conversation-history/conversation-history-plugin.js +0 -270
  184. package/dist/plugins/conversation-history/conversation-history-plugin.js.map +0 -1
  185. package/dist/plugins/conversation-history/index.d.ts +0 -3
  186. package/dist/plugins/conversation-history/index.d.ts.map +0 -1
  187. package/dist/plugins/conversation-history/index.js +0 -2
  188. package/dist/plugins/conversation-history/index.js.map +0 -1
  189. package/dist/plugins/conversation-history/storages/database-storage.d.ts +0 -19
  190. package/dist/plugins/conversation-history/storages/database-storage.d.ts.map +0 -1
  191. package/dist/plugins/conversation-history/storages/database-storage.js +0 -94
  192. package/dist/plugins/conversation-history/storages/database-storage.js.map +0 -1
  193. package/dist/plugins/conversation-history/storages/file-storage.d.ts +0 -15
  194. package/dist/plugins/conversation-history/storages/file-storage.d.ts.map +0 -1
  195. package/dist/plugins/conversation-history/storages/file-storage.js +0 -94
  196. package/dist/plugins/conversation-history/storages/file-storage.js.map +0 -1
  197. package/dist/plugins/conversation-history/storages/index.d.ts +0 -4
  198. package/dist/plugins/conversation-history/storages/index.d.ts.map +0 -1
  199. package/dist/plugins/conversation-history/storages/index.js +0 -4
  200. package/dist/plugins/conversation-history/storages/index.js.map +0 -1
  201. package/dist/plugins/conversation-history/storages/memory-storage.d.ts +0 -15
  202. package/dist/plugins/conversation-history/storages/memory-storage.d.ts.map +0 -1
  203. package/dist/plugins/conversation-history/storages/memory-storage.js +0 -33
  204. package/dist/plugins/conversation-history/storages/memory-storage.js.map +0 -1
  205. package/dist/plugins/conversation-history/types.d.ts +0 -61
  206. package/dist/plugins/conversation-history/types.d.ts.map +0 -1
  207. package/dist/plugins/conversation-history/types.js +0 -2
  208. package/dist/plugins/conversation-history/types.js.map +0 -1
  209. package/dist/plugins/error-handling/context-adapter.d.ts +0 -30
  210. package/dist/plugins/error-handling/context-adapter.d.ts.map +0 -1
  211. package/dist/plugins/error-handling/context-adapter.js +0 -41
  212. package/dist/plugins/error-handling/context-adapter.js.map +0 -1
  213. package/dist/plugins/error-handling/error-handling-plugin.d.ts +0 -49
  214. package/dist/plugins/error-handling/error-handling-plugin.d.ts.map +0 -1
  215. package/dist/plugins/error-handling/error-handling-plugin.js +0 -229
  216. package/dist/plugins/error-handling/error-handling-plugin.js.map +0 -1
  217. package/dist/plugins/error-handling/index.d.ts +0 -10
  218. package/dist/plugins/error-handling/index.d.ts.map +0 -1
  219. package/dist/plugins/error-handling/index.js +0 -10
  220. package/dist/plugins/error-handling/index.js.map +0 -1
  221. package/dist/plugins/error-handling/types.d.ts +0 -73
  222. package/dist/plugins/error-handling/types.d.ts.map +0 -1
  223. package/dist/plugins/error-handling/types.js +0 -14
  224. package/dist/plugins/error-handling/types.js.map +0 -1
  225. package/dist/plugins/event-emitter/metrics.d.ts +0 -17
  226. package/dist/plugins/event-emitter/metrics.d.ts.map +0 -1
  227. package/dist/plugins/event-emitter/metrics.js +0 -17
  228. package/dist/plugins/event-emitter/metrics.js.map +0 -1
  229. package/dist/plugins/event-emitter/types.d.ts +0 -112
  230. package/dist/plugins/event-emitter/types.d.ts.map +0 -1
  231. package/dist/plugins/event-emitter/types.js +0 -65
  232. package/dist/plugins/event-emitter/types.js.map +0 -1
  233. package/dist/plugins/event-emitter-plugin.d.ts +0 -222
  234. package/dist/plugins/event-emitter-plugin.d.ts.map +0 -1
  235. package/dist/plugins/event-emitter-plugin.js +0 -432
  236. package/dist/plugins/event-emitter-plugin.js.map +0 -1
  237. package/dist/plugins/event-emitter-plugin.test.d.ts +0 -2
  238. package/dist/plugins/event-emitter-plugin.test.d.ts.map +0 -1
  239. package/dist/plugins/event-emitter-plugin.test.js +0 -94
  240. package/dist/plugins/event-emitter-plugin.test.js.map +0 -1
  241. package/dist/plugins/execution/execution-analytics-plugin.d.ts +0 -129
  242. package/dist/plugins/execution/execution-analytics-plugin.d.ts.map +0 -1
  243. package/dist/plugins/execution/execution-analytics-plugin.js +0 -517
  244. package/dist/plugins/execution/execution-analytics-plugin.js.map +0 -1
  245. package/dist/plugins/execution/index.d.ts +0 -3
  246. package/dist/plugins/execution/index.d.ts.map +0 -1
  247. package/dist/plugins/execution/index.js +0 -2
  248. package/dist/plugins/execution/index.js.map +0 -1
  249. package/dist/plugins/execution/types.d.ts +0 -90
  250. package/dist/plugins/execution/types.d.ts.map +0 -1
  251. package/dist/plugins/execution/types.js +0 -2
  252. package/dist/plugins/execution/types.js.map +0 -1
  253. package/dist/plugins/index.d.ts +0 -10
  254. package/dist/plugins/index.d.ts.map +0 -1
  255. package/dist/plugins/index.js +0 -11
  256. package/dist/plugins/index.js.map +0 -1
  257. package/dist/plugins/limits/types.d.ts +0 -61
  258. package/dist/plugins/limits/types.d.ts.map +0 -1
  259. package/dist/plugins/limits/types.js +0 -2
  260. package/dist/plugins/limits/types.js.map +0 -1
  261. package/dist/plugins/limits-plugin.d.ts +0 -113
  262. package/dist/plugins/limits-plugin.d.ts.map +0 -1
  263. package/dist/plugins/limits-plugin.js +0 -380
  264. package/dist/plugins/limits-plugin.js.map +0 -1
  265. package/dist/plugins/logging/formatters.d.ts +0 -14
  266. package/dist/plugins/logging/formatters.d.ts.map +0 -1
  267. package/dist/plugins/logging/formatters.js +0 -24
  268. package/dist/plugins/logging/formatters.js.map +0 -1
  269. package/dist/plugins/logging/index.d.ts +0 -3
  270. package/dist/plugins/logging/index.d.ts.map +0 -1
  271. package/dist/plugins/logging/index.js +0 -2
  272. package/dist/plugins/logging/index.js.map +0 -1
  273. package/dist/plugins/logging/logging-plugin.d.ts +0 -91
  274. package/dist/plugins/logging/logging-plugin.d.ts.map +0 -1
  275. package/dist/plugins/logging/logging-plugin.js +0 -335
  276. package/dist/plugins/logging/logging-plugin.js.map +0 -1
  277. package/dist/plugins/logging/storages/console-storage.d.ts +0 -14
  278. package/dist/plugins/logging/storages/console-storage.d.ts.map +0 -1
  279. package/dist/plugins/logging/storages/console-storage.js +0 -38
  280. package/dist/plugins/logging/storages/console-storage.js.map +0 -1
  281. package/dist/plugins/logging/storages/file-storage.d.ts +0 -14
  282. package/dist/plugins/logging/storages/file-storage.d.ts.map +0 -1
  283. package/dist/plugins/logging/storages/file-storage.js +0 -41
  284. package/dist/plugins/logging/storages/file-storage.js.map +0 -1
  285. package/dist/plugins/logging/storages/index.d.ts +0 -5
  286. package/dist/plugins/logging/storages/index.d.ts.map +0 -1
  287. package/dist/plugins/logging/storages/index.js +0 -5
  288. package/dist/plugins/logging/storages/index.js.map +0 -1
  289. package/dist/plugins/logging/storages/remote-storage.d.ts +0 -20
  290. package/dist/plugins/logging/storages/remote-storage.d.ts.map +0 -1
  291. package/dist/plugins/logging/storages/remote-storage.js +0 -61
  292. package/dist/plugins/logging/storages/remote-storage.js.map +0 -1
  293. package/dist/plugins/logging/storages/silent-storage.d.ts +0 -10
  294. package/dist/plugins/logging/storages/silent-storage.d.ts.map +0 -1
  295. package/dist/plugins/logging/storages/silent-storage.js +0 -15
  296. package/dist/plugins/logging/storages/silent-storage.js.map +0 -1
  297. package/dist/plugins/logging/types.d.ts +0 -84
  298. package/dist/plugins/logging/types.d.ts.map +0 -1
  299. package/dist/plugins/logging/types.js +0 -2
  300. package/dist/plugins/logging/types.js.map +0 -1
  301. package/dist/plugins/performance/collectors/system-metrics-collector.d.ts +0 -12
  302. package/dist/plugins/performance/collectors/system-metrics-collector.d.ts.map +0 -1
  303. package/dist/plugins/performance/collectors/system-metrics-collector.js +0 -65
  304. package/dist/plugins/performance/collectors/system-metrics-collector.js.map +0 -1
  305. package/dist/plugins/performance/index.d.ts +0 -5
  306. package/dist/plugins/performance/index.d.ts.map +0 -1
  307. package/dist/plugins/performance/index.js +0 -4
  308. package/dist/plugins/performance/index.js.map +0 -1
  309. package/dist/plugins/performance/performance-plugin.d.ts +0 -49
  310. package/dist/plugins/performance/performance-plugin.d.ts.map +0 -1
  311. package/dist/plugins/performance/performance-plugin.js +0 -293
  312. package/dist/plugins/performance/performance-plugin.js.map +0 -1
  313. package/dist/plugins/performance/storages/index.d.ts +0 -2
  314. package/dist/plugins/performance/storages/index.d.ts.map +0 -1
  315. package/dist/plugins/performance/storages/index.js +0 -4
  316. package/dist/plugins/performance/storages/index.js.map +0 -1
  317. package/dist/plugins/performance/storages/memory-storage.d.ts +0 -19
  318. package/dist/plugins/performance/storages/memory-storage.d.ts.map +0 -1
  319. package/dist/plugins/performance/storages/memory-storage.js +0 -69
  320. package/dist/plugins/performance/storages/memory-storage.js.map +0 -1
  321. package/dist/plugins/performance/types.d.ts +0 -154
  322. package/dist/plugins/performance/types.d.ts.map +0 -1
  323. package/dist/plugins/performance/types.js +0 -2
  324. package/dist/plugins/performance/types.js.map +0 -1
  325. package/dist/plugins/usage/aggregate-usage-stats.d.ts +0 -12
  326. package/dist/plugins/usage/aggregate-usage-stats.d.ts.map +0 -1
  327. package/dist/plugins/usage/aggregate-usage-stats.js +0 -115
  328. package/dist/plugins/usage/aggregate-usage-stats.js.map +0 -1
  329. package/dist/plugins/usage/index.d.ts +0 -5
  330. package/dist/plugins/usage/index.d.ts.map +0 -1
  331. package/dist/plugins/usage/index.js +0 -4
  332. package/dist/plugins/usage/index.js.map +0 -1
  333. package/dist/plugins/usage/storages/file-storage.d.ts +0 -22
  334. package/dist/plugins/usage/storages/file-storage.d.ts.map +0 -1
  335. package/dist/plugins/usage/storages/file-storage.js +0 -111
  336. package/dist/plugins/usage/storages/file-storage.js.map +0 -1
  337. package/dist/plugins/usage/storages/index.d.ts +0 -5
  338. package/dist/plugins/usage/storages/index.d.ts.map +0 -1
  339. package/dist/plugins/usage/storages/index.js +0 -5
  340. package/dist/plugins/usage/storages/index.js.map +0 -1
  341. package/dist/plugins/usage/storages/memory-storage.d.ts +0 -22
  342. package/dist/plugins/usage/storages/memory-storage.d.ts.map +0 -1
  343. package/dist/plugins/usage/storages/memory-storage.js +0 -42
  344. package/dist/plugins/usage/storages/memory-storage.js.map +0 -1
  345. package/dist/plugins/usage/storages/remote-storage.d.ts +0 -26
  346. package/dist/plugins/usage/storages/remote-storage.d.ts.map +0 -1
  347. package/dist/plugins/usage/storages/remote-storage.js +0 -115
  348. package/dist/plugins/usage/storages/remote-storage.js.map +0 -1
  349. package/dist/plugins/usage/storages/silent-storage.d.ts +0 -19
  350. package/dist/plugins/usage/storages/silent-storage.d.ts.map +0 -1
  351. package/dist/plugins/usage/storages/silent-storage.js +0 -26
  352. package/dist/plugins/usage/storages/silent-storage.js.map +0 -1
  353. package/dist/plugins/usage/types.d.ts +0 -127
  354. package/dist/plugins/usage/types.d.ts.map +0 -1
  355. package/dist/plugins/usage/types.js +0 -2
  356. package/dist/plugins/usage/types.js.map +0 -1
  357. package/dist/plugins/usage/usage-plugin.d.ts +0 -67
  358. package/dist/plugins/usage/usage-plugin.d.ts.map +0 -1
  359. package/dist/plugins/usage/usage-plugin.js +0 -309
  360. package/dist/plugins/usage/usage-plugin.js.map +0 -1
  361. package/dist/plugins/webhook/http-client.d.ts +0 -30
  362. package/dist/plugins/webhook/http-client.d.ts.map +0 -1
  363. package/dist/plugins/webhook/http-client.js +0 -110
  364. package/dist/plugins/webhook/http-client.js.map +0 -1
  365. package/dist/plugins/webhook/index.d.ts +0 -9
  366. package/dist/plugins/webhook/index.d.ts.map +0 -1
  367. package/dist/plugins/webhook/index.js +0 -9
  368. package/dist/plugins/webhook/index.js.map +0 -1
  369. package/dist/plugins/webhook/transformer.d.ts +0 -63
  370. package/dist/plugins/webhook/transformer.d.ts.map +0 -1
  371. package/dist/plugins/webhook/transformer.js +0 -157
  372. package/dist/plugins/webhook/transformer.js.map +0 -1
  373. package/dist/plugins/webhook/types.d.ts +0 -183
  374. package/dist/plugins/webhook/types.d.ts.map +0 -1
  375. package/dist/plugins/webhook/types.js +0 -2
  376. package/dist/plugins/webhook/types.js.map +0 -1
  377. package/dist/plugins/webhook/webhook-plugin.d.ts +0 -92
  378. package/dist/plugins/webhook/webhook-plugin.d.ts.map +0 -1
  379. package/dist/plugins/webhook/webhook-plugin.js +0 -328
  380. package/dist/plugins/webhook/webhook-plugin.js.map +0 -1
  381. package/dist/schemas/agent-template-schema.d.ts +0 -137
  382. package/dist/schemas/agent-template-schema.d.ts.map +0 -1
  383. package/dist/schemas/agent-template-schema.js +0 -87
  384. package/dist/schemas/agent-template-schema.js.map +0 -1
  385. package/dist/services/conversation-service/index.d.ts +0 -88
  386. package/dist/services/conversation-service/index.d.ts.map +0 -1
  387. package/dist/services/conversation-service/index.js +0 -441
  388. package/dist/services/conversation-service/index.js.map +0 -1
  389. package/dist/services/conversation-service/types.d.ts +0 -32
  390. package/dist/services/conversation-service/types.d.ts.map +0 -1
  391. package/dist/services/conversation-service/types.js +0 -8
  392. package/dist/services/conversation-service/types.js.map +0 -1
  393. package/dist/services/event-service.d.ts +0 -61
  394. package/dist/services/event-service.d.ts.map +0 -1
  395. package/dist/services/event-service.js +0 -110
  396. package/dist/services/event-service.js.map +0 -1
  397. package/dist/services/event-service.test.d.ts +0 -2
  398. package/dist/services/event-service.test.d.ts.map +0 -1
  399. package/dist/services/event-service.test.js +0 -86
  400. package/dist/services/event-service.test.js.map +0 -1
  401. package/dist/services/execution-service.d.ts +0 -151
  402. package/dist/services/execution-service.d.ts.map +0 -1
  403. package/dist/services/execution-service.js +0 -1262
  404. package/dist/services/execution-service.js.map +0 -1
  405. package/dist/services/execution-service.test.d.ts +0 -2
  406. package/dist/services/execution-service.test.d.ts.map +0 -1
  407. package/dist/services/execution-service.test.js +0 -338
  408. package/dist/services/execution-service.test.js.map +0 -1
  409. package/dist/services/history-module.d.ts +0 -15
  410. package/dist/services/history-module.d.ts.map +0 -1
  411. package/dist/services/history-module.js +0 -42
  412. package/dist/services/history-module.js.map +0 -1
  413. package/dist/services/in-memory-history-store.d.ts +0 -12
  414. package/dist/services/in-memory-history-store.d.ts.map +0 -1
  415. package/dist/services/in-memory-history-store.js +0 -41
  416. package/dist/services/in-memory-history-store.js.map +0 -1
  417. package/dist/services/index.d.ts +0 -7
  418. package/dist/services/index.d.ts.map +0 -1
  419. package/dist/services/index.js +0 -13
  420. package/dist/services/index.js.map +0 -1
  421. package/dist/services/task-events.d.ts +0 -6
  422. package/dist/services/task-events.d.ts.map +0 -1
  423. package/dist/services/task-events.js +0 -6
  424. package/dist/services/task-events.js.map +0 -1
  425. package/dist/services/tool-execution-service.d.ts +0 -74
  426. package/dist/services/tool-execution-service.d.ts.map +0 -1
  427. package/dist/services/tool-execution-service.js +0 -189
  428. package/dist/services/tool-execution-service.js.map +0 -1
  429. package/dist/services/user-events.d.ts +0 -7
  430. package/dist/services/user-events.d.ts.map +0 -1
  431. package/dist/services/user-events.js +0 -6
  432. package/dist/services/user-events.js.map +0 -1
  433. package/dist/tools/implementations/function-tool/index.d.ts +0 -9
  434. package/dist/tools/implementations/function-tool/index.d.ts.map +0 -1
  435. package/dist/tools/implementations/function-tool/index.js +0 -13
  436. package/dist/tools/implementations/function-tool/index.js.map +0 -1
  437. package/dist/tools/implementations/function-tool/schema-converter.d.ts +0 -32
  438. package/dist/tools/implementations/function-tool/schema-converter.d.ts.map +0 -1
  439. package/dist/tools/implementations/function-tool/schema-converter.js +0 -164
  440. package/dist/tools/implementations/function-tool/schema-converter.js.map +0 -1
  441. package/dist/tools/implementations/function-tool/types.d.ts +0 -72
  442. package/dist/tools/implementations/function-tool/types.d.ts.map +0 -1
  443. package/dist/tools/implementations/function-tool/types.js +0 -14
  444. package/dist/tools/implementations/function-tool/types.js.map +0 -1
  445. package/dist/tools/implementations/function-tool.d.ts +0 -49
  446. package/dist/tools/implementations/function-tool.d.ts.map +0 -1
  447. package/dist/tools/implementations/function-tool.js +0 -223
  448. package/dist/tools/implementations/function-tool.js.map +0 -1
  449. package/dist/tools/implementations/index.d.ts +0 -4
  450. package/dist/tools/implementations/index.d.ts.map +0 -1
  451. package/dist/tools/implementations/index.js +0 -5
  452. package/dist/tools/implementations/index.js.map +0 -1
  453. package/dist/tools/implementations/mcp-tool.d.ts +0 -72
  454. package/dist/tools/implementations/mcp-tool.d.ts.map +0 -1
  455. package/dist/tools/implementations/mcp-tool.js +0 -246
  456. package/dist/tools/implementations/mcp-tool.js.map +0 -1
  457. package/dist/tools/implementations/openapi-tool.d.ts +0 -56
  458. package/dist/tools/implementations/openapi-tool.d.ts.map +0 -1
  459. package/dist/tools/implementations/openapi-tool.js +0 -324
  460. package/dist/tools/implementations/openapi-tool.js.map +0 -1
  461. package/dist/tools/implementations/relay-mcp-tool.d.ts +0 -38
  462. package/dist/tools/implementations/relay-mcp-tool.d.ts.map +0 -1
  463. package/dist/tools/implementations/relay-mcp-tool.js +0 -46
  464. package/dist/tools/implementations/relay-mcp-tool.js.map +0 -1
  465. package/dist/tools/index.d.ts +0 -3
  466. package/dist/tools/index.d.ts.map +0 -1
  467. package/dist/tools/index.js +0 -4
  468. package/dist/tools/index.js.map +0 -1
  469. package/dist/tools/registry/index.d.ts +0 -2
  470. package/dist/tools/registry/index.d.ts.map +0 -1
  471. package/dist/tools/registry/index.js +0 -3
  472. package/dist/tools/registry/index.js.map +0 -1
  473. package/dist/tools/registry/tool-registry.d.ts +0 -54
  474. package/dist/tools/registry/tool-registry.d.ts.map +0 -1
  475. package/dist/tools/registry/tool-registry.js +0 -146
  476. package/dist/tools/registry/tool-registry.js.map +0 -1
  477. package/dist/utils/errors.d.ts +0 -155
  478. package/dist/utils/errors.d.ts.map +0 -1
  479. package/dist/utils/errors.js +0 -203
  480. package/dist/utils/errors.js.map +0 -1
  481. package/dist/utils/execution-proxy.d.ts +0 -75
  482. package/dist/utils/execution-proxy.d.ts.map +0 -1
  483. package/dist/utils/execution-proxy.js +0 -230
  484. package/dist/utils/execution-proxy.js.map +0 -1
  485. package/dist/utils/index.d.ts +0 -11
  486. package/dist/utils/index.d.ts.map +0 -1
  487. package/dist/utils/index.js +0 -7
  488. package/dist/utils/index.js.map +0 -1
  489. package/dist/utils/logger.d.ts +0 -74
  490. package/dist/utils/logger.d.ts.map +0 -1
  491. package/dist/utils/logger.js +0 -143
  492. package/dist/utils/logger.js.map +0 -1
  493. package/dist/utils/message-converter.d.ts +0 -68
  494. package/dist/utils/message-converter.d.ts.map +0 -1
  495. package/dist/utils/message-converter.js +0 -87
  496. package/dist/utils/message-converter.js.map +0 -1
  497. package/dist/utils/periodic-task.d.ts +0 -14
  498. package/dist/utils/periodic-task.d.ts.map +0 -1
  499. package/dist/utils/periodic-task.js +0 -26
  500. package/dist/utils/periodic-task.js.map +0 -1
  501. package/dist/utils/validation.d.ts +0 -40
  502. package/dist/utils/validation.d.ts.map +0 -1
  503. package/dist/utils/validation.js +0 -162
  504. package/dist/utils/validation.js.map +0 -1
@@ -44,12 +44,18 @@ interface IToolCall {
44
44
  arguments: string;
45
45
  };
46
46
  }
47
+ /** State of a message in conversation history */
48
+ type TMessageState = 'complete' | 'interrupted';
47
49
  /**
48
50
  * Base message contract shared by all message variants.
49
51
  */
50
52
  interface IBaseMessage {
53
+ /** Unique message identifier */
54
+ id: string;
51
55
  /** Message creation timestamp */
52
56
  timestamp: Date;
57
+ /** Whether this message is complete or was interrupted */
58
+ state: TMessageState;
53
59
  /** Additional metadata */
54
60
  metadata?: TUniversalMessageMetadata;
55
61
  }
@@ -299,6 +305,8 @@ interface IChatOptions extends IProviderSpecificOptions {
299
305
  * should use streaming internally and call this for each text chunk,
300
306
  * while still returning the complete assembled message. */
301
307
  onTextDelta?: TTextDeltaCallback;
308
+ /** AbortSignal for cancelling the provider call */
309
+ signal?: AbortSignal;
302
310
  }
303
311
  /**
304
312
  * Provider-agnostic AI Provider interface
@@ -481,6 +489,78 @@ interface IEventServiceOwnerBinding {
481
489
  ownerPath: IOwnerPathSegment[];
482
490
  }
483
491
 
492
+ /**
493
+ * Abstract base for event services.
494
+ * Concrete implementations decide how events are delivered.
495
+ */
496
+ declare abstract class AbstractEventService implements IEventService {
497
+ private listeners;
498
+ abstract emit(eventType: string, data: IBaseEventData, context?: IEventContext): void;
499
+ subscribe(listener: TEventListener): void;
500
+ unsubscribe(listener: TEventListener): void;
501
+ protected notifyListeners(eventType: string, data: IBaseEventData, context?: IEventContext): void;
502
+ }
503
+ /**
504
+ * Default no-op event service (production-safe).
505
+ * When injected, emit() intentionally does nothing.
506
+ */
507
+ declare class DefaultEventService extends AbstractEventService {
508
+ emit(_eventType: string, _data: IBaseEventData, _context?: IEventContext): void;
509
+ }
510
+ /**
511
+ * Singleton default event service instance.
512
+ */
513
+ declare const DEFAULT_ABSTRACT_EVENT_SERVICE: IEventService;
514
+ /**
515
+ * Check if a given service is the default no-op implementation.
516
+ */
517
+ declare function isDefaultEventService(service: IEventService): boolean;
518
+ /**
519
+ * Compose a full event name from owner prefix and local name.
520
+ * Local names must not contain dots.
521
+ */
522
+ declare function composeEventName(ownerType: string, localName: string): string;
523
+ /**
524
+ * A scoped event service that always emits with an owner binding applied.
525
+ */
526
+ declare class StructuredEventService extends AbstractEventService {
527
+ private readonly base;
528
+ private readonly binding;
529
+ constructor(base: IEventService, binding: IEventServiceOwnerBinding);
530
+ emit(eventType: string, data: IBaseEventData, context?: IEventContext): void;
531
+ subscribe(listener: TEventListener): void;
532
+ unsubscribe(listener: TEventListener): void;
533
+ }
534
+ /**
535
+ * Bind an EventService to an explicit owner path.
536
+ * This is the standard entry point for scoped emission (path-only architecture).
537
+ */
538
+ declare function bindWithOwnerPath(base: IEventService, binding: IEventServiceOwnerBinding): IEventService;
539
+ /**
540
+ * Alias for bindWithOwnerPath for historical call sites.
541
+ * Intentionally forwards to the single authoritative implementation.
542
+ */
543
+ declare function bindEventServiceOwner(base: IEventService, binding: IEventServiceOwnerBinding): IEventService;
544
+ /**
545
+ * Observable EventService that notifies subscribed listeners.
546
+ */
547
+ declare class ObservableEventService extends AbstractEventService {
548
+ emit(eventType: string, data: IBaseEventData, context?: IEventContext): void;
549
+ }
550
+
551
+ declare const TASK_EVENTS: {
552
+ readonly ASSIGNED: "assigned";
553
+ readonly COMPLETED: "completed";
554
+ };
555
+ declare const TASK_EVENT_PREFIX: "task";
556
+
557
+ declare const USER_EVENTS: {
558
+ readonly MESSAGE: "message";
559
+ readonly INPUT: "input";
560
+ };
561
+ declare const USER_EVENT_PREFIX: "user";
562
+ type TUserEvent = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
563
+
484
564
  type TToolContextExtensionValue = TUniversalValue | Date | Error | TLoggerData | TContextData | TToolParameters | TToolMetadata;
485
565
  /**
486
566
  * Tool metadata structure - specific type definition
@@ -1549,6 +1629,8 @@ interface IRunOptions {
1549
1629
  sessionId?: string;
1550
1630
  userId?: string;
1551
1631
  metadata?: TMetadata;
1632
+ /** AbortSignal for cancelling execution */
1633
+ signal?: AbortSignal;
1552
1634
  }
1553
1635
  /**
1554
1636
  * Generic agent interface with type parameters for enhanced type safety
@@ -2470,6 +2552,15 @@ declare abstract class AbstractAIProvider<TConfig = IProviderConfig> implements
2470
2552
  * @returns Promise resolving to a response
2471
2553
  */
2472
2554
  abstract chat(messages: TUniversalMessage[], options?: IChatOptions): Promise<TUniversalMessage>;
2555
+ /**
2556
+ * Wrap an async iterable to yield to the macrotask queue periodically.
2557
+ * Providers MUST use this when iterating over streaming events to ensure
2558
+ * the main thread event loop stays responsive (ESC abort, Ctrl+C, etc.).
2559
+ *
2560
+ * Usage in provider:
2561
+ * for await (const event of this.streamWithAbort(stream, signal)) { ... }
2562
+ */
2563
+ protected streamWithAbort<T>(source: AsyncIterable<T>, signal?: AbortSignal): AsyncGenerator<T>;
2473
2564
  /**
2474
2565
  * Each provider must implement streaming chat using their own native SDK types internally
2475
2566
  * @param messages - Array of messages from conversation history
@@ -2919,6 +3010,125 @@ declare function stopPeriodicTask(timer: TTimerId | undefined): void;
2919
3010
  */
2920
3011
  type TTimerId = ReturnType<typeof setTimeout>;
2921
3012
 
3013
+ /** Create a user message. */
3014
+ declare function createUserMessage(content: string, options?: {
3015
+ name?: string;
3016
+ metadata?: TUniversalMessageMetadata;
3017
+ parts?: TUniversalMessagePart[];
3018
+ }): IUserMessage;
3019
+ /** Create an assistant message. */
3020
+ declare function createAssistantMessage(content: string | null, options?: {
3021
+ toolCalls?: IToolCall[];
3022
+ metadata?: TUniversalMessageMetadata;
3023
+ parts?: TUniversalMessagePart[];
3024
+ state?: TMessageState;
3025
+ }): IAssistantMessage;
3026
+ /** Create a system message. */
3027
+ declare function createSystemMessage(content: string, options?: {
3028
+ name?: string;
3029
+ metadata?: TUniversalMessageMetadata;
3030
+ parts?: TUniversalMessagePart[];
3031
+ }): ISystemMessage;
3032
+ /** Create a tool message. */
3033
+ declare function createToolMessage(content: string, options: {
3034
+ toolCallId: string;
3035
+ name?: string;
3036
+ metadata?: TUniversalMessageMetadata;
3037
+ parts?: TUniversalMessagePart[];
3038
+ }): IToolMessage;
3039
+
3040
+ /** API message format for provider consumption */
3041
+ interface IProviderApiMessage {
3042
+ role: string;
3043
+ content: string | null;
3044
+ tool_calls?: Array<{
3045
+ id: string;
3046
+ type: 'function';
3047
+ function: {
3048
+ name: string;
3049
+ arguments: string;
3050
+ };
3051
+ }>;
3052
+ tool_call_id?: string;
3053
+ }
3054
+ /**
3055
+ * Conversation store with duplicate prevention and API format conversion.
3056
+ * @public
3057
+ */
3058
+ declare class ConversationStore implements IConversationHistory {
3059
+ private history;
3060
+ private toolCallIds;
3061
+ private pendingAssistant;
3062
+ constructor(maxMessages?: number);
3063
+ addMessage(message: TUniversalMessage): void;
3064
+ addUserMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3065
+ addAssistantMessage(content: string | null, toolCalls?: IToolCall[], metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3066
+ addSystemMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3067
+ addToolMessage(content: string, toolCallId: string, toolName?: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3068
+ addToolMessageWithId(content: string, toolCallId: string, toolName: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3069
+ getMessages(): TUniversalMessage[];
3070
+ getMessagesByRole(role: TUniversalMessageRole): TUniversalMessage[];
3071
+ getRecentMessages(count: number): TUniversalMessage[];
3072
+ getMessageCount(): number;
3073
+ /** Begin a new assistant response. Must be called before provider call.
3074
+ * Ensures pendingAssistant exists so commitAssistant always has data to save. */
3075
+ beginAssistant(): void;
3076
+ /** Append streaming text delta to pending assistant response */
3077
+ appendStreaming(delta: string): void;
3078
+ /** Append a tool call to pending assistant response (deduplicates by id) */
3079
+ appendToolCall(toolCall: IToolCall): void;
3080
+ /**
3081
+ * Commit pending assistant response to history.
3082
+ * Precondition: beginAssistant() must have been called before the provider call.
3083
+ * History is append-only — this always adds a message.
3084
+ */
3085
+ commitAssistant(state: TMessageState, metadata?: TUniversalMessageMetadata): void;
3086
+ /** Discard pending assistant response without saving */
3087
+ discardPending(): void;
3088
+ /** Returns true if there is accumulated pending assistant state (streaming or tool calls) */
3089
+ hasPendingAssistant(): boolean;
3090
+ /** Get pending assistant content (empty string if no content streamed yet) */
3091
+ getPendingContent(): string;
3092
+ getMessagesForAPI(): IProviderApiMessage[];
3093
+ clear(): void;
3094
+ }
3095
+
3096
+ /** Interface for managing conversation history. @public */
3097
+ interface IConversationHistory {
3098
+ addMessage(message: TUniversalMessage): void;
3099
+ addUserMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3100
+ addAssistantMessage(content: string | null, toolCalls?: IToolCall[], metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3101
+ addSystemMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3102
+ addToolMessageWithId(content: string, toolCallId: string, toolName: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3103
+ getMessages(): TUniversalMessage[];
3104
+ getMessagesByRole(role: TUniversalMessageRole): TUniversalMessage[];
3105
+ getRecentMessages(count: number): TUniversalMessage[];
3106
+ clear(): void;
3107
+ getMessageCount(): number;
3108
+ }
3109
+ /** Configuration options for ConversationHistory manager */
3110
+ interface IConversationHistoryOptions {
3111
+ maxMessagesPerConversation?: number;
3112
+ maxConversations?: number;
3113
+ }
3114
+ /** Multi-session conversation history manager. @public */
3115
+ declare class ConversationHistory {
3116
+ private conversations;
3117
+ private logger;
3118
+ private readonly maxMessagesPerConversation;
3119
+ private readonly maxConversations;
3120
+ constructor(options?: IConversationHistoryOptions);
3121
+ getConversationStore(conversationId: string): ConversationStore;
3122
+ hasConversation(conversationId: string): boolean;
3123
+ removeConversation(conversationId: string): boolean;
3124
+ clearAll(): void;
3125
+ getStats(): {
3126
+ totalConversations: number;
3127
+ conversationIds: string[];
3128
+ totalMessages: number;
3129
+ };
3130
+ }
3131
+
2922
3132
  /**
2923
3133
  * Local executor that directly delegates to AI provider instances
2924
3134
  *
@@ -3151,6 +3361,8 @@ declare class Robota extends AbstractAgent<IAgentConfig, IRunOptions, TUniversal
3151
3361
  private executionDeps;
3152
3362
  getHistory(): TUniversalMessage[];
3153
3363
  clearHistory(): void;
3364
+ /** Inject a message into conversation history without triggering execution. */
3365
+ injectMessage(role: 'user' | 'assistant' | 'system', content: string): void;
3154
3366
  updateTools(next: Array<IToolWithEventService>): Promise<{
3155
3367
  version: number;
3156
3368
  }>;
@@ -3443,84 +3655,6 @@ declare class AgentFactory {
3443
3655
  private updateCreationStats;
3444
3656
  }
3445
3657
 
3446
- /**
3447
- * Conversation session implementations.
3448
- *
3449
- * Extracted from conversation-history-manager.ts.
3450
- */
3451
-
3452
- /** API message format for provider consumption */
3453
- interface IProviderApiMessage {
3454
- role: string;
3455
- content: string | null;
3456
- tool_calls?: Array<{
3457
- id: string;
3458
- type: 'function';
3459
- function: {
3460
- name: string;
3461
- arguments: string;
3462
- };
3463
- }>;
3464
- tool_call_id?: string;
3465
- }
3466
- /**
3467
- * Conversation session with duplicate prevention and API format conversion.
3468
- * @public
3469
- */
3470
- declare class ConversationSession implements IConversationHistory {
3471
- private history;
3472
- private toolCallIds;
3473
- constructor(maxMessages?: number);
3474
- addMessage(message: TUniversalMessage): void;
3475
- addUserMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3476
- addAssistantMessage(content: string | null, toolCalls?: IToolCall[], metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3477
- addSystemMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3478
- addToolMessage(content: string, toolCallId: string, toolName?: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3479
- addToolMessageWithId(content: string, toolCallId: string, toolName: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3480
- getMessages(): TUniversalMessage[];
3481
- getMessagesByRole(role: TUniversalMessageRole): TUniversalMessage[];
3482
- getRecentMessages(count: number): TUniversalMessage[];
3483
- getMessageCount(): number;
3484
- getMessagesForAPI(): IProviderApiMessage[];
3485
- clear(): void;
3486
- }
3487
-
3488
- /** Interface for managing conversation history. @public */
3489
- interface IConversationHistory {
3490
- addMessage(message: TUniversalMessage): void;
3491
- addUserMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3492
- addAssistantMessage(content: string | null, toolCalls?: IToolCall[], metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3493
- addSystemMessage(content: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3494
- addToolMessageWithId(content: string, toolCallId: string, toolName: string, metadata?: TUniversalMessageMetadata, parts?: TUniversalMessagePart[]): void;
3495
- getMessages(): TUniversalMessage[];
3496
- getMessagesByRole(role: TUniversalMessageRole): TUniversalMessage[];
3497
- getRecentMessages(count: number): TUniversalMessage[];
3498
- clear(): void;
3499
- getMessageCount(): number;
3500
- }
3501
- /** Configuration options for ConversationHistory manager */
3502
- interface IConversationHistoryOptions {
3503
- maxMessagesPerConversation?: number;
3504
- maxConversations?: number;
3505
- }
3506
- /** Multi-session conversation history manager. @public */
3507
- declare class ConversationHistory {
3508
- private conversations;
3509
- private logger;
3510
- private readonly maxMessagesPerConversation;
3511
- private readonly maxConversations;
3512
- constructor(options?: IConversationHistoryOptions);
3513
- getConversationSession(conversationId: string): ConversationSession;
3514
- hasConversation(conversationId: string): boolean;
3515
- removeConversation(conversationId: string): boolean;
3516
- clearAll(): void;
3517
- getStats(): {
3518
- totalConversations: number;
3519
- conversationIds: string[];
3520
- totalMessages: number;
3521
- };
3522
- }
3523
-
3524
3658
  declare class EventHistoryModule implements IEventHistoryModule {
3525
3659
  private readonly store;
3526
3660
  private readonly listener;
@@ -4175,22 +4309,76 @@ interface IContextWindowState {
4175
4309
  remainingPercentage: number;
4176
4310
  }
4177
4311
 
4312
+ /**
4313
+ * Claude model definitions — SSOT for model metadata.
4314
+ * Source: https://platform.claude.com/docs/en/about-claude/models/overview
4315
+ */
4316
+ interface IModelDefinition {
4317
+ /** Human-readable model name */
4318
+ name: string;
4319
+ /** API model identifier */
4320
+ id: string;
4321
+ /** Context window size in tokens */
4322
+ contextWindow: number;
4323
+ /** Maximum output tokens */
4324
+ maxOutput: number;
4325
+ }
4326
+ /**
4327
+ * Known Claude models (4.5+).
4328
+ * Keyed by API model ID for fast lookup.
4329
+ */
4330
+ declare const CLAUDE_MODELS: Record<string, IModelDefinition>;
4331
+ declare const DEFAULT_CONTEXT_WINDOW = 200000;
4332
+ /** Get context window size for a model ID. Falls back to DEFAULT_CONTEXT_WINDOW. */
4333
+ declare function getModelContextWindow(modelId: string): number;
4334
+ declare const DEFAULT_MAX_OUTPUT = 16384;
4335
+ /** Get max output tokens for a model ID. Falls back to DEFAULT_MAX_OUTPUT. */
4336
+ declare function getModelMaxOutput(modelId: string): number;
4337
+ /** Get human-readable model name for a model ID. Falls back to the ID itself. */
4338
+ declare function getModelName(modelId: string): string;
4339
+ /** Format token count as human-readable (e.g., 200K, 1M, 1.2M). Minimum unit is K. */
4340
+ declare function formatTokenCount(tokens: number): string;
4341
+
4178
4342
  /**
4179
4343
  * Hook system types — Claude Code compatible event/hook model.
4180
4344
  */
4181
4345
  /** Hook lifecycle events */
4182
- type THookEvent = 'PreToolUse' | 'PostToolUse' | 'SessionStart' | 'Stop' | 'PreCompact' | 'PostCompact';
4183
- /** A single hook definition */
4184
- interface IHookDefinition {
4185
- /** Shell command to execute */
4346
+ type THookEvent = 'PreToolUse' | 'PostToolUse' | 'SessionStart' | 'Stop' | 'PreCompact' | 'PostCompact' | 'UserPromptSubmit' | 'Notification';
4347
+ /** Command hook executes a shell command */
4348
+ interface ICommandHookDefinition {
4186
4349
  type: 'command';
4187
4350
  command: string;
4351
+ timeout?: number;
4352
+ }
4353
+ /** HTTP hook — sends an HTTP request */
4354
+ interface IHttpHookDefinition {
4355
+ type: 'http';
4356
+ url: string;
4357
+ headers?: Record<string, string>;
4358
+ timeout?: number;
4359
+ }
4360
+ /** Prompt hook — evaluates a prompt via an AI model */
4361
+ interface IPromptHookDefinition {
4362
+ type: 'prompt';
4363
+ prompt: string;
4364
+ model?: string;
4365
+ }
4366
+ /** Agent hook — delegates to a sub-agent */
4367
+ interface IAgentHookDefinition {
4368
+ type: 'agent';
4369
+ agent: string;
4370
+ maxTurns?: number;
4371
+ timeout?: number;
4188
4372
  }
4373
+ /** Discriminated union of all hook definition types */
4374
+ type IHookDefinition = ICommandHookDefinition | IHttpHookDefinition | IPromptHookDefinition | IAgentHookDefinition;
4189
4375
  /** A hook group — matcher + array of hook definitions */
4190
4376
  interface IHookGroup {
4191
4377
  /** Regex pattern to match tool name (empty string = match all) */
4192
4378
  matcher: string;
4193
4379
  hooks: IHookDefinition[];
4380
+ /** Environment variables injected into hook child processes for this group */
4381
+ env?: Record<string, string>;
4194
4382
  }
4195
4383
  /** Complete hooks configuration: event → array of hook groups */
4196
4384
  type THooksConfig = Partial<Record<THookEvent, IHookGroup[]>>;
@@ -4206,6 +4394,14 @@ interface IHookInput {
4206
4394
  trigger?: 'auto' | 'manual';
4207
4395
  /** Compaction summary text (PostCompact only) */
4208
4396
  compact_summary?: string;
4397
+ /** User message text (UserPromptSubmit only) */
4398
+ user_message?: string;
4399
+ /** User prompt text — Claude Code compatible alias for user_message (UserPromptSubmit only) */
4400
+ prompt?: string;
4401
+ /** Assistant response text (Stop only) */
4402
+ response?: string;
4403
+ /** Additional environment variables to pass to hook child processes */
4404
+ env?: Record<string, string>;
4209
4405
  }
4210
4406
  /** Hook execution result */
4211
4407
  interface IHookResult {
@@ -4214,11 +4410,21 @@ interface IHookResult {
4214
4410
  stdout: string;
4215
4411
  stderr: string;
4216
4412
  }
4413
+ /** Strategy interface for hook type executors */
4414
+ interface IHookTypeExecutor {
4415
+ /** The hook type this executor handles */
4416
+ type: IHookDefinition['type'];
4417
+ /** Execute a hook definition with the given input */
4418
+ execute(definition: IHookDefinition, input: IHookInput): Promise<IHookResult>;
4419
+ }
4217
4420
 
4218
4421
  /**
4219
- * Hook runner — executes shell command hooks for lifecycle events.
4422
+ * Hook runner — executes hooks for lifecycle events using the strategy pattern.
4423
+ *
4424
+ * Dispatches to registered IHookTypeExecutor implementations by definition type.
4425
+ * Default executors: CommandExecutor (shell), HttpExecutor (HTTP POST).
4220
4426
  *
4221
- * Hooks receive JSON input on stdin and communicate results via exit codes:
4427
+ * Exit code semantics:
4222
4428
  * - 0: allow/proceed
4223
4429
  * - 2: block/deny (stderr contains reason)
4224
4430
  * - other: proceed (logged as warning)
@@ -4229,10 +4435,19 @@ interface IHookResult {
4229
4435
  *
4230
4436
  * For PreToolUse: if any hook returns exit code 2, the tool call is blocked.
4231
4437
  * Returns { blocked: true, reason: string } if blocked, { blocked: false } otherwise.
4438
+ *
4439
+ * @param config - Hooks configuration mapping events to hook groups
4440
+ * @param event - The lifecycle event being fired
4441
+ * @param input - Hook input data passed to executors
4442
+ * @param executors - Optional array of hook type executors (defaults to command + http)
4232
4443
  */
4233
- declare function runHooks(config: THooksConfig | undefined, event: THookEvent, input: IHookInput): Promise<{
4444
+ /** Result of running hooks for an event. */
4445
+ interface IRunHooksResult {
4234
4446
  blocked: boolean;
4235
4447
  reason?: string;
4236
- }>;
4448
+ /** Collected stdout from all successful hooks (exit code 0). */
4449
+ stdout: string;
4450
+ }
4451
+ declare function runHooks(config: THooksConfig | undefined, event: THookEvent, input: IHookInput, executors?: IHookTypeExecutor[]): Promise<IRunHooksResult>;
4237
4452
 
4238
- export { AGENT_EVENTS, AGENT_EVENT_PREFIX, AbstractAIProvider, AbstractAgent, AbstractExecutor, AbstractManager, AbstractPlugin, AbstractTool, AgentFactory, AgentTemplates, AuthenticationError, CacheIntegrityError, CircuitBreakerOpenError, ConfigurationError, ConversationHistory, ConversationSession, EVENT_EMITTER_EVENTS, EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX, ErrorUtils, EventEmitterPlugin, EventHistoryModule, ExecutionProxy, type IAIProvider, type IAIProviderInstance, type IAIProviderManager, type IAbstractTool, type IAbstractToolOptions, type IAgent, type IAgentConfig, type IAgentCreationOptions, type IAgentCreationStats, type IAgentEventData, type IAgentFactory, type IAgentFactoryOptions, type IAgentLifecycleEvents, type IAgentTemplate, type IAssistantMessage, type IBaseEventData, type IBaseMessage, type ICacheEntry, type ICacheKey, type ICacheOptions, type ICacheStats, type ICacheStorage, type IChatExecutionRequest, type IChatOptions, type IConfigValidationResult, type IContextOptions, type IContextTokenUsage, type IContextWindowState, type IConversationContext, type IConversationResponse, type IConversationService, type IConversationServiceOptions, type IEventContext, type IEventEmitterEventData, type IEventEmitterHierarchicalEventData, type IEventEmitterMetrics, type IEventEmitterMetricsSnapshot, type IEventEmitterPlugin, type IEventEmitterPluginOptions, type IEventHistoryModule, type IEventHistoryRecord, type IEventHistorySnapshot, type IEventService, type IEventServiceOwnerBinding, type IExecutionEventData, type IExecutionService, type IExecutionServiceOptions, type IExecutor, type IExecutorAwareProviderConfig, type IFunctionTool, type IHookDefinition, type IHookGroup, type IHookInput, type IHookResult, type IImageComposeRequest, type IImageEditRequest, type IImageGenerationProvider, type IImageGenerationRequest, type IImageGenerationResult, type IInlineImageInputSource, type IInlineImageMessagePart, type ILocalExecutorConfig, type ILogger, type IMCPToolConfig, type IMediaOutputRef, type IOpenAPIToolConfig, type IOwnerPathSegment, type IParameterSchema, type IParameterValidationResult, type IPermissionLists, type IPlugin, type IPluginConfig, type IPluginContext, type IPluginContract, type IPluginData, type IPluginErrorContext, type IPluginExecutionContext, type IPluginExecutionResult, type IPluginHooks, type IPluginOptions, type IPluginStats, type IProgressReportingTool, type IProviderConfig, type IProviderMediaError, type IProviderOptions, type IProviderRequest, type IProviderSpecificOptions, type IRawProviderResponse, type IRemoteExecutorConfig, type IRunOptions, type ISimpleValidationResult, type IStreamExecutionRequest, type IStreamingChunk, type ISystemMessage, type ITemplateApplicationResult, type ITextMessagePart, type ITokenUsage, type ITool, type IToolCall, type IToolContract, type IToolEventData, type IToolExecutionContext, type IToolExecutionRequest, type IToolExecutionResult, type IToolExecutionService, type IToolExecutionStep, type IToolFactory, type IToolManager, type IToolMessage, type IToolRegistry, type IToolResult, type IToolSchema, type IToolWithEventService, type IUniversalObjectValue, type IUriImageInputSource, type IUriImageMessagePart, type IUserMessage, type IUtilLogEntry, type IValidationIssue, type IValidationOptions, type IValidationResult, type IVideoGenerationProvider, type IVideoGenerationRequest, type IVideoJobAccepted, type IVideoJobSnapshot, type IWorkflowConfig, type IWorkflowConversionOptions, type IWorkflowConversionResult, type IWorkflowConverter, type IWorkflowData, type IWorkflowMetadata, type IWorkflowValidator, InMemoryEventEmitterMetrics, LocalExecutor, MODE_POLICY, MessageConverter, ModelNotAvailableError, NetworkError, PluginCategory, PluginError, PluginPriority, ProviderError, RateLimitError, Robota, RobotaError, SilentLogger, StorageError, type TAgentCreationMetadata, type TComplexConfigValue, type TConfigData, type TConfigValue, type TContextData, type TConversationContextMetadata, type TErrorContextData, type TErrorExternalInput, type TEventEmitterListener, type TEventListener, type TEventName, type TExecutionEventName, type TExecutionMetadata, type THookEvent, type THooksConfig, type TImageInputSource, type TJSONSchemaEnum, type TJSONSchemaKind, type TKnownToolName, type TLoggerData, type TManagerToolParameters, type TMetadata, type TMetadataValue, TOOL_EVENTS, TOOL_EVENT_PREFIX, type TParameterDefaultValue, type TPermissionDecision, type TPermissionMode, type TPrimitiveValue, type TProviderConfigValue, type TProviderLoggingData, type TProviderMediaResult, type TProviderOptionValueBase, TRUST_TO_MODE, type TResponseMetadata, type TTextDeltaCallback, type TTimerId, type TToolArgs, type TToolExecutionFunction, type TToolExecutionParameters, type TToolExecutor, type TToolMetadata, type TToolParameters, type TToolProgressCallback, type TTrustLevel, type TUniversalArrayValue, type TUniversalMessage, type TUniversalMessageMetadata, type TUniversalMessagePart, type TUniversalMessageRole, type TUniversalValue, type TUtilLogLevel, ToolExecutionError, UNKNOWN_TOOL_FALLBACK, ValidationError, ValidationSeverity, Validator, createExecutionProxy, createLogger, evaluatePermission, getGlobalLogLevel, getToolEstimatedDuration, getToolExecutionSteps, isAssistantMessage, isImageGenerationProvider, isProgressReportingTool, isSystemMessage, isToolMessage, isUserMessage, isVideoGenerationProvider, logger, runHooks, setGlobalLogLevel, setToolProgressCallback, startPeriodicTask, stopPeriodicTask, validateAgentConfig, validateApiKey, validateModelName, validateProviderName, validateUserInput, withEventEmission };
4453
+ export { AGENT_EVENTS, AGENT_EVENT_PREFIX, AbstractAIProvider, AbstractAgent, AbstractEventService, AbstractExecutor, AbstractManager, AbstractPlugin, AbstractTool, AgentFactory, AgentTemplates, AuthenticationError, CLAUDE_MODELS, CacheIntegrityError, CircuitBreakerOpenError, ConfigurationError, ConversationHistory, ConversationStore, DEFAULT_ABSTRACT_EVENT_SERVICE, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_OUTPUT, DefaultEventService, EVENT_EMITTER_EVENTS, EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX, ErrorUtils, EventEmitterPlugin, EventHistoryModule, ExecutionProxy, type IAIProvider, type IAIProviderInstance, type IAIProviderManager, type IAbstractTool, type IAbstractToolOptions, type IAgent, type IAgentConfig, type IAgentCreationOptions, type IAgentCreationStats, type IAgentEventData, type IAgentFactory, type IAgentFactoryOptions, type IAgentHookDefinition, type IAgentLifecycleEvents, type IAgentTemplate, type IAssistantMessage, type IBaseEventData, type IBaseMessage, type ICacheEntry, type ICacheKey, type ICacheOptions, type ICacheStats, type ICacheStorage, type IChatExecutionRequest, type IChatOptions, type ICommandHookDefinition, type IConfigValidationResult, type IContextOptions, type IContextTokenUsage, type IContextWindowState, type IConversationContext, type IConversationResponse, type IConversationService, type IConversationServiceOptions, type IEventContext, type IEventEmitterEventData, type IEventEmitterHierarchicalEventData, type IEventEmitterMetrics, type IEventEmitterMetricsSnapshot, type IEventEmitterPlugin, type IEventEmitterPluginOptions, type IEventHistoryModule, type IEventHistoryRecord, type IEventHistorySnapshot, type IEventObjectValue, type IEventService, type IEventServiceOwnerBinding, type IExecutionEventData, type IExecutionService, type IExecutionServiceOptions, type IExecutor, type IExecutorAwareProviderConfig, type IFunctionTool, type IHookDefinition, type IHookGroup, type IHookInput, type IHookResult, type IHookTypeExecutor, type IHttpHookDefinition, type IImageComposeRequest, type IImageEditRequest, type IImageGenerationProvider, type IImageGenerationRequest, type IImageGenerationResult, type IInlineImageInputSource, type IInlineImageMessagePart, type ILocalExecutorConfig, type ILogger, type IMCPToolConfig, type IMediaOutputRef, type IModelDefinition, type IOpenAPIToolConfig, type IOwnerPathSegment, type IParameterSchema, type IParameterValidationResult, type IPermissionLists, type IPlugin, type IPluginConfig, type IPluginContext, type IPluginContract, type IPluginData, type IPluginErrorContext, type IPluginExecutionContext, type IPluginExecutionResult, type IPluginHooks, type IPluginOptions, type IPluginStats, type IProgressReportingTool, type IPromptHookDefinition, type IProviderConfig, type IProviderMediaError, type IProviderOptions, type IProviderRequest, type IProviderSpecificOptions, type IRawProviderResponse, type IRemoteExecutorConfig, type IRunOptions, type ISimpleValidationResult, type IStreamExecutionRequest, type IStreamingChunk, type ISystemMessage, type ITemplateApplicationResult, type ITextMessagePart, type ITokenUsage, type ITool, type IToolCall, type IToolContract, type IToolEventData, type IToolExecutionContext, type IToolExecutionRequest, type IToolExecutionResult, type IToolExecutionService, type IToolExecutionStep, type IToolFactory, type IToolManager, type IToolMessage, type IToolRegistry, type IToolResult, type IToolSchema, type IToolWithEventService, type IUniversalObjectValue, type IUriImageInputSource, type IUriImageMessagePart, type IUserMessage, type IUtilLogEntry, type IValidationIssue, type IValidationOptions, type IValidationResult, type IVideoGenerationProvider, type IVideoGenerationRequest, type IVideoJobAccepted, type IVideoJobSnapshot, type IWorkflowConfig, type IWorkflowConversionOptions, type IWorkflowConversionResult, type IWorkflowConverter, type IWorkflowData, type IWorkflowMetadata, type IWorkflowValidator, InMemoryEventEmitterMetrics, LocalExecutor, MODE_POLICY, MessageConverter, ModelNotAvailableError, NetworkError, ObservableEventService, PluginCategory, PluginError, PluginPriority, ProviderError, RateLimitError, Robota, RobotaError, SilentLogger, StorageError, StructuredEventService, TASK_EVENTS, TASK_EVENT_PREFIX, type TAgentCreationMetadata, type TComplexConfigValue, type TConfigData, type TConfigValue, type TContextData, type TConversationContextMetadata, type TErrorContextData, type TErrorExternalInput, type TEventEmitterListener, type TEventExtensionValue, type TEventListener, type TEventLoggerData, type TEventName, type TEventUniversalValue, type TExecutionEventName, type TExecutionMetadata, type THookEvent, type THooksConfig, type TImageInputSource, type TJSONSchemaEnum, type TJSONSchemaKind, type TKnownToolName, type TLoggerData, type TManagerToolParameters, type TMessageState, type TMetadata, type TMetadataValue, TOOL_EVENTS, TOOL_EVENT_PREFIX, type TParameterDefaultValue, type TPermissionDecision, type TPermissionMode, type TPrimitiveValue, type TProviderConfigValue, type TProviderLoggingData, type TProviderMediaResult, type TProviderOptionValueBase, TRUST_TO_MODE, type TResponseMetadata, type TTextDeltaCallback, type TTimerId, type TToolArgs, type TToolExecutionFunction, type TToolExecutionParameters, type TToolExecutor, type TToolMetadata, type TToolParameters, type TToolProgressCallback, type TTrustLevel, type TUniversalArrayValue, type TUniversalMessage, type TUniversalMessageMetadata, type TUniversalMessagePart, type TUniversalMessageRole, type TUniversalValue, type TUserEvent, type TUtilLogLevel, ToolExecutionError, UNKNOWN_TOOL_FALLBACK, USER_EVENTS, USER_EVENT_PREFIX, ValidationError, ValidationSeverity, Validator, bindEventServiceOwner, bindWithOwnerPath, composeEventName, createAssistantMessage, createExecutionProxy, createLogger, createSystemMessage, createToolMessage, createUserMessage, evaluatePermission, formatTokenCount, getGlobalLogLevel, getModelContextWindow, getModelMaxOutput, getModelName, getToolEstimatedDuration, getToolExecutionSteps, isAssistantMessage, isDefaultEventService, isImageGenerationProvider, isProgressReportingTool, isSystemMessage, isToolMessage, isUserMessage, isVideoGenerationProvider, logger, runHooks, setGlobalLogLevel, setToolProgressCallback, startPeriodicTask, stopPeriodicTask, validateAgentConfig, validateApiKey, validateModelName, validateProviderName, validateUserInput, withEventEmission };