@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
@@ -1,445 +1,226 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.Message = void 0;
4
- const Role_1 = require("./Role");
5
- const Usage_1 = require("./Usage");
6
- /**
7
- * 统一消息模型
8
- *
9
- * 支持多模态内容(文本/图片/音频/文件/工具调用),
10
- * 树结构管理(parent/children),标签系统,token统计。
11
- * 通过链式 API 构建,通过 Adapter 序列化为各平台格式。
12
- */
3
+ exports.Message = exports.PROTOCOL_METADATA_KEYS = exports.Role = void 0;
4
+ const data_1 = require("../core/data");
5
+ var Role_1 = require("./Role");
6
+ Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return Role_1.Role; } });
7
+ const Role_2 = require("./Role");
8
+ /** Metadata consumed by the built-in wire codecs, rather than business state. */
9
+ exports.PROTOCOL_METADATA_KEYS = ["thinkingSignature", "geminiThinkingSignature", "openaiReasoningItems", "toolName", "name"];
10
+ /** An editable content object. It has no parents, children or session ownership. */
13
11
  class Message {
12
+ id;
14
13
  role;
15
- parts;
16
- metadata;
17
- // === 模型 & 用量 ===
18
- model;
19
- usage;
20
- // === 标签系统 ===
21
- tags = new Set();
22
- // === 树结构 ===
23
- parent;
24
- children = [];
25
- // === Getter 缓存(懒计算,parts 变更时通过 addX 方法失效;
26
- // 如直接 push parts,请手动调用 invalidateCache()) ===
27
- _textCache;
28
- _thinkingCache;
29
- _toolCallsCache;
30
- _hasMediaCache;
31
- _hasThinkingCache;
32
- constructor(role, parts = [], metadata = {}) {
14
+ version;
15
+ requestVersion;
16
+ requestKeys;
17
+ content;
18
+ meta;
19
+ labels;
20
+ observers = new Set();
21
+ constructor(role, content = "", metadata = {}, identity) {
22
+ (0, data_1.assert)(Object.values(Role_2.Role).includes(role), "Invalid message role");
23
+ this.id = identity?.id ?? (0, data_1.id)("msg");
24
+ this.version = identity?.revision ?? 0;
25
+ this.requestVersion = identity?.requestRevision ?? this.version;
26
+ (0, data_1.assert)(Number.isSafeInteger(this.requestVersion) && this.requestVersion >= 0 && this.requestVersion <= this.version, "Invalid request revision");
27
+ (0, data_1.assert)((identity?.requestMetadataKeys ?? []).every(key => typeof key === "string"), "Invalid request metadata keys");
28
+ this.requestKeys = new Set([...exports.PROTOCOL_METADATA_KEYS, ...identity?.requestMetadataKeys ?? []]);
29
+ (0, data_1.assert)(typeof this.id === "string" && this.id && Number.isSafeInteger(this.version) && this.version >= 0, "Invalid message identity");
30
+ (0, data_1.assert)(metadata && typeof metadata === "object" && !Array.isArray(metadata), "Invalid message metadata");
31
+ (0, data_1.assertJson)(metadata);
32
+ (0, data_1.assert)((identity?.tags ?? []).every(tag => typeof tag === "string"), "Invalid message tags");
33
33
  this.role = role;
34
- this.parts = parts;
35
- this.metadata = metadata;
36
- }
37
- // ========================
38
- // 静态工厂方法
39
- // ========================
40
- /**
41
- * 创建 User 消息
42
- * @param content 字符串、单个Part、或Part数组
43
- */
34
+ this.content = this.normalize(content);
35
+ this.meta = (0, data_1.immutable)((0, data_1.copy)(metadata));
36
+ this.labels = (0, data_1.immutable)([...new Set(identity?.tags ?? [])]);
37
+ }
44
38
  static user(content) {
45
- return new Message(Role_1.Role.User, Message.normalizeParts(content));
46
- }
47
- /**
48
- * 创建 Assistant 消息
49
- */
50
- static assistant(content) {
51
- return new Message(Role_1.Role.Assistant, Message.normalizeParts(content));
52
- }
53
- /**
54
- * 创建 System 消息
55
- */
56
- static system(content) {
57
- return new Message(Role_1.Role.System, [{ type: "text", text: content }]);
58
- }
59
- /**
60
- * 创建空System 消息(用作树的永恒根节点)
61
- */
62
- static emptySystem() {
63
- return new Message(Role_1.Role.System, []);
64
- }
65
- /**
66
- * 创建 Tool Result 消息
67
- */
39
+ return new Message(Role_2.Role.User, content);
40
+ }
41
+ static assistant(content = "") {
42
+ return new Message(Role_2.Role.Assistant, content);
43
+ }
44
+ static system(content = "") {
45
+ return new Message(Role_2.Role.System, content);
46
+ }
68
47
  static tool(toolCallId, result, name) {
69
- return new Message(Role_1.Role.Tool, [
70
- { type: "tool_result", toolCallId, result, ...(name ? { name } : {}) },
71
- ], name ? { toolName: name } : {});
72
- }
73
- /**
74
- * 创建 Assistant 发起的工具调用消息
75
- */
76
- static assistantToolCalls(toolCalls) {
77
- const parts = toolCalls.map((tc) => ({
78
- type: "tool_call",
79
- toolCallId: tc.id,
80
- name: tc.name,
81
- arguments: tc.arguments,
82
- }));
83
- return new Message(Role_1.Role.Assistant, parts);
84
- }
85
- // ========================
86
- // 链式构建方法
87
- // ========================
88
- addText(text) {
89
- this.parts.push({ type: "text", text });
90
- return this.invalidateCache();
48
+ return new Message(Role_2.Role.Tool, [{ type: "tool_result", toolCallId, name, result: typeof result === "string" ? result : JSON.stringify(result ?? null) }]);
91
49
  }
92
- addImage(url, mimeType) {
93
- const part = { type: "image", url };
94
- if (mimeType)
95
- part.mimeType = mimeType;
96
- this.parts.push(part);
97
- return this.invalidateCache();
50
+ get revision() {
51
+ return this.version;
52
+ }
53
+ get requestRevision() { return this.requestVersion; }
54
+ get requestMetadataKeys() { return (0, data_1.immutable)([...this.requestKeys]); }
55
+ get parts() {
56
+ return this.content;
57
+ }
58
+ get metadata() {
59
+ return this.meta;
60
+ }
61
+ get tags() {
62
+ return this.labels;
63
+ }
64
+ get text() {
65
+ return this.content.map(p => p.type === "text" ? p.text : p.type === "tool_result" ? p.result : "").join("");
66
+ }
67
+ get thinking() {
68
+ return this.content.filter(p => p.type === "thinking").map(p => p.text).join("");
69
+ }
70
+ get toolCalls() {
71
+ return this.content.filter(p => p.type === "tool_call");
72
+ }
73
+ get isEmpty() {
74
+ return !this.content.some(p => p.type === "text" || p.type === "thinking" ? p.text.trim() : true);
75
+ }
76
+ get hasMedia() {
77
+ return this.content.some(p => ["image", "audio", "video", "file"].includes(p.type));
78
+ }
79
+ onChange(handler) {
80
+ this.observers.add(handler);
81
+ return () => this.observers.delete(handler);
98
82
  }
99
- addAudio(url, mimeType) {
100
- const part = { type: "audio", url };
101
- if (mimeType)
102
- part.mimeType = mimeType;
103
- this.parts.push(part);
104
- return this.invalidateCache();
105
- }
106
- addFile(url, options) {
107
- const part = { type: "file", url };
108
- if (options?.mimeType)
109
- part.mimeType = options.mimeType;
110
- if (options?.fileName)
111
- part.fileName = options.fileName;
112
- this.parts.push(part);
113
- return this.invalidateCache();
114
- }
115
- /** 替换消息的全部内容,并自动失效 getter 缓存。 */
116
83
  setParts(content) {
117
- const parts = Message.normalizeParts(content);
118
- this.parts.splice(0, this.parts.length, ...parts);
119
- return this.invalidateCache();
120
- }
121
- /**
122
- * 替换消息中的全部文本,同时保留 thinking、媒体和工具调用等非文本 part。
123
- * 多个 TextPart 会合并为一个;空字符串会移除全部 TextPart。
124
- */
125
- setText(text) {
126
- const firstTextIndex = this.parts.findIndex((part) => part.type === "text");
127
- if (firstTextIndex === -1) {
128
- if (text)
129
- this.parts.push({ type: "text", text });
130
- return this.invalidateCache();
131
- }
132
- const nextParts = [];
84
+ this.content = this.normalize(content);
85
+ return this.changed(true);
86
+ }
87
+ /** Validate and apply a staged update atomically, preserving this object's identity. */
88
+ update(update) {
89
+ const parts = update.parts === undefined ? this.content : this.normalize(update.parts);
90
+ const metadata = update.metadata ?? this.meta;
91
+ (0, data_1.assert)(metadata && typeof metadata === "object" && !Array.isArray(metadata), "Invalid message metadata");
92
+ (0, data_1.assertJson)(metadata);
93
+ const tags = update.tags ?? this.labels;
94
+ (0, data_1.assert)(tags.every(tag => typeof tag === "string"), "Invalid message tags");
95
+ const keys = new Set([...this.requestKeys, ...update.requestMetadataKeys ?? []]);
96
+ (0, data_1.assert)([...keys].every(key => typeof key === "string"), "Invalid request metadata keys");
97
+ const affectsRequest = update.parts !== undefined || [...keys].some(key => JSON.stringify(this.meta[key]) !== JSON.stringify(metadata[key]));
98
+ const nextMeta = (0, data_1.immutable)((0, data_1.copy)(metadata));
99
+ const nextTags = (0, data_1.immutable)([...new Set(tags)]);
100
+ this.content = parts;
101
+ this.meta = nextMeta;
102
+ this.labels = nextTags;
103
+ this.requestKeys = keys;
104
+ return this.changed(affectsRequest);
105
+ }
106
+ replaceText(type, text) {
107
+ const next = [];
133
108
  let inserted = false;
134
- for (const part of this.parts) {
135
- if (part.type !== "text") {
136
- nextParts.push(part);
137
- continue;
138
- }
139
- if (!inserted && text) {
140
- nextParts.push({ type: "text", text });
109
+ for (const part of this.content) {
110
+ if (part.type === type) {
111
+ if (!inserted && text)
112
+ next.push({ type, text, id: part.id });
141
113
  inserted = true;
142
114
  }
115
+ else
116
+ next.push(part);
143
117
  }
144
- this.parts.splice(0, this.parts.length, ...nextParts);
145
- return this.invalidateCache();
118
+ if (!inserted && text)
119
+ next.push({ type, text });
120
+ return this.setParts(next);
146
121
  }
147
- setMeta(key, value) {
148
- this.metadata[key] = value;
149
- return this;
122
+ setText(text) {
123
+ return this.replaceText("text", text);
150
124
  }
151
- // ========================
152
- // 标签系统
153
- // ========================
154
- /** 添加标签(链式) */
155
- tag(...tagNames) {
156
- for (const t of tagNames) {
157
- this.tags.add(t);
158
- }
159
- return this;
125
+ setThinking(text) {
126
+ return this.replaceText("thinking", text);
160
127
  }
161
- /** 移除标签(链式) */
162
- untag(...tagNames) {
163
- for (const t of tagNames) {
164
- this.tags.delete(t);
165
- }
166
- return this;
128
+ appendText(text) {
129
+ return this.addPart({ type: "text", text });
167
130
  }
168
- /** 是否有某标签 */
169
- hasTag(tagName) {
170
- return this.tags.has(tagName);
171
- }
172
- // ========================
173
- // 树结构操作
174
- // ========================
175
- /**
176
- * 追加子节点,设置 parent 关系,返回 child
177
- */
178
- append(child) {
179
- if (child === this) {
180
- throw new Error("消息不能追加到自身");
181
- }
182
- let ancestor = this;
183
- while (ancestor) {
184
- if (ancestor === child) {
185
- throw new Error("不能将祖先消息追加为子节点");
186
- }
187
- ancestor = ancestor.parent;
188
- }
189
- if (child.parent === this && this.children.includes(child)) {
190
- return child;
191
- }
192
- if (child.parent) {
193
- const previousParent = child.parent;
194
- const previousIndex = previousParent.children.indexOf(child);
195
- if (previousIndex !== -1) {
196
- previousParent.children.splice(previousIndex, 1);
197
- }
198
- }
199
- child.parent = this;
200
- this.children.push(child);
201
- return child;
202
- }
203
- /**
204
- * 删除自身节点
205
- *
206
- * @param mode
207
- * - "prune": 剪枝 — 删除自身及所有后代
208
- * - "graft": 嫁接 — 删除自身,子节点继承父节点
209
- *
210
- * 根节点不可删除,尝试删除会抛异常
211
- */
212
- remove(mode) {
213
- if (this.isRoot) {
214
- throw new Error("根节点不可删除");
215
- }
216
- const parent = this.parent;
217
- const index = parent.children.indexOf(this);
218
- if (index === -1)
219
- return;
220
- if (mode === "prune") {
221
- // 剪枝:从父节点移除自身(含所有后代)
222
- parent.children.splice(index, 1);
223
- this.parent = undefined;
224
- }
225
- else {
226
- // 嫁接:子节点继承父节点
227
- const children = [...this.children];
228
- for (const child of children) {
229
- child.parent = parent;
230
- }
231
- parent.children.splice(index, 1, ...children);
232
- this.children.length = 0;
233
- this.parent = undefined;
234
- }
131
+ appendThinking(text) {
132
+ return this.addPart({ type: "thinking", text });
235
133
  }
236
- /**溯源到根节点 */
237
- get root() {
238
- // eslint-disable-next-line @typescript-eslint/no-this-alias
239
- let node = this;
240
- while (node.parent) {
241
- node = node.parent;
242
- }
243
- return node;
244
- }
245
- /** 在树中的深度(根节点为 0) */
246
- get depth() {
247
- let d = 0;
248
- // eslint-disable-next-line @typescript-eslint/no-this-alias
249
- let node = this;
250
- while (node.parent) {
251
- d++;
252
- node = node.parent;
253
- }
254
- return d;
255
- }
256
- /** 是否根节点(没有 parent) */
257
- get isRoot() {
258
- return !this.parent;
259
- }
260
- /** 是否叶子节点 */
261
- get isLeaf() {
262
- return this.children.length === 0;
263
- }
264
- /** 最后一个子节点 */
265
- get lastChild() {
266
- return this.children.length > 0
267
- ? this.children[this.children.length - 1]
268
- : undefined;
269
- }
270
- /**
271
- * 从根节点到当前节点的完整路径
272
- *
273
- * @param includeRoot 是否包含根节点,默认 true。
274
- */
275
- getHistory(includeRoot = true) {
276
- const path = [];
277
- // eslint-disable-next-line @typescript-eslint/no-this-alias
278
- let node = this;
279
- while (node) {
280
- path.unshift(node);
281
- node = node.parent;
282
- }
283
- if (!includeRoot && path.length > 0 && path[0].isRoot) {
284
- path.shift();
285
- }
286
- return path;
134
+ addPart(part) {
135
+ return this.setParts([...this.content, part]);
287
136
  }
288
- // ========================
289
- // 便捷 Getter(带懒缓存)
290
- // ========================
291
- /** 获取消息的文本内容(拼接所有 TextPart + ToolResultPart) */
292
- get text() {
293
- if (this._textCache !== undefined)
294
- return this._textCache;
295
- let result = "";
296
- for (const p of this.parts) {
297
- if (p.type === "text")
298
- result += p.text;
299
- else if (p.type === "tool_result")
300
- result += p.result;
301
- }
302
- this._textCache = result;
303
- return result;
137
+ replacePart(partId, replacement) {
138
+ (0, data_1.assert)(this.content.some(p => p.id === partId), "Unknown content part");
139
+ return this.setParts(this.content.map(p => p.id === partId ? { ...replacement, id: partId } : p));
304
140
  }
305
- /** 获取所有 ToolCallPart */
306
- get toolCalls() {
307
- if (this._toolCallsCache !== undefined)
308
- return this._toolCallsCache;
309
- const result = [];
310
- for (const p of this.parts) {
311
- if (p.type === "tool_call")
312
- result.push(p);
313
- }
314
- this._toolCallsCache = result;
315
- return result;
141
+ removePart(partId) {
142
+ (0, data_1.assert)(this.content.some(p => p.id === partId), "Unknown content part");
143
+ return this.setParts(this.content.filter(p => p.id !== partId));
316
144
  }
317
- /** 获取思考/推理内容(拼接所有 ThinkingPart) */
318
- get thinking() {
319
- if (this._thinkingCache !== undefined)
320
- return this._thinkingCache;
321
- let result = "";
322
- for (const p of this.parts) {
323
- if (p.type === "thinking")
324
- result += p.text;
325
- }
326
- this._thinkingCache = result;
327
- return result;
145
+ addImage(url, mimeType) {
146
+ return this.addPart({ type: "image", url, mimeType });
328
147
  }
329
- /** 是否包含思考内容 */
330
- get hasThinking() {
331
- if (this._hasThinkingCache !== undefined)
332
- return this._hasThinkingCache;
333
- this._hasThinkingCache = this.parts.some((p) => p.type === "thinking");
334
- return this._hasThinkingCache;
148
+ addAudio(url, mimeType) {
149
+ return this.addPart({ type: "audio", url, mimeType });
335
150
  }
336
- /** 是否包含媒体内容(图片/音频/文件) */
337
- get hasMedia() {
338
- if (this._hasMediaCache !== undefined)
339
- return this._hasMediaCache;
340
- this._hasMediaCache = this.parts.some((p) => p.type === "image" || p.type === "audio" || p.type === "file");
341
- return this._hasMediaCache;
342
- }
343
- /**
344
- * 是否为空消息。
345
- *
346
- * 只包含空 text/thinking part 或没有 parts 的消息视为空;
347
- * 媒体、工具调用和工具结果即使文本载荷为空,也保留为有效消息。
348
- */
349
- get isEmpty() {
350
- return !this.parts.some((part) => {
351
- if (part.type === "text" || part.type === "thinking") {
352
- return part.text.length > 0;
353
- }
354
- return true;
355
- });
356
- }
357
- /** 返回移除空消息后的新数组,不修改原数组。 */
358
- static pruneEmpty(messages) {
359
- return messages.filter((message) => !message.isEmpty);
360
- }
361
- /**
362
- * 手动失效所有 getter 缓存。
363
- *
364
- * 当通过 addText/addImage/... 等内置方法修改时,缓存会自动失效;
365
- * 但如果直接对 parts 数组进行 push/splice 等操作,请调用此方法。
366
- */
367
- invalidateCache() {
368
- this._textCache = undefined;
369
- this._thinkingCache = undefined;
370
- this._toolCallsCache = undefined;
371
- this._hasMediaCache = undefined;
372
- this._hasThinkingCache = undefined;
373
- return this;
151
+ addVideo(url, mimeType) {
152
+ return this.addPart({ type: "video", url, mimeType });
153
+ }
154
+ addFile(url, options = {}) {
155
+ return this.addPart({ type: "file", url, ...options });
156
+ }
157
+ setMeta(key, value, options = {}) {
158
+ (0, data_1.assertJson)(value);
159
+ this.meta = (0, data_1.immutable)((0, data_1.copy)({ ...this.meta, [key]: value }));
160
+ if (options.affectsRequest)
161
+ this.requestKeys.add(key);
162
+ return this.changed(this.requestKeys.has(key));
163
+ }
164
+ deleteMeta(key, options = {}) {
165
+ const next = { ...this.meta };
166
+ delete next[key];
167
+ this.meta = (0, data_1.immutable)(next);
168
+ if (options.affectsRequest)
169
+ this.requestKeys.add(key);
170
+ return this.changed(this.requestKeys.has(key));
171
+ }
172
+ tag(...tags) {
173
+ this.labels = (0, data_1.immutable)([...new Set([...this.labels, ...tags])]);
174
+ return this.changed();
175
+ }
176
+ untag(...tags) {
177
+ this.labels = (0, data_1.immutable)(this.labels.filter(tag => !tags.includes(tag)));
178
+ return this.changed();
179
+ }
180
+ hasTag(tag) {
181
+ return this.labels.includes(tag);
182
+ }
183
+ /** Detached request snapshot preserves source identity, while clone creates new identity. */
184
+ snapshot() {
185
+ return Message.fromJSON(this.toJSON());
186
+ }
187
+ clone() {
188
+ return new Message(this.role, this.content, this.meta, { id: (0, data_1.id)("msg"), tags: this.labels, requestMetadataKeys: [...this.requestKeys] });
374
189
  }
375
- // ========================
376
- // 内部辅助
377
- // ========================
378
- static normalizeParts(content) {
379
- if (typeof content === "string") {
380
- return [{ type: "text", text: content }];
381
- }
382
- if (Array.isArray(content)) {
383
- return content;
384
- }
385
- return [content];
386
- }
387
- //========================
388
- // 序列化 / 反序列化
389
- // ========================
390
- /**
391
- * 序列化为 JSON 安全对象(含子树)
392
- *
393
- * 递归序列化所有 children,避免 parent 循环引用。
394
- * 反序列化时通过 fromJSON 自动重建 parent 关系。
395
- */
396
190
  toJSON() {
397
- const data = {
398
- role: this.role,
399
- parts: this.parts,
400
- metadata: this.metadata,
401
- tags: Array.from(this.tags),
402
- };
403
- if (this.model)
404
- data.model = this.model;
405
- if (this.usage)
406
- data.usage = this.usage.toJSON();
407
- if (this.children.length > 0) {
408
- data.children = this.children.map((c) => c.toJSON());
409
- }
410
- return data;
191
+ return (0, data_1.copy)({ id: this.id, revision: this.version, requestRevision: this.requestVersion, requestMetadataKeys: [...this.requestKeys], role: this.role, parts: this.content, metadata: this.meta, tags: this.labels });
411
192
  }
412
- /**
413
- * 从 JSON 对象反序列化(含子树)
414
- *
415
- * 自动重建 parent/children 树结构关系。
416
- */
417
193
  static fromJSON(data) {
418
- const role = data.role;
419
- const parts = data.parts || [];
420
- const metadata = data.metadata || {};
421
- const msg = new Message(role, parts, metadata);
422
- // 恢复标签
423
- const tags = data.tags;
424
- if (tags) {
425
- for (const t of tags) {
426
- msg.tags.add(t);
427
- }
428
- }
429
- // 恢复 model & usage
430
- if (data.model)
431
- msg.model = data.model;
432
- if (data.usage)
433
- msg.usage = Usage_1.Usage.fromJSON(data.usage);
434
- // 递归恢复子节点
435
- const childrenData = data.children;
436
- if (childrenData) {
437
- for (const childData of childrenData) {
438
- const child = Message.fromJSON(childData);
439
- msg.append(child);
440
- }
441
- }
442
- return msg;
194
+ (0, data_1.assert)(data && typeof data.id === "string" && Number.isSafeInteger(data.revision) && data.metadata && Array.isArray(data.parts) && Array.isArray(data.tags) && data.tags.every(t => typeof t === "string"), "Invalid message data");
195
+ return new Message(data.role, data.parts, data.metadata, data);
196
+ }
197
+ normalize(content) {
198
+ const parts = typeof content === "string" ? (content ? [{ type: "text", text: content }] : []) : (0, data_1.copy)([...content]);
199
+ const ids = new Set();
200
+ for (const part of parts) {
201
+ (0, data_1.assert)(part && ["text", "thinking", "image", "audio", "video", "file", "tool_call", "tool_result"].includes(part.type), "Invalid message part");
202
+ if (part.type === "text" || part.type === "thinking")
203
+ (0, data_1.assert)(typeof part.text === "string", "Invalid text part");
204
+ else if (part.type === "tool_call")
205
+ (0, data_1.assert)(typeof part.toolCallId === "string" && typeof part.name === "string" && typeof part.arguments === "string", "Invalid tool call");
206
+ else if (part.type === "tool_result")
207
+ (0, data_1.assert)(typeof part.toolCallId === "string" && typeof part.result === "string", "Invalid tool result");
208
+ else
209
+ (0, data_1.assert)(typeof part.url === "string", "Invalid media part");
210
+ (0, data_1.assertJson)(part);
211
+ part.id ??= (0, data_1.id)("part");
212
+ (0, data_1.assert)(typeof part.id === "string" && part.id && !ids.has(part.id), "Invalid or duplicate part identity");
213
+ ids.add(part.id);
214
+ }
215
+ return (0, data_1.immutable)(parts);
216
+ }
217
+ changed(affectsRequest = false) {
218
+ this.version++;
219
+ if (affectsRequest)
220
+ this.requestVersion++;
221
+ for (const observer of [...this.observers])
222
+ observer({ message: this, revision: this.version });
223
+ return this;
443
224
  }
444
225
  }
445
226
  exports.Message = Message;