@namzu/sdk 45.1.0 → 48.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 (767) hide show
  1. package/CHANGELOG.md +436 -8
  2. package/README.md +7 -8
  3. package/dist/advisory/history.d.ts.map +1 -1
  4. package/dist/advisory/history.js +21 -1
  5. package/dist/advisory/history.js.map +1 -1
  6. package/dist/advisory/index.d.ts +1 -1
  7. package/dist/advisory/index.d.ts.map +1 -1
  8. package/dist/advisory/index.js +1 -1
  9. package/dist/advisory/index.js.map +1 -1
  10. package/dist/advisory/registry.d.ts +17 -0
  11. package/dist/advisory/registry.d.ts.map +1 -1
  12. package/dist/advisory/registry.js +26 -0
  13. package/dist/advisory/registry.js.map +1 -1
  14. package/dist/agents/PipelineAgent.d.ts +2 -46
  15. package/dist/agents/PipelineAgent.d.ts.map +1 -1
  16. package/dist/agents/PipelineAgent.js +2 -242
  17. package/dist/agents/PipelineAgent.js.map +1 -1
  18. package/dist/agents/QueryAgent.d.ts +21 -0
  19. package/dist/agents/QueryAgent.d.ts.map +1 -0
  20. package/dist/agents/QueryAgent.js +214 -0
  21. package/dist/agents/QueryAgent.js.map +1 -0
  22. package/dist/agents/ReactiveAgent.d.ts +4 -16
  23. package/dist/agents/ReactiveAgent.d.ts.map +1 -1
  24. package/dist/agents/ReactiveAgent.js +4 -183
  25. package/dist/agents/ReactiveAgent.js.map +1 -1
  26. package/dist/agents/RouterAgent.d.ts +2 -20
  27. package/dist/agents/RouterAgent.d.ts.map +1 -1
  28. package/dist/agents/RouterAgent.js +2 -266
  29. package/dist/agents/RouterAgent.js.map +1 -1
  30. package/dist/agents/SupervisorAgent.d.ts +3 -43
  31. package/dist/agents/SupervisorAgent.d.ts.map +1 -1
  32. package/dist/agents/SupervisorAgent.js +3 -418
  33. package/dist/agents/SupervisorAgent.js.map +1 -1
  34. package/dist/agents/defineAgent.d.ts +2 -1
  35. package/dist/agents/defineAgent.d.ts.map +1 -1
  36. package/dist/agents/defineAgent.js +6 -1
  37. package/dist/agents/defineAgent.js.map +1 -1
  38. package/dist/agents/examples/PipelineAgent.d.ts +46 -0
  39. package/dist/agents/examples/PipelineAgent.d.ts.map +1 -0
  40. package/dist/agents/examples/PipelineAgent.js +242 -0
  41. package/dist/agents/examples/PipelineAgent.js.map +1 -0
  42. package/dist/agents/examples/RouterAgent.d.ts +22 -0
  43. package/dist/agents/examples/RouterAgent.d.ts.map +1 -0
  44. package/dist/agents/examples/RouterAgent.js +268 -0
  45. package/dist/agents/examples/RouterAgent.js.map +1 -0
  46. package/dist/agents/examples/SupervisorAgent.d.ts +45 -0
  47. package/dist/agents/examples/SupervisorAgent.d.ts.map +1 -0
  48. package/dist/agents/examples/SupervisorAgent.js +406 -0
  49. package/dist/agents/examples/SupervisorAgent.js.map +1 -0
  50. package/dist/agents/explore.d.ts +6 -3
  51. package/dist/agents/explore.d.ts.map +1 -1
  52. package/dist/agents/explore.js +6 -3
  53. package/dist/agents/explore.js.map +1 -1
  54. package/dist/agents/forward-options.d.ts +11 -0
  55. package/dist/agents/forward-options.d.ts.map +1 -0
  56. package/dist/agents/forward-options.js +15 -0
  57. package/dist/agents/forward-options.js.map +1 -0
  58. package/dist/agents/index.d.ts +1 -0
  59. package/dist/agents/index.d.ts.map +1 -1
  60. package/dist/agents/index.js +2 -0
  61. package/dist/agents/index.js.map +1 -1
  62. package/dist/agents/runAgent.d.ts +19 -8
  63. package/dist/agents/runAgent.d.ts.map +1 -1
  64. package/dist/agents/runAgent.js +99 -29
  65. package/dist/agents/runAgent.js.map +1 -1
  66. package/dist/authorization/command-line.d.ts +2 -0
  67. package/dist/authorization/command-line.d.ts.map +1 -1
  68. package/dist/authorization/command-line.js +2 -2
  69. package/dist/authorization/command-line.js.map +1 -1
  70. package/dist/authorization/gate.d.ts +13 -2
  71. package/dist/authorization/gate.d.ts.map +1 -1
  72. package/dist/authorization/gate.js +37 -5
  73. package/dist/authorization/gate.js.map +1 -1
  74. package/dist/authorization/program.d.ts +151 -0
  75. package/dist/authorization/program.d.ts.map +1 -0
  76. package/dist/authorization/program.js +713 -0
  77. package/dist/authorization/program.js.map +1 -0
  78. package/dist/authorization/reexec-wrapper.d.ts +106 -0
  79. package/dist/authorization/reexec-wrapper.d.ts.map +1 -0
  80. package/dist/authorization/reexec-wrapper.js +532 -0
  81. package/dist/authorization/reexec-wrapper.js.map +1 -0
  82. package/dist/authorization/rules.d.ts +9 -0
  83. package/dist/authorization/rules.d.ts.map +1 -1
  84. package/dist/authorization/rules.js +27 -1
  85. package/dist/authorization/rules.js.map +1 -1
  86. package/dist/authorization/shell-lexer.d.ts +39 -0
  87. package/dist/authorization/shell-lexer.d.ts.map +1 -1
  88. package/dist/authorization/shell-lexer.js +113 -69
  89. package/dist/authorization/shell-lexer.js.map +1 -1
  90. package/dist/bridge/sse/mapper.d.ts.map +1 -1
  91. package/dist/bridge/sse/mapper.js +6 -0
  92. package/dist/bridge/sse/mapper.js.map +1 -1
  93. package/dist/capabilities/index.d.ts +54 -0
  94. package/dist/capabilities/index.d.ts.map +1 -0
  95. package/dist/capabilities/index.js +92 -0
  96. package/dist/capabilities/index.js.map +1 -0
  97. package/dist/config/registry.d.ts +2 -1
  98. package/dist/config/registry.d.ts.map +1 -1
  99. package/dist/config/registry.js +3 -2
  100. package/dist/config/registry.js.map +1 -1
  101. package/dist/connector/index.d.ts +4 -4
  102. package/dist/connector/index.d.ts.map +1 -1
  103. package/dist/connector/index.js +3 -3
  104. package/dist/connector/index.js.map +1 -1
  105. package/dist/connector/mcp/adapter.d.ts +16 -1
  106. package/dist/connector/mcp/adapter.d.ts.map +1 -1
  107. package/dist/connector/mcp/adapter.js +60 -4
  108. package/dist/connector/mcp/adapter.js.map +1 -1
  109. package/dist/connector/mcp/client.d.ts +13 -4
  110. package/dist/connector/mcp/client.d.ts.map +1 -1
  111. package/dist/connector/mcp/client.js +20 -3
  112. package/dist/connector/mcp/client.js.map +1 -1
  113. package/dist/connector/mcp/discovery.d.ts +24 -1
  114. package/dist/connector/mcp/discovery.d.ts.map +1 -1
  115. package/dist/connector/mcp/discovery.js +44 -0
  116. package/dist/connector/mcp/discovery.js.map +1 -1
  117. package/dist/connector/mcp/index.d.ts +2 -0
  118. package/dist/connector/mcp/index.d.ts.map +1 -1
  119. package/dist/connector/mcp/index.js +11 -0
  120. package/dist/connector/mcp/index.js.map +1 -1
  121. package/dist/connector/mcp/mcp-toolset.d.ts +133 -0
  122. package/dist/connector/mcp/mcp-toolset.d.ts.map +1 -0
  123. package/dist/connector/mcp/mcp-toolset.js +399 -0
  124. package/dist/connector/mcp/mcp-toolset.js.map +1 -0
  125. package/dist/connector/tools/index.d.ts +2 -2
  126. package/dist/connector/tools/index.d.ts.map +1 -1
  127. package/dist/connector/tools/index.js +1 -1
  128. package/dist/connector/tools/index.js.map +1 -1
  129. package/dist/connector/tools/router.d.ts +15 -13
  130. package/dist/connector/tools/router.d.ts.map +1 -1
  131. package/dist/connector/tools/router.js +30 -51
  132. package/dist/connector/tools/router.js.map +1 -1
  133. package/dist/contracts/a2a.d.ts +2 -2
  134. package/dist/directory/derive-supervisor.d.ts +2 -2
  135. package/dist/directory/derive-supervisor.d.ts.map +1 -1
  136. package/dist/directory/derive-supervisor.js +6 -7
  137. package/dist/directory/derive-supervisor.js.map +1 -1
  138. package/dist/directory/derive.d.ts.map +1 -1
  139. package/dist/directory/derive.js +5 -5
  140. package/dist/directory/derive.js.map +1 -1
  141. package/dist/execution/code-runtime/types.d.ts +2 -2
  142. package/dist/execution/code-runtime/types.js +1 -1
  143. package/dist/invariants/index.d.ts +2 -1
  144. package/dist/invariants/index.d.ts.map +1 -1
  145. package/dist/invariants/index.js +3 -2
  146. package/dist/invariants/index.js.map +1 -1
  147. package/dist/manager/agent/lifecycle.d.ts.map +1 -1
  148. package/dist/manager/agent/lifecycle.js +9 -0
  149. package/dist/manager/agent/lifecycle.js.map +1 -1
  150. package/dist/manager/connector/environment.d.ts +6 -0
  151. package/dist/manager/connector/environment.d.ts.map +1 -1
  152. package/dist/manager/connector/environment.js +11 -4
  153. package/dist/manager/connector/environment.js.map +1 -1
  154. package/dist/manager/connector/index.d.ts +2 -2
  155. package/dist/manager/connector/index.d.ts.map +1 -1
  156. package/dist/manager/connector/index.js +2 -2
  157. package/dist/manager/connector/index.js.map +1 -1
  158. package/dist/manager/connector/tenant.d.ts +6 -0
  159. package/dist/manager/connector/tenant.d.ts.map +1 -1
  160. package/dist/manager/connector/tenant.js +11 -4
  161. package/dist/manager/connector/tenant.js.map +1 -1
  162. package/dist/manager/index.d.ts +2 -2
  163. package/dist/manager/index.d.ts.map +1 -1
  164. package/dist/manager/index.js +2 -2
  165. package/dist/manager/index.js.map +1 -1
  166. package/dist/manager/resident/learning-observation.d.ts +4 -4
  167. package/dist/manager/resident/learning.d.ts +36 -36
  168. package/dist/manager/session/attribution.d.ts +22 -0
  169. package/dist/manager/session/attribution.d.ts.map +1 -0
  170. package/dist/manager/session/attribution.js +64 -0
  171. package/dist/manager/session/attribution.js.map +1 -0
  172. package/dist/manager/session/turn-recorder.d.ts +14 -0
  173. package/dist/manager/session/turn-recorder.d.ts.map +1 -1
  174. package/dist/manager/session/turn-recorder.js +208 -55
  175. package/dist/manager/session/turn-recorder.js.map +1 -1
  176. package/dist/peers/address.d.ts +36 -0
  177. package/dist/peers/address.d.ts.map +1 -0
  178. package/dist/peers/address.js +52 -0
  179. package/dist/peers/address.js.map +1 -0
  180. package/dist/peers/client.d.ts +47 -0
  181. package/dist/peers/client.d.ts.map +1 -0
  182. package/dist/peers/client.js +132 -0
  183. package/dist/peers/client.js.map +1 -0
  184. package/dist/peers/dir.d.ts +88 -0
  185. package/dist/peers/dir.d.ts.map +1 -0
  186. package/dist/peers/dir.js +139 -0
  187. package/dist/peers/dir.js.map +1 -0
  188. package/dist/peers/endpoint.d.ts +144 -0
  189. package/dist/peers/endpoint.d.ts.map +1 -0
  190. package/dist/peers/endpoint.js +420 -0
  191. package/dist/peers/endpoint.js.map +1 -0
  192. package/dist/peers/envelope.d.ts +42 -0
  193. package/dist/peers/envelope.d.ts.map +1 -0
  194. package/dist/peers/envelope.js +110 -0
  195. package/dist/peers/envelope.js.map +1 -0
  196. package/dist/peers/index.d.ts +30 -0
  197. package/dist/peers/index.d.ts.map +1 -0
  198. package/dist/peers/index.js +22 -0
  199. package/dist/peers/index.js.map +1 -0
  200. package/dist/peers/protocol.d.ts +645 -0
  201. package/dist/peers/protocol.d.ts.map +1 -0
  202. package/dist/peers/protocol.js +151 -0
  203. package/dist/peers/protocol.js.map +1 -0
  204. package/dist/peers/record.d.ts +71 -0
  205. package/dist/peers/record.d.ts.map +1 -0
  206. package/dist/peers/record.js +45 -0
  207. package/dist/peers/record.js.map +1 -0
  208. package/dist/peers/registry.d.ts +54 -0
  209. package/dist/peers/registry.d.ts.map +1 -0
  210. package/dist/peers/registry.js +213 -0
  211. package/dist/peers/registry.js.map +1 -0
  212. package/dist/plugin/define.d.ts +24 -0
  213. package/dist/plugin/define.d.ts.map +1 -0
  214. package/dist/plugin/define.js +42 -0
  215. package/dist/plugin/define.js.map +1 -0
  216. package/dist/plugin/index.d.ts +2 -0
  217. package/dist/plugin/index.d.ts.map +1 -1
  218. package/dist/plugin/index.js +1 -0
  219. package/dist/plugin/index.js.map +1 -1
  220. package/dist/plugin/lifecycle.d.ts +27 -3
  221. package/dist/plugin/lifecycle.d.ts.map +1 -1
  222. package/dist/plugin/lifecycle.js +242 -92
  223. package/dist/plugin/lifecycle.js.map +1 -1
  224. package/dist/plugin/resolver.d.ts +2 -2
  225. package/dist/plugin/resolver.d.ts.map +1 -1
  226. package/dist/plugin/resolver.js.map +1 -1
  227. package/dist/plugin/shell-hook.d.ts.map +1 -1
  228. package/dist/plugin/shell-hook.js +17 -3
  229. package/dist/plugin/shell-hook.js.map +1 -1
  230. package/dist/pricing/catalogue.generated.d.ts.map +1 -1
  231. package/dist/pricing/catalogue.generated.js +28 -4
  232. package/dist/pricing/catalogue.generated.js.map +1 -1
  233. package/dist/probe/errors.d.ts +2 -1
  234. package/dist/probe/errors.d.ts.map +1 -1
  235. package/dist/probe/errors.js +3 -2
  236. package/dist/probe/errors.js.map +1 -1
  237. package/dist/prompt/coding-agent-doctrine.d.ts +18 -7
  238. package/dist/prompt/coding-agent-doctrine.d.ts.map +1 -1
  239. package/dist/prompt/coding-agent-doctrine.js +11 -6
  240. package/dist/prompt/coding-agent-doctrine.js.map +1 -1
  241. package/dist/prompt/contributions.d.ts +4 -1
  242. package/dist/prompt/contributions.d.ts.map +1 -1
  243. package/dist/prompt/contributions.js +7 -2
  244. package/dist/prompt/contributions.js.map +1 -1
  245. package/dist/prompt/index.d.ts +1 -1
  246. package/dist/prompt/index.d.ts.map +1 -1
  247. package/dist/prompt/index.js +1 -1
  248. package/dist/prompt/index.js.map +1 -1
  249. package/dist/provider/collect-chat-completion.d.ts +6 -1
  250. package/dist/provider/collect-chat-completion.d.ts.map +1 -1
  251. package/dist/provider/collect-chat-completion.js +88 -10
  252. package/dist/provider/collect-chat-completion.js.map +1 -1
  253. package/dist/provider/mock.d.ts.map +1 -1
  254. package/dist/provider/mock.js +23 -6
  255. package/dist/provider/mock.js.map +1 -1
  256. package/dist/provider/registry.d.ts +2 -1
  257. package/dist/provider/registry.d.ts.map +1 -1
  258. package/dist/provider/registry.js +3 -2
  259. package/dist/provider/registry.js.map +1 -1
  260. package/dist/provider/tool-call-framing.d.ts +164 -0
  261. package/dist/provider/tool-call-framing.d.ts.map +1 -0
  262. package/dist/provider/tool-call-framing.js +163 -0
  263. package/dist/provider/tool-call-framing.js.map +1 -0
  264. package/dist/public-runtime.d.ts +27 -14
  265. package/dist/public-runtime.d.ts.map +1 -1
  266. package/dist/public-runtime.js +49 -11
  267. package/dist/public-runtime.js.map +1 -1
  268. package/dist/public-tools.d.ts +9 -6
  269. package/dist/public-tools.d.ts.map +1 -1
  270. package/dist/public-tools.js +13 -5
  271. package/dist/public-tools.js.map +1 -1
  272. package/dist/public-types.d.ts +16 -5
  273. package/dist/public-types.d.ts.map +1 -1
  274. package/dist/read-model/registry.d.ts +2 -1
  275. package/dist/read-model/registry.d.ts.map +1 -1
  276. package/dist/read-model/registry.js +3 -2
  277. package/dist/read-model/registry.js.map +1 -1
  278. package/dist/registry/ManagedRegistry.d.ts +30 -0
  279. package/dist/registry/ManagedRegistry.d.ts.map +1 -1
  280. package/dist/registry/ManagedRegistry.js +45 -6
  281. package/dist/registry/ManagedRegistry.js.map +1 -1
  282. package/dist/registry/collision.d.ts +57 -0
  283. package/dist/registry/collision.d.ts.map +1 -0
  284. package/dist/registry/collision.js +41 -0
  285. package/dist/registry/collision.js.map +1 -0
  286. package/dist/registry/command/index.d.ts +5 -3
  287. package/dist/registry/command/index.d.ts.map +1 -1
  288. package/dist/registry/command/index.js +6 -4
  289. package/dist/registry/command/index.js.map +1 -1
  290. package/dist/registry/index.d.ts +3 -4
  291. package/dist/registry/index.d.ts.map +1 -1
  292. package/dist/registry/index.js +2 -2
  293. package/dist/registry/index.js.map +1 -1
  294. package/dist/registry/plugin/index.d.ts.map +1 -1
  295. package/dist/registry/plugin/index.js +14 -1
  296. package/dist/registry/plugin/index.js.map +1 -1
  297. package/dist/registry/tool/callable.d.ts +22 -0
  298. package/dist/registry/tool/callable.d.ts.map +1 -0
  299. package/dist/registry/tool/callable.js +28 -0
  300. package/dist/registry/tool/callable.js.map +1 -0
  301. package/dist/registry/tool/execute.d.ts +14 -77
  302. package/dist/registry/tool/execute.d.ts.map +1 -1
  303. package/dist/registry/tool/execute.js +15 -720
  304. package/dist/registry/tool/execute.js.map +1 -1
  305. package/dist/registry/tool/portable.d.ts +25 -0
  306. package/dist/registry/tool/portable.d.ts.map +1 -1
  307. package/dist/registry/tool/portable.js +50 -0
  308. package/dist/registry/tool/portable.js.map +1 -1
  309. package/dist/registry/tool/presentation.d.ts +6 -5
  310. package/dist/registry/tool/presentation.d.ts.map +1 -1
  311. package/dist/registry/tool/presentation.js +3 -3
  312. package/dist/registry/tool/presentation.js.map +1 -1
  313. package/dist/runtime/bidi/session.d.ts +5 -4
  314. package/dist/runtime/bidi/session.d.ts.map +1 -1
  315. package/dist/runtime/bidi/session.js +18 -1
  316. package/dist/runtime/bidi/session.js.map +1 -1
  317. package/dist/runtime/query/executor/tool-call-admission.d.ts +82 -13
  318. package/dist/runtime/query/executor/tool-call-admission.d.ts.map +1 -1
  319. package/dist/runtime/query/executor/tool-call-admission.js +227 -17
  320. package/dist/runtime/query/executor/tool-call-admission.js.map +1 -1
  321. package/dist/runtime/query/executor.d.ts +37 -5
  322. package/dist/runtime/query/executor.d.ts.map +1 -1
  323. package/dist/runtime/query/executor.js +103 -14
  324. package/dist/runtime/query/executor.js.map +1 -1
  325. package/dist/runtime/query/file-evidence-replay.d.ts +1 -1
  326. package/dist/runtime/query/file-evidence-replay.d.ts.map +1 -1
  327. package/dist/runtime/query/file-evidence-replay.js +8 -7
  328. package/dist/runtime/query/file-evidence-replay.js.map +1 -1
  329. package/dist/runtime/query/fork/prepare.d.ts +4 -1
  330. package/dist/runtime/query/fork/prepare.d.ts.map +1 -1
  331. package/dist/runtime/query/fork/prepare.js +4 -0
  332. package/dist/runtime/query/fork/prepare.js.map +1 -1
  333. package/dist/runtime/query/guardrail-presets.d.ts +4 -3
  334. package/dist/runtime/query/guardrail-presets.d.ts.map +1 -1
  335. package/dist/runtime/query/guardrail-presets.js +4 -3
  336. package/dist/runtime/query/guardrail-presets.js.map +1 -1
  337. package/dist/runtime/query/index.d.ts +23 -10
  338. package/dist/runtime/query/index.d.ts.map +1 -1
  339. package/dist/runtime/query/index.js +149 -70
  340. package/dist/runtime/query/index.js.map +1 -1
  341. package/dist/runtime/query/iteration/index.d.ts.map +1 -1
  342. package/dist/runtime/query/iteration/index.js +8 -1
  343. package/dist/runtime/query/iteration/index.js.map +1 -1
  344. package/dist/runtime/query/iteration/phases/compaction.js +1 -1
  345. package/dist/runtime/query/iteration/phases/compaction.js.map +1 -1
  346. package/dist/runtime/query/iteration/phases/context.d.ts +2 -2
  347. package/dist/runtime/query/iteration/phases/context.d.ts.map +1 -1
  348. package/dist/runtime/query/iteration/phases/tool-review.d.ts.map +1 -1
  349. package/dist/runtime/query/iteration/phases/tool-review.js +55 -2
  350. package/dist/runtime/query/iteration/phases/tool-review.js.map +1 -1
  351. package/dist/runtime/query/iteration/stream-turn.d.ts.map +1 -1
  352. package/dist/runtime/query/iteration/stream-turn.js +342 -116
  353. package/dist/runtime/query/iteration/stream-turn.js.map +1 -1
  354. package/dist/runtime/query/iteration/tool-input.d.ts +79 -0
  355. package/dist/runtime/query/iteration/tool-input.d.ts.map +1 -0
  356. package/dist/runtime/query/iteration/tool-input.js +291 -0
  357. package/dist/runtime/query/iteration/tool-input.js.map +1 -0
  358. package/dist/runtime/query/observation-context.d.ts +2 -2
  359. package/dist/runtime/query/observation-context.d.ts.map +1 -1
  360. package/dist/runtime/query/observation-context.js.map +1 -1
  361. package/dist/runtime/query/prelude-lease.d.ts +18 -0
  362. package/dist/runtime/query/prelude-lease.d.ts.map +1 -0
  363. package/dist/runtime/query/prelude-lease.js +121 -0
  364. package/dist/runtime/query/prelude-lease.js.map +1 -0
  365. package/dist/runtime/query/prepare-turn.d.ts.map +1 -1
  366. package/dist/runtime/query/prepare-turn.js +386 -187
  367. package/dist/runtime/query/prepare-turn.js.map +1 -1
  368. package/dist/runtime/query/prompt-cache.d.ts +2 -2
  369. package/dist/runtime/query/prompt-cache.d.ts.map +1 -1
  370. package/dist/runtime/query/prompt.d.ts +2 -2
  371. package/dist/runtime/query/prompt.d.ts.map +1 -1
  372. package/dist/runtime/query/prompt.js +1 -1
  373. package/dist/runtime/query/prompt.js.map +1 -1
  374. package/dist/runtime/query/resume-session.d.ts.map +1 -1
  375. package/dist/runtime/query/resume-session.js +37 -2
  376. package/dist/runtime/query/resume-session.js.map +1 -1
  377. package/dist/runtime/query/review-policy.d.ts +65 -3
  378. package/dist/runtime/query/review-policy.d.ts.map +1 -1
  379. package/dist/runtime/query/review-policy.js +143 -22
  380. package/dist/runtime/query/review-policy.js.map +1 -1
  381. package/dist/runtime/query/tooling.d.ts +3 -2
  382. package/dist/runtime/query/tooling.d.ts.map +1 -1
  383. package/dist/runtime/query/tooling.js.map +1 -1
  384. package/dist/runtime/query/turn-state.d.ts.map +1 -1
  385. package/dist/runtime/query/turn-state.js +5 -0
  386. package/dist/runtime/query/turn-state.js.map +1 -1
  387. package/dist/runtime/system-events.d.ts +112 -0
  388. package/dist/runtime/system-events.d.ts.map +1 -0
  389. package/dist/runtime/system-events.js +183 -0
  390. package/dist/runtime/system-events.js.map +1 -0
  391. package/dist/scheduler/delegating.d.ts +2 -1
  392. package/dist/scheduler/delegating.d.ts.map +1 -1
  393. package/dist/scheduler/delegating.js +3 -2
  394. package/dist/scheduler/delegating.js.map +1 -1
  395. package/dist/skills/index.d.ts +1 -1
  396. package/dist/skills/index.d.ts.map +1 -1
  397. package/dist/skills/index.js +1 -1
  398. package/dist/skills/index.js.map +1 -1
  399. package/dist/skills/registry.d.ts +18 -0
  400. package/dist/skills/registry.d.ts.map +1 -1
  401. package/dist/skills/registry.js +20 -0
  402. package/dist/skills/registry.js.map +1 -1
  403. package/dist/store/evidence/index-page.d.ts +2 -2
  404. package/dist/store/session-log/conformance.d.ts +1 -1
  405. package/dist/store/session-log/conformance.d.ts.map +1 -1
  406. package/dist/store/session-log/conformance.js +49 -8
  407. package/dist/store/session-log/conformance.js.map +1 -1
  408. package/dist/store/session-log/core.d.ts +8 -3
  409. package/dist/store/session-log/core.d.ts.map +1 -1
  410. package/dist/store/session-log/core.js +2 -1
  411. package/dist/store/session-log/core.js.map +1 -1
  412. package/dist/store/session-log/fold.d.ts +12 -0
  413. package/dist/store/session-log/fold.d.ts.map +1 -1
  414. package/dist/store/session-log/fold.js +57 -7
  415. package/dist/store/session-log/fold.js.map +1 -1
  416. package/dist/store/session-log/index.d.ts +2 -2
  417. package/dist/store/session-log/index.d.ts.map +1 -1
  418. package/dist/store/session-log/index.js +1 -1
  419. package/dist/store/session-log/index.js.map +1 -1
  420. package/dist/test-support/toolset.d.ts +19 -0
  421. package/dist/test-support/toolset.d.ts.map +1 -0
  422. package/dist/test-support/toolset.js +20 -0
  423. package/dist/test-support/toolset.js.map +1 -0
  424. package/dist/tools/builtins/bash.d.ts +29 -0
  425. package/dist/tools/builtins/bash.d.ts.map +1 -1
  426. package/dist/tools/builtins/bash.js +19 -9
  427. package/dist/tools/builtins/bash.js.map +1 -1
  428. package/dist/tools/builtins/browser-url.d.ts +1 -1
  429. package/dist/tools/builtins/browser-url.js +1 -1
  430. package/dist/tools/builtins/browser.d.ts +6 -6
  431. package/dist/tools/builtins/computer-use-coordinates.d.ts +65 -0
  432. package/dist/tools/builtins/computer-use-coordinates.d.ts.map +1 -0
  433. package/dist/tools/builtins/computer-use-coordinates.js +123 -0
  434. package/dist/tools/builtins/computer-use-coordinates.js.map +1 -0
  435. package/dist/tools/builtins/computer-use-image.d.ts +77 -0
  436. package/dist/tools/builtins/computer-use-image.d.ts.map +1 -0
  437. package/dist/tools/builtins/computer-use-image.js +223 -0
  438. package/dist/tools/builtins/computer-use-image.js.map +1 -0
  439. package/dist/tools/builtins/computer-use.d.ts +519 -14
  440. package/dist/tools/builtins/computer-use.d.ts.map +1 -1
  441. package/dist/tools/builtins/computer-use.js +1196 -183
  442. package/dist/tools/builtins/computer-use.js.map +1 -1
  443. package/dist/tools/builtins/edit.d.ts.map +1 -1
  444. package/dist/tools/builtins/edit.js +9 -1
  445. package/dist/tools/builtins/edit.js.map +1 -1
  446. package/dist/tools/builtins/index.d.ts +2 -1
  447. package/dist/tools/builtins/index.d.ts.map +1 -1
  448. package/dist/tools/builtins/index.js +1 -1
  449. package/dist/tools/builtins/index.js.map +1 -1
  450. package/dist/tools/builtins/json-string-hint.d.ts +15 -0
  451. package/dist/tools/builtins/json-string-hint.d.ts.map +1 -0
  452. package/dist/tools/builtins/json-string-hint.js +17 -0
  453. package/dist/tools/builtins/json-string-hint.js.map +1 -0
  454. package/dist/tools/builtins/search-tools.d.ts.map +1 -1
  455. package/dist/tools/builtins/search-tools.js +7 -15
  456. package/dist/tools/builtins/search-tools.js.map +1 -1
  457. package/dist/tools/builtins/skill.d.ts +74 -0
  458. package/dist/tools/builtins/skill.d.ts.map +1 -1
  459. package/dist/tools/builtins/skill.js +214 -174
  460. package/dist/tools/builtins/skill.js.map +1 -1
  461. package/dist/tools/builtins/write-file.d.ts.map +1 -1
  462. package/dist/tools/builtins/write-file.js +11 -0
  463. package/dist/tools/builtins/write-file.js.map +1 -1
  464. package/dist/tools/command-shell.d.ts +10 -0
  465. package/dist/tools/command-shell.d.ts.map +1 -1
  466. package/dist/tools/command-shell.js +45 -1
  467. package/dist/tools/command-shell.js.map +1 -1
  468. package/dist/tools/coordinator/agent.d.ts.map +1 -1
  469. package/dist/tools/coordinator/agent.js +5 -0
  470. package/dist/tools/coordinator/agent.js.map +1 -1
  471. package/dist/tools/coordinator/ask-user-question.d.ts.map +1 -1
  472. package/dist/tools/coordinator/ask-user-question.js +26 -13
  473. package/dist/tools/coordinator/ask-user-question.js.map +1 -1
  474. package/dist/tools/coordinator/index.d.ts.map +1 -1
  475. package/dist/tools/coordinator/index.js +5 -0
  476. package/dist/tools/coordinator/index.js.map +1 -1
  477. package/dist/tools/coordinator/question-options.d.ts +78 -0
  478. package/dist/tools/coordinator/question-options.d.ts.map +1 -0
  479. package/dist/tools/coordinator/question-options.js +153 -0
  480. package/dist/tools/coordinator/question-options.js.map +1 -0
  481. package/dist/tools/defineTool.d.ts +12 -0
  482. package/dist/tools/defineTool.d.ts.map +1 -1
  483. package/dist/tools/defineTool.js +24 -0
  484. package/dist/tools/defineTool.js.map +1 -1
  485. package/dist/tools/memory/search.d.ts.map +1 -1
  486. package/dist/tools/memory/search.js +4 -1
  487. package/dist/tools/memory/search.js.map +1 -1
  488. package/dist/tools/memory/update.d.ts.map +1 -1
  489. package/dist/tools/memory/update.js +8 -5
  490. package/dist/tools/memory/update.js.map +1 -1
  491. package/dist/tools/render-nonce.d.ts +47 -0
  492. package/dist/tools/render-nonce.d.ts.map +1 -0
  493. package/dist/tools/render-nonce.js +63 -0
  494. package/dist/tools/render-nonce.js.map +1 -0
  495. package/dist/tools/roster.d.ts +46 -19
  496. package/dist/tools/roster.d.ts.map +1 -1
  497. package/dist/tools/roster.js +63 -33
  498. package/dist/tools/roster.js.map +1 -1
  499. package/dist/tools/schedules/present.d.ts.map +1 -1
  500. package/dist/tools/schedules/present.js +2 -0
  501. package/dist/tools/schedules/present.js.map +1 -1
  502. package/dist/tools/schedules/schedule-tool.d.ts +6 -5
  503. package/dist/tools/schedules/schedule-tool.d.ts.map +1 -1
  504. package/dist/tools/schedules/schedule-tool.js +208 -37
  505. package/dist/tools/schedules/schedule-tool.js.map +1 -1
  506. package/dist/tools/schedules/types.d.ts +120 -6
  507. package/dist/tools/schedules/types.d.ts.map +1 -1
  508. package/dist/tools/trusted-read-only.d.ts +9 -5
  509. package/dist/tools/trusted-read-only.d.ts.map +1 -1
  510. package/dist/tools/trusted-read-only.js +14 -10
  511. package/dist/tools/trusted-read-only.js.map +1 -1
  512. package/dist/tools/untrusted-envelope.d.ts +67 -28
  513. package/dist/tools/untrusted-envelope.d.ts.map +1 -1
  514. package/dist/tools/untrusted-envelope.js +108 -59
  515. package/dist/tools/untrusted-envelope.js.map +1 -1
  516. package/dist/toolsets/combine.d.ts +44 -0
  517. package/dist/toolsets/combine.d.ts.map +1 -0
  518. package/dist/toolsets/combine.js +153 -0
  519. package/dist/toolsets/combine.js.map +1 -0
  520. package/dist/toolsets/manager.d.ts +201 -0
  521. package/dist/toolsets/manager.d.ts.map +1 -0
  522. package/dist/toolsets/manager.js +837 -0
  523. package/dist/toolsets/manager.js.map +1 -0
  524. package/dist/toolsets/source-glob.d.ts +15 -0
  525. package/dist/toolsets/source-glob.d.ts.map +1 -0
  526. package/dist/toolsets/source-glob.js +23 -0
  527. package/dist/toolsets/source-glob.js.map +1 -0
  528. package/dist/toolsets/toolset.d.ts +20 -0
  529. package/dist/toolsets/toolset.d.ts.map +1 -0
  530. package/dist/toolsets/toolset.js +28 -0
  531. package/dist/toolsets/toolset.js.map +1 -0
  532. package/dist/toolsets/types.d.ts +128 -0
  533. package/dist/toolsets/types.d.ts.map +1 -0
  534. package/dist/toolsets/types.js +33 -0
  535. package/dist/toolsets/types.js.map +1 -0
  536. package/dist/toolsets/wrappers.d.ts +59 -0
  537. package/dist/toolsets/wrappers.d.ts.map +1 -0
  538. package/dist/toolsets/wrappers.js +165 -0
  539. package/dist/toolsets/wrappers.js.map +1 -0
  540. package/dist/types/agent/base.d.ts +27 -16
  541. package/dist/types/agent/base.d.ts.map +1 -1
  542. package/dist/types/agent/index.d.ts +1 -0
  543. package/dist/types/agent/index.d.ts.map +1 -1
  544. package/dist/types/agent/index.js +1 -0
  545. package/dist/types/agent/index.js.map +1 -1
  546. package/dist/types/agent/pipeline.d.ts +2 -0
  547. package/dist/types/agent/pipeline.d.ts.map +1 -1
  548. package/dist/types/agent/query.d.ts +117 -0
  549. package/dist/types/agent/query.d.ts.map +1 -0
  550. package/dist/types/agent/query.js +2 -0
  551. package/dist/types/agent/query.js.map +1 -0
  552. package/dist/types/agent/reactive.d.ts +2 -129
  553. package/dist/types/agent/reactive.d.ts.map +1 -1
  554. package/dist/types/agent/router.d.ts +2 -0
  555. package/dist/types/agent/router.d.ts.map +1 -1
  556. package/dist/types/agent/supervisor.d.ts +5 -2
  557. package/dist/types/agent/supervisor.d.ts.map +1 -1
  558. package/dist/types/authorization/index.d.ts +70 -12
  559. package/dist/types/authorization/index.d.ts.map +1 -1
  560. package/dist/types/authorization/index.js +11 -0
  561. package/dist/types/authorization/index.js.map +1 -1
  562. package/dist/types/computer-use/index.d.ts +176 -0
  563. package/dist/types/computer-use/index.d.ts.map +1 -1
  564. package/dist/types/computer-use/index.js.map +1 -1
  565. package/dist/types/connector/mcp.d.ts +32 -0
  566. package/dist/types/connector/mcp.d.ts.map +1 -1
  567. package/dist/types/errors/index.d.ts +15 -0
  568. package/dist/types/errors/index.d.ts.map +1 -1
  569. package/dist/types/errors/index.js.map +1 -1
  570. package/dist/types/hitl/index.d.ts +57 -0
  571. package/dist/types/hitl/index.d.ts.map +1 -1
  572. package/dist/types/hitl/index.js.map +1 -1
  573. package/dist/types/message/index.d.ts +130 -9
  574. package/dist/types/message/index.d.ts.map +1 -1
  575. package/dist/types/message/index.js +4 -1
  576. package/dist/types/message/index.js.map +1 -1
  577. package/dist/types/plugin/index.d.ts +22 -4
  578. package/dist/types/plugin/index.d.ts.map +1 -1
  579. package/dist/types/plugin/index.js +1 -0
  580. package/dist/types/plugin/index.js.map +1 -1
  581. package/dist/types/provider/chat.d.ts +5 -0
  582. package/dist/types/provider/chat.d.ts.map +1 -1
  583. package/dist/types/provider/config.d.ts +8 -3
  584. package/dist/types/provider/config.d.ts.map +1 -1
  585. package/dist/types/provider/stream.d.ts +39 -0
  586. package/dist/types/provider/stream.d.ts.map +1 -1
  587. package/dist/types/sandbox/index.d.ts +1 -1
  588. package/dist/types/session/events.d.ts +14 -3
  589. package/dist/types/session/events.d.ts.map +1 -1
  590. package/dist/types/session/events.js.map +1 -1
  591. package/dist/types/tool/index.d.ts +171 -91
  592. package/dist/types/tool/index.d.ts.map +1 -1
  593. package/dist/types/tool/index.js.map +1 -1
  594. package/dist/types/toolset/index.d.ts +10 -40
  595. package/dist/types/toolset/index.d.ts.map +1 -1
  596. package/package.json +3 -1
  597. package/src/advisory/history.ts +27 -2
  598. package/src/advisory/index.ts +1 -1
  599. package/src/advisory/registry.ts +33 -0
  600. package/src/agents/AGENTS.md +14 -7
  601. package/src/agents/PipelineAgent.ts +2 -303
  602. package/src/agents/QueryAgent.ts +269 -0
  603. package/src/agents/ReactiveAgent.ts +6 -216
  604. package/src/agents/RouterAgent.ts +2 -337
  605. package/src/agents/SupervisorAgent.ts +3 -476
  606. package/src/agents/defineAgent.ts +13 -2
  607. package/src/agents/examples/PipelineAgent.ts +302 -0
  608. package/src/agents/examples/RouterAgent.ts +338 -0
  609. package/src/agents/examples/SupervisorAgent.ts +472 -0
  610. package/src/agents/explore.ts +6 -3
  611. package/src/agents/forward-options.ts +37 -0
  612. package/src/agents/index.ts +2 -0
  613. package/src/agents/runAgent.ts +144 -37
  614. package/src/authorization/command-line.ts +2 -2
  615. package/src/authorization/gate.ts +46 -5
  616. package/src/authorization/program.ts +773 -0
  617. package/src/authorization/reexec-wrapper.ts +589 -0
  618. package/src/authorization/rules.ts +36 -1
  619. package/src/authorization/shell-lexer.ts +136 -63
  620. package/src/bridge/sse/mapper.ts +6 -0
  621. package/src/capabilities/index.ts +157 -0
  622. package/src/config/registry.ts +4 -1
  623. package/src/connector/index.ts +9 -2
  624. package/src/connector/mcp/adapter.ts +58 -3
  625. package/src/connector/mcp/client.ts +20 -4
  626. package/src/connector/mcp/discovery.ts +60 -0
  627. package/src/connector/mcp/index.ts +13 -0
  628. package/src/connector/mcp/mcp-toolset.ts +515 -0
  629. package/src/connector/tools/index.ts +2 -2
  630. package/src/connector/tools/router.ts +35 -58
  631. package/src/directory/derive-supervisor.ts +12 -8
  632. package/src/directory/derive.ts +8 -5
  633. package/src/execution/code-runtime/types.ts +2 -2
  634. package/src/invariants/index.ts +4 -1
  635. package/src/manager/agent/lifecycle.ts +9 -0
  636. package/src/manager/connector/environment.ts +17 -4
  637. package/src/manager/connector/index.ts +2 -2
  638. package/src/manager/connector/tenant.ts +17 -4
  639. package/src/manager/index.ts +2 -2
  640. package/src/manager/session/attribution.ts +79 -0
  641. package/src/manager/session/turn-recorder.ts +211 -55
  642. package/src/peers/address.ts +58 -0
  643. package/src/peers/client.ts +202 -0
  644. package/src/peers/dir.ts +176 -0
  645. package/src/peers/endpoint.ts +564 -0
  646. package/src/peers/envelope.ts +121 -0
  647. package/src/peers/index.ts +96 -0
  648. package/src/peers/protocol.ts +196 -0
  649. package/src/peers/record.ts +56 -0
  650. package/src/peers/registry.ts +241 -0
  651. package/src/plugin/define.ts +68 -0
  652. package/src/plugin/index.ts +2 -0
  653. package/src/plugin/lifecycle.ts +286 -106
  654. package/src/plugin/resolver.ts +6 -3
  655. package/src/plugin/shell-hook.ts +21 -5
  656. package/src/pricing/catalogue.generated.ts +28 -4
  657. package/src/pricing/rates.source.json +27 -6
  658. package/src/probe/errors.ts +4 -1
  659. package/src/prompt/coding-agent-doctrine.ts +22 -10
  660. package/src/prompt/contributions.ts +12 -2
  661. package/src/prompt/index.ts +1 -0
  662. package/src/provider/collect-chat-completion.ts +96 -11
  663. package/src/provider/mock.ts +24 -6
  664. package/src/provider/registry.ts +4 -1
  665. package/src/provider/tool-call-framing.ts +226 -0
  666. package/src/public-runtime.ts +152 -9
  667. package/src/public-tools.ts +43 -5
  668. package/src/public-types.ts +65 -6
  669. package/src/read-model/registry.ts +7 -2
  670. package/src/registry/ManagedRegistry.ts +57 -6
  671. package/src/registry/collision.ts +64 -0
  672. package/src/registry/command/index.ts +7 -3
  673. package/src/registry/index.ts +3 -9
  674. package/src/registry/plugin/index.ts +14 -1
  675. package/src/registry/tool/callable.ts +36 -0
  676. package/src/registry/tool/execute.ts +16 -839
  677. package/src/registry/tool/portable.ts +59 -0
  678. package/src/registry/tool/presentation.ts +6 -5
  679. package/src/runtime/bidi/session.ts +24 -5
  680. package/src/runtime/query/executor/tool-call-admission.ts +288 -22
  681. package/src/runtime/query/executor.ts +129 -16
  682. package/src/runtime/query/file-evidence-replay.ts +8 -7
  683. package/src/runtime/query/fork/prepare.ts +6 -1
  684. package/src/runtime/query/guardrail-presets.ts +4 -3
  685. package/src/runtime/query/index.ts +199 -101
  686. package/src/runtime/query/iteration/index.ts +13 -3
  687. package/src/runtime/query/iteration/phases/compaction.ts +1 -1
  688. package/src/runtime/query/iteration/phases/context.ts +2 -2
  689. package/src/runtime/query/iteration/phases/tool-review.ts +59 -2
  690. package/src/runtime/query/iteration/stream-turn.ts +390 -136
  691. package/src/runtime/query/iteration/tool-input.ts +284 -0
  692. package/src/runtime/query/observation-context.ts +2 -2
  693. package/src/runtime/query/prelude-lease.ts +132 -0
  694. package/src/runtime/query/prepare-turn.ts +477 -198
  695. package/src/runtime/query/prompt-cache.ts +2 -2
  696. package/src/runtime/query/prompt.ts +4 -4
  697. package/src/runtime/query/resume-session.ts +42 -3
  698. package/src/runtime/query/review-policy.ts +190 -24
  699. package/src/runtime/query/tooling.ts +3 -6
  700. package/src/runtime/query/turn-state.ts +4 -0
  701. package/src/runtime/system-events.ts +246 -0
  702. package/src/scheduler/delegating.ts +7 -2
  703. package/src/skills/index.ts +1 -1
  704. package/src/skills/registry.ts +33 -0
  705. package/src/store/session-log/conformance.ts +51 -8
  706. package/src/store/session-log/core.ts +10 -4
  707. package/src/store/session-log/fold.ts +33 -7
  708. package/src/store/session-log/index.ts +2 -0
  709. package/src/test-support/toolset.ts +23 -0
  710. package/src/tools/builtins/bash.ts +27 -10
  711. package/src/tools/builtins/browser-url.ts +1 -1
  712. package/src/tools/builtins/computer-use-coordinates.ts +144 -0
  713. package/src/tools/builtins/computer-use-image.ts +278 -0
  714. package/src/tools/builtins/computer-use.ts +1495 -191
  715. package/src/tools/builtins/edit.ts +12 -2
  716. package/src/tools/builtins/index.ts +7 -1
  717. package/src/tools/builtins/json-string-hint.ts +16 -0
  718. package/src/tools/builtins/search-tools.ts +7 -20
  719. package/src/tools/builtins/skill.ts +304 -174
  720. package/src/tools/builtins/write-file.ts +12 -0
  721. package/src/tools/command-shell.ts +46 -1
  722. package/src/tools/coordinator/agent.ts +6 -0
  723. package/src/tools/coordinator/ask-user-question.ts +29 -15
  724. package/src/tools/coordinator/index.ts +6 -0
  725. package/src/tools/coordinator/question-options.ts +195 -0
  726. package/src/tools/defineTool.ts +38 -0
  727. package/src/tools/memory/search.ts +4 -1
  728. package/src/tools/memory/update.ts +8 -5
  729. package/src/tools/render-nonce.ts +69 -0
  730. package/src/tools/roster.ts +84 -33
  731. package/src/tools/schedules/present.ts +2 -0
  732. package/src/tools/schedules/schedule-tool.ts +238 -39
  733. package/src/tools/schedules/types.ts +120 -6
  734. package/src/tools/trusted-read-only.ts +19 -10
  735. package/src/tools/untrusted-envelope.ts +121 -57
  736. package/src/toolsets/combine.ts +181 -0
  737. package/src/toolsets/manager.ts +996 -0
  738. package/src/toolsets/source-glob.ts +22 -0
  739. package/src/toolsets/toolset.ts +31 -0
  740. package/src/toolsets/types.ts +154 -0
  741. package/src/toolsets/wrappers.ts +191 -0
  742. package/src/types/agent/base.ts +29 -16
  743. package/src/types/agent/index.ts +1 -0
  744. package/src/types/agent/pipeline.ts +2 -0
  745. package/src/types/agent/query.ts +129 -0
  746. package/src/types/agent/reactive.ts +5 -142
  747. package/src/types/agent/router.ts +2 -0
  748. package/src/types/agent/supervisor.ts +5 -2
  749. package/src/types/authorization/index.ts +33 -0
  750. package/src/types/computer-use/index.ts +202 -0
  751. package/src/types/connector/mcp.ts +32 -0
  752. package/src/types/errors/index.ts +15 -0
  753. package/src/types/hitl/index.ts +57 -0
  754. package/src/types/message/index.ts +135 -7
  755. package/src/types/plugin/index.ts +44 -21
  756. package/src/types/provider/chat.ts +5 -0
  757. package/src/types/provider/config.ts +8 -3
  758. package/src/types/provider/stream.ts +39 -0
  759. package/src/types/sandbox/index.ts +1 -1
  760. package/src/types/session/events.ts +14 -3
  761. package/src/types/tool/index.ts +173 -105
  762. package/src/types/toolset/index.ts +10 -47
  763. package/dist/registry/toolset/catalog.d.ts +0 -42
  764. package/dist/registry/toolset/catalog.d.ts.map +0 -1
  765. package/dist/registry/toolset/catalog.js +0 -234
  766. package/dist/registry/toolset/catalog.js.map +0 -1
  767. package/src/registry/toolset/catalog.ts +0 -308
@@ -1,19 +1,111 @@
1
1
  import { z } from 'zod';
2
2
  import type { ComputerUseHost } from '../../types/computer-use/index.js';
3
+ import type { LLMProvider } from '../../types/provider/index.js';
3
4
  import type { ToolDefinition } from '../../types/tool/index.js';
5
+ import { type ScreenshotLimits } from './computer-use-image.js';
6
+ export { HIGH_RES_SCREENSHOT_LIMITS, STANDARD_SCREENSHOT_LIMITS, screenshotTargetSize, } from './computer-use-image.js';
7
+ export type { ImageSize, ScreenshotLimits } from './computer-use-image.js';
4
8
  export declare const COMPUTER_USE_TOOL_NAME: "computer_use";
9
+ /**
10
+ * How `createComputerUseTool` sizes screenshots, paces actions and bounds a
11
+ * batch. Every field is optional.
12
+ */
13
+ export interface ComputerUseToolOptions {
14
+ /**
15
+ * What every screenshot and zoom image is fitted to before the model sees
16
+ * it. Default {@link STANDARD_SCREENSHOT_LIMITS}, which every current vision
17
+ * model takes without a further resize; {@link HIGH_RES_SCREENSHOT_LIMITS}
18
+ * only when every model the session can reach is on that tier.
19
+ */
20
+ readonly screenshotLimits?: ScreenshotLimits;
21
+ /**
22
+ * Milliseconds to wait after an action before the screenshot it returns,
23
+ * so a menu has opened or a page has started to paint. Default 500.
24
+ */
25
+ readonly settleMs?: number;
26
+ /**
27
+ * Return a fresh screenshot after every call that changed something.
28
+ * Default true. Off, a model has to ask for one — an extra round trip per
29
+ * action, which is what this exists to remove.
30
+ */
31
+ readonly screenshotAfterActions?: boolean;
32
+ /** Most actions one `batch` may carry. Default 20. */
33
+ readonly maxBatchActions?: number;
34
+ /** Longest single `wait`, in milliseconds. Default 10 000. */
35
+ readonly maxWaitMs?: number;
36
+ /**
37
+ * Why computer use cannot work in this session although the host could —
38
+ * typically that the provider cannot put an image in a tool result, so the
39
+ * model would never see a screenshot (see
40
+ * {@link computerUseUnavailableReason}). Set, the tool mounts as a
41
+ * diagnostic: its description says why and every call is refused without
42
+ * touching the host.
43
+ */
44
+ readonly unavailableReason?: string;
45
+ }
46
+ /**
47
+ * Why `provider` cannot drive `computer_use`, or undefined when it can.
48
+ *
49
+ * The tool's only way to show the model the screen is an image in a tool
50
+ * result. A driver that declares `supportsToolResultImages: false` replaces
51
+ * that image with a line of text, so the model acts on a screen it has never
52
+ * seen while every call reports success. Pass the answer to
53
+ * {@link ComputerUseToolOptions.unavailableReason}.
54
+ */
55
+ export declare function computerUseUnavailableReason(provider: Pick<LLMProvider, 'id' | 'capabilities'>): string | undefined;
5
56
  declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
6
57
  type: z.ZodLiteral<"screenshot">;
7
58
  }, "strip", z.ZodTypeAny, {
8
59
  type: "screenshot";
9
60
  }, {
10
61
  type: "screenshot";
62
+ }>, z.ZodObject<{
63
+ screenshot_id: z.ZodOptional<z.ZodString>;
64
+ type: z.ZodLiteral<"zoom">;
65
+ region: z.ZodObject<{
66
+ x: z.ZodNumber;
67
+ y: z.ZodNumber;
68
+ width: z.ZodNumber;
69
+ height: z.ZodNumber;
70
+ }, "strip", z.ZodTypeAny, {
71
+ y: number;
72
+ x: number;
73
+ width: number;
74
+ height: number;
75
+ }, {
76
+ y: number;
77
+ x: number;
78
+ width: number;
79
+ height: number;
80
+ }>;
81
+ }, "strip", z.ZodTypeAny, {
82
+ type: "zoom";
83
+ region: {
84
+ y: number;
85
+ x: number;
86
+ width: number;
87
+ height: number;
88
+ };
89
+ screenshot_id?: string | undefined;
90
+ }, {
91
+ type: "zoom";
92
+ region: {
93
+ y: number;
94
+ x: number;
95
+ width: number;
96
+ height: number;
97
+ };
98
+ screenshot_id?: string | undefined;
11
99
  }>, z.ZodObject<{
12
100
  type: z.ZodLiteral<"cursor_position">;
101
+ } & {
102
+ screenshot_id: z.ZodOptional<z.ZodString>;
13
103
  }, "strip", z.ZodTypeAny, {
14
104
  type: "cursor_position";
105
+ screenshot_id?: string | undefined;
15
106
  }, {
16
107
  type: "cursor_position";
108
+ screenshot_id?: string | undefined;
17
109
  }>, z.ZodObject<{
18
110
  type: z.ZodLiteral<"mouse_move">;
19
111
  to: z.ZodObject<{
@@ -26,18 +118,22 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
26
118
  y: number;
27
119
  x: number;
28
120
  }>;
121
+ } & {
122
+ screenshot_id: z.ZodOptional<z.ZodString>;
29
123
  }, "strip", z.ZodTypeAny, {
30
124
  type: "mouse_move";
31
125
  to: {
32
126
  y: number;
33
127
  x: number;
34
128
  };
129
+ screenshot_id?: string | undefined;
35
130
  }, {
36
131
  type: "mouse_move";
37
132
  to: {
38
133
  y: number;
39
134
  x: number;
40
135
  };
136
+ screenshot_id?: string | undefined;
41
137
  }>, z.ZodObject<{
42
138
  type: z.ZodLiteral<"mouse_click">;
43
139
  at: z.ZodObject<{
@@ -50,7 +146,9 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
50
146
  y: number;
51
147
  x: number;
52
148
  }>;
53
- button: z.ZodEnum<["left", "right", "middle"]>;
149
+ button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
150
+ } & {
151
+ screenshot_id: z.ZodOptional<z.ZodString>;
54
152
  }, "strip", z.ZodTypeAny, {
55
153
  at: {
56
154
  y: number;
@@ -58,13 +156,15 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
58
156
  };
59
157
  type: "mouse_click";
60
158
  button: "left" | "right" | "middle";
159
+ screenshot_id?: string | undefined;
61
160
  }, {
62
161
  at: {
63
162
  y: number;
64
163
  x: number;
65
164
  };
66
165
  type: "mouse_click";
67
- button: "left" | "right" | "middle";
166
+ button?: "left" | "right" | "middle" | undefined;
167
+ screenshot_id?: string | undefined;
68
168
  }>, z.ZodObject<{
69
169
  type: z.ZodLiteral<"mouse_drag">;
70
170
  from: z.ZodObject<{
@@ -87,7 +187,9 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
87
187
  y: number;
88
188
  x: number;
89
189
  }>;
90
- button: z.ZodEnum<["left", "right", "middle"]>;
190
+ button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
191
+ } & {
192
+ screenshot_id: z.ZodOptional<z.ZodString>;
91
193
  }, "strip", z.ZodTypeAny, {
92
194
  type: "mouse_drag";
93
195
  from: {
@@ -99,6 +201,7 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
99
201
  x: number;
100
202
  };
101
203
  button: "left" | "right" | "middle";
204
+ screenshot_id?: string | undefined;
102
205
  }, {
103
206
  type: "mouse_drag";
104
207
  from: {
@@ -109,7 +212,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
109
212
  y: number;
110
213
  x: number;
111
214
  };
112
- button: "left" | "right" | "middle";
215
+ button?: "left" | "right" | "middle" | undefined;
216
+ screenshot_id?: string | undefined;
113
217
  }>, z.ZodObject<{
114
218
  type: z.ZodLiteral<"scroll">;
115
219
  at: z.ZodObject<{
@@ -124,6 +228,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
124
228
  }>;
125
229
  direction: z.ZodEnum<["up", "down", "left", "right"]>;
126
230
  amount: z.ZodNumber;
231
+ } & {
232
+ screenshot_id: z.ZodOptional<z.ZodString>;
127
233
  }, "strip", z.ZodTypeAny, {
128
234
  at: {
129
235
  y: number;
@@ -132,6 +238,7 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
132
238
  type: "scroll";
133
239
  amount: number;
134
240
  direction: "left" | "right" | "up" | "down";
241
+ screenshot_id?: string | undefined;
135
242
  }, {
136
243
  at: {
137
244
  y: number;
@@ -140,43 +247,442 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
140
247
  type: "scroll";
141
248
  amount: number;
142
249
  direction: "left" | "right" | "up" | "down";
250
+ screenshot_id?: string | undefined;
143
251
  }>, z.ZodObject<{
144
252
  type: z.ZodLiteral<"type_text">;
145
253
  text: z.ZodString;
254
+ } & {
255
+ screenshot_id: z.ZodOptional<z.ZodString>;
146
256
  }, "strip", z.ZodTypeAny, {
147
257
  text: string;
148
258
  type: "type_text";
259
+ screenshot_id?: string | undefined;
149
260
  }, {
150
261
  text: string;
151
262
  type: "type_text";
263
+ screenshot_id?: string | undefined;
152
264
  }>, z.ZodObject<{
153
265
  type: z.ZodLiteral<"key">;
154
266
  keys: z.ZodString;
267
+ } & {
268
+ screenshot_id: z.ZodOptional<z.ZodString>;
155
269
  }, "strip", z.ZodTypeAny, {
156
270
  keys: string;
157
271
  type: "key";
272
+ screenshot_id?: string | undefined;
158
273
  }, {
159
274
  keys: string;
160
275
  type: "key";
276
+ screenshot_id?: string | undefined;
277
+ }>, z.ZodObject<{
278
+ type: z.ZodLiteral<"wait">;
279
+ ms: z.ZodNumber;
280
+ } & {
281
+ screenshot_id: z.ZodOptional<z.ZodString>;
282
+ }, "strip", z.ZodTypeAny, {
283
+ type: "wait";
284
+ ms: number;
285
+ screenshot_id?: string | undefined;
286
+ }, {
287
+ type: "wait";
288
+ ms: number;
289
+ screenshot_id?: string | undefined;
290
+ }>, z.ZodObject<{
291
+ type: z.ZodLiteral<"list_windows">;
292
+ } & {
293
+ screenshot_id: z.ZodOptional<z.ZodString>;
294
+ }, "strip", z.ZodTypeAny, {
295
+ type: "list_windows";
296
+ screenshot_id?: string | undefined;
297
+ }, {
298
+ type: "list_windows";
299
+ screenshot_id?: string | undefined;
300
+ }>, z.ZodObject<{
301
+ type: z.ZodLiteral<"focus_window">;
302
+ window_id: z.ZodString;
303
+ } & {
304
+ screenshot_id: z.ZodOptional<z.ZodString>;
305
+ }, "strip", z.ZodTypeAny, {
306
+ type: "focus_window";
307
+ window_id: string;
308
+ screenshot_id?: string | undefined;
309
+ }, {
310
+ type: "focus_window";
311
+ window_id: string;
312
+ screenshot_id?: string | undefined;
313
+ }>, z.ZodObject<{
314
+ type: z.ZodLiteral<"ui_snapshot">;
315
+ window_id: z.ZodOptional<z.ZodString>;
316
+ }, "strip", z.ZodTypeAny, {
317
+ type: "ui_snapshot";
318
+ window_id?: string | undefined;
319
+ }, {
320
+ type: "ui_snapshot";
321
+ window_id?: string | undefined;
322
+ }>, z.ZodObject<{
323
+ type: z.ZodLiteral<"ui_act">;
324
+ ref: z.ZodString;
325
+ action: z.ZodEnum<["invoke", "set_value", "toggle", "select", "expand", "collapse", "focus", "scroll_into_view"]>;
326
+ value: z.ZodOptional<z.ZodString>;
327
+ } & {
328
+ screenshot_id: z.ZodOptional<z.ZodString>;
329
+ }, "strip", z.ZodTypeAny, {
330
+ type: "ui_act";
331
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
332
+ ref: string;
333
+ value?: string | undefined;
334
+ screenshot_id?: string | undefined;
335
+ }, {
336
+ type: "ui_act";
337
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
338
+ ref: string;
339
+ value?: string | undefined;
340
+ screenshot_id?: string | undefined;
341
+ }>, z.ZodObject<{
342
+ screenshot_id: z.ZodOptional<z.ZodString>;
343
+ type: z.ZodLiteral<"batch">;
344
+ actions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
345
+ type: z.ZodLiteral<"cursor_position">;
346
+ }, "strip", z.ZodTypeAny, {
347
+ type: "cursor_position";
348
+ }, {
349
+ type: "cursor_position";
350
+ }>, z.ZodObject<{
351
+ type: z.ZodLiteral<"mouse_move">;
352
+ to: z.ZodObject<{
353
+ x: z.ZodNumber;
354
+ y: z.ZodNumber;
355
+ }, "strip", z.ZodTypeAny, {
356
+ y: number;
357
+ x: number;
358
+ }, {
359
+ y: number;
360
+ x: number;
361
+ }>;
362
+ }, "strip", z.ZodTypeAny, {
363
+ type: "mouse_move";
364
+ to: {
365
+ y: number;
366
+ x: number;
367
+ };
368
+ }, {
369
+ type: "mouse_move";
370
+ to: {
371
+ y: number;
372
+ x: number;
373
+ };
374
+ }>, z.ZodObject<{
375
+ type: z.ZodLiteral<"mouse_click">;
376
+ at: z.ZodObject<{
377
+ x: z.ZodNumber;
378
+ y: z.ZodNumber;
379
+ }, "strip", z.ZodTypeAny, {
380
+ y: number;
381
+ x: number;
382
+ }, {
383
+ y: number;
384
+ x: number;
385
+ }>;
386
+ button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
387
+ }, "strip", z.ZodTypeAny, {
388
+ at: {
389
+ y: number;
390
+ x: number;
391
+ };
392
+ type: "mouse_click";
393
+ button: "left" | "right" | "middle";
394
+ }, {
395
+ at: {
396
+ y: number;
397
+ x: number;
398
+ };
399
+ type: "mouse_click";
400
+ button?: "left" | "right" | "middle" | undefined;
401
+ }>, z.ZodObject<{
402
+ type: z.ZodLiteral<"mouse_drag">;
403
+ from: z.ZodObject<{
404
+ x: z.ZodNumber;
405
+ y: z.ZodNumber;
406
+ }, "strip", z.ZodTypeAny, {
407
+ y: number;
408
+ x: number;
409
+ }, {
410
+ y: number;
411
+ x: number;
412
+ }>;
413
+ to: z.ZodObject<{
414
+ x: z.ZodNumber;
415
+ y: z.ZodNumber;
416
+ }, "strip", z.ZodTypeAny, {
417
+ y: number;
418
+ x: number;
419
+ }, {
420
+ y: number;
421
+ x: number;
422
+ }>;
423
+ button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
424
+ }, "strip", z.ZodTypeAny, {
425
+ type: "mouse_drag";
426
+ from: {
427
+ y: number;
428
+ x: number;
429
+ };
430
+ to: {
431
+ y: number;
432
+ x: number;
433
+ };
434
+ button: "left" | "right" | "middle";
435
+ }, {
436
+ type: "mouse_drag";
437
+ from: {
438
+ y: number;
439
+ x: number;
440
+ };
441
+ to: {
442
+ y: number;
443
+ x: number;
444
+ };
445
+ button?: "left" | "right" | "middle" | undefined;
446
+ }>, z.ZodObject<{
447
+ type: z.ZodLiteral<"scroll">;
448
+ at: z.ZodObject<{
449
+ x: z.ZodNumber;
450
+ y: z.ZodNumber;
451
+ }, "strip", z.ZodTypeAny, {
452
+ y: number;
453
+ x: number;
454
+ }, {
455
+ y: number;
456
+ x: number;
457
+ }>;
458
+ direction: z.ZodEnum<["up", "down", "left", "right"]>;
459
+ amount: z.ZodNumber;
460
+ }, "strip", z.ZodTypeAny, {
461
+ at: {
462
+ y: number;
463
+ x: number;
464
+ };
465
+ type: "scroll";
466
+ amount: number;
467
+ direction: "left" | "right" | "up" | "down";
468
+ }, {
469
+ at: {
470
+ y: number;
471
+ x: number;
472
+ };
473
+ type: "scroll";
474
+ amount: number;
475
+ direction: "left" | "right" | "up" | "down";
476
+ }>, z.ZodObject<{
477
+ type: z.ZodLiteral<"type_text">;
478
+ text: z.ZodString;
479
+ }, "strip", z.ZodTypeAny, {
480
+ text: string;
481
+ type: "type_text";
482
+ }, {
483
+ text: string;
484
+ type: "type_text";
485
+ }>, z.ZodObject<{
486
+ type: z.ZodLiteral<"key">;
487
+ keys: z.ZodString;
488
+ }, "strip", z.ZodTypeAny, {
489
+ keys: string;
490
+ type: "key";
491
+ }, {
492
+ keys: string;
493
+ type: "key";
494
+ }>, z.ZodObject<{
495
+ type: z.ZodLiteral<"wait">;
496
+ ms: z.ZodNumber;
497
+ }, "strip", z.ZodTypeAny, {
498
+ type: "wait";
499
+ ms: number;
500
+ }, {
501
+ type: "wait";
502
+ ms: number;
503
+ }>, z.ZodObject<{
504
+ type: z.ZodLiteral<"list_windows">;
505
+ }, "strip", z.ZodTypeAny, {
506
+ type: "list_windows";
507
+ }, {
508
+ type: "list_windows";
509
+ }>, z.ZodObject<{
510
+ type: z.ZodLiteral<"focus_window">;
511
+ window_id: z.ZodString;
512
+ }, "strip", z.ZodTypeAny, {
513
+ type: "focus_window";
514
+ window_id: string;
515
+ }, {
516
+ type: "focus_window";
517
+ window_id: string;
518
+ }>, z.ZodObject<{
519
+ type: z.ZodLiteral<"ui_act">;
520
+ ref: z.ZodString;
521
+ action: z.ZodEnum<["invoke", "set_value", "toggle", "select", "expand", "collapse", "focus", "scroll_into_view"]>;
522
+ value: z.ZodOptional<z.ZodString>;
523
+ }, "strip", z.ZodTypeAny, {
524
+ type: "ui_act";
525
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
526
+ ref: string;
527
+ value?: string | undefined;
528
+ }, {
529
+ type: "ui_act";
530
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
531
+ ref: string;
532
+ value?: string | undefined;
533
+ }>]>, "many">;
534
+ }, "strip", z.ZodTypeAny, {
535
+ type: "batch";
536
+ actions: ({
537
+ type: "cursor_position";
538
+ } | {
539
+ type: "mouse_move";
540
+ to: {
541
+ y: number;
542
+ x: number;
543
+ };
544
+ } | {
545
+ at: {
546
+ y: number;
547
+ x: number;
548
+ };
549
+ type: "mouse_click";
550
+ button: "left" | "right" | "middle";
551
+ } | {
552
+ type: "mouse_drag";
553
+ from: {
554
+ y: number;
555
+ x: number;
556
+ };
557
+ to: {
558
+ y: number;
559
+ x: number;
560
+ };
561
+ button: "left" | "right" | "middle";
562
+ } | {
563
+ at: {
564
+ y: number;
565
+ x: number;
566
+ };
567
+ type: "scroll";
568
+ amount: number;
569
+ direction: "left" | "right" | "up" | "down";
570
+ } | {
571
+ text: string;
572
+ type: "type_text";
573
+ } | {
574
+ keys: string;
575
+ type: "key";
576
+ } | {
577
+ type: "wait";
578
+ ms: number;
579
+ } | {
580
+ type: "list_windows";
581
+ } | {
582
+ type: "focus_window";
583
+ window_id: string;
584
+ } | {
585
+ type: "ui_act";
586
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
587
+ ref: string;
588
+ value?: string | undefined;
589
+ })[];
590
+ screenshot_id?: string | undefined;
591
+ }, {
592
+ type: "batch";
593
+ actions: ({
594
+ type: "cursor_position";
595
+ } | {
596
+ type: "mouse_move";
597
+ to: {
598
+ y: number;
599
+ x: number;
600
+ };
601
+ } | {
602
+ at: {
603
+ y: number;
604
+ x: number;
605
+ };
606
+ type: "mouse_click";
607
+ button?: "left" | "right" | "middle" | undefined;
608
+ } | {
609
+ type: "mouse_drag";
610
+ from: {
611
+ y: number;
612
+ x: number;
613
+ };
614
+ to: {
615
+ y: number;
616
+ x: number;
617
+ };
618
+ button?: "left" | "right" | "middle" | undefined;
619
+ } | {
620
+ at: {
621
+ y: number;
622
+ x: number;
623
+ };
624
+ type: "scroll";
625
+ amount: number;
626
+ direction: "left" | "right" | "up" | "down";
627
+ } | {
628
+ text: string;
629
+ type: "type_text";
630
+ } | {
631
+ keys: string;
632
+ type: "key";
633
+ } | {
634
+ type: "wait";
635
+ ms: number;
636
+ } | {
637
+ type: "list_windows";
638
+ } | {
639
+ type: "focus_window";
640
+ window_id: string;
641
+ } | {
642
+ type: "ui_act";
643
+ action: "select" | "invoke" | "focus" | "set_value" | "toggle" | "expand" | "collapse" | "scroll_into_view";
644
+ ref: string;
645
+ value?: string | undefined;
646
+ })[];
647
+ screenshot_id?: string | undefined;
161
648
  }>]>;
162
649
  /**
163
- * The tool's input, inferred from its schema.
650
+ * The tool's input, inferred from its schema: one action, or
651
+ * `{ type: 'batch', actions: [...] }`.
164
652
  *
165
- * Exported because `createComputerUseTool` returns a `ToolDefinition<ActionInput>`
653
+ * Exported because `createComputerUseTool` returns a `ToolDefinition<ActionInput>` (a `ComputerUseTool`)
166
654
  * and a consumer typing that variable, or writing a wrapper around it, had no
167
655
  * name for the parameter — the type was module-private while the function
168
656
  * carrying it was public.
169
657
  */
170
658
  export type ActionInput = z.infer<typeof actionSchema>;
659
+ /**
660
+ * The `computer_use` tool, with one question a host's review screen can ask
661
+ * of it.
662
+ */
663
+ export interface ComputerUseTool extends ToolDefinition<ActionInput> {
664
+ /**
665
+ * What a `ui_act` ref names in the latest `ui_snapshot` — `Button "Beş"
666
+ * (e30)` — or undefined for a ref it does not hold. For a host that shows
667
+ * a person the call before it runs; the words are the application's, so a
668
+ * host shows them as text and nothing more.
669
+ *
670
+ * @experimental Follows the UI-tree surface; see `ComputerUseCapabilities.uiTree`.
671
+ */
672
+ describeUiRef(ref: string): string | undefined;
673
+ }
171
674
  /**
172
675
  * Factory: given a ComputerUseHost (provided by the consumer — e.g.
173
- * @namzu/computer-use's SubprocessComputerUseHost), returns a ToolDefinition
174
- * that routes the discriminated action to the host and maps results back to
175
- * the SDK's ToolResult shape.
676
+ * @namzu/computer-use's SubprocessComputerUseHost), returns the
677
+ * `computer_use` tool.
176
678
  *
177
- * The tool's description reflects the host's frozen capabilities, and any
178
- * action targeting an unavailable capability is rejected with a clear error
179
- * rather than hanging or failing silently.
679
+ * Every screenshot is fitted to the model's image limits and numbered;
680
+ * every coordinate the model sends is a pixel of one of those screenshots and
681
+ * is mapped onto the host's display. Actions that change something return a
682
+ * fresh screenshot after a short settle delay, and `batch` runs several in
683
+ * one call. The description and schema reflect the host's frozen
684
+ * capabilities, and any action targeting an unavailable capability is
685
+ * rejected before the host is touched.
180
686
  *
181
687
  * @example
182
688
  * ```ts
@@ -188,6 +694,5 @@ export type ActionInput = z.infer<typeof actionSchema>;
188
694
  * registry.register(createComputerUseTool(host))
189
695
  * ```
190
696
  */
191
- export declare function createComputerUseTool(host: ComputerUseHost): ToolDefinition<ActionInput>;
192
- export {};
697
+ export declare function createComputerUseTool(host: ComputerUseHost, options?: ComputerUseToolOptions): ComputerUseTool;
193
698
  //# sourceMappingURL=computer-use.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"computer-use.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/computer-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAGX,eAAe,EAGf,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,2BAA2B,CAAA;AAG3E,eAAO,MAAM,sBAAsB,EAAG,cAAuB,CAAA;AAa7D,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBhB,CAAA;AAwDF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AA2LtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CA+DxF"}
1
+ {"version":3,"file":"computer-use.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/computer-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAGX,eAAe,EAUf,MAAM,mCAAmC,CAAA;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,2BAA2B,CAAA;AAcxF,OAAO,EAGN,KAAK,gBAAgB,EAIrB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACN,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1E,eAAO,MAAM,sBAAsB,EAAG,cAAuB,CAAA;AAS7D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAC5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IACzC,sDAAsD;IACtD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,cAAc,CAAC,GAChD,MAAM,GAAG,SAAS,CAGpB;AAwFD,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBhB,CAAA;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AA0mBtD;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACnE;;;;;;;OAOG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9C;AA2DD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,sBAA2B,GAClC,eAAe,CAguBjB"}