@notic/agent-engine 2.1.0 → 3.0.0

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 +56 -15
  2. package/README.md +97 -434
  3. package/dist/agent/Agent.d.ts +133 -355
  4. package/dist/agent/Agent.d.ts.map +1 -1
  5. package/dist/agent/Agent.js +302 -1123
  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 +37 -0
  16. package/dist/generator/Generator.d.ts.map +1 -0
  17. package/dist/generator/Generator.js +71 -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 -33
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +21 -92
  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 +16 -0
  229. package/dist/session/AgentSession.d.ts.map +1 -0
  230. package/dist/session/AgentSession.js +24 -0
  231. package/dist/session/AgentSession.js.map +1 -0
  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 +46 -0
  237. package/dist/session/ListSession.d.ts.map +1 -0
  238. package/dist/session/ListSession.js +205 -0
  239. package/dist/session/ListSession.js.map +1 -0
  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 -5
  253. package/dist/session/index.d.ts.map +1 -1
  254. package/dist/session/index.js +24 -12
  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 +248 -1698
  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 +37 -26
  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
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"}
@@ -0,0 +1,59 @@
1
+ import { Message, ToolCallPart } from "../message";
2
+ import type { ToolExecutionRecord } from "../session/trace";
3
+ import { ToolKit } from './ToolKit';
4
+ export declare class ToolExecutionError extends Error {
5
+ readonly record: ToolExecutionRecord;
6
+ readonly cause?: unknown | undefined;
7
+ readonly code = "TOOL_EXECUTION";
8
+ constructor(message: string, record: ToolExecutionRecord, cause?: unknown | undefined);
9
+ }
10
+ export interface ApprovalRequest {
11
+ approvalId: string;
12
+ toolExecutionId: string;
13
+ toolCallId: string;
14
+ name: string;
15
+ arguments: Record<string, unknown>;
16
+ runId?: string;
17
+ stepId?: string;
18
+ }
19
+ export type ApprovalDecision = "allow" | "deny" | "ask" | {
20
+ action: "allow" | "deny" | "ask";
21
+ reason?: string;
22
+ };
23
+ export interface ToolExecutorOptions {
24
+ toolkit: ToolKit;
25
+ approval?: "auto" | "manual" | ((request: ApprovalRequest) => ApprovalDecision | Promise<ApprovalDecision>);
26
+ approvalTimeoutMs?: number;
27
+ errorPolicy?: "return" | "throw";
28
+ }
29
+ export type ToolEvent = {
30
+ type: "approvalRequired";
31
+ request: ApprovalRequest;
32
+ } | {
33
+ type: "toolUpdated";
34
+ record: ToolExecutionRecord;
35
+ };
36
+ export interface ToolOutcome {
37
+ message: Message;
38
+ record: ToolExecutionRecord;
39
+ }
40
+ export declare class ToolExecutor {
41
+ private options;
42
+ readonly toolkit: ToolKit;
43
+ private events;
44
+ private pending;
45
+ constructor(options: ToolExecutorOptions);
46
+ on(type: ToolEvent["type"] | "*", handler: (event: ToolEvent) => unknown): () => void;
47
+ get pendingApprovals(): ApprovalRequest[];
48
+ approve(approvalId: string): boolean;
49
+ reject(approvalId: string, reason?: string): boolean;
50
+ execute(call: ToolCallPart, context?: {
51
+ signal?: AbortSignal;
52
+ runId?: string;
53
+ stepId?: string;
54
+ onRecord?: (record: ToolExecutionRecord) => void | Promise<void>;
55
+ errorPolicy?: "return" | "throw";
56
+ }): Promise<ToolOutcome>;
57
+ private wait;
58
+ }
59
+ //# sourceMappingURL=ToolExecutor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../src/tool/ToolExecutor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,qBAAa,kBAAmB,SAAQ,KAAK;IAEZ,QAAQ,CAAC,MAAM,EAAE,mBAAmB;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAD3F,QAAQ,CAAC,IAAI,oBAAoB;gBACrB,OAAO,EAAE,MAAM,EAAW,MAAM,EAAE,mBAAmB,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAI9F;AACD,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG;IACtD,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5G,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC;AACD,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;CAC5B,GAAG;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AACF,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AACD,qBAAa,YAAY;IAUT,OAAO,CAAC,OAAO;IAT3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAMV;gBACe,OAAO,EAAE,mBAAmB;IAGhD,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM,IAAI;IAGrF,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAExC;IACD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAOpC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAqB,GAAG,OAAO;IAO1D,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE;QACvC,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;KAC/B,GAAG,OAAO,CAAC,WAAW,CAAC;YAgEf,IAAI;CAuBrB"}
@@ -0,0 +1,128 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ToolExecutor = exports.ToolExecutionError = void 0;
4
+ const data_1 = require("../core/data");
5
+ const message_1 = require("../message");
6
+ const Tool_1 = require("./Tool");
7
+ class ToolExecutionError extends Error {
8
+ record;
9
+ cause;
10
+ code = "TOOL_EXECUTION";
11
+ constructor(message, record, cause) {
12
+ super(message);
13
+ this.record = record;
14
+ this.cause = cause;
15
+ this.name = "ToolExecutionError";
16
+ }
17
+ }
18
+ exports.ToolExecutionError = ToolExecutionError;
19
+ class ToolExecutor {
20
+ options;
21
+ toolkit;
22
+ events = new data_1.Events();
23
+ pending = new Map();
24
+ constructor(options) {
25
+ this.options = options;
26
+ this.toolkit = options.toolkit;
27
+ }
28
+ on(type, handler) {
29
+ return this.events.on(type, handler);
30
+ }
31
+ get pendingApprovals() {
32
+ return (0, data_1.copy)([...this.pending.values()].map(item => item.request));
33
+ }
34
+ approve(approvalId) {
35
+ const pending = this.pending.get(approvalId);
36
+ if (!pending)
37
+ return false;
38
+ pending.resolve({ approved: true });
39
+ return true;
40
+ }
41
+ reject(approvalId, reason = "Rejected by user") {
42
+ const pending = this.pending.get(approvalId);
43
+ if (!pending)
44
+ return false;
45
+ pending.resolve({ approved: false, reason });
46
+ return true;
47
+ }
48
+ async execute(call, context = {}) {
49
+ const record = { id: (0, data_1.id)("execution"), name: call.name, toolCallId: call.toolCallId, runId: context.runId, stepId: context.stepId, arguments: {}, status: "running" };
50
+ const update = async () => {
51
+ await context.onRecord?.((0, data_1.copy)(record));
52
+ await this.events.emit({ type: "toolUpdated", record: (0, data_1.copy)(record) });
53
+ };
54
+ try {
55
+ context.signal?.throwIfAborted();
56
+ const tool = this.toolkit.get(call.name);
57
+ (0, data_1.assert)(tool && this.toolkit.isEnabled(call.name), `Unavailable tool: ${call.name}`);
58
+ let args;
59
+ try {
60
+ args = call.arguments.trim() ? JSON.parse(call.arguments) : {};
61
+ }
62
+ catch {
63
+ throw new Tool_1.ToolArgumentsError("Tool arguments are not valid JSON");
64
+ }
65
+ const validated = tool.validate(args);
66
+ record.arguments = (0, data_1.copy)(validated);
67
+ const request = { approvalId: (0, data_1.id)("approval"), toolExecutionId: record.id, toolCallId: call.toolCallId, name: call.name, arguments: (0, data_1.copy)(validated), runId: context.runId, stepId: context.stepId };
68
+ const decision = typeof this.options.approval === "function" ? await (0, data_1.abortable)(Promise.resolve(this.options.approval(request)), context.signal) : this.options.approval === "manual" || tool.requiresApproval ? "ask" : "allow";
69
+ const action = typeof decision === "string" ? decision : decision.action;
70
+ let accepted = { approved: action === "allow", reason: typeof decision === "object" ? decision.reason : undefined };
71
+ if (action === "ask") {
72
+ record.status = "awaitingApproval";
73
+ await update();
74
+ accepted = await this.wait(request, context.signal);
75
+ }
76
+ if (!accepted.approved) {
77
+ record.status = "rejected";
78
+ record.error = accepted.reason ?? "Tool execution denied";
79
+ const message = message_1.Message.tool(call.toolCallId, { error: record.error, rejected: true }, call.name);
80
+ record.resultMessageId = message.id;
81
+ await update();
82
+ return { message, record: (0, data_1.copy)(record) };
83
+ }
84
+ context.signal?.throwIfAborted();
85
+ (0, data_1.assert)(this.toolkit.isEnabled(call.name), `Tool disabled before execution: ${call.name}`);
86
+ record.status = "running";
87
+ await update();
88
+ const toolContext = { signal: context.signal, runId: context.runId, stepId: context.stepId, toolExecutionId: record.id, toolCallId: call.toolCallId, throwIfAborted: () => context.signal?.throwIfAborted() };
89
+ const result = await (0, data_1.abortable)(Promise.resolve(tool.execute(validated, toolContext)), context.signal);
90
+ const message = message_1.Message.tool(call.toolCallId, result, call.name);
91
+ record.status = "completed";
92
+ record.resultMessageId = message.id;
93
+ await update();
94
+ return { message, record: (0, data_1.copy)(record) };
95
+ }
96
+ catch (error) {
97
+ record.status = context.signal?.aborted ? "interrupted" : "failed";
98
+ record.error = (0, data_1.errorOf)(error).message;
99
+ const message = message_1.Message.tool(call.toolCallId, { error: record.error, interrupted: record.status === "interrupted" }, call.name);
100
+ record.resultMessageId = message.id;
101
+ await update();
102
+ if (context.signal?.aborted)
103
+ throw new ToolExecutionError(record.error, (0, data_1.copy)(record), error);
104
+ if ((context.errorPolicy ?? this.options.errorPolicy) === "throw")
105
+ throw new ToolExecutionError(record.error, (0, data_1.copy)(record), error);
106
+ return { message, record: (0, data_1.copy)(record) };
107
+ }
108
+ }
109
+ async wait(request, signal) {
110
+ let timer;
111
+ const promise = new Promise(resolve => {
112
+ this.pending.set(request.approvalId, { request: (0, data_1.copy)(request), resolve });
113
+ if (this.options.approvalTimeoutMs !== undefined)
114
+ timer = setTimeout(() => resolve({ approved: false, reason: "Approval timed out" }), this.options.approvalTimeoutMs);
115
+ });
116
+ try {
117
+ await this.events.emit({ type: "approvalRequired", request: (0, data_1.copy)(request) });
118
+ return await (0, data_1.abortable)(promise, signal);
119
+ }
120
+ finally {
121
+ if (timer)
122
+ clearTimeout(timer);
123
+ this.pending.delete(request.approvalId);
124
+ }
125
+ }
126
+ }
127
+ exports.ToolExecutor = ToolExecutor;
128
+ //# sourceMappingURL=ToolExecutor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ToolExecutor.js","sourceRoot":"","sources":["../../src/tool/ToolExecutor.ts"],"names":[],"mappings":"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"}
@@ -1,75 +1,18 @@
1
- import { Tool, ToolSchema } from "./Tool";
2
- import { ToolCallPart } from "../message/MessagePart";
3
- import { Message } from "../message/Message";
4
- export type ToolErrorPolicy = "return_to_model" | "throw";
5
- export declare class ToolExecutionError extends Error {
6
- readonly toolCallId: string;
7
- readonly toolName: string;
8
- readonly cause?: unknown;
9
- constructor(toolCallId: string, toolName: string, cause: unknown);
10
- }
11
- export declare class ToolArgumentsError extends Error {
12
- readonly rawArguments: string;
13
- constructor(message: string, rawArguments: string);
14
- }
15
- export interface ToolExecutionOptions {
16
- /** 中断信号:传入 Tool Context,供工具内部响应取消 */
17
- signal?: AbortSignal;
18
- /** 工具错误策略:默认 return_to_model */
19
- errorPolicy?: ToolErrorPolicy;
20
- }
21
- /**
22
- * 工具包管理器
23
- *
24
- * 统一管理所有工具,作为 Message 系统与 Tool 系统之间的桥梁。
25
- *
26
- * 用法:
27
- *const toolkit = new ToolKit()
28
- * .add(weatherTool, timeTool);
29
- *
30
- * await toolkit.addMCP(mcpClient);// 自动发现 MCP 工具
31
- *
32
- * const tools = toolkit.schemas;// 丢给LLM
33
- * const results = await toolkit.executeAll(msg.toolCalls); // 批量执行
34
- */
1
+ import type { ToolDefinition } from "../provider";
2
+ import { Tool } from './Tool';
35
3
  export declare class ToolKit {
36
- private _tools;
37
- /**
38
- * 添加一个或多个工具
39
- */
40
- add(...tools: Tool[]): this;
41
- /**
42
- * 从 MCP Client 自动发现并注册工具
43
- *
44
- * @param client @modelcontextprotocol/sdk的 Client 实例
45
- */
46
- addMCP(client: McpClientLike): Promise<this>;
47
- /** 按名称获取工具 */
48
- get(name: string): Tool | undefined;
49
- /** 检查工具是否存在 */
50
- has(name: string): boolean;
51
- /** 所有工具的schema,直接传给LLM 的 tools参数 */
52
- get schemas(): ToolSchema[];
53
- /** 所有工具名*/
54
- get names(): string[];
55
- /** 工具数量 */
4
+ private tools;
5
+ private visible;
6
+ add(...tools: Tool<any>[]): this;
7
+ get(name: string): Tool<any> | undefined;
56
8
  get size(): number;
57
- /**
58
- * 执行单个 ToolCallPart
59
- *
60
- * ToolCallPart(数据) → ToolCall(行为) → execute → Message(数据)
61
- */
62
- execute(toolCallPart: ToolCallPart, options?: ToolExecutionOptions): Promise<Message>;
63
- /**
64
- * 并行执行多个 ToolCallPart
65
- */
66
- executeAll(toolCallParts: ToolCallPart[], options?: ToolExecutionOptions): Promise<Message[]>;
67
- private parseArguments;
9
+ has(name: string): boolean;
10
+ enable(name: string): this;
11
+ disable(name: string): this;
12
+ isEnabled(name: string): boolean;
13
+ get definitions(): ToolDefinition[];
14
+ addMCP(client: McpClientLike): Promise<this>;
68
15
  }
69
- /**
70
- * MCP Client最小接口
71
- *避免直接依赖 @modelcontextprotocol/sdk 的具体类型
72
- */
73
16
  export interface McpClientLike {
74
17
  listTools(): Promise<{
75
18
  tools: Array<{
@@ -78,14 +21,11 @@ export interface McpClientLike {
78
21
  inputSchema: Record<string, unknown>;
79
22
  }>;
80
23
  }>;
81
- callTool(params: {
24
+ callTool(input: {
82
25
  name: string;
83
- arguments?: Record<string, unknown>;
84
- }): Promise<{
85
- content: Array<{
86
- type: string;
87
- text?: string;
88
- }>;
89
- }>;
26
+ arguments: Record<string, unknown>;
27
+ }, options?: {
28
+ signal?: AbortSignal;
29
+ }): Promise<unknown>;
90
30
  }
91
31
  //# sourceMappingURL=ToolKit.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ToolKit.d.ts","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAE1D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAQjE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAKlD;AAED,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAgC;IAM9C;;OAEG;IACH,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAU3B;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD,cAAc;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,eAAe;IACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oCAAoC;IACpC,IAAI,OAAO,IAAI,UAAU,EAAE,CAE1B;IAED,WAAW;IACX,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,WAAW;IACX,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;;;OAIG;IACG,OAAO,CACX,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC;IA0DnB;;OAEG;IACG,UAAU,CACd,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;IAQrB,OAAO,CAAC,cAAc;CAmBvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACtC,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,CAAC,CAAC;CACJ"}
1
+ {"version":3,"file":"ToolKit.d.ts","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,qBAAa,OAAO;IAChB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAqB;IACpC,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAQhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;IAGxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAG1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAGhC,IAAI,WAAW,IAAI,cAAc,EAAE,CAElC;IACK,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrD;AACD,MAAM,WAAW,aAAa;IAC1B,SAAS,IAAI,OAAO,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC;YACT,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,CAAC,CAAC;KACN,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,EAAE,OAAO,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,WAAW,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxB"}