@strands-agents/sdk 1.0.0-rc.5 → 1.1.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 (380) hide show
  1. package/LICENSE +175 -0
  2. package/README.md +340 -0
  3. package/dist/src/__fixtures__/agent-helpers.d.ts +22 -1
  4. package/dist/src/__fixtures__/agent-helpers.d.ts.map +1 -1
  5. package/dist/src/__fixtures__/agent-helpers.js +45 -1
  6. package/dist/src/__fixtures__/agent-helpers.js.map +1 -1
  7. package/dist/src/__fixtures__/mock-plugin.d.ts.map +1 -1
  8. package/dist/src/__fixtures__/mock-plugin.js +3 -1
  9. package/dist/src/__fixtures__/mock-plugin.js.map +1 -1
  10. package/dist/src/__fixtures__/tool-helpers.d.ts +5 -2
  11. package/dist/src/__fixtures__/tool-helpers.d.ts.map +1 -1
  12. package/dist/src/__fixtures__/tool-helpers.js +23 -4
  13. package/dist/src/__fixtures__/tool-helpers.js.map +1 -1
  14. package/dist/src/__tests__/interrupt.test.d.ts +2 -0
  15. package/dist/src/__tests__/interrupt.test.d.ts.map +1 -0
  16. package/dist/src/__tests__/interrupt.test.js +259 -0
  17. package/dist/src/__tests__/interrupt.test.js.map +1 -0
  18. package/dist/src/__tests__/mcp.test.js +448 -2
  19. package/dist/src/__tests__/mcp.test.js.map +1 -1
  20. package/dist/src/a2a/__tests__/events.test.js +2 -0
  21. package/dist/src/a2a/__tests__/events.test.js.map +1 -1
  22. package/dist/src/a2a/__tests__/executor.test.js +16 -5
  23. package/dist/src/a2a/__tests__/executor.test.js.map +1 -1
  24. package/dist/src/a2a/a2a-agent.d.ts +8 -3
  25. package/dist/src/a2a/a2a-agent.d.ts.map +1 -1
  26. package/dist/src/a2a/a2a-agent.js +12 -6
  27. package/dist/src/a2a/a2a-agent.js.map +1 -1
  28. package/dist/src/a2a/executor.d.ts +13 -0
  29. package/dist/src/a2a/executor.d.ts.map +1 -1
  30. package/dist/src/a2a/executor.js +19 -1
  31. package/dist/src/a2a/executor.js.map +1 -1
  32. package/dist/src/agent/__tests__/agent-as-tool.invocation-state.test.d.ts +2 -0
  33. package/dist/src/agent/__tests__/agent-as-tool.invocation-state.test.d.ts.map +1 -0
  34. package/dist/src/agent/__tests__/agent-as-tool.invocation-state.test.js +23 -0
  35. package/dist/src/agent/__tests__/agent-as-tool.invocation-state.test.js.map +1 -0
  36. package/dist/src/agent/__tests__/agent.cancel.test.js +1 -1
  37. package/dist/src/agent/__tests__/agent.cancel.test.js.map +1 -1
  38. package/dist/src/agent/__tests__/agent.concurrent.test.d.ts +2 -0
  39. package/dist/src/agent/__tests__/agent.concurrent.test.d.ts.map +1 -0
  40. package/dist/src/agent/__tests__/agent.concurrent.test.js +488 -0
  41. package/dist/src/agent/__tests__/agent.concurrent.test.js.map +1 -0
  42. package/dist/src/agent/__tests__/agent.hook.test.js +724 -12
  43. package/dist/src/agent/__tests__/agent.hook.test.js.map +1 -1
  44. package/dist/src/agent/__tests__/agent.interrupt.test.d.ts +2 -0
  45. package/dist/src/agent/__tests__/agent.interrupt.test.d.ts.map +1 -0
  46. package/dist/src/agent/__tests__/agent.interrupt.test.js +730 -0
  47. package/dist/src/agent/__tests__/agent.interrupt.test.js.map +1 -0
  48. package/dist/src/agent/__tests__/agent.invocation-state.test.d.ts +2 -0
  49. package/dist/src/agent/__tests__/agent.invocation-state.test.d.ts.map +1 -0
  50. package/dist/src/agent/__tests__/agent.invocation-state.test.js +219 -0
  51. package/dist/src/agent/__tests__/agent.invocation-state.test.js.map +1 -0
  52. package/dist/src/agent/__tests__/agent.model-retry.test.d.ts +2 -0
  53. package/dist/src/agent/__tests__/agent.model-retry.test.d.ts.map +1 -0
  54. package/dist/src/agent/__tests__/agent.model-retry.test.js +161 -0
  55. package/dist/src/agent/__tests__/agent.model-retry.test.js.map +1 -0
  56. package/dist/src/agent/__tests__/agent.stateful-model.test.d.ts +2 -0
  57. package/dist/src/agent/__tests__/agent.stateful-model.test.d.ts.map +1 -0
  58. package/dist/src/agent/__tests__/agent.stateful-model.test.js +169 -0
  59. package/dist/src/agent/__tests__/agent.stateful-model.test.js.map +1 -0
  60. package/dist/src/agent/__tests__/agent.test.js +217 -2
  61. package/dist/src/agent/__tests__/agent.test.js.map +1 -1
  62. package/dist/src/agent/__tests__/agent.tracer.test.node.js +39 -0
  63. package/dist/src/agent/__tests__/agent.tracer.test.node.js.map +1 -1
  64. package/dist/src/agent/__tests__/snapshot.test.js +51 -4
  65. package/dist/src/agent/__tests__/snapshot.test.js.map +1 -1
  66. package/dist/src/agent/agent-as-tool.d.ts.map +1 -1
  67. package/dist/src/agent/agent-as-tool.js +4 -2
  68. package/dist/src/agent/agent-as-tool.js.map +1 -1
  69. package/dist/src/agent/agent.d.ts +109 -4
  70. package/dist/src/agent/agent.d.ts.map +1 -1
  71. package/dist/src/agent/agent.js +790 -224
  72. package/dist/src/agent/agent.js.map +1 -1
  73. package/dist/src/agent/snapshot.d.ts +2 -2
  74. package/dist/src/agent/snapshot.d.ts.map +1 -1
  75. package/dist/src/agent/snapshot.js +20 -2
  76. package/dist/src/agent/snapshot.js.map +1 -1
  77. package/dist/src/conversation-manager/__tests__/conversation-manager.test.js +230 -9
  78. package/dist/src/conversation-manager/__tests__/conversation-manager.test.js.map +1 -1
  79. package/dist/src/conversation-manager/__tests__/null-conversation-manager.test.js +19 -6
  80. package/dist/src/conversation-manager/__tests__/null-conversation-manager.test.js.map +1 -1
  81. package/dist/src/conversation-manager/__tests__/sliding-window-conversation-manager.test.js +58 -4
  82. package/dist/src/conversation-manager/__tests__/sliding-window-conversation-manager.test.js.map +1 -1
  83. package/dist/src/conversation-manager/__tests__/summarizing-conversation-manager.test.js +76 -1
  84. package/dist/src/conversation-manager/__tests__/summarizing-conversation-manager.test.js.map +1 -1
  85. package/dist/src/conversation-manager/conversation-manager.d.ts +67 -22
  86. package/dist/src/conversation-manager/conversation-manager.d.ts.map +1 -1
  87. package/dist/src/conversation-manager/conversation-manager.js +65 -13
  88. package/dist/src/conversation-manager/conversation-manager.js.map +1 -1
  89. package/dist/src/conversation-manager/index.d.ts +1 -1
  90. package/dist/src/conversation-manager/index.d.ts.map +1 -1
  91. package/dist/src/conversation-manager/index.js +1 -1
  92. package/dist/src/conversation-manager/index.js.map +1 -1
  93. package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts +17 -3
  94. package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts.map +1 -1
  95. package/dist/src/conversation-manager/sliding-window-conversation-manager.js +10 -4
  96. package/dist/src/conversation-manager/sliding-window-conversation-manager.js.map +1 -1
  97. package/dist/src/conversation-manager/summarizing-conversation-manager.d.ts +23 -1
  98. package/dist/src/conversation-manager/summarizing-conversation-manager.d.ts.map +1 -1
  99. package/dist/src/conversation-manager/summarizing-conversation-manager.js +39 -17
  100. package/dist/src/conversation-manager/summarizing-conversation-manager.js.map +1 -1
  101. package/dist/src/errors.d.ts +11 -0
  102. package/dist/src/errors.d.ts.map +1 -1
  103. package/dist/src/errors.js +12 -0
  104. package/dist/src/errors.js.map +1 -1
  105. package/dist/src/hooks/__tests__/events.test.js +267 -73
  106. package/dist/src/hooks/__tests__/events.test.js.map +1 -1
  107. package/dist/src/hooks/__tests__/registry.test.js +182 -18
  108. package/dist/src/hooks/__tests__/registry.test.js.map +1 -1
  109. package/dist/src/hooks/events.d.ts +193 -51
  110. package/dist/src/hooks/events.d.ts.map +1 -1
  111. package/dist/src/hooks/events.js +182 -26
  112. package/dist/src/hooks/events.js.map +1 -1
  113. package/dist/src/hooks/index.d.ts +3 -2
  114. package/dist/src/hooks/index.d.ts.map +1 -1
  115. package/dist/src/hooks/index.js +1 -0
  116. package/dist/src/hooks/index.js.map +1 -1
  117. package/dist/src/hooks/registry.d.ts +12 -12
  118. package/dist/src/hooks/registry.d.ts.map +1 -1
  119. package/dist/src/hooks/registry.js +55 -15
  120. package/dist/src/hooks/registry.js.map +1 -1
  121. package/dist/src/hooks/types.d.ts +23 -0
  122. package/dist/src/hooks/types.d.ts.map +1 -1
  123. package/dist/src/hooks/types.js +17 -1
  124. package/dist/src/hooks/types.js.map +1 -1
  125. package/dist/src/index.d.ts +12 -7
  126. package/dist/src/index.d.ts.map +1 -1
  127. package/dist/src/index.js +4 -1
  128. package/dist/src/index.js.map +1 -1
  129. package/dist/src/interrupt.d.ts +220 -0
  130. package/dist/src/interrupt.d.ts.map +1 -0
  131. package/dist/src/interrupt.js +274 -0
  132. package/dist/src/interrupt.js.map +1 -0
  133. package/dist/src/logging/__tests__/warn-once.test.d.ts +2 -0
  134. package/dist/src/logging/__tests__/warn-once.test.d.ts.map +1 -0
  135. package/dist/src/logging/__tests__/warn-once.test.js +30 -0
  136. package/dist/src/logging/__tests__/warn-once.test.js.map +1 -0
  137. package/dist/src/logging/warn-once.d.ts +13 -0
  138. package/dist/src/logging/warn-once.d.ts.map +1 -0
  139. package/dist/src/logging/warn-once.js +18 -0
  140. package/dist/src/logging/warn-once.js.map +1 -0
  141. package/dist/src/mcp.d.ts +43 -3
  142. package/dist/src/mcp.d.ts.map +1 -1
  143. package/dist/src/mcp.js +85 -17
  144. package/dist/src/mcp.js.map +1 -1
  145. package/dist/src/mime.d.ts +2 -1
  146. package/dist/src/mime.d.ts.map +1 -1
  147. package/dist/src/mime.js +1 -0
  148. package/dist/src/mime.js.map +1 -1
  149. package/dist/src/models/__tests__/anthropic.test.js +147 -3
  150. package/dist/src/models/__tests__/anthropic.test.js.map +1 -1
  151. package/dist/src/models/__tests__/bedrock.test.js +228 -2
  152. package/dist/src/models/__tests__/bedrock.test.js.map +1 -1
  153. package/dist/src/models/__tests__/defaults.test.d.ts +2 -0
  154. package/dist/src/models/__tests__/defaults.test.d.ts.map +1 -0
  155. package/dist/src/models/__tests__/defaults.test.js +36 -0
  156. package/dist/src/models/__tests__/defaults.test.js.map +1 -0
  157. package/dist/src/models/__tests__/google.test.js +135 -0
  158. package/dist/src/models/__tests__/google.test.js.map +1 -1
  159. package/dist/src/models/__tests__/model.test.js +149 -1
  160. package/dist/src/models/__tests__/model.test.js.map +1 -1
  161. package/dist/src/models/anthropic.d.ts +20 -1
  162. package/dist/src/models/anthropic.d.ts.map +1 -1
  163. package/dist/src/models/anthropic.js +42 -8
  164. package/dist/src/models/anthropic.js.map +1 -1
  165. package/dist/src/models/bedrock.d.ts +27 -1
  166. package/dist/src/models/bedrock.d.ts.map +1 -1
  167. package/dist/src/models/bedrock.js +100 -12
  168. package/dist/src/models/bedrock.js.map +1 -1
  169. package/dist/src/models/defaults.d.ts +47 -0
  170. package/dist/src/models/defaults.d.ts.map +1 -0
  171. package/dist/src/models/defaults.js +170 -0
  172. package/dist/src/models/defaults.js.map +1 -0
  173. package/dist/src/models/google/model.d.ts +14 -1
  174. package/dist/src/models/google/model.d.ts.map +1 -1
  175. package/dist/src/models/google/model.js +54 -8
  176. package/dist/src/models/google/model.js.map +1 -1
  177. package/dist/src/models/google/types.d.ts +8 -0
  178. package/dist/src/models/google/types.d.ts.map +1 -1
  179. package/dist/src/models/model.d.ts +65 -0
  180. package/dist/src/models/model.d.ts.map +1 -1
  181. package/dist/src/models/model.js +138 -0
  182. package/dist/src/models/model.js.map +1 -1
  183. package/dist/src/models/openai/__tests__/chat.test.d.ts +2 -0
  184. package/dist/src/models/openai/__tests__/chat.test.d.ts.map +1 -0
  185. package/dist/src/models/{__tests__/openai.test.js → openai/__tests__/chat.test.js} +117 -7
  186. package/dist/src/models/openai/__tests__/chat.test.js.map +1 -0
  187. package/dist/src/models/openai/__tests__/responses.test.d.ts +2 -0
  188. package/dist/src/models/openai/__tests__/responses.test.d.ts.map +1 -0
  189. package/dist/src/models/openai/__tests__/responses.test.js +668 -0
  190. package/dist/src/models/openai/__tests__/responses.test.js.map +1 -0
  191. package/dist/src/models/openai/chat-adapter.d.ts +33 -0
  192. package/dist/src/models/openai/chat-adapter.d.ts.map +1 -0
  193. package/dist/src/models/openai/chat-adapter.js +383 -0
  194. package/dist/src/models/openai/chat-adapter.js.map +1 -0
  195. package/dist/src/models/openai/errors.d.ts +16 -0
  196. package/dist/src/models/openai/errors.d.ts.map +1 -0
  197. package/dist/src/models/openai/errors.js +40 -0
  198. package/dist/src/models/openai/errors.js.map +1 -0
  199. package/dist/src/models/openai/formatting.d.ts +18 -0
  200. package/dist/src/models/openai/formatting.d.ts.map +1 -0
  201. package/dist/src/models/openai/formatting.js +38 -0
  202. package/dist/src/models/openai/formatting.js.map +1 -0
  203. package/dist/src/models/openai/index.d.ts +19 -0
  204. package/dist/src/models/openai/index.d.ts.map +1 -0
  205. package/dist/src/models/openai/index.js +18 -0
  206. package/dist/src/models/openai/index.js.map +1 -0
  207. package/dist/src/models/openai/model.d.ts +77 -0
  208. package/dist/src/models/openai/model.d.ts.map +1 -0
  209. package/dist/src/models/openai/model.js +211 -0
  210. package/dist/src/models/openai/model.js.map +1 -0
  211. package/dist/src/models/openai/responses-adapter.d.ts +78 -0
  212. package/dist/src/models/openai/responses-adapter.d.ts.map +1 -0
  213. package/dist/src/models/openai/responses-adapter.js +467 -0
  214. package/dist/src/models/openai/responses-adapter.js.map +1 -0
  215. package/dist/src/models/openai/types.d.ts +131 -0
  216. package/dist/src/models/openai/types.d.ts.map +1 -0
  217. package/dist/src/models/openai/types.js +5 -0
  218. package/dist/src/models/openai/types.js.map +1 -0
  219. package/dist/src/multiagent/__tests__/events.test.js +122 -28
  220. package/dist/src/multiagent/__tests__/events.test.js.map +1 -1
  221. package/dist/src/multiagent/__tests__/graph.invocation-state.test.d.ts +2 -0
  222. package/dist/src/multiagent/__tests__/graph.invocation-state.test.d.ts.map +1 -0
  223. package/dist/src/multiagent/__tests__/graph.invocation-state.test.js +95 -0
  224. package/dist/src/multiagent/__tests__/graph.invocation-state.test.js.map +1 -0
  225. package/dist/src/multiagent/__tests__/graph.test.js +69 -0
  226. package/dist/src/multiagent/__tests__/graph.test.js.map +1 -1
  227. package/dist/src/multiagent/__tests__/nodes.test.js +18 -2
  228. package/dist/src/multiagent/__tests__/nodes.test.js.map +1 -1
  229. package/dist/src/multiagent/__tests__/swarm.invocation-state.test.d.ts +2 -0
  230. package/dist/src/multiagent/__tests__/swarm.invocation-state.test.d.ts.map +1 -0
  231. package/dist/src/multiagent/__tests__/swarm.invocation-state.test.js +56 -0
  232. package/dist/src/multiagent/__tests__/swarm.invocation-state.test.js.map +1 -0
  233. package/dist/src/multiagent/__tests__/swarm.test.js +77 -0
  234. package/dist/src/multiagent/__tests__/swarm.test.js.map +1 -1
  235. package/dist/src/multiagent/events.d.ts +19 -1
  236. package/dist/src/multiagent/events.d.ts.map +1 -1
  237. package/dist/src/multiagent/events.js +18 -0
  238. package/dist/src/multiagent/events.js.map +1 -1
  239. package/dist/src/multiagent/graph.d.ts +27 -5
  240. package/dist/src/multiagent/graph.d.ts.map +1 -1
  241. package/dist/src/multiagent/graph.js +61 -15
  242. package/dist/src/multiagent/graph.js.map +1 -1
  243. package/dist/src/multiagent/index.d.ts +1 -1
  244. package/dist/src/multiagent/index.d.ts.map +1 -1
  245. package/dist/src/multiagent/multiagent.d.ts +21 -6
  246. package/dist/src/multiagent/multiagent.d.ts.map +1 -1
  247. package/dist/src/multiagent/nodes.d.ts +28 -3
  248. package/dist/src/multiagent/nodes.d.ts.map +1 -1
  249. package/dist/src/multiagent/nodes.js +42 -7
  250. package/dist/src/multiagent/nodes.js.map +1 -1
  251. package/dist/src/multiagent/swarm.d.ts +20 -4
  252. package/dist/src/multiagent/swarm.d.ts.map +1 -1
  253. package/dist/src/multiagent/swarm.js +65 -16
  254. package/dist/src/multiagent/swarm.js.map +1 -1
  255. package/dist/src/plugins/__tests__/registry.test.js +1 -1
  256. package/dist/src/plugins/__tests__/registry.test.js.map +1 -1
  257. package/dist/src/plugins/model-plugin.d.ts +20 -0
  258. package/dist/src/plugins/model-plugin.d.ts.map +1 -0
  259. package/dist/src/plugins/model-plugin.js +29 -0
  260. package/dist/src/plugins/model-plugin.js.map +1 -0
  261. package/dist/src/registry/__tests__/tool-registry.test.js +11 -0
  262. package/dist/src/registry/__tests__/tool-registry.test.js.map +1 -1
  263. package/dist/src/registry/tool-registry.d.ts +4 -0
  264. package/dist/src/registry/tool-registry.d.ts.map +1 -1
  265. package/dist/src/registry/tool-registry.js +6 -0
  266. package/dist/src/registry/tool-registry.js.map +1 -1
  267. package/dist/src/retry/__tests__/backoff-strategy.test.d.ts +2 -0
  268. package/dist/src/retry/__tests__/backoff-strategy.test.d.ts.map +1 -0
  269. package/dist/src/retry/__tests__/backoff-strategy.test.js +116 -0
  270. package/dist/src/retry/__tests__/backoff-strategy.test.js.map +1 -0
  271. package/dist/src/retry/__tests__/default-model-retry-strategy.test.d.ts +2 -0
  272. package/dist/src/retry/__tests__/default-model-retry-strategy.test.d.ts.map +1 -0
  273. package/dist/src/retry/__tests__/default-model-retry-strategy.test.js +225 -0
  274. package/dist/src/retry/__tests__/default-model-retry-strategy.test.js.map +1 -0
  275. package/dist/src/retry/backoff-strategy.d.ts +108 -0
  276. package/dist/src/retry/backoff-strategy.d.ts.map +1 -0
  277. package/dist/src/retry/backoff-strategy.js +86 -0
  278. package/dist/src/retry/backoff-strategy.js.map +1 -0
  279. package/dist/src/retry/default-model-retry-strategy.d.ts +76 -0
  280. package/dist/src/retry/default-model-retry-strategy.d.ts.map +1 -0
  281. package/dist/src/retry/default-model-retry-strategy.js +104 -0
  282. package/dist/src/retry/default-model-retry-strategy.js.map +1 -0
  283. package/dist/src/retry/index.d.ts +8 -0
  284. package/dist/src/retry/index.d.ts.map +1 -0
  285. package/dist/src/retry/index.js +7 -0
  286. package/dist/src/retry/index.js.map +1 -0
  287. package/dist/src/retry/model-retry-strategy.d.ts +80 -0
  288. package/dist/src/retry/model-retry-strategy.d.ts.map +1 -0
  289. package/dist/src/retry/model-retry-strategy.js +85 -0
  290. package/dist/src/retry/model-retry-strategy.js.map +1 -0
  291. package/dist/src/retry/retry-strategy.d.ts +34 -0
  292. package/dist/src/retry/retry-strategy.d.ts.map +1 -0
  293. package/dist/src/retry/retry-strategy.js +25 -0
  294. package/dist/src/retry/retry-strategy.js.map +1 -0
  295. package/dist/src/session/__tests__/session-manager.test.js +52 -11
  296. package/dist/src/session/__tests__/session-manager.test.js.map +1 -1
  297. package/dist/src/session/session-manager.d.ts +6 -0
  298. package/dist/src/session/session-manager.d.ts.map +1 -1
  299. package/dist/src/session/session-manager.js +17 -0
  300. package/dist/src/session/session-manager.js.map +1 -1
  301. package/dist/src/telemetry/__tests__/meter.test.js +23 -0
  302. package/dist/src/telemetry/__tests__/meter.test.js.map +1 -1
  303. package/dist/src/telemetry/meter.d.ts +15 -0
  304. package/dist/src/telemetry/meter.d.ts.map +1 -1
  305. package/dist/src/telemetry/meter.js +14 -0
  306. package/dist/src/telemetry/meter.js.map +1 -1
  307. package/dist/src/tools/__tests__/tool.test.js +24 -1
  308. package/dist/src/tools/__tests__/tool.test.js.map +1 -1
  309. package/dist/src/tools/function-tool.d.ts.map +1 -1
  310. package/dist/src/tools/function-tool.js +6 -1
  311. package/dist/src/tools/function-tool.js.map +1 -1
  312. package/dist/src/tools/mcp-tool.d.ts +24 -3
  313. package/dist/src/tools/mcp-tool.d.ts.map +1 -1
  314. package/dist/src/tools/mcp-tool.js +103 -31
  315. package/dist/src/tools/mcp-tool.js.map +1 -1
  316. package/dist/src/tools/tool.d.ts +21 -2
  317. package/dist/src/tools/tool.d.ts.map +1 -1
  318. package/dist/src/tools/tool.js +12 -0
  319. package/dist/src/tools/tool.js.map +1 -1
  320. package/dist/src/tsconfig.tsbuildinfo +1 -1
  321. package/dist/src/types/__tests__/agent.test.js +48 -0
  322. package/dist/src/types/__tests__/agent.test.js.map +1 -1
  323. package/dist/src/types/agent.d.ts +77 -9
  324. package/dist/src/types/agent.d.ts.map +1 -1
  325. package/dist/src/types/agent.js +30 -6
  326. package/dist/src/types/agent.js.map +1 -1
  327. package/dist/src/types/elicitation.d.ts +15 -0
  328. package/dist/src/types/elicitation.d.ts.map +1 -0
  329. package/dist/src/types/elicitation.js +2 -0
  330. package/dist/src/types/elicitation.js.map +1 -0
  331. package/dist/src/types/interrupt.d.ts +103 -0
  332. package/dist/src/types/interrupt.d.ts.map +1 -0
  333. package/dist/src/types/interrupt.js +63 -0
  334. package/dist/src/types/interrupt.js.map +1 -0
  335. package/dist/src/types/messages.d.ts +2 -1
  336. package/dist/src/types/messages.d.ts.map +1 -1
  337. package/dist/src/types/messages.js.map +1 -1
  338. package/dist/src/vended-plugins/context-offloader/__tests__/plugin.test.d.ts +2 -0
  339. package/dist/src/vended-plugins/context-offloader/__tests__/plugin.test.d.ts.map +1 -0
  340. package/dist/src/vended-plugins/context-offloader/__tests__/plugin.test.js +292 -0
  341. package/dist/src/vended-plugins/context-offloader/__tests__/plugin.test.js.map +1 -0
  342. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.d.ts +2 -0
  343. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.d.ts.map +1 -0
  344. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.js +148 -0
  345. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.js.map +1 -0
  346. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.d.ts +2 -0
  347. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.d.ts.map +1 -0
  348. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.js +78 -0
  349. package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.js.map +1 -0
  350. package/dist/src/vended-plugins/context-offloader/index.d.ts +23 -0
  351. package/dist/src/vended-plugins/context-offloader/index.d.ts.map +1 -0
  352. package/dist/src/vended-plugins/context-offloader/index.js +21 -0
  353. package/dist/src/vended-plugins/context-offloader/index.js.map +1 -0
  354. package/dist/src/vended-plugins/context-offloader/plugin.d.ts +48 -0
  355. package/dist/src/vended-plugins/context-offloader/plugin.d.ts.map +1 -0
  356. package/dist/src/vended-plugins/context-offloader/plugin.js +244 -0
  357. package/dist/src/vended-plugins/context-offloader/plugin.js.map +1 -0
  358. package/dist/src/vended-plugins/context-offloader/storage.d.ts +114 -0
  359. package/dist/src/vended-plugins/context-offloader/storage.d.ts.map +1 -0
  360. package/dist/src/vended-plugins/context-offloader/storage.js +204 -0
  361. package/dist/src/vended-plugins/context-offloader/storage.js.map +1 -0
  362. package/dist/src/vended-plugins/skills/__tests__/agent-skills.test.node.js +21 -5
  363. package/dist/src/vended-plugins/skills/__tests__/agent-skills.test.node.js.map +1 -1
  364. package/dist/src/vended-tools/bash/__tests__/bash.test.node.js +4 -0
  365. package/dist/src/vended-tools/bash/__tests__/bash.test.node.js.map +1 -1
  366. package/dist/src/vended-tools/bash/bash.d.ts.map +1 -1
  367. package/dist/src/vended-tools/bash/bash.js +0 -3
  368. package/dist/src/vended-tools/bash/bash.js.map +1 -1
  369. package/dist/src/vended-tools/file-editor/__tests__/file-editor.test.node.js +4 -0
  370. package/dist/src/vended-tools/file-editor/__tests__/file-editor.test.node.js.map +1 -1
  371. package/dist/src/vended-tools/notebook/__tests__/notebook.test.js +4 -0
  372. package/dist/src/vended-tools/notebook/__tests__/notebook.test.js.map +1 -1
  373. package/package.json +17 -9
  374. package/dist/src/models/__tests__/openai.test.d.ts +0 -2
  375. package/dist/src/models/__tests__/openai.test.d.ts.map +0 -1
  376. package/dist/src/models/__tests__/openai.test.js.map +0 -1
  377. package/dist/src/models/openai.d.ts +0 -312
  378. package/dist/src/models/openai.d.ts.map +0 -1
  379. package/dist/src/models/openai.js +0 -789
  380. package/dist/src/models/openai.js.map +0 -1
@@ -16,6 +16,7 @@ describe('AgentResult', () => {
16
16
  stopReason: 'endTurn',
17
17
  lastMessage: message,
18
18
  metrics: new AgentMetrics(),
19
+ invocationState: {},
19
20
  });
20
21
  expect(result.toString()).toBe('');
21
22
  });
@@ -30,6 +31,7 @@ describe('AgentResult', () => {
30
31
  stopReason: 'endTurn',
31
32
  lastMessage: message,
32
33
  metrics: new AgentMetrics(),
34
+ invocationState: {},
33
35
  });
34
36
  expect(result.toString()).toBe('Hello, world!');
35
37
  });
@@ -44,6 +46,7 @@ describe('AgentResult', () => {
44
46
  stopReason: 'endTurn',
45
47
  lastMessage: message,
46
48
  metrics: new AgentMetrics(),
49
+ invocationState: {},
47
50
  });
48
51
  expect(result.toString()).toBe('First line\nSecond line\nThird line');
49
52
  });
@@ -58,6 +61,7 @@ describe('AgentResult', () => {
58
61
  stopReason: 'endTurn',
59
62
  lastMessage: message,
60
63
  metrics: new AgentMetrics(),
64
+ invocationState: {},
61
65
  });
62
66
  expect(result.toString()).toBe('💭 Reasoning:\n Let me think about this...');
63
67
  });
@@ -72,6 +76,7 @@ describe('AgentResult', () => {
72
76
  stopReason: 'endTurn',
73
77
  lastMessage: message,
74
78
  metrics: new AgentMetrics(),
79
+ invocationState: {},
75
80
  });
76
81
  expect(result.toString()).toBe('');
77
82
  });
@@ -90,6 +95,7 @@ describe('AgentResult', () => {
90
95
  stopReason: 'endTurn',
91
96
  lastMessage: message,
92
97
  metrics: new AgentMetrics(),
98
+ invocationState: {},
93
99
  });
94
100
  expect(result.toString()).toBe('Here is my response.\n💭 Reasoning:\n I reasoned carefully.\nAdditional context.');
95
101
  });
@@ -112,6 +118,7 @@ describe('AgentResult', () => {
112
118
  stopReason: 'toolUse',
113
119
  lastMessage: message,
114
120
  metrics: new AgentMetrics(),
121
+ invocationState: {},
115
122
  });
116
123
  expect(result.toString()).toBe('');
117
124
  });
@@ -132,6 +139,7 @@ describe('AgentResult', () => {
132
139
  stopReason: 'toolUse',
133
140
  lastMessage: message,
134
141
  metrics: new AgentMetrics(),
142
+ invocationState: {},
135
143
  });
136
144
  expect(result.toString()).toBe('Before tool\n💭 Reasoning:\n Thinking...\nAfter tool');
137
145
  });
@@ -146,6 +154,7 @@ describe('AgentResult', () => {
146
154
  stopReason: 'endTurn',
147
155
  lastMessage: message,
148
156
  metrics: new AgentMetrics(),
157
+ invocationState: {},
149
158
  });
150
159
  expect(String(result)).toBe('Hello');
151
160
  });
@@ -158,6 +167,7 @@ describe('AgentResult', () => {
158
167
  stopReason: 'endTurn',
159
168
  lastMessage: message,
160
169
  metrics: new AgentMetrics(),
170
+ invocationState: {},
161
171
  });
162
172
  expect(`Response: ${result}`).toBe('Response: World');
163
173
  });
@@ -174,6 +184,7 @@ describe('AgentResult', () => {
174
184
  stopReason: 'endTurn',
175
185
  lastMessage: message,
176
186
  metrics,
187
+ invocationState: {},
177
188
  });
178
189
  expect(result.contextSize).toBe(500);
179
190
  });
@@ -186,6 +197,7 @@ describe('AgentResult', () => {
186
197
  stopReason: 'endTurn',
187
198
  lastMessage: message,
188
199
  metrics: new AgentMetrics(),
200
+ invocationState: {},
189
201
  });
190
202
  expect(result.contextSize).toBeUndefined();
191
203
  });
@@ -197,10 +209,40 @@ describe('AgentResult', () => {
197
209
  const result = new AgentResult({
198
210
  stopReason: 'endTurn',
199
211
  lastMessage: message,
212
+ invocationState: {},
200
213
  });
201
214
  expect(result.contextSize).toBeUndefined();
202
215
  });
203
216
  });
217
+ describe('projectedContextSize', () => {
218
+ it('returns projectedContextSize from metrics', () => {
219
+ const message = new Message({
220
+ role: 'assistant',
221
+ content: [new TextBlock('Hello')],
222
+ });
223
+ const metrics = new AgentMetrics({ projectedContextSize: 750 });
224
+ const result = new AgentResult({
225
+ stopReason: 'endTurn',
226
+ lastMessage: message,
227
+ metrics,
228
+ invocationState: {},
229
+ });
230
+ expect(result.projectedContextSize).toBe(750);
231
+ });
232
+ it('returns undefined when metrics has no projectedContextSize', () => {
233
+ const message = new Message({
234
+ role: 'assistant',
235
+ content: [new TextBlock('Hello')],
236
+ });
237
+ const result = new AgentResult({
238
+ stopReason: 'endTurn',
239
+ lastMessage: message,
240
+ metrics: new AgentMetrics(),
241
+ invocationState: {},
242
+ });
243
+ expect(result.projectedContextSize).toBeUndefined();
244
+ });
245
+ });
204
246
  describe('toJSON', () => {
205
247
  it('excludes traces and metrics from serialization', () => {
206
248
  const message = new Message({
@@ -214,6 +256,7 @@ describe('AgentResult', () => {
214
256
  lastMessage: message,
215
257
  traces,
216
258
  metrics,
259
+ invocationState: {},
217
260
  });
218
261
  const json = result.toJSON();
219
262
  expect(json).toEqual({
@@ -232,6 +275,7 @@ describe('AgentResult', () => {
232
275
  stopReason: 'endTurn',
233
276
  lastMessage: message,
234
277
  structuredOutput,
278
+ invocationState: {},
235
279
  });
236
280
  const json = result.toJSON();
237
281
  expect(json).toHaveProperty('structuredOutput', structuredOutput);
@@ -244,6 +288,7 @@ describe('AgentResult', () => {
244
288
  const result = new AgentResult({
245
289
  stopReason: 'endTurn',
246
290
  lastMessage: message,
291
+ invocationState: {},
247
292
  });
248
293
  const json = result.toJSON();
249
294
  expect(json).not.toHaveProperty('structuredOutput');
@@ -260,6 +305,7 @@ describe('AgentResult', () => {
260
305
  lastMessage: message,
261
306
  traces,
262
307
  metrics,
308
+ invocationState: {},
263
309
  });
264
310
  const jsonString = JSON.stringify(result);
265
311
  const parsed = JSON.parse(jsonString);
@@ -284,6 +330,7 @@ describe('AgentResult', () => {
284
330
  lastMessage: message,
285
331
  traces,
286
332
  metrics,
333
+ invocationState: {},
287
334
  });
288
335
  // Properties are still accessible
289
336
  expect({ traces: result.traces, metrics: result.metrics }).toEqual({
@@ -311,6 +358,7 @@ describe('AgentResult', () => {
311
358
  lastMessage: message,
312
359
  traces,
313
360
  metrics,
361
+ invocationState: {},
314
362
  });
315
363
  // Simulate what happens in Express/Next.js: res.json(result)
316
364
  const apiResponse = JSON.parse(JSON.stringify(result));
@@ -1 +1 @@
1
- {"version":3,"file":"agent.test.js","sourceRoot":"","sources":["../../../../src/types/__tests__/agent.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent.test.js","sourceRoot":"","sources":["../../../../src/types/__tests__/agent.test.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,12 @@
1
1
  import type { StateStore } from '../state-store.js';
2
2
  import type { ContentBlock, ContentBlockData, Message, MessageData, StopReason, SystemPrompt } from './messages.js';
3
+ import type { Interrupt } from '../interrupt.js';
4
+ import type { InterruptResponseContent, InterruptResponseContentData } from './interrupt.js';
3
5
  import type { AgentTrace } from '../telemetry/tracer.js';
4
6
  import type { BeforeInvocationEvent, AfterInvocationEvent, BeforeModelCallEvent, AfterModelCallEvent, BeforeToolsEvent, AfterToolsEvent, BeforeToolCallEvent, AfterToolCallEvent, MessageAddedEvent, ModelStreamUpdateEvent, ContentBlockEvent, ModelMessageEvent, ToolResultEvent, ToolStreamUpdateEvent, AgentResultEvent, HookableEvent, StreamEvent } from '../hooks/events.js';
5
- import type { HookCallback, HookableEventConstructor, HookCleanup } from '../hooks/types.js';
7
+ import type { HookCallback, HookableEventConstructor, HookCallbackOptions, HookCleanup } from '../hooks/types.js';
6
8
  import type { ToolRegistry } from '../registry/tool-registry.js';
9
+ import type { Model } from '../models/model.js';
7
10
  import type { z } from 'zod';
8
11
  import { AgentMetrics } from '../telemetry/meter.js';
9
12
  /**
@@ -13,8 +16,30 @@ import { AgentMetrics } from '../telemetry/meter.js';
13
16
  * - `string` - User text input (wrapped in TextBlock, creates user Message)
14
17
  * - `ContentBlock[]` | `ContentBlockData[]` - Array of content blocks (creates single user Message)
15
18
  * - `Message[]` | `MessageData[]` - Array of messages (appends all to conversation)
19
+ * - `InterruptResponseContent[]` - Array of interrupt responses (resumes from interrupted state)
16
20
  */
17
- export type InvokeArgs = string | ContentBlock[] | ContentBlockData[] | Message[] | MessageData[];
21
+ export type InvokeArgs = string | ContentBlock[] | ContentBlockData[] | Message[] | MessageData[] | InterruptResponseContent[] | InterruptResponseContentData[];
22
+ /**
23
+ * Per-invocation state threaded through hooks and tools for a single agent
24
+ * invocation, and returned on {@link AgentResult.invocationState}. One object
25
+ * per invocation, shared by reference; mutations by hooks or tools are visible
26
+ * to subsequent hooks, tools, and recursive loop cycles.
27
+ *
28
+ * Typically used for request-scoped context (`userId`, `requestId`, `traceId`)
29
+ * or cross-hook counters. The core agent loop writes no keys into it — the
30
+ * key space is the caller's. Transport bridges may populate reserved keys
31
+ * (e.g. `A2AExecutor` sets `a2aRequestContext`); those bridges document their
32
+ * own reserved keys.
33
+ *
34
+ * Distinct from {@link LocalAgent.appState}: `appState` is durable across
35
+ * invocations, JSON-serializable, and deep-copied. `invocationState` is
36
+ * ephemeral and accepts arbitrary values.
37
+ *
38
+ * Excluded from `toJSON()` on {@link AgentResult} and all hook events because
39
+ * values may not be serializable; callers produce a serialized form explicitly
40
+ * if needed.
41
+ */
42
+ export type InvocationState = Record<string, unknown>;
18
43
  /**
19
44
  * Options for a single agent invocation.
20
45
  */
@@ -23,6 +48,14 @@ export interface InvokeOptions {
23
48
  * Zod schema for structured output validation, overriding the constructor-provided schema for this invocation only.
24
49
  */
25
50
  structuredOutputSchema?: z.ZodSchema;
51
+ /**
52
+ * Per-invocation state. Passed to lifecycle hook events and tools, and
53
+ * returned on {@link AgentResult.invocationState}. Mutable — hooks and tools
54
+ * may read and write. See {@link InvocationState} for details.
55
+ *
56
+ * Defaults to an empty object when omitted.
57
+ */
58
+ invocationState?: InvocationState;
26
59
  /**
27
60
  * External AbortSignal for cancelling the agent invocation.
28
61
  *
@@ -119,10 +152,20 @@ export interface LocalAgent {
119
152
  * The conversation history of messages between user and assistant.
120
153
  */
121
154
  messages: Message[];
155
+ /**
156
+ * Runtime state for the model provider. Used by stateful models to persist
157
+ * provider-specific data (e.g., response IDs for server-side conversation chaining)
158
+ * across invocations.
159
+ */
160
+ modelState: StateStore;
122
161
  /**
123
162
  * The tool registry for registering tools with the agent.
124
163
  */
125
164
  readonly toolRegistry: ToolRegistry;
165
+ /**
166
+ * The model provider used by the agent for inference.
167
+ */
168
+ readonly model: Model;
126
169
  /**
127
170
  * The system prompt to pass to the model provider.
128
171
  */
@@ -164,11 +207,16 @@ export interface LocalAgent {
164
207
  /**
165
208
  * Register a hook callback for a specific event type.
166
209
  *
210
+ * Hooks execute in order from lowest to highest. Lower values always run
211
+ * first, on both Before* and After* events. Within the same order, After*
212
+ * events reverse registration order for cleanup symmetry.
213
+ *
167
214
  * @param eventType - The event class constructor to register the callback for
168
215
  * @param callback - The callback function to invoke when the event occurs
216
+ * @param options - Optional configuration including execution order
169
217
  * @returns Cleanup function that removes the callback when invoked
170
218
  */
171
- addHook<T extends HookableEvent>(eventType: HookableEventConstructor<T>, callback: HookCallback<T>): HookCleanup;
219
+ addHook<T extends HookableEvent>(eventType: HookableEventConstructor<T>, callback: HookCallback<T>, options?: HookCallbackOptions): HookCleanup;
172
220
  }
173
221
  /**
174
222
  * Result returned by the agent loop.
@@ -198,12 +246,26 @@ export declare class AgentResult {
198
246
  * Tracks cycle counts, token usage, tool execution stats, and model latency.
199
247
  */
200
248
  readonly metrics?: AgentMetrics;
249
+ /**
250
+ * Per-invocation state passed into the agent, threaded through hooks and
251
+ * tools, and surfaced here at the end of the invocation. See
252
+ * {@link InvocationState} for details. Always defined — defaults to `{}` when
253
+ * no `invocationState` was provided in {@link InvokeOptions}.
254
+ */
255
+ readonly invocationState: InvocationState;
256
+ /**
257
+ * Interrupts that caused the agent to stop, when `stopReason` is `'interrupt'`.
258
+ * Contains the unanswered interrupts that require human input to resume.
259
+ */
260
+ readonly interrupts?: Interrupt[];
201
261
  constructor(data: {
202
262
  stopReason: StopReason;
203
263
  lastMessage: Message;
264
+ invocationState: InvocationState;
204
265
  traces?: AgentTrace[];
205
266
  metrics?: AgentMetrics;
206
267
  structuredOutput?: z.output<z.ZodType>;
268
+ interrupts?: Interrupt[];
207
269
  });
208
270
  /**
209
271
  * The most recent input token count from the last model invocation.
@@ -212,14 +274,20 @@ export declare class AgentResult {
212
274
  */
213
275
  get contextSize(): number | undefined;
214
276
  /**
215
- * Custom JSON serialization that excludes traces and metrics by default.
216
- * This prevents accidentally sending large trace/metric data over the wire
217
- * when serializing AgentResult for API responses.
277
+ * Projected context size for the next model call (inputTokens + outputTokens from the last call).
278
+ * Convenience accessor that delegates to `metrics.projectedContextSize`.
279
+ * Returns `undefined` when no metrics or invocations are available.
280
+ */
281
+ get projectedContextSize(): number | undefined;
282
+ /**
283
+ * Custom JSON serialization that excludes traces, metrics, and invocationState.
284
+ * Traces and metrics are excluded to avoid sending large payloads over the wire
285
+ * in API responses; `invocationState` is excluded because its values are
286
+ * caller-owned and may not be serializable (see {@link InvocationState}).
218
287
  *
219
- * Traces and metrics remain accessible via their properties for debugging,
220
- * but won't be included in JSON.stringify() output.
288
+ * All three remain accessible via their properties for debugging.
221
289
  *
222
- * @returns Object representation without traces/metrics for safe serialization
290
+ * @returns Object representation for safe serialization
223
291
  */
224
292
  toJSON(): object;
225
293
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"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"}
@@ -27,9 +27,22 @@ export class AgentResult {
27
27
  * Tracks cycle counts, token usage, tool execution stats, and model latency.
28
28
  */
29
29
  metrics;
30
+ /**
31
+ * Per-invocation state passed into the agent, threaded through hooks and
32
+ * tools, and surfaced here at the end of the invocation. See
33
+ * {@link InvocationState} for details. Always defined — defaults to `{}` when
34
+ * no `invocationState` was provided in {@link InvokeOptions}.
35
+ */
36
+ invocationState;
37
+ /**
38
+ * Interrupts that caused the agent to stop, when `stopReason` is `'interrupt'`.
39
+ * Contains the unanswered interrupts that require human input to resume.
40
+ */
41
+ interrupts;
30
42
  constructor(data) {
31
43
  this.stopReason = data.stopReason;
32
44
  this.lastMessage = data.lastMessage;
45
+ this.invocationState = data.invocationState;
33
46
  if (data.traces !== undefined) {
34
47
  this.traces = data.traces;
35
48
  }
@@ -39,6 +52,9 @@ export class AgentResult {
39
52
  if (data.structuredOutput !== undefined) {
40
53
  this.structuredOutput = data.structuredOutput;
41
54
  }
55
+ if (data.interrupts !== undefined) {
56
+ this.interrupts = data.interrupts;
57
+ }
42
58
  }
43
59
  /**
44
60
  * The most recent input token count from the last model invocation.
@@ -49,14 +65,22 @@ export class AgentResult {
49
65
  return this.metrics?.latestContextSize;
50
66
  }
51
67
  /**
52
- * Custom JSON serialization that excludes traces and metrics by default.
53
- * This prevents accidentally sending large trace/metric data over the wire
54
- * when serializing AgentResult for API responses.
68
+ * Projected context size for the next model call (inputTokens + outputTokens from the last call).
69
+ * Convenience accessor that delegates to `metrics.projectedContextSize`.
70
+ * Returns `undefined` when no metrics or invocations are available.
71
+ */
72
+ get projectedContextSize() {
73
+ return this.metrics?.projectedContextSize;
74
+ }
75
+ /**
76
+ * Custom JSON serialization that excludes traces, metrics, and invocationState.
77
+ * Traces and metrics are excluded to avoid sending large payloads over the wire
78
+ * in API responses; `invocationState` is excluded because its values are
79
+ * caller-owned and may not be serializable (see {@link InvocationState}).
55
80
  *
56
- * Traces and metrics remain accessible via their properties for debugging,
57
- * but won't be included in JSON.stringify() output.
81
+ * All three remain accessible via their properties for debugging.
58
82
  *
59
- * @returns Object representation without traces/metrics for safe serialization
83
+ * @returns Object representation for safe serialization
60
84
  */
61
85
  toJSON() {
62
86
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAuLpD;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAsB,CAAA;IAEtC;;OAEG;IACM,UAAU,CAAY;IAE/B;;OAEG;IACM,WAAW,CAAS;IAE7B;;;OAGG;IACM,MAAM,CAAe;IAE9B;;;OAGG;IACM,gBAAgB,CAAsB;IAE/C;;;OAGG;IACM,OAAO,CAAe;IAE/B,YAAY,IAMX;QACC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAC/C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACxC,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;SACxF,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACI,QAAQ;QACb,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,WAAW;oBACd,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC1B,MAAK;gBACP,KAAK,gBAAgB;oBACnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACf,uCAAuC;wBACvC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;wBACvD,SAAS,CAAC,IAAI,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;oBACrD,CAAC;oBACD,MAAK;gBACP;oBACE,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;oBAC3D,MAAK;YACT,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}
1
+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAmPpD;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAsB,CAAA;IAEtC;;OAEG;IACM,UAAU,CAAY;IAE/B;;OAEG;IACM,WAAW,CAAS;IAE7B;;;OAGG;IACM,MAAM,CAAe;IAE9B;;;OAGG;IACM,gBAAgB,CAAsB;IAE/C;;;OAGG;IACM,OAAO,CAAe;IAE/B;;;;;OAKG;IACM,eAAe,CAAiB;IAEzC;;;OAGG;IACM,UAAU,CAAc;IAEjC,YAAY,IAQX;QACC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QACnC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAA;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAC/C,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACxC,CAAC;IAED;;;;OAIG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAA;IAC3C,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;SACxF,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACI,QAAQ;QACb,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,WAAW;oBACd,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC1B,MAAK;gBACP,KAAK,gBAAgB;oBACnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACf,uCAAuC;wBACvC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;wBACvD,SAAS,CAAC,IAAI,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;oBACrD,CAAC;oBACD,MAAK;gBACP;oBACE,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;oBAC3D,MAAK;YACT,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}
@@ -0,0 +1,15 @@
1
+ import type { ElicitResult, ElicitRequestParams, ClientRequest, ClientNotification } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
3
+ /**
4
+ * Context provided to an elicitation callback, including the abort signal for the in-flight request.
5
+ */
6
+ export type ElicitationContext = RequestHandlerExtra<ClientRequest, ClientNotification>;
7
+ /**
8
+ * Callback invoked when an MCP server sends an elicitation request to gather user input during tool execution.
9
+ *
10
+ * @param context - Request context including abort signal.
11
+ * @param params - The elicitation parameters from the server (message, requested schema or URL).
12
+ * @returns The user's response: accept (with content), decline, or cancel.
13
+ */
14
+ export type ElicitationCallback = (context: ElicitationContext, params: ElicitRequestParams) => Promise<ElicitResult>;
15
+ //# sourceMappingURL=elicitation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../../src/types/elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EACnB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AAEvF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAA;AAEvF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=elicitation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../../src/types/elicitation.ts"],"names":[],"mappings":""}
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Interrupt-related type definitions for human-in-the-loop workflows.
3
+ *
4
+ * These types define the data structures used when invoking agents with
5
+ * interrupt responses to resume execution.
6
+ */
7
+ import type { JSONValue } from './json.js';
8
+ import type { JSONSerializable } from './json.js';
9
+ /**
10
+ * Parameters for raising an interrupt.
11
+ */
12
+ export interface InterruptParams {
13
+ /**
14
+ * User-defined name for the interrupt.
15
+ * Must be unique within a single hook callback or tool execution.
16
+ */
17
+ name: string;
18
+ /**
19
+ * User-provided reason for the interrupt.
20
+ */
21
+ reason?: JSONValue;
22
+ /**
23
+ * Preemptive response to use if available.
24
+ * When provided, the interrupt returns this value immediately without
25
+ * halting agent execution. Useful for session-managed trust responses
26
+ * where a previous user response can be reused.
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * // If user already approved in a previous session, skip the interrupt
31
+ * const approval = context.interrupt({
32
+ * name: 'confirm_delete',
33
+ * reason: 'Confirm deletion?',
34
+ * response: agent.appState['savedApproval'],
35
+ * })
36
+ * ```
37
+ */
38
+ response?: JSONValue;
39
+ }
40
+ /**
41
+ * User response to an interrupt.
42
+ */
43
+ export interface InterruptResponse {
44
+ /**
45
+ * Unique identifier of the interrupt being responded to.
46
+ */
47
+ interruptId: string;
48
+ /**
49
+ * User's response to the interrupt.
50
+ */
51
+ response: JSONValue;
52
+ }
53
+ /**
54
+ * Data format for a content block containing a user response to an interrupt.
55
+ */
56
+ export interface InterruptResponseContentData {
57
+ /**
58
+ * The interrupt response data.
59
+ */
60
+ interruptResponse: InterruptResponse;
61
+ }
62
+ /**
63
+ * Content block containing a user response to an interrupt.
64
+ * Used when invoking an agent to resume from an interrupted state.
65
+ *
66
+ * @example
67
+ * ```typescript
68
+ * const content = new InterruptResponseContent({
69
+ * interruptId: interrupt.id,
70
+ * response: 'approved',
71
+ * })
72
+ * ```
73
+ */
74
+ export declare class InterruptResponseContent implements InterruptResponseContentData, JSONSerializable<InterruptResponseContentData> {
75
+ /**
76
+ * Discriminator for interrupt response content blocks.
77
+ */
78
+ readonly type: "interruptResponseContent";
79
+ /**
80
+ * The interrupt response data.
81
+ */
82
+ readonly interruptResponse: InterruptResponse;
83
+ constructor(data: InterruptResponse);
84
+ /**
85
+ * Serializes to a JSON-compatible {@link InterruptResponseContentData} object.
86
+ * Called automatically by `JSON.stringify()`.
87
+ */
88
+ toJSON(): InterruptResponseContentData;
89
+ /**
90
+ * Creates an InterruptResponseContent instance from data.
91
+ *
92
+ * @param data - Data to deserialize
93
+ * @returns InterruptResponseContent instance
94
+ */
95
+ static fromJSON(data: InterruptResponseContentData): InterruptResponseContent;
96
+ }
97
+ /**
98
+ * Type guard that checks whether a value is an {@link InterruptResponseContent}.
99
+ *
100
+ * @internal
101
+ */
102
+ export declare function isInterruptResponseContent(value: unknown): value is InterruptResponseContent;
103
+ //# sourceMappingURL=interrupt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../../src/types/interrupt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAA;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,wBACX,YAAW,4BAA4B,EAAE,gBAAgB,CAAC,4BAA4B,CAAC;IAEvF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAG,0BAA0B,CAAS;IAEnD;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;gBAEjC,IAAI,EAAE,iBAAiB;IAInC;;;OAGG;IACH,MAAM,IAAI,4BAA4B;IAItC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,GAAG,wBAAwB;CAG9E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAS5F"}