@notic/agent-engine 2.2.0 → 3.0.1

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 (446) hide show
  1. package/CHANGELOG.md +31 -1
  2. package/README.md +97 -449
  3. package/dist/agent/Agent.d.ts +138 -355
  4. package/dist/agent/Agent.d.ts.map +1 -1
  5. package/dist/agent/Agent.js +305 -1128
  6. package/dist/agent/Agent.js.map +1 -1
  7. package/dist/agent/index.d.ts +1 -1
  8. package/dist/agent/index.d.ts.map +1 -1
  9. package/dist/agent/index.js +15 -8
  10. package/dist/agent/index.js.map +1 -1
  11. package/dist/core/data.d.ts +17 -0
  12. package/dist/core/data.d.ts.map +1 -0
  13. package/dist/core/data.js +86 -0
  14. package/dist/core/data.js.map +1 -0
  15. package/dist/generator/Generator.d.ts +41 -0
  16. package/dist/generator/Generator.d.ts.map +1 -0
  17. package/dist/generator/Generator.js +89 -0
  18. package/dist/generator/Generator.js.map +1 -0
  19. package/dist/generator/index.d.ts +2 -0
  20. package/dist/generator/index.d.ts.map +1 -0
  21. package/dist/generator/index.js +18 -0
  22. package/dist/generator/index.js.map +1 -0
  23. package/dist/index.d.ts +7 -35
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +21 -94
  26. package/dist/index.js.map +1 -1
  27. package/dist/legacy/adapter/AnthropicAdapter.d.ts.map +1 -0
  28. package/dist/{adapter → legacy/adapter}/AnthropicAdapter.js +3 -3
  29. package/dist/legacy/adapter/AnthropicAdapter.js.map +1 -0
  30. package/dist/legacy/adapter/GeminiAdapter.d.ts.map +1 -0
  31. package/dist/{adapter → legacy/adapter}/GeminiAdapter.js +3 -3
  32. package/dist/legacy/adapter/GeminiAdapter.js.map +1 -0
  33. package/dist/legacy/adapter/MessageAdapter.d.ts.map +1 -0
  34. package/dist/legacy/adapter/MessageAdapter.js.map +1 -0
  35. package/dist/legacy/adapter/OpenAIAdapter.d.ts.map +1 -0
  36. package/dist/{adapter → legacy/adapter}/OpenAIAdapter.js +1 -1
  37. package/dist/legacy/adapter/OpenAIAdapter.js.map +1 -0
  38. package/dist/legacy/adapter/OpenAIResponsesAdapter.d.ts.map +1 -0
  39. package/dist/legacy/adapter/OpenAIResponsesAdapter.js.map +1 -0
  40. package/dist/legacy/adapter/index.d.ts.map +1 -0
  41. package/dist/legacy/adapter/index.js.map +1 -0
  42. package/dist/legacy/agent/Agent.d.ts +371 -0
  43. package/dist/legacy/agent/Agent.d.ts.map +1 -0
  44. package/dist/legacy/agent/Agent.js +1169 -0
  45. package/dist/legacy/agent/Agent.js.map +1 -0
  46. package/dist/legacy/agent/index.d.ts +2 -0
  47. package/dist/legacy/agent/index.d.ts.map +1 -0
  48. package/dist/legacy/agent/index.js +11 -0
  49. package/dist/legacy/agent/index.js.map +1 -0
  50. package/dist/legacy/client/ModelClient.d.ts.map +1 -0
  51. package/dist/legacy/client/ModelClient.js.map +1 -0
  52. package/dist/legacy/client/index.d.ts.map +1 -0
  53. package/dist/legacy/client/index.js.map +1 -0
  54. package/dist/legacy/config/RequestConfig.d.ts.map +1 -0
  55. package/dist/legacy/config/RequestConfig.js.map +1 -0
  56. package/dist/legacy/config/index.d.ts.map +1 -0
  57. package/dist/legacy/config/index.js.map +1 -0
  58. package/dist/legacy/index.d.ts +36 -0
  59. package/dist/legacy/index.d.ts.map +1 -0
  60. package/dist/legacy/index.js +97 -0
  61. package/dist/legacy/index.js.map +1 -0
  62. package/dist/legacy/media/BrowserMediaResolver.d.ts.map +1 -0
  63. package/dist/legacy/media/BrowserMediaResolver.js.map +1 -0
  64. package/dist/legacy/media/DefaultMediaResolver.d.ts.map +1 -0
  65. package/dist/legacy/media/DefaultMediaResolver.js.map +1 -0
  66. package/dist/legacy/media/MediaResolver.d.ts.map +1 -0
  67. package/dist/legacy/media/MediaResolver.js.map +1 -0
  68. package/dist/legacy/media/index.d.ts.map +1 -0
  69. package/dist/legacy/media/index.js.map +1 -0
  70. package/dist/legacy/message/Message.d.ts +147 -0
  71. package/dist/legacy/message/Message.d.ts.map +1 -0
  72. package/dist/legacy/message/Message.js +446 -0
  73. package/dist/legacy/message/Message.js.map +1 -0
  74. package/dist/legacy/message/MessagePart.d.ts +50 -0
  75. package/dist/legacy/message/MessagePart.d.ts.map +1 -0
  76. package/dist/legacy/message/MessagePart.js +6 -0
  77. package/dist/legacy/message/MessagePart.js.map +1 -0
  78. package/dist/legacy/message/Role.d.ts +10 -0
  79. package/dist/legacy/message/Role.d.ts.map +1 -0
  80. package/dist/legacy/message/Role.js +14 -0
  81. package/dist/legacy/message/Role.js.map +1 -0
  82. package/dist/legacy/message/Usage.d.ts.map +1 -0
  83. package/dist/legacy/message/Usage.js.map +1 -0
  84. package/dist/legacy/message/index.d.ts +5 -0
  85. package/dist/legacy/message/index.d.ts.map +1 -0
  86. package/dist/legacy/message/index.js +10 -0
  87. package/dist/legacy/message/index.js.map +1 -0
  88. package/dist/legacy/node.d.ts +3 -0
  89. package/dist/legacy/node.d.ts.map +1 -0
  90. package/dist/legacy/node.js +6 -0
  91. package/dist/legacy/node.js.map +1 -0
  92. package/dist/legacy/prompt/Injection.d.ts.map +1 -0
  93. package/dist/legacy/prompt/Injection.js.map +1 -0
  94. package/dist/legacy/prompt/PromptBuilder.d.ts +284 -0
  95. package/dist/legacy/prompt/PromptBuilder.d.ts.map +1 -0
  96. package/dist/legacy/prompt/PromptBuilder.js +491 -0
  97. package/dist/legacy/prompt/PromptBuilder.js.map +1 -0
  98. package/dist/legacy/prompt/Rule.d.ts.map +1 -0
  99. package/dist/legacy/prompt/Rule.js.map +1 -0
  100. package/dist/legacy/prompt/index.d.ts +4 -0
  101. package/dist/legacy/prompt/index.d.ts.map +1 -0
  102. package/dist/legacy/prompt/index.js +10 -0
  103. package/dist/legacy/prompt/index.js.map +1 -0
  104. package/dist/legacy/provider/Provider.d.ts +48 -0
  105. package/dist/legacy/provider/Provider.d.ts.map +1 -0
  106. package/dist/legacy/provider/Provider.js +73 -0
  107. package/dist/legacy/provider/Provider.js.map +1 -0
  108. package/dist/legacy/provider/index.d.ts +2 -0
  109. package/dist/legacy/provider/index.d.ts.map +1 -0
  110. package/dist/legacy/provider/index.js +10 -0
  111. package/dist/legacy/provider/index.js.map +1 -0
  112. package/dist/legacy/session/AgentSession.d.ts +13 -0
  113. package/dist/legacy/session/AgentSession.d.ts.map +1 -0
  114. package/dist/legacy/session/AgentSession.js +3 -0
  115. package/dist/legacy/session/AgentSession.js.map +1 -0
  116. package/dist/legacy/session/Inserter.d.ts.map +1 -0
  117. package/dist/legacy/session/Inserter.js.map +1 -0
  118. package/dist/legacy/session/ListSession.d.ts +64 -0
  119. package/dist/legacy/session/ListSession.d.ts.map +1 -0
  120. package/dist/legacy/session/ListSession.js +251 -0
  121. package/dist/legacy/session/ListSession.js.map +1 -0
  122. package/dist/legacy/session/Paginator.d.ts.map +1 -0
  123. package/dist/legacy/session/Paginator.js.map +1 -0
  124. package/dist/legacy/session/Query.d.ts.map +1 -0
  125. package/dist/legacy/session/Query.js.map +1 -0
  126. package/dist/legacy/session/SearchCriteria.d.ts.map +1 -0
  127. package/dist/legacy/session/SearchCriteria.js.map +1 -0
  128. package/dist/legacy/session/Session.d.ts.map +1 -0
  129. package/dist/legacy/session/Session.js.map +1 -0
  130. package/dist/legacy/session/index.d.ts +9 -0
  131. package/dist/legacy/session/index.d.ts.map +1 -0
  132. package/dist/legacy/session/index.js +17 -0
  133. package/dist/legacy/session/index.js.map +1 -0
  134. package/dist/legacy/session/matchUtils.d.ts.map +1 -0
  135. package/dist/legacy/session/matchUtils.js.map +1 -0
  136. package/dist/legacy/stream/AnthropicStreamParser.d.ts.map +1 -0
  137. package/dist/legacy/stream/AnthropicStreamParser.js.map +1 -0
  138. package/dist/legacy/stream/GeminiStreamParser.d.ts.map +1 -0
  139. package/dist/legacy/stream/GeminiStreamParser.js.map +1 -0
  140. package/dist/legacy/stream/MessageStreamParser.d.ts.map +1 -0
  141. package/dist/legacy/stream/MessageStreamParser.js.map +1 -0
  142. package/dist/legacy/stream/OpenAIResponsesStreamParser.d.ts.map +1 -0
  143. package/dist/legacy/stream/OpenAIResponsesStreamParser.js.map +1 -0
  144. package/dist/legacy/stream/StreamEvent.d.ts.map +1 -0
  145. package/dist/legacy/stream/StreamEvent.js.map +1 -0
  146. package/dist/legacy/stream/StreamParser.d.ts.map +1 -0
  147. package/dist/legacy/stream/StreamParser.js.map +1 -0
  148. package/dist/legacy/stream/index.d.ts.map +1 -0
  149. package/dist/legacy/stream/index.js.map +1 -0
  150. package/dist/legacy/tool/Context.d.ts.map +1 -0
  151. package/dist/legacy/tool/Context.js.map +1 -0
  152. package/dist/legacy/tool/Hook.d.ts.map +1 -0
  153. package/dist/legacy/tool/Hook.js.map +1 -0
  154. package/dist/legacy/tool/McpToolAdapter.d.ts.map +1 -0
  155. package/dist/legacy/tool/McpToolAdapter.js.map +1 -0
  156. package/dist/legacy/tool/Param.d.ts.map +1 -0
  157. package/dist/legacy/tool/Param.js.map +1 -0
  158. package/dist/legacy/tool/Tool.d.ts +92 -0
  159. package/dist/legacy/tool/Tool.d.ts.map +1 -0
  160. package/dist/legacy/tool/Tool.js +198 -0
  161. package/dist/legacy/tool/Tool.js.map +1 -0
  162. package/dist/legacy/tool/ToolCall.d.ts.map +1 -0
  163. package/dist/legacy/tool/ToolCall.js.map +1 -0
  164. package/dist/legacy/tool/ToolKit.d.ts +91 -0
  165. package/dist/legacy/tool/ToolKit.d.ts.map +1 -0
  166. package/dist/legacy/tool/ToolKit.js +209 -0
  167. package/dist/legacy/tool/ToolKit.js.map +1 -0
  168. package/dist/legacy/tool/ValueType.d.ts.map +1 -0
  169. package/dist/legacy/tool/ValueType.js.map +1 -0
  170. package/dist/legacy/tool/index.d.ts +9 -0
  171. package/dist/legacy/tool/index.d.ts.map +1 -0
  172. package/dist/legacy/tool/index.js +22 -0
  173. package/dist/legacy/tool/index.js.map +1 -0
  174. package/dist/legacy/utils/generateId.d.ts.map +1 -0
  175. package/dist/legacy/utils/generateId.js.map +1 -0
  176. package/dist/legacy/utils/index.d.ts.map +1 -0
  177. package/dist/legacy/utils/index.js.map +1 -0
  178. package/dist/message/Message.d.ts +90 -135
  179. package/dist/message/Message.d.ts.map +1 -1
  180. package/dist/message/Message.js +195 -414
  181. package/dist/message/Message.js.map +1 -1
  182. package/dist/message/MessagePart.d.ts +7 -1
  183. package/dist/message/MessagePart.d.ts.map +1 -1
  184. package/dist/message/MessagePart.js +0 -3
  185. package/dist/message/MessagePart.js.map +1 -1
  186. package/dist/message/Role.d.ts.map +1 -1
  187. package/dist/message/Role.js.map +1 -1
  188. package/dist/message/index.d.ts +1 -4
  189. package/dist/message/index.d.ts.map +1 -1
  190. package/dist/message/index.js +15 -7
  191. package/dist/message/index.js.map +1 -1
  192. package/dist/node.d.ts +1 -2
  193. package/dist/node.d.ts.map +1 -1
  194. package/dist/node.js +1 -1
  195. package/dist/node.js.map +1 -1
  196. package/dist/prompt/PromptBuilder.d.ts +43 -278
  197. package/dist/prompt/PromptBuilder.d.ts.map +1 -1
  198. package/dist/prompt/PromptBuilder.js +71 -473
  199. package/dist/prompt/PromptBuilder.js.map +1 -1
  200. package/dist/prompt/index.d.ts +1 -3
  201. package/dist/prompt/index.d.ts.map +1 -1
  202. package/dist/prompt/index.js +15 -7
  203. package/dist/prompt/index.js.map +1 -1
  204. package/dist/provider/HttpProvider.d.ts +32 -0
  205. package/dist/provider/HttpProvider.d.ts.map +1 -0
  206. package/dist/provider/HttpProvider.js +160 -0
  207. package/dist/provider/HttpProvider.js.map +1 -0
  208. package/dist/provider/Provider.d.ts +125 -45
  209. package/dist/provider/Provider.d.ts.map +1 -1
  210. package/dist/provider/Provider.js +77 -58
  211. package/dist/provider/Provider.js.map +1 -1
  212. package/dist/provider/capabilities.d.ts +108 -0
  213. package/dist/provider/capabilities.d.ts.map +1 -0
  214. package/dist/provider/capabilities.js +10 -0
  215. package/dist/provider/capabilities.js.map +1 -0
  216. package/dist/provider/index.d.ts +7 -1
  217. package/dist/provider/index.d.ts.map +1 -1
  218. package/dist/provider/index.js +23 -7
  219. package/dist/provider/index.js.map +1 -1
  220. package/dist/provider/media.d.ts +9 -0
  221. package/dist/provider/media.d.ts.map +1 -0
  222. package/dist/provider/media.js +3 -0
  223. package/dist/provider/media.js.map +1 -0
  224. package/dist/provider/transport.d.ts +10 -0
  225. package/dist/provider/transport.d.ts.map +1 -0
  226. package/dist/provider/transport.js +121 -0
  227. package/dist/provider/transport.js.map +1 -0
  228. package/dist/session/AgentSession.d.ts +14 -11
  229. package/dist/session/AgentSession.d.ts.map +1 -1
  230. package/dist/session/AgentSession.js +21 -0
  231. package/dist/session/AgentSession.js.map +1 -1
  232. package/dist/session/BaseSession.d.ts +49 -0
  233. package/dist/session/BaseSession.d.ts.map +1 -0
  234. package/dist/session/BaseSession.js +147 -0
  235. package/dist/session/BaseSession.js.map +1 -0
  236. package/dist/session/ListSession.d.ts +37 -55
  237. package/dist/session/ListSession.d.ts.map +1 -1
  238. package/dist/session/ListSession.js +175 -221
  239. package/dist/session/ListSession.js.map +1 -1
  240. package/dist/session/SessionQuery.d.ts +31 -0
  241. package/dist/session/SessionQuery.d.ts.map +1 -0
  242. package/dist/session/SessionQuery.js +67 -0
  243. package/dist/session/SessionQuery.js.map +1 -0
  244. package/dist/session/TreeSession.d.ts +24 -0
  245. package/dist/session/TreeSession.d.ts.map +1 -0
  246. package/dist/session/TreeSession.js +122 -0
  247. package/dist/session/TreeSession.js.map +1 -0
  248. package/dist/session/continuation.d.ts +9 -0
  249. package/dist/session/continuation.d.ts.map +1 -0
  250. package/dist/session/continuation.js +48 -0
  251. package/dist/session/continuation.js.map +1 -0
  252. package/dist/session/index.d.ts +10 -8
  253. package/dist/session/index.d.ts.map +1 -1
  254. package/dist/session/index.js +24 -14
  255. package/dist/session/index.js.map +1 -1
  256. package/dist/session/restoreSession.d.ts +4 -0
  257. package/dist/session/restoreSession.d.ts.map +1 -0
  258. package/dist/session/restoreSession.js +12 -0
  259. package/dist/session/restoreSession.js.map +1 -0
  260. package/dist/session/structures.d.ts +32 -0
  261. package/dist/session/structures.d.ts.map +1 -0
  262. package/dist/session/structures.js +3 -0
  263. package/dist/session/structures.js.map +1 -0
  264. package/dist/session/trace.d.ts +73 -0
  265. package/dist/session/trace.d.ts.map +1 -0
  266. package/dist/session/trace.js +90 -0
  267. package/dist/session/trace.js.map +1 -0
  268. package/dist/session/types.d.ts +76 -0
  269. package/dist/session/types.d.ts.map +1 -0
  270. package/dist/session/types.js +12 -0
  271. package/dist/session/types.js.map +1 -0
  272. package/dist/tool/Tool.d.ts +26 -89
  273. package/dist/tool/Tool.d.ts.map +1 -1
  274. package/dist/tool/Tool.js +38 -185
  275. package/dist/tool/Tool.js.map +1 -1
  276. package/dist/tool/ToolExecutor.d.ts +59 -0
  277. package/dist/tool/ToolExecutor.d.ts.map +1 -0
  278. package/dist/tool/ToolExecutor.js +128 -0
  279. package/dist/tool/ToolExecutor.js.map +1 -0
  280. package/dist/tool/ToolKit.d.ts +17 -77
  281. package/dist/tool/ToolKit.d.ts.map +1 -1
  282. package/dist/tool/ToolKit.js +29 -189
  283. package/dist/tool/ToolKit.js.map +1 -1
  284. package/dist/tool/index.d.ts +4 -8
  285. package/dist/tool/index.d.ts.map +1 -1
  286. package/dist/tool/index.js +17 -19
  287. package/dist/tool/index.js.map +1 -1
  288. package/docs/API-2.x.md +1827 -0
  289. package/docs/API.md +251 -1825
  290. package/docs/CE-FEEDBACK-3.0.md +148 -0
  291. package/docs/CHARACTEREDITOR-3.0-NOTES.md +156 -0
  292. package/docs/DATA-MODEL-3.0.md +248 -0
  293. package/docs/DESIGN-3.0.md +326 -0
  294. package/docs/MIGRATION-3.0.md +77 -0
  295. package/docs/MULTIMEDIA-3.0.md +145 -0
  296. package/docs/PLAN-3.0.md +121 -0
  297. package/package.json +36 -25
  298. package/dist/adapter/AnthropicAdapter.d.ts.map +0 -1
  299. package/dist/adapter/AnthropicAdapter.js.map +0 -1
  300. package/dist/adapter/GeminiAdapter.d.ts.map +0 -1
  301. package/dist/adapter/GeminiAdapter.js.map +0 -1
  302. package/dist/adapter/MessageAdapter.d.ts.map +0 -1
  303. package/dist/adapter/MessageAdapter.js.map +0 -1
  304. package/dist/adapter/OpenAIAdapter.d.ts.map +0 -1
  305. package/dist/adapter/OpenAIAdapter.js.map +0 -1
  306. package/dist/adapter/OpenAIResponsesAdapter.d.ts.map +0 -1
  307. package/dist/adapter/OpenAIResponsesAdapter.js.map +0 -1
  308. package/dist/adapter/index.d.ts.map +0 -1
  309. package/dist/adapter/index.js.map +0 -1
  310. package/dist/client/ModelClient.d.ts.map +0 -1
  311. package/dist/client/ModelClient.js.map +0 -1
  312. package/dist/client/index.d.ts.map +0 -1
  313. package/dist/client/index.js.map +0 -1
  314. package/dist/config/RequestConfig.d.ts.map +0 -1
  315. package/dist/config/RequestConfig.js.map +0 -1
  316. package/dist/config/index.d.ts.map +0 -1
  317. package/dist/config/index.js.map +0 -1
  318. package/dist/media/BrowserMediaResolver.d.ts.map +0 -1
  319. package/dist/media/BrowserMediaResolver.js.map +0 -1
  320. package/dist/media/DefaultMediaResolver.d.ts.map +0 -1
  321. package/dist/media/DefaultMediaResolver.js.map +0 -1
  322. package/dist/media/MediaResolver.d.ts.map +0 -1
  323. package/dist/media/MediaResolver.js.map +0 -1
  324. package/dist/media/index.d.ts.map +0 -1
  325. package/dist/media/index.js.map +0 -1
  326. package/dist/message/Usage.d.ts.map +0 -1
  327. package/dist/message/Usage.js.map +0 -1
  328. package/dist/prompt/Injection.d.ts.map +0 -1
  329. package/dist/prompt/Injection.js.map +0 -1
  330. package/dist/prompt/Rule.d.ts.map +0 -1
  331. package/dist/prompt/Rule.js.map +0 -1
  332. package/dist/session/Inserter.d.ts.map +0 -1
  333. package/dist/session/Inserter.js.map +0 -1
  334. package/dist/session/Paginator.d.ts.map +0 -1
  335. package/dist/session/Paginator.js.map +0 -1
  336. package/dist/session/Query.d.ts.map +0 -1
  337. package/dist/session/Query.js.map +0 -1
  338. package/dist/session/SearchCriteria.d.ts.map +0 -1
  339. package/dist/session/SearchCriteria.js.map +0 -1
  340. package/dist/session/Session.d.ts.map +0 -1
  341. package/dist/session/Session.js.map +0 -1
  342. package/dist/session/matchUtils.d.ts.map +0 -1
  343. package/dist/session/matchUtils.js.map +0 -1
  344. package/dist/stream/AnthropicStreamParser.d.ts.map +0 -1
  345. package/dist/stream/AnthropicStreamParser.js.map +0 -1
  346. package/dist/stream/GeminiStreamParser.d.ts.map +0 -1
  347. package/dist/stream/GeminiStreamParser.js.map +0 -1
  348. package/dist/stream/MessageStreamParser.d.ts.map +0 -1
  349. package/dist/stream/MessageStreamParser.js.map +0 -1
  350. package/dist/stream/OpenAIResponsesStreamParser.d.ts.map +0 -1
  351. package/dist/stream/OpenAIResponsesStreamParser.js.map +0 -1
  352. package/dist/stream/StreamEvent.d.ts.map +0 -1
  353. package/dist/stream/StreamEvent.js.map +0 -1
  354. package/dist/stream/StreamParser.d.ts.map +0 -1
  355. package/dist/stream/StreamParser.js.map +0 -1
  356. package/dist/stream/index.d.ts.map +0 -1
  357. package/dist/stream/index.js.map +0 -1
  358. package/dist/tool/Context.d.ts.map +0 -1
  359. package/dist/tool/Context.js.map +0 -1
  360. package/dist/tool/Hook.d.ts.map +0 -1
  361. package/dist/tool/Hook.js.map +0 -1
  362. package/dist/tool/McpToolAdapter.d.ts.map +0 -1
  363. package/dist/tool/McpToolAdapter.js.map +0 -1
  364. package/dist/tool/Param.d.ts.map +0 -1
  365. package/dist/tool/Param.js.map +0 -1
  366. package/dist/tool/ToolCall.d.ts.map +0 -1
  367. package/dist/tool/ToolCall.js.map +0 -1
  368. package/dist/tool/ValueType.d.ts.map +0 -1
  369. package/dist/tool/ValueType.js.map +0 -1
  370. package/dist/utils/generateId.d.ts.map +0 -1
  371. package/dist/utils/generateId.js.map +0 -1
  372. package/dist/utils/index.d.ts.map +0 -1
  373. package/dist/utils/index.js.map +0 -1
  374. /package/dist/{adapter → legacy/adapter}/AnthropicAdapter.d.ts +0 -0
  375. /package/dist/{adapter → legacy/adapter}/GeminiAdapter.d.ts +0 -0
  376. /package/dist/{adapter → legacy/adapter}/MessageAdapter.d.ts +0 -0
  377. /package/dist/{adapter → legacy/adapter}/MessageAdapter.js +0 -0
  378. /package/dist/{adapter → legacy/adapter}/OpenAIAdapter.d.ts +0 -0
  379. /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.d.ts +0 -0
  380. /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.js +0 -0
  381. /package/dist/{adapter → legacy/adapter}/index.d.ts +0 -0
  382. /package/dist/{adapter → legacy/adapter}/index.js +0 -0
  383. /package/dist/{client → legacy/client}/ModelClient.d.ts +0 -0
  384. /package/dist/{client → legacy/client}/ModelClient.js +0 -0
  385. /package/dist/{client → legacy/client}/index.d.ts +0 -0
  386. /package/dist/{client → legacy/client}/index.js +0 -0
  387. /package/dist/{config → legacy/config}/RequestConfig.d.ts +0 -0
  388. /package/dist/{config → legacy/config}/RequestConfig.js +0 -0
  389. /package/dist/{config → legacy/config}/index.d.ts +0 -0
  390. /package/dist/{config → legacy/config}/index.js +0 -0
  391. /package/dist/{media → legacy/media}/BrowserMediaResolver.d.ts +0 -0
  392. /package/dist/{media → legacy/media}/BrowserMediaResolver.js +0 -0
  393. /package/dist/{media → legacy/media}/DefaultMediaResolver.d.ts +0 -0
  394. /package/dist/{media → legacy/media}/DefaultMediaResolver.js +0 -0
  395. /package/dist/{media → legacy/media}/MediaResolver.d.ts +0 -0
  396. /package/dist/{media → legacy/media}/MediaResolver.js +0 -0
  397. /package/dist/{media → legacy/media}/index.d.ts +0 -0
  398. /package/dist/{media → legacy/media}/index.js +0 -0
  399. /package/dist/{message → legacy/message}/Usage.d.ts +0 -0
  400. /package/dist/{message → legacy/message}/Usage.js +0 -0
  401. /package/dist/{prompt → legacy/prompt}/Injection.d.ts +0 -0
  402. /package/dist/{prompt → legacy/prompt}/Injection.js +0 -0
  403. /package/dist/{prompt → legacy/prompt}/Rule.d.ts +0 -0
  404. /package/dist/{prompt → legacy/prompt}/Rule.js +0 -0
  405. /package/dist/{session → legacy/session}/Inserter.d.ts +0 -0
  406. /package/dist/{session → legacy/session}/Inserter.js +0 -0
  407. /package/dist/{session → legacy/session}/Paginator.d.ts +0 -0
  408. /package/dist/{session → legacy/session}/Paginator.js +0 -0
  409. /package/dist/{session → legacy/session}/Query.d.ts +0 -0
  410. /package/dist/{session → legacy/session}/Query.js +0 -0
  411. /package/dist/{session → legacy/session}/SearchCriteria.d.ts +0 -0
  412. /package/dist/{session → legacy/session}/SearchCriteria.js +0 -0
  413. /package/dist/{session → legacy/session}/Session.d.ts +0 -0
  414. /package/dist/{session → legacy/session}/Session.js +0 -0
  415. /package/dist/{session → legacy/session}/matchUtils.d.ts +0 -0
  416. /package/dist/{session → legacy/session}/matchUtils.js +0 -0
  417. /package/dist/{stream → legacy/stream}/AnthropicStreamParser.d.ts +0 -0
  418. /package/dist/{stream → legacy/stream}/AnthropicStreamParser.js +0 -0
  419. /package/dist/{stream → legacy/stream}/GeminiStreamParser.d.ts +0 -0
  420. /package/dist/{stream → legacy/stream}/GeminiStreamParser.js +0 -0
  421. /package/dist/{stream → legacy/stream}/MessageStreamParser.d.ts +0 -0
  422. /package/dist/{stream → legacy/stream}/MessageStreamParser.js +0 -0
  423. /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.d.ts +0 -0
  424. /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.js +0 -0
  425. /package/dist/{stream → legacy/stream}/StreamEvent.d.ts +0 -0
  426. /package/dist/{stream → legacy/stream}/StreamEvent.js +0 -0
  427. /package/dist/{stream → legacy/stream}/StreamParser.d.ts +0 -0
  428. /package/dist/{stream → legacy/stream}/StreamParser.js +0 -0
  429. /package/dist/{stream → legacy/stream}/index.d.ts +0 -0
  430. /package/dist/{stream → legacy/stream}/index.js +0 -0
  431. /package/dist/{tool → legacy/tool}/Context.d.ts +0 -0
  432. /package/dist/{tool → legacy/tool}/Context.js +0 -0
  433. /package/dist/{tool → legacy/tool}/Hook.d.ts +0 -0
  434. /package/dist/{tool → legacy/tool}/Hook.js +0 -0
  435. /package/dist/{tool → legacy/tool}/McpToolAdapter.d.ts +0 -0
  436. /package/dist/{tool → legacy/tool}/McpToolAdapter.js +0 -0
  437. /package/dist/{tool → legacy/tool}/Param.d.ts +0 -0
  438. /package/dist/{tool → legacy/tool}/Param.js +0 -0
  439. /package/dist/{tool → legacy/tool}/ToolCall.d.ts +0 -0
  440. /package/dist/{tool → legacy/tool}/ToolCall.js +0 -0
  441. /package/dist/{tool → legacy/tool}/ValueType.d.ts +0 -0
  442. /package/dist/{tool → legacy/tool}/ValueType.js +0 -0
  443. /package/dist/{utils → legacy/utils}/generateId.d.ts +0 -0
  444. /package/dist/{utils → legacy/utils}/generateId.js +0 -0
  445. /package/dist/{utils → legacy/utils}/index.d.ts +0 -0
  446. /package/dist/{utils → legacy/utils}/index.js +0 -0
@@ -0,0 +1,90 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ExecutionTrace = void 0;
4
+ const data_1 = require("../core/data");
5
+ class ExecutionTrace {
6
+ data = { turns: [], runs: [], steps: [], tools: [], contributions: [] };
7
+ get records() {
8
+ return (0, data_1.immutable)((0, data_1.copy)(this.data));
9
+ }
10
+ turn(inputs) {
11
+ const record = { id: (0, data_1.id)("turn"), inputMessageIds: [...inputs], createdAt: new Date().toISOString() };
12
+ this.data.turns.push(record);
13
+ return (0, data_1.copy)(record);
14
+ }
15
+ run(kind, turnId, targetMessageId, resumedFrom) {
16
+ const record = { id: (0, data_1.id)("run"), kind, turnId, targetMessageId, resumedFrom, status: "running", createdAt: new Date().toISOString() };
17
+ this.data.runs.push(record);
18
+ return (0, data_1.copy)(record);
19
+ }
20
+ step(runId) {
21
+ const record = { id: (0, data_1.id)("step"), runId, index: this.data.steps.filter(s => s.runId === runId).length, status: "running" };
22
+ this.data.steps.push(record);
23
+ return (0, data_1.copy)(record);
24
+ }
25
+ updateRun(runId, patch) {
26
+ const record = this.data.runs.find(r => r.id === runId);
27
+ (0, data_1.assert)(record, "Unknown run");
28
+ Object.assign(record, (0, data_1.copy)(patch));
29
+ }
30
+ updateStep(stepId, patch) {
31
+ const record = this.data.steps.find(s => s.id === stepId);
32
+ (0, data_1.assert)(record, "Unknown step");
33
+ Object.assign(record, (0, data_1.copy)(patch));
34
+ }
35
+ tool(record) {
36
+ const index = this.data.tools.findIndex(t => t.id === record.id);
37
+ if (index < 0)
38
+ this.data.tools.push((0, data_1.copy)(record));
39
+ else
40
+ this.data.tools[index] = (0, data_1.copy)(record);
41
+ }
42
+ contribute(record) {
43
+ this.data.contributions.push((0, data_1.copy)(record));
44
+ }
45
+ source(messageId) {
46
+ return (0, data_1.copy)(this.data.contributions.find(c => c.messageId === messageId));
47
+ }
48
+ usage(runId) {
49
+ return this.data.steps.filter(s => !runId || s.runId === runId).reduce((sum, s) => ({ inputTokens: sum.inputTokens + (s.usage?.inputTokens ?? 0), outputTokens: sum.outputTokens + (s.usage?.outputTokens ?? 0), totalTokens: sum.totalTokens + (s.usage?.totalTokens ?? 0) }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 });
50
+ }
51
+ toJSON() {
52
+ return JSON.parse(JSON.stringify(this.data));
53
+ }
54
+ static fromJSON(data) {
55
+ const trace = new ExecutionTrace();
56
+ (0, data_1.assert)(data && [data.turns, data.runs, data.steps, data.tools, data.contributions].every(Array.isArray), "Invalid execution trace");
57
+ const identifiers = new Set();
58
+ for (const record of [...data.turns, ...data.runs, ...data.steps, ...data.tools]) {
59
+ (0, data_1.assert)(typeof record.id === "string" && !identifiers.has(record.id), "Duplicate execution identity");
60
+ identifiers.add(record.id);
61
+ }
62
+ const statuses = ["running", "completed", "interrupted", "failed"];
63
+ for (const turn of data.turns)
64
+ (0, data_1.assert)(Array.isArray(turn.inputMessageIds) && turn.inputMessageIds.every(key => typeof key === "string"), "Invalid turn inputs");
65
+ for (const run of data.runs) {
66
+ (0, data_1.assert)(statuses.includes(run.status) && ["chat", "run", "continue", "resume"].includes(run.kind), "Invalid run record");
67
+ (0, data_1.assert)(!run.turnId || data.turns.some(t => t.id === run.turnId), "Unknown turn reference");
68
+ (0, data_1.assert)(!run.resumedFrom || data.runs.some(r => r.id === run.resumedFrom && r.id !== run.id), "Unknown resumed run");
69
+ }
70
+ for (const step of data.steps) {
71
+ (0, data_1.assert)(statuses.includes(step.status) && Number.isSafeInteger(step.index) && step.index >= 0, "Invalid model step");
72
+ (0, data_1.assert)(data.runs.some(r => r.id === step.runId), "Unknown run reference");
73
+ if (step.usage)
74
+ (0, data_1.assert)([step.usage.inputTokens, step.usage.outputTokens, step.usage.totalTokens].every(value => Number.isFinite(value) && value >= 0), "Invalid token usage");
75
+ }
76
+ for (const tool of data.tools) {
77
+ (0, data_1.assert)(["awaitingApproval", "rejected", ...statuses].includes(tool.status) && typeof tool.toolCallId === "string" && typeof tool.name === "string" && tool.arguments && typeof tool.arguments === "object", "Invalid tool record");
78
+ (0, data_1.assert)(!tool.runId || data.runs.some(run => run.id === tool.runId), "Unknown tool run reference");
79
+ (0, data_1.assert)(!tool.stepId || data.steps.some(s => s.id === tool.stepId && (!tool.runId || s.runId === tool.runId)), "Unknown tool step reference");
80
+ }
81
+ for (const contribution of data.contributions) {
82
+ (0, data_1.assert)(typeof contribution.messageId === "string" && Number.isSafeInteger(contribution.revision) && contribution.revision >= 0 && ["create", "append", "replace"].includes(contribution.operation), "Invalid message contribution");
83
+ (0, data_1.assert)(data.steps.some(s => s.id === contribution.stepId && s.runId === contribution.runId), "Unknown contribution reference");
84
+ }
85
+ trace.data = (0, data_1.copy)(data);
86
+ return trace;
87
+ }
88
+ }
89
+ exports.ExecutionTrace = ExecutionTrace;
90
+ //# sourceMappingURL=trace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/session/trace.ts"],"names":[],"mappings":";;;AAAA,uCAA2D;AA0D3D,MAAa,cAAc;IACf,IAAI,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IAC3F,IAAI,OAAO;QACP,OAAO,IAAA,gBAAS,EAAC,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,MAAgB;QACjB,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,IAAA,SAAE,EAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACrG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,GAAG,CAAC,IAAuB,EAAE,MAAe,EAAE,eAAwB,EAAE,WAAoB;QACxF,MAAM,MAAM,GAAc,EAAE,EAAE,EAAE,IAAA,SAAE,EAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAChJ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,KAAa;QACd,MAAM,MAAM,GAAe,EAAE,EAAE,EAAE,IAAA,SAAE,EAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACtI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,SAAS,CAAC,KAAa,EAAE,KAAqC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;QACxD,IAAA,aAAM,EAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAA,WAAI,EAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,UAAU,CAAC,MAAc,EAAE,KAAsC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAC1D,IAAA,aAAM,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAA,WAAI,EAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,MAA2B;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,KAAK,GAAG,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC,CAAC;;YAEnC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,UAAU,CAAC,MAAoB;QAC3B,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,CAAC,SAAiB;QACpB,OAAO,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,CAAC,KAAc;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IACzU,CAAC;IACD,MAAM;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAc,CAAC;IAC9D,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,IAAe;QAC3B,MAAM,KAAK,GAAG,IAAI,cAAc,EAAE,CAAC;QACnC,IAAA,aAAM,EAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACpI,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/E,IAAA,aAAM,EAAC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,8BAA8B,CAAC,CAAC;YACrG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YACzB,IAAA,aAAM,EAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACrI,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;YACxH,IAAA,aAAM,EAAC,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,wBAAwB,CAAC,CAAC;YAC3F,IAAA,aAAM,EAAC,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACxH,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;YACpH,IAAA,aAAM,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC,CAAC;YAC1E,IAAI,IAAI,CAAC,KAAK;gBACV,IAAA,aAAM,EAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACtK,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAA,aAAM,EAAC,CAAC,kBAAkB,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,qBAAqB,CAAC,CAAC;YACnO,IAAA,aAAM,EAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,4BAA4B,CAAC,CAAC;YAClG,IAAA,aAAM,EAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAC;QACjJ,CAAC;QACD,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,IAAA,aAAM,EAAC,OAAO,YAAY,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,8BAA8B,CAAC,CAAC;YACpO,IAAA,aAAM,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,gCAAgC,CAAC,CAAC;QACnI,CAAC;QACD,KAAK,CAAC,IAAI,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AAnFD,wCAmFC"}
@@ -0,0 +1,76 @@
1
+ import { Message, MessageContent, MessageData, Role } from "../message";
2
+ import { ExecutionTrace, TraceData } from "./trace";
3
+ import type { SessionQuery } from "./SessionQuery";
4
+ import type { TreeStructure, ListStructure, AgentStructure } from "./structures";
5
+ export declare class SessionConflictError extends Error {
6
+ readonly code = "SESSION_CONFLICT";
7
+ constructor();
8
+ }
9
+ export type QueryScope = "active" | "all";
10
+ export type SessionQueries = Pick<SessionQuery, "messages" | "turns" | "runs" | "steps" | "toolExecutions">;
11
+ export interface MessageCriteria {
12
+ id?: string;
13
+ role?: Role;
14
+ tags?: readonly string[];
15
+ content?: string | RegExp;
16
+ partType?: MessageData["parts"][number]["type"];
17
+ metadata?: Record<string, unknown>;
18
+ turnId?: string;
19
+ runId?: string;
20
+ stepId?: string;
21
+ toolCallId?: string;
22
+ scope?: QueryScope;
23
+ offset?: number;
24
+ limit?: number;
25
+ predicate?: (message: Message) => boolean;
26
+ }
27
+ export interface SessionDataBase {
28
+ format: "agent-engine-session";
29
+ version: 3;
30
+ id: string;
31
+ title?: string;
32
+ metadata?: Record<string, unknown>;
33
+ systemMessageId: string;
34
+ messages: MessageData[];
35
+ trace: TraceData;
36
+ }
37
+ export interface TreeSessionData extends SessionDataBase {
38
+ type: "tree";
39
+ structure: TreeStructure;
40
+ }
41
+ export interface ListSessionData extends SessionDataBase {
42
+ type: "list";
43
+ structure: ListStructure;
44
+ }
45
+ export interface AgentSessionData extends SessionDataBase {
46
+ type: "agent";
47
+ structure: AgentStructure;
48
+ }
49
+ export type SessionData = TreeSessionData | ListSessionData | AgentSessionData;
50
+ export interface ContinuationCommitOptions {
51
+ draft?: Message;
52
+ baseline?: Message;
53
+ }
54
+ export interface SessionLike {
55
+ readonly id: string;
56
+ readonly type: SessionData["type"];
57
+ readonly trace: ExecutionTrace;
58
+ readonly query: SessionQueries;
59
+ readonly currentTurnId: string | undefined;
60
+ readonly isGenerating: boolean;
61
+ readonly metadata: Readonly<Record<string, unknown>>;
62
+ setMeta(key: string, value: unknown): this;
63
+ deleteMeta(key: string): this;
64
+ history(): Message[];
65
+ addMessage(message: Message): Message;
66
+ addUser(content: MessageContent): Message;
67
+ getMessage(id: string): Message | undefined;
68
+ editMessage(id: string, edit: (message: Message) => void): Message;
69
+ beginGeneration(): void;
70
+ assertGenerationUnchanged(): void;
71
+ appendGenerated(message: Message): Message;
72
+ appendContinuation(targetId: string, generated: Message, options?: ContinuationCommitOptions): Message;
73
+ endGeneration(): void;
74
+ toJSON(): SessionData;
75
+ }
76
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SessionConflictError = void 0;
4
+ class SessionConflictError extends Error {
5
+ code = "SESSION_CONFLICT";
6
+ constructor() {
7
+ super("The session changed while generation was in progress");
8
+ this.name = "SessionConflictError";
9
+ }
10
+ }
11
+ exports.SessionConflictError = SessionConflictError;
12
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":";;;AAIA,MAAa,oBAAqB,SAAQ,KAAK;IAClC,IAAI,GAAG,kBAAkB,CAAC;IACnC;QACI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAND,oDAMC"}
@@ -1,92 +1,29 @@
1
- import { Param } from "./Param";
2
- import { Hook } from "./Hook";
3
- import { Context } from "./Context";
4
- import { ToolCall } from "./ToolCall";
5
- /** 工具执行函数签名 */
6
- export type ToolFunction = (args: Record<string, unknown>, ctx: Context) => unknown | Promise<unknown>;
7
- /**钩子处理函数签名 */
8
- export type HookHandler = (ctx: Context) => void | Context;
9
- /** OpenAI tools 格式的 schema */
10
- export interface ToolSchema {
11
- type: "function";
12
- function: {
13
- name: string;
14
- description: string;
15
- parameters: {
16
- type: "object";
17
- properties: Record<string, unknown>;
18
- required: string[];
19
- };
20
- };
1
+ import type { ToolDefinition } from "../provider";
2
+ export interface ToolContext {
3
+ signal?: AbortSignal;
4
+ runId?: string;
5
+ stepId?: string;
6
+ toolExecutionId: string;
7
+ toolCallId: string;
8
+ throwIfAborted(): void;
21
9
  }
22
- /**
23
- * 工具定义 — Builder 模式
24
- *
25
- * build() 前: 构建阶段,链式配置
26
- * build() 后: 冻结状态,只能create() 调用实例
27
- *
28
- * 用法:
29
- * const weather = Tool.create(getWeatherFn)
30
- * .name("get_weather")
31
- * .description("获取天气")
32
- * .params(
33
- * Param.string("city").desc("城市名").required(),
34
- * Param.string("unit").desc("单位").enum(["celsius", "fahrenheit"]),
35
- * )
36
- * .on(Hook.ON_ERROR, (ctx) => { ctx.result = "暂不可用"; })
37
- * .build();
38
- */
39
- export declare class Tool {
40
- private _func;
41
- private _name;
42
- private _description;
43
- private _params;
44
- private _hooks;
45
- private _built;
46
- private _schema?;
47
- private constructor();
48
- /**
49
- * 创建工具 Builder
50
- * @param fn 工具执行函数,签名 (args: Record<string, unknown>) => unknown
51
- */
52
- static create(fn: ToolFunction): Tool;
53
- /**
54
- * 从已有的schema + 执行函数直接创建(用于 MCP 等外部工具)
55
- *跳过 Builder 阶段,直接进入 built 状态
56
- */
57
- static fromRaw(name: string, description: string, schema: ToolSchema, fn: ToolFunction): Tool;
58
- name(n: string): this;
59
- description(desc: string): this;
60
- /**
61
- * 批量添加参数
62
- */
63
- params(...params: Param[]): this;
64
- /**
65
- * 注册钩子,同一Hook 可注册多个handler,按注册顺序执行
66
- */
67
- on(hook: Hook, handler: HookHandler): this;
68
- /**
69
- * 冻结配置,生成 JSON Schema
70
- */
71
- build(): this;
72
- /** 获取 OpenAI tools 格式的 JSON Schema */
73
- get schema(): ToolSchema;
74
- /** 工具名*/
75
- get toolName(): string;
76
- /** 执行函数 */
77
- get func(): ToolFunction;
78
- /**
79
- * 从模版创建一次具体的函数调用
80
- *
81
- * @param toolCallId LLM 返回的 tool_call id
82
- * @param args 调用参数
83
- */
84
- create(toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): ToolCall;
85
- /**
86
- * 触发钩子链
87
- */
88
- fire(hook: Hook, ctx: Context): Context;
89
- private guardBuilt;
90
- private guardNotBuilt;
10
+ export interface ToolOptions<A extends Record<string, unknown> = Record<string, unknown>> extends ToolDefinition {
11
+ execute: (arguments_: A, context: ToolContext) => unknown | Promise<unknown>;
12
+ requiresApproval?: boolean;
13
+ }
14
+ export declare class Tool<A extends Record<string, unknown> = Record<string, unknown>> {
15
+ private validator;
16
+ private options;
17
+ constructor(options: ToolOptions<A>);
18
+ static define<A extends Record<string, unknown>>(options: ToolOptions<A>): Tool<A>;
19
+ get name(): string;
20
+ get requiresApproval(): boolean;
21
+ get definition(): ToolDefinition;
22
+ validate(arguments_: unknown): A;
23
+ execute(arguments_: A, context: ToolContext): unknown | Promise<unknown>;
24
+ }
25
+ export declare class ToolArgumentsError extends Error {
26
+ readonly code = "TOOL_ARGUMENTS";
27
+ constructor(message: string);
91
28
  }
92
29
  //# sourceMappingURL=Tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAe;AACf,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,OAAO,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,cAAc;AACd,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;AAE3D,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B,OAAO;IAcP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAIrC;;;OAGG;IACH,MAAM,CAAC,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,YAAY,GACf,IAAI;IAYP,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMrB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAMhC;;OAEG;IACH,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAM1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAmCb,sCAAsC;IACtC,IAAI,MAAM,IAAI,UAAU,CAGvB;IAED,SAAS;IACT,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,WAAW;IACX,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED;;;;;OAKG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,QAAQ;IAqCX;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO;IAevC,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,aAAa;CAKtB"}
1
+ {"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,IAAI,IAAI,CAAC;CAC1B;AACD,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,cAAc;IAC5G,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AACD,qBAAa,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,OAAO,CAAiB;gBACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAOnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAGlF,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IACD,IAAI,UAAU,IAAI,cAAc,CAE/B;IACD,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC;IAKhC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAG3E;AACD,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,oBAAoB;gBACrB,OAAO,EAAE,MAAM;CAI9B"}
package/dist/tool/Tool.js CHANGED
@@ -1,198 +1,51 @@
1
1
  "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
2
5
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.Tool = void 0;
4
- const Hook_1 = require("./Hook");
5
- const Context_1 = require("./Context");
6
- const ToolCall_1 = require("./ToolCall");
7
- /**
8
- * 工具定义 — Builder 模式
9
- *
10
- * build() 前: 构建阶段,链式配置
11
- * build() 后: 冻结状态,只能create() 调用实例
12
- *
13
- * 用法:
14
- * const weather = Tool.create(getWeatherFn)
15
- * .name("get_weather")
16
- * .description("获取天气")
17
- * .params(
18
- * Param.string("city").desc("城市名").required(),
19
- * Param.string("unit").desc("单位").enum(["celsius", "fahrenheit"]),
20
- * )
21
- * .on(Hook.ON_ERROR, (ctx) => { ctx.result = "暂不可用"; })
22
- * .build();
23
- */
6
+ exports.ToolArgumentsError = exports.Tool = void 0;
7
+ const data_1 = require("../core/data");
8
+ const ajv_1 = __importDefault(require("ajv"));
9
+ const _2020_1 = __importDefault(require("ajv/dist/2020"));
10
+ const ajv_formats_1 = __importDefault(require("ajv-formats"));
24
11
  class Tool {
25
- _func;
26
- _name;
27
- _description = "";
28
- _params = [];
29
- _hooks = new Map();
30
- _built = false;
31
- _schema;
32
- constructor(func, name) {
33
- this._func = func;
34
- this._name = name || func.name || "unnamed";
35
- // 初始化所有 Hook的handler 列表
36
- for (const hook of Object.values(Hook_1.Hook)) {
37
- this._hooks.set(hook, []);
38
- }
12
+ validator;
13
+ options;
14
+ constructor(options) {
15
+ (0, data_1.assert)(options.name.trim() && typeof options.execute === "function", "Invalid tool definition");
16
+ this.options = { ...options, parameters: (0, data_1.immutable)((0, data_1.copy)(options.parameters)) };
17
+ const compiler = String(options.parameters.$schema ?? "").includes("2020-12") ? new _2020_1.default({ allErrors: true }) : new ajv_1.default({ allErrors: true });
18
+ (0, ajv_formats_1.default)(compiler);
19
+ this.validator = compiler.compile((0, data_1.copy)(options.parameters));
39
20
  }
40
- // ========================
41
- // 静态工厂
42
- // ========================
43
- /**
44
- * 创建工具 Builder
45
- * @param fn 工具执行函数,签名 (args: Record<string, unknown>) => unknown
46
- */
47
- static create(fn) {
48
- return new Tool(fn);
21
+ static define(options) {
22
+ return new Tool(options);
49
23
  }
50
- /**
51
- * 从已有的schema + 执行函数直接创建(用于 MCP 等外部工具)
52
- *跳过 Builder 阶段,直接进入 built 状态
53
- */
54
- static fromRaw(name, description, schema, fn) {
55
- const tool = new Tool(fn, name);
56
- tool._description = description;
57
- tool._schema = schema;
58
- tool._built = true;
59
- return tool;
24
+ get name() {
25
+ return this.options.name;
60
26
  }
61
- // ========================
62
- // 链式配置(build前)
63
- // ========================
64
- name(n) {
65
- this.guardNotBuilt();
66
- this._name = n;
67
- return this;
27
+ get requiresApproval() {
28
+ return this.options.requiresApproval ?? false;
68
29
  }
69
- description(desc) {
70
- this.guardNotBuilt();
71
- this._description = desc;
72
- return this;
30
+ get definition() {
31
+ return (0, data_1.copy)({ name: this.name, description: this.options.description, parameters: this.options.parameters });
73
32
  }
74
- /**
75
- * 批量添加参数
76
- */
77
- params(...params) {
78
- this.guardNotBuilt();
79
- this._params.push(...params);
80
- return this;
33
+ validate(arguments_) {
34
+ if (!arguments_ || typeof arguments_ !== "object" || Array.isArray(arguments_) || !this.validator(arguments_))
35
+ throw new ToolArgumentsError(this.validator.errors?.map(error => `${error.instancePath || "/"} ${error.message}`).join("; ") || "Tool arguments must be an object");
36
+ return arguments_;
81
37
  }
82
- /**
83
- * 注册钩子,同一Hook 可注册多个handler,按注册顺序执行
84
- */
85
- on(hook, handler) {
86
- this.guardNotBuilt();
87
- this._hooks.get(hook).push(handler);
88
- return this;
89
- }
90
- /**
91
- * 冻结配置,生成 JSON Schema
92
- */
93
- build() {
94
- this.guardNotBuilt();
95
- // 组装 properties和 required
96
- const properties = {};
97
- const required = [];
98
- for (const param of this._params) {
99
- properties[param.name] = param.toSchema();
100
- if (param.isRequired) {
101
- required.push(param.name);
102
- }
103
- }
104
- this._schema = {
105
- type: "function",
106
- function: {
107
- name: this._name,
108
- description: this._description,
109
- parameters: {
110
- type: "object",
111
- properties,
112
- required,
113
- },
114
- },
115
- };
116
- this._built = true;
117
- return this;
118
- }
119
- // ========================
120
- // 运行时(build 后)
121
- // ========================
122
- /** 获取 OpenAI tools 格式的 JSON Schema */
123
- get schema() {
124
- this.guardBuilt();
125
- return this._schema;
126
- }
127
- /** 工具名*/
128
- get toolName() {
129
- return this._name;
130
- }
131
- /** 执行函数 */
132
- get func() {
133
- return this._func;
134
- }
135
- /**
136
- * 从模版创建一次具体的函数调用
137
- *
138
- * @param toolCallId LLM 返回的 tool_call id
139
- * @param args 调用参数
140
- */
141
- create(toolCallId, args, signal) {
142
- this.guardBuilt();
143
- const ctx = new Context_1.Context(toolCallId, this._name, { ...args }, signal);
144
- try {
145
- // ---- ON_CREATE ----
146
- this.fire(Hook_1.Hook.ON_CREATE, ctx);
147
- // ---- ON_VALIDATE ----
148
- this.fire(Hook_1.Hook.ON_VALIDATE, ctx);
149
- //内置校验:必填参数
150
- const requiredParams = this._params.filter((p) => p.isRequired);
151
- const missing = requiredParams
152
- .filter((p) => !(p.name in ctx.arguments))
153
- .map((p) => p.name);
154
- if (missing.length > 0) {
155
- throw new Error(`缺少必填参数: ${missing.join(", ")}`);
156
- }
157
- }
158
- catch (e) {
159
- const error = e instanceof Error ? e : new Error(String(e));
160
- ctx.error = error;
161
- // ---- ON_ERROR ----
162
- this.fire(Hook_1.Hook.ON_ERROR, ctx);
163
- // ON_ERROR 未提供降级结果则继续抛出
164
- if (ctx.result === undefined) {
165
- throw error;
166
- }
167
- }
168
- return new ToolCall_1.ToolCall(this, toolCallId, this._name, ctx.arguments, signal, ctx);
169
- }
170
- /**
171
- * 触发钩子链
172
- */
173
- fire(hook, ctx) {
174
- const handlers = this._hooks.get(hook) || [];
175
- for (const handler of handlers) {
176
- const result = handler(ctx);
177
- if (result instanceof Context_1.Context) {
178
- ctx = result;
179
- }
180
- }
181
- return ctx;
182
- }
183
- // ========================
184
- // 防护
185
- // ========================
186
- guardBuilt() {
187
- if (!this._built) {
188
- throw new Error("工具尚未构建,请先调用 build()");
189
- }
190
- }
191
- guardNotBuilt() {
192
- if (this._built) {
193
- throw new Error("工具已构建,无法修改");
194
- }
38
+ execute(arguments_, context) {
39
+ return this.options.execute(arguments_, context);
195
40
  }
196
41
  }
197
42
  exports.Tool = Tool;
43
+ class ToolArgumentsError extends Error {
44
+ code = "TOOL_ARGUMENTS";
45
+ constructor(message) {
46
+ super(message);
47
+ this.name = "ToolArgumentsError";
48
+ }
49
+ }
50
+ exports.ToolArgumentsError = ToolArgumentsError;
198
51
  //# sourceMappingURL=Tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAuD;AAEvD,8CAA4C;AAC5C,0DAAoC;AACpC,8DAAqC;AAarC,MAAa,IAAI;IACL,SAAS,CAAmB;IAC5B,OAAO,CAAiB;IAChC,YAAY,OAAuB;QAC/B,IAAA,aAAM,EAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAChG,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAA,gBAAS,EAAC,IAAA,WAAI,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,eAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChJ,IAAA,qBAAU,EAAC,QAAQ,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAA,WAAI,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,CAAC,MAAM,CAAoC,OAAuB;QACpE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAClD,CAAC;IACD,IAAI,UAAU;QACV,OAAO,IAAA,WAAI,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,QAAQ,CAAC,UAAmB;QACxB,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YACzG,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;QACxK,OAAO,UAAe,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,UAAa,EAAE,OAAoB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACJ;AA9BD,oBA8BC;AACD,MAAa,kBAAmB,SAAQ,KAAK;IAChC,IAAI,GAAG,gBAAgB,CAAC;IACjC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AAND,gDAMC"}