@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,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"}
@@ -1,208 +1,48 @@
1
1
  "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || (function () {
19
- var ownKeys = function(o) {
20
- ownKeys = Object.getOwnPropertyNames || function (o) {
21
- var ar = [];
22
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
- return ar;
24
- };
25
- return ownKeys(o);
26
- };
27
- return function (mod) {
28
- if (mod && mod.__esModule) return mod;
29
- var result = {};
30
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
- __setModuleDefault(result, mod);
32
- return result;
33
- };
34
- })();
35
2
  Object.defineProperty(exports, "__esModule", { value: true });
36
- exports.ToolKit = exports.ToolArgumentsError = exports.ToolExecutionError = void 0;
37
- const Message_1 = require("../message/Message");
38
- class ToolExecutionError extends Error {
39
- toolCallId;
40
- toolName;
41
- cause;
42
- constructor(toolCallId, toolName, cause) {
43
- const message = cause instanceof Error ? cause.message : String(cause);
44
- super(`工具执行失败 [${toolName}]: ${message}`);
45
- this.name = "ToolExecutionError";
46
- this.toolCallId = toolCallId;
47
- this.toolName = toolName;
48
- this.cause = cause;
49
- }
50
- }
51
- exports.ToolExecutionError = ToolExecutionError;
52
- class ToolArgumentsError extends Error {
53
- rawArguments;
54
- constructor(message, rawArguments) {
55
- super(message);
56
- this.name = "ToolArgumentsError";
57
- this.rawArguments = rawArguments;
58
- }
59
- }
60
- exports.ToolArgumentsError = ToolArgumentsError;
61
- /**
62
- * 工具包管理器
63
- *
64
- * 统一管理所有工具,作为 Message 系统与 Tool 系统之间的桥梁。
65
- *
66
- * 用法:
67
- *const toolkit = new ToolKit()
68
- * .add(weatherTool, timeTool);
69
- *
70
- * await toolkit.addMCP(mcpClient);// 自动发现 MCP 工具
71
- *
72
- * const tools = toolkit.schemas;// 丢给LLM
73
- * const results = await toolkit.executeAll(msg.toolCalls); // 批量执行
74
- */
3
+ exports.ToolKit = void 0;
4
+ const data_1 = require("../core/data");
5
+ const Tool_1 = require("./Tool");
75
6
  class ToolKit {
76
- _tools = new Map();
77
- // ========================
78
- // 注册工具
79
- // ========================
80
- /**
81
- * 添加一个或多个工具
82
- */
7
+ tools = new Map();
8
+ visible = new Set();
83
9
  add(...tools) {
84
10
  for (const tool of tools) {
85
- if (this._tools.has(tool.toolName)) {
86
- throw new Error(`工具名重复: ${tool.toolName}`);
87
- }
88
- this._tools.set(tool.toolName, tool);
89
- }
90
- return this;
91
- }
92
- /**
93
- * 从 MCP Client 自动发现并注册工具
94
- *
95
- * @param client @modelcontextprotocol/sdk的 Client 实例
96
- */
97
- async addMCP(client) {
98
- const { McpToolAdapter } = await Promise.resolve().then(() => __importStar(require("./McpToolAdapter")));
99
- const tools = await McpToolAdapter.fromClient(client);
100
- for (const tool of tools) {
101
- if (!this._tools.has(tool.toolName)) {
102
- this._tools.set(tool.toolName, tool);
103
- }
11
+ (0, data_1.assert)(!this.tools.has(tool.name), `Duplicate tool: ${tool.name}`);
12
+ this.tools.set(tool.name, tool);
13
+ this.visible.add(tool.name);
104
14
  }
105
15
  return this;
106
16
  }
107
- // ========================
108
- // 查询
109
- // ========================
110
- /** 按名称获取工具 */
111
17
  get(name) {
112
- return this._tools.get(name);
18
+ return this.tools.get(name);
113
19
  }
114
- /** 检查工具是否存在 */
115
- has(name) {
116
- return this._tools.has(name);
20
+ get size() {
21
+ return this.tools.size;
117
22
  }
118
- /** 所有工具的schema,直接传给LLM 的 tools参数 */
119
- get schemas() {
120
- return Array.from(this._tools.values()).map((t) => t.schema);
23
+ has(name) {
24
+ return this.tools.has(name);
121
25
  }
122
- /** 所有工具名*/
123
- get names() {
124
- return Array.from(this._tools.keys());
26
+ enable(name) {
27
+ (0, data_1.assert)(this.has(name), "Unknown tool");
28
+ this.visible.add(name);
29
+ return this;
125
30
  }
126
- /** 工具数量 */
127
- get size() {
128
- return this._tools.size;
31
+ disable(name) {
32
+ this.visible.delete(name);
33
+ return this;
129
34
  }
130
- // ========================
131
- // 执行 —桥接Message↔ Tool
132
- // ========================
133
- /**
134
- * 执行单个 ToolCallPart
135
- *
136
- * ToolCallPart(数据) → ToolCall(行为) → execute → Message(数据)
137
- */
138
- async execute(toolCallPart, options) {
139
- const tool = this._tools.get(toolCallPart.name);
140
- if (!tool) {
141
- const error = new Error(`未知工具: ${toolCallPart.name}`);
142
- if (options?.errorPolicy === "throw") {
143
- throw new ToolExecutionError(toolCallPart.toolCallId, toolCallPart.name, error);
144
- }
145
- return Message_1.Message.tool(toolCallPart.toolCallId, JSON.stringify({ error: error.message }), toolCallPart.name).setMeta("toolExecutionError", {
146
- message: error.message,
147
- code: "unknown_tool",
148
- });
149
- }
150
- let args;
151
- try {
152
- args = this.parseArguments(toolCallPart.arguments);
153
- }
154
- catch (e) {
155
- if (options?.errorPolicy === "throw") {
156
- throw new ToolExecutionError(toolCallPart.toolCallId, toolCallPart.name, e);
157
- }
158
- const errorMsg = e instanceof Error ? e.message : String(e);
159
- return Message_1.Message.tool(toolCallPart.toolCallId, JSON.stringify({ error: errorMsg, code: "invalid_tool_arguments" }), toolCallPart.name).setMeta("toolExecutionError", {
160
- message: errorMsg,
161
- code: "invalid_tool_arguments",
162
- });
163
- }
164
- try {
165
- const call = tool.create(toolCallPart.toolCallId, args, options?.signal);
166
- await call.execute();
167
- return call.toMessage();
168
- }
169
- catch (e) {
170
- if (options?.errorPolicy === "throw") {
171
- throw new ToolExecutionError(toolCallPart.toolCallId, toolCallPart.name, e);
172
- }
173
- // 执行失败,返回错误消息
174
- const errorMsg = e instanceof Error ? e.message : String(e);
175
- return Message_1.Message.tool(toolCallPart.toolCallId, JSON.stringify({ error: errorMsg }), toolCallPart.name).setMeta("toolExecutionError", {
176
- message: errorMsg,
177
- code: "tool_execution_error",
178
- });
179
- }
35
+ isEnabled(name) {
36
+ return this.visible.has(name);
180
37
  }
181
- /**
182
- * 并行执行多个 ToolCallPart
183
- */
184
- async executeAll(toolCallParts, options) {
185
- return Promise.all(toolCallParts.map((part) => this.execute(part, options)));
38
+ get definitions() {
39
+ return [...this.visible].map(name => this.tools.get(name).definition);
186
40
  }
187
- // ========================
188
- // 内部辅助
189
- // ========================
190
- parseArguments(args) {
191
- if (args.trim().length === 0) {
192
- return {};
193
- }
194
- let parsed;
195
- try {
196
- parsed = JSON.parse(args);
197
- }
198
- catch (e) {
199
- const detail = e instanceof Error ? e.message : String(e);
200
- throw new ToolArgumentsError(`工具参数不是合法 JSON: ${detail}`, args);
201
- }
202
- if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
203
- throw new ToolArgumentsError("工具参数必须是 JSON 对象", args);
204
- }
205
- return parsed;
41
+ async addMCP(client) {
42
+ const { tools } = await client.listTools();
43
+ for (const tool of tools)
44
+ this.add(new Tool_1.Tool({ name: tool.name, description: tool.description, parameters: tool.inputSchema, execute: (args, context) => client.callTool({ name: tool.name, arguments: args }, { signal: context.signal }) }));
45
+ return this;
206
46
  }
207
47
  }
208
48
  exports.ToolKit = ToolKit;
@@ -1 +1 @@
1
- {"version":3,"file":"ToolKit.js","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ToolKit.js","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AAEtC,iCAA8B;AAC9B,MAAa,OAAO;IACR,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IACrC,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,GAAG,CAAC,GAAG,KAAkB;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAA,aAAM,EAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,mBAAmB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,CAAC,IAAY;QACf,IAAA,aAAM,EAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,WAAW;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,MAAqB;QAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,WAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACxN,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAzCD,0BAyCC"}
@@ -1,9 +1,5 @@
1
- export { ValueType } from "./ValueType";
2
- export { Param } from "./Param";
3
- export { Hook } from "./Hook";
4
- export { Context } from "./Context";
5
- export { Tool, ToolFunction, HookHandler, ToolSchema } from "./Tool";
6
- export { ToolCall } from "./ToolCall";
7
- export { ToolKit, McpClientLike, ToolExecutionOptions, ToolErrorPolicy, ToolExecutionError, ToolArgumentsError, } from "./ToolKit";
8
- export { McpToolAdapter } from "./McpToolAdapter";
1
+ export * from './Tool';
2
+ export * from './ToolKit';
3
+ export * from './ToolExecutor';
4
+ export type { ToolDefinition } from "../provider";
9
5
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,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,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}