eve 0.51.0 → 0.52.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 (462) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/dist/src/channel/session.d.ts +2 -1
  3. package/dist/src/channel/session.js +1 -1
  4. package/dist/src/channel/types.d.ts +4 -1
  5. package/dist/src/chunks/{use-eve-agent-C3vUG5g2.js → use-eve-agent-3DZuvuWE.js} +17 -6
  6. package/dist/src/chunks/{use-eve-agent-B4xN7-fK.js → use-eve-agent-D7apPojZ.js} +17 -6
  7. package/dist/src/cli/agent-command.js +1 -1
  8. package/dist/src/cli/commands/agent-instructions.d.ts +3 -1
  9. package/dist/src/cli/commands/agent-instructions.js +1 -1
  10. package/dist/src/cli/commands/build.js +1 -1
  11. package/dist/src/cli/commands/deploy.js +1 -1
  12. package/dist/src/cli/commands/init-agent-workspace.js +1 -1
  13. package/dist/src/cli/commands/init-repl.js +1 -1
  14. package/dist/src/cli/commands/init.js +1 -1
  15. package/dist/src/cli/commands/integration-connect.js +1 -1
  16. package/dist/src/cli/commands/link.js +1 -1
  17. package/dist/src/cli/commands/preconditions.js +1 -1
  18. package/dist/src/cli/commands/register-project-commands.d.ts +1 -1
  19. package/dist/src/cli/commands/register-project-commands.js +1 -1
  20. package/dist/src/cli/commands/registry.js +1 -1
  21. package/dist/src/cli/dev/boot-progress.d.ts +3 -0
  22. package/dist/src/cli/dev/boot-progress.js +1 -0
  23. package/dist/src/cli/dev/environment.js +1 -1
  24. package/dist/src/cli/dev/run-interactive-ui.js +1 -1
  25. package/dist/src/cli/dev/tui/prompt-command-handler.js +1 -1
  26. package/dist/src/cli/dev/tui/setup-commands.d.ts +3 -1
  27. package/dist/src/cli/dev/tui/setup-commands.js +1 -1
  28. package/dist/src/cli/run.d.ts +4 -0
  29. package/dist/src/cli/run.js +3 -3
  30. package/dist/src/cli/telemetry/command.d.ts +9 -0
  31. package/dist/src/cli/telemetry/command.js +1 -0
  32. package/dist/src/cli/telemetry/flush.d.ts +2 -0
  33. package/dist/src/cli/telemetry/flush.js +1 -0
  34. package/dist/src/cli/telemetry/identity.d.ts +13 -0
  35. package/dist/src/cli/telemetry/identity.js +1 -0
  36. package/dist/src/cli/telemetry/index.d.ts +25 -0
  37. package/dist/src/cli/telemetry/index.js +3 -0
  38. package/dist/src/cli/telemetry/preference.d.ts +9 -0
  39. package/dist/src/cli/telemetry/preference.js +1 -0
  40. package/dist/src/client/open-stream.js +1 -1
  41. package/dist/src/client/session-controls.d.ts +3 -0
  42. package/dist/src/client/session-controls.js +1 -1
  43. package/dist/src/client/session.d.ts +4 -1
  44. package/dist/src/client/types.d.ts +3 -2
  45. package/dist/src/compiled/.vendor-stamp.json +11 -11
  46. package/dist/src/compiled/@clack/core/LICENSE +9 -0
  47. package/dist/src/compiled/@clack/core/index.d.ts +363 -0
  48. package/dist/src/compiled/@clack/core/index.js +20 -0
  49. package/dist/src/compiled/@eve/catalog/index.js +1 -1
  50. package/dist/src/compiled/@modelcontextprotocol/server/index.d.ts +1 -0
  51. package/dist/src/compiled/@vercel/sandbox/api-client/api-client.d.ts +34 -92
  52. package/dist/src/compiled/@vercel/sandbox/api-client/base-client.d.ts +1 -1
  53. package/dist/src/compiled/@vercel/sandbox/api-client/index.d.ts +1 -1
  54. package/dist/src/compiled/@vercel/sandbox/api-client/validators.d.ts +13 -29
  55. package/dist/src/compiled/@vercel/sandbox/constants.d.ts +11 -1
  56. package/dist/src/compiled/@vercel/sandbox/index.d.ts +3 -3
  57. package/dist/src/compiled/@vercel/sandbox/index.js +9 -9
  58. package/dist/src/compiled/@vercel/sandbox/sandbox-user.d.ts +5 -6
  59. package/dist/src/compiled/@vercel/sandbox/sandbox.d.ts +79 -67
  60. package/dist/src/compiled/@vercel/sandbox/session.d.ts +5 -3
  61. package/dist/src/compiled/@vercel/sandbox/snapshot.d.ts +9 -0
  62. package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/api-client.d.ts +86 -1
  63. package/dist/src/compiled/@vercel/sandbox-drives/api-client/index.d.ts +2 -0
  64. package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/validators.d.ts +26 -1
  65. package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/constants.d.ts +2 -2
  66. package/dist/src/compiled/@vercel/{sandbox → sandbox-drives}/drive.d.ts +10 -0
  67. package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/index.d.ts +3 -2
  68. package/dist/src/compiled/@vercel/sandbox-drives/index.js +9 -0
  69. package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/sandbox.d.ts +35 -6
  70. package/dist/src/compiled/@workflow/core/index.js +1 -1
  71. package/dist/src/compiled/@workflow/core/private.d.ts +2 -4
  72. package/dist/src/compiled/@workflow/core/private.js +1 -1
  73. package/dist/src/compiled/@workflow/core/runtime/constants.d.ts +9 -7
  74. package/dist/src/compiled/@workflow/core/runtime/helpers.d.ts +13 -0
  75. package/dist/src/compiled/@workflow/core/runtime/suspension-handler.d.ts +54 -1
  76. package/dist/src/compiled/@workflow/core/runtime.js +3 -3
  77. package/dist/src/compiled/@workflow/core/serialization/types.d.ts +7 -0
  78. package/dist/src/compiled/@workflow/core/serialization.d.ts +24 -2
  79. package/dist/src/compiled/@workflow/core/version.d.ts +1 -1
  80. package/dist/src/compiled/@workflow/core/workflow.js +1 -1
  81. package/dist/src/compiled/@workflow/errors/error-codes.d.ts +2 -0
  82. package/dist/src/compiled/@workflow/errors/index.d.ts +19 -0
  83. package/dist/src/compiled/@workflow/errors/index.js +1 -1
  84. package/dist/src/compiled/@workflow/world/analytics.d.ts +46 -2
  85. package/dist/src/compiled/@workflow/world/events.d.ts +26 -1
  86. package/dist/src/compiled/@workflow/world/index.d.ts +1 -1
  87. package/dist/src/compiled/@workflow/world/runs.d.ts +2 -2
  88. package/dist/src/compiled/@workflow/world-local/index.js +3 -3
  89. package/dist/src/compiled/@workflow/world-vercel/index.js +12 -12
  90. package/dist/src/compiled/_chunks/node/{auth-BSKyPAEP.js → auth-Bx1Aoyfo.js} +1 -1
  91. package/dist/src/compiled/_chunks/node/{auth-YpKlwhP1.js → auth-CA8ZMfB8.js} +1 -1
  92. package/dist/src/compiled/_chunks/node/esm-CE0tAvRh.js +7 -0
  93. package/dist/src/compiled/_chunks/node/version-BC6t2Txc.js +1 -0
  94. package/dist/src/compiled/_chunks/node/version-DSQqVZ5T.js +1 -0
  95. package/dist/src/compiled/_chunks/workflow/{attribute-changes-BwAadFfB.js → attribute-changes-03lzo29R.js} +1 -1
  96. package/dist/src/compiled/_chunks/workflow/dist-BIdMK5N8.js +40 -0
  97. package/dist/src/compiled/_chunks/workflow/dist-DMQ3CtWt.js +3 -0
  98. package/dist/src/compiled/_chunks/workflow/frames-Boesh7kU.js +3 -0
  99. package/dist/src/compiled/_chunks/workflow/{private-CZFMABEf.js → private-CKx3PkSS.js} +1 -1
  100. package/dist/src/compiled/_chunks/workflow/{resume-hook-BToMtPbH.js → resume-hook-C6eL-S_T.js} +1 -1
  101. package/dist/src/compiled/_chunks/workflow/run-BV0S6Zc2.js +1 -0
  102. package/dist/src/compiled/_chunks/workflow/sleep-Bh3jP9ii.js +1 -0
  103. package/dist/src/compiled/_chunks/workflow/wait-until-l-cwfJvm.js +15 -0
  104. package/dist/src/compiled/_chunks/workflow/{ws-transport-PnVVxT0R.js → ws-transport-BagXNxCE.js} +1 -1
  105. package/dist/src/compiler/compile-from-memory.d.ts +1 -0
  106. package/dist/src/compiler/extension-compatibility.d.ts +38 -20
  107. package/dist/src/compiler/extension-compatibility.js +1 -1
  108. package/dist/src/compiler/manifest.d.ts +2 -2
  109. package/dist/src/compiler/manifest.js +1 -1
  110. package/dist/src/compiler/normalize-agent-config.js +1 -1
  111. package/dist/src/compiler/normalize-channel.js +1 -1
  112. package/dist/src/compiler/normalize-schedule.js +1 -1
  113. package/dist/src/compiler/normalize-tool.js +1 -1
  114. package/dist/src/context/dynamic-tool-lifecycle.js +1 -1
  115. package/dist/src/discover/extensions.d.ts +2 -0
  116. package/dist/src/discover/extensions.js +1 -1
  117. package/dist/src/discover/filesystem.d.ts +1 -0
  118. package/dist/src/discover/filesystem.js +1 -1
  119. package/dist/src/discover/project.js +1 -1
  120. package/dist/src/evals/runner/execute-task.js +1 -1
  121. package/dist/src/evals/session-cleanup.d.ts +7 -0
  122. package/dist/src/evals/session-cleanup.js +1 -0
  123. package/dist/src/evals/session.d.ts +4 -0
  124. package/dist/src/evals/session.js +1 -1
  125. package/dist/src/eve-channel/index.js +1 -1
  126. package/dist/src/eve-channel/request.d.ts +1 -0
  127. package/dist/src/eve-channel/request.js +1 -1
  128. package/dist/src/execution/activity-collector.js +1 -1
  129. package/dist/src/execution/activity-work.d.ts +8 -0
  130. package/dist/src/execution/activity-work.js +1 -1
  131. package/dist/src/execution/cancel-indexed-session-tasks-step.d.ts +6 -0
  132. package/dist/src/execution/cancel-indexed-session-tasks-step.js +1 -0
  133. package/dist/src/execution/continuation-conflict-step.js +1 -1
  134. package/dist/src/execution/coordination-dispatch-shared.d.ts +2 -2
  135. package/dist/src/execution/coordination-dispatch-shared.js +1 -1
  136. package/dist/src/execution/coordination-dispatch-step.js +1 -1
  137. package/dist/src/execution/create-session-step.js +1 -1
  138. package/dist/src/execution/durable-session-migrations/turn-workflow.d.ts +1 -1
  139. package/dist/src/execution/inline-turn.d.ts +4 -2
  140. package/dist/src/execution/inline-turn.js +1 -1
  141. package/dist/src/execution/next-driver-action.d.ts +0 -3
  142. package/dist/src/execution/parked-delivery-wait.js +1 -1
  143. package/dist/src/execution/proxied-deliver-step.js +1 -1
  144. package/dist/src/execution/run-session-limits.d.ts +5 -5
  145. package/dist/src/execution/sandbox/bindings/vercel-create-sdk.js +1 -1
  146. package/dist/src/execution/sandbox/bindings/vercel-sdk-types.d.ts +4 -4
  147. package/dist/src/execution/sandbox/bindings/vercel.js +1 -1
  148. package/dist/src/execution/session-activity-projection.js +1 -1
  149. package/dist/src/execution/session-activity.js +1 -1
  150. package/dist/src/execution/session-timeout-workflow.js +1 -1
  151. package/dist/src/execution/session.d.ts +1 -0
  152. package/dist/src/execution/session.js +1 -1
  153. package/dist/src/execution/settle-cancelled-turn-step.js +1 -1
  154. package/dist/src/execution/tasks/child/steps.d.ts +19 -1
  155. package/dist/src/execution/tasks/child/steps.js +1 -1
  156. package/dist/src/execution/tasks/child/workflow.d.ts +2 -0
  157. package/dist/src/execution/tasks/child/workflow.js +1 -1
  158. package/dist/src/execution/tasks/parent/control-shared.js +1 -1
  159. package/dist/src/execution/tasks/parent/delegate.d.ts +2 -0
  160. package/dist/src/execution/tasks/parent/delegate.js +1 -1
  161. package/dist/src/execution/tasks/parent/hitl-proxy-steps.js +1 -1
  162. package/dist/src/execution/tasks/parent/subagent-task-projection.d.ts +26 -0
  163. package/dist/src/execution/tasks/parent/subagent-task-projection.js +1 -0
  164. package/dist/src/execution/tasks/parent/tool-execution.js +1 -1
  165. package/dist/src/execution/terminate-child-sessions-step.js +1 -1
  166. package/dist/src/execution/tools/sleep-workflow.d.ts +3 -0
  167. package/dist/src/execution/tools/sleep-workflow.js +1 -0
  168. package/dist/src/execution/tools/sleep.d.ts +1 -5
  169. package/dist/src/execution/tools/sleep.js +1 -1
  170. package/dist/src/execution/tools/subagent/accept-event-step.js +1 -1
  171. package/dist/src/execution/tools/subagent/invoke-agent.d.ts +1 -7
  172. package/dist/src/execution/tools/subagent/invoke-agent.js +1 -1
  173. package/dist/src/execution/tools/subagent/invoke-step.js +1 -1
  174. package/dist/src/execution/tools/workflow/ask.d.ts +1 -2
  175. package/dist/src/execution/tools/workflow/ask.js +1 -1
  176. package/dist/src/execution/tools/workflow/body.d.ts +6 -1
  177. package/dist/src/execution/tools/workflow/body.js +1 -1
  178. package/dist/src/execution/tools/workflow/cancel.js +1 -1
  179. package/dist/src/execution/tools/workflow/messages.d.ts +9 -8
  180. package/dist/src/execution/tools/workflow/messages.js +1 -1
  181. package/dist/src/execution/tools/workflow/owner-inbox.d.ts +2 -2
  182. package/dist/src/execution/tools/workflow/owner-inbox.js +1 -1
  183. package/dist/src/execution/tools/workflow/owner.d.ts +5 -11
  184. package/dist/src/execution/tools/workflow/owner.js +1 -1
  185. package/dist/src/execution/tools/workflow/run-control.d.ts +0 -4
  186. package/dist/src/execution/tools/workflow/run-control.js +1 -1
  187. package/dist/src/execution/tools/workflow/start.d.ts +5 -14
  188. package/dist/src/execution/tools/workflow/start.js +1 -1
  189. package/dist/src/execution/tools/workflow/workflow.d.ts +1 -1
  190. package/dist/src/execution/tools/workflow/workflow.js +1 -1
  191. package/dist/src/execution/turn-cancellation-control.d.ts +1 -0
  192. package/dist/src/execution/turn-cancellation-control.js +1 -1
  193. package/dist/src/execution/turn-cancellation-token.d.ts +1 -0
  194. package/dist/src/execution/turn-control-receiver.d.ts +3 -0
  195. package/dist/src/execution/turn-control-receiver.js +1 -1
  196. package/dist/src/execution/turn-dispatch.d.ts +2 -0
  197. package/dist/src/execution/turn-dispatch.js +1 -1
  198. package/dist/src/execution/turn-workflow-tool-run.d.ts +2 -8
  199. package/dist/src/execution/turn-workflow-tool-run.js +1 -1
  200. package/dist/src/execution/turn-workflow.d.ts +1 -0
  201. package/dist/src/execution/turn-workflow.js +1 -1
  202. package/dist/src/execution/wire/session-inbox-contract.d.ts +2 -2
  203. package/dist/src/execution/wire/session-inbox-contract.js +1 -1
  204. package/dist/src/execution/wire/session-inbox-encoder.d.ts +10 -2
  205. package/dist/src/execution/wire/session-inbox-encoder.js +1 -1
  206. package/dist/src/execution/wire/session-inbox-resume.js +1 -1
  207. package/dist/src/execution/wire/session-inbox-wire.js +1 -1
  208. package/dist/src/execution/wire/session-inbox-wire.v5.d.ts +341 -0
  209. package/dist/src/execution/wire/session-inbox-wire.v5.js +1 -0
  210. package/dist/src/execution/wire/session-inbox-wire.v5.migration.d.ts +3 -0
  211. package/dist/src/execution/wire/session-inbox-wire.v5.migration.js +1 -0
  212. package/dist/src/execution/wire/session-inbox-wire.v6.d.ts +341 -0
  213. package/dist/src/execution/wire/session-inbox-wire.v6.js +1 -0
  214. package/dist/src/execution/workflow-entry.js +1 -1
  215. package/dist/src/execution/workflow-runtime.js +1 -1
  216. package/dist/src/execution/workflow-steps.js +1 -1
  217. package/dist/src/harness/emission-state.js +1 -1
  218. package/dist/src/harness/session-limit-continuation.d.ts +5 -5
  219. package/dist/src/harness/session-limit-continuation.js +1 -1
  220. package/dist/src/harness/session-limit-enforcement.d.ts +4 -4
  221. package/dist/src/harness/session-limit-enforcement.js +1 -1
  222. package/dist/src/harness/session-usage-limits.d.ts +48 -0
  223. package/dist/src/harness/session-usage-limits.js +1 -0
  224. package/dist/src/harness/tool-loop.js +2 -2
  225. package/dist/src/harness/turn-client-context.d.ts +9 -0
  226. package/dist/src/harness/turn-client-context.js +1 -0
  227. package/dist/src/harness/turn-tag-state.d.ts +17 -20
  228. package/dist/src/harness/turn-tag-state.js +1 -1
  229. package/dist/src/harness/types.d.ts +5 -0
  230. package/dist/src/harness/workflow-tool-runs.d.ts +0 -1
  231. package/dist/src/harness/workflow-tool-runs.js +1 -1
  232. package/dist/src/internal/application/build-output-environment.d.ts +1 -0
  233. package/dist/src/internal/application/build-output-environment.js +1 -1
  234. package/dist/src/internal/application/package.js +1 -1
  235. package/dist/src/internal/application/paths.js +1 -1
  236. package/dist/src/internal/authored-definition/core.js +1 -1
  237. package/dist/src/internal/authored-definition/schema-backed.js +1 -1
  238. package/dist/src/internal/eve-project-root.d.ts +8 -0
  239. package/dist/src/internal/eve-project-root.js +1 -0
  240. package/dist/src/internal/invocation/workflow-execution.js +1 -1
  241. package/dist/src/internal/mcp/streamable-http-server.d.ts +29 -1
  242. package/dist/src/internal/mcp/streamable-http-server.js +1 -1
  243. package/dist/src/internal/nitro/host/build-application.js +1 -1
  244. package/dist/src/internal/nitro/host/create-application-nitro.d.ts +1 -0
  245. package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
  246. package/dist/src/internal/nitro/host/types.d.ts +2 -0
  247. package/dist/src/internal/nitro/host/vercel-build-output-config.d.ts +1 -0
  248. package/dist/src/internal/nitro/host/vercel-build-output-config.js +1 -1
  249. package/dist/src/internal/project-context.d.ts +13 -8
  250. package/dist/src/internal/project-context.js +1 -1
  251. package/dist/src/internal/vercel/build-agent-workspace.d.ts +1 -1
  252. package/dist/src/internal/vercel/build-agent-workspace.js +1 -1
  253. package/dist/src/internal/vercel/eve-service-contribution.d.ts +1 -0
  254. package/dist/src/internal/vercel/eve-service-contribution.js +1 -1
  255. package/dist/src/internal/workflow/reference.d.ts +2 -0
  256. package/dist/src/internal/workflow/reference.js +1 -0
  257. package/dist/src/internal/workflow/runtime.d.ts +6 -0
  258. package/dist/src/internal/workflow/runtime.js +1 -1
  259. package/dist/src/internal/workflow-bundle/authored-workflow-directives.d.ts +1 -3
  260. package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
  261. package/dist/src/internal/workflow-bundle/authored-workflow-modules.d.ts +1 -11
  262. package/dist/src/internal/workflow-bundle/authored-workflow-modules.js +1 -1
  263. package/dist/src/internal/workflow-bundle/builder.js +1 -1
  264. package/dist/src/internal/workflow-bundle/dynamic-tool-transform.js +1 -1
  265. package/dist/src/internal/workflow-bundle/workflow-builders.d.ts +1 -3
  266. package/dist/src/internal/workflow-bundle/workflow-builders.js +1 -1
  267. package/dist/src/internal/workflow-bundle/workflow-transformer.d.ts +1 -1
  268. package/dist/src/internal/workflow-bundle/workflow-transformer.js +2 -2
  269. package/dist/src/protocol/message.d.ts +3 -2
  270. package/dist/src/public/channels/mcp.js +1 -1
  271. package/dist/src/public/channels/slack/activity-plan.d.ts +4 -0
  272. package/dist/src/public/channels/slack/activity-plan.js +1 -0
  273. package/dist/src/public/channels/slack/activity.d.ts +45 -2
  274. package/dist/src/public/channels/slack/activity.js +2 -1
  275. package/dist/src/public/channels/slack/index.d.ts +1 -1
  276. package/dist/src/public/channels/slack/index.js +1 -1
  277. package/dist/src/public/channels/slack/slackChannel.js +1 -1
  278. package/dist/src/public/memory/index.js +1 -1
  279. package/dist/src/public/models/openai/chatgpt/model.js +2 -2
  280. package/dist/src/public/models/openai/chatgpt/transport.js +1 -1
  281. package/dist/src/public/nuxt/index.js +1 -1
  282. package/dist/src/public/nuxt/module.d.ts +3 -2
  283. package/dist/src/public/nuxt/module.js +1 -1
  284. package/dist/src/public/sandbox/vercel-sandbox.d.ts +9 -5
  285. package/dist/src/public/sandbox/vercel.d.ts +1 -1
  286. package/dist/src/public/sandbox/vercel.js +1 -1
  287. package/dist/src/public/tools/index.d.ts +3 -1
  288. package/dist/src/public/tools/index.js +1 -1
  289. package/dist/src/runtime/resolve-agent.js +1 -1
  290. package/dist/src/runtime/subagents/workflow.js +1 -1
  291. package/dist/src/self-modification/agent.d.ts +22 -0
  292. package/dist/src/self-modification/agent.js +1 -0
  293. package/dist/src/self-modification/extension/classify-registry-item.d.ts +19 -0
  294. package/dist/src/self-modification/extension/classify-registry-item.js +1 -0
  295. package/dist/src/self-modification/extension/eve-add.d.ts +56 -0
  296. package/dist/src/self-modification/extension/eve-add.js +2 -0
  297. package/dist/src/self-modification/extension/extension.d.ts +2 -0
  298. package/dist/src/self-modification/extension/extension.js +1 -0
  299. package/dist/src/self-modification/extension/instructions.d.ts +4 -0
  300. package/dist/src/self-modification/extension/instructions.js +23 -0
  301. package/dist/src/self-modification/extension/source-lock.d.ts +2 -0
  302. package/dist/src/self-modification/extension/source-lock.js +1 -0
  303. package/dist/src/self-modification/extension/tools/edit_file.d.ts +16 -0
  304. package/dist/src/self-modification/extension/tools/edit_file.js +1 -0
  305. package/dist/src/self-modification/extension/tools/registry_add.d.ts +52 -0
  306. package/dist/src/self-modification/extension/tools/registry_add.js +1 -0
  307. package/dist/src/self-modification/extension/tools/search_models.d.ts +22 -0
  308. package/dist/src/self-modification/extension/tools/search_models.js +1 -0
  309. package/dist/src/self-modification/extension/tools/search_registry.d.ts +103 -0
  310. package/dist/src/self-modification/extension/tools/search_registry.js +1 -0
  311. package/dist/src/self-modification/filesystem.d.ts +6 -0
  312. package/dist/src/self-modification/filesystem.js +1 -0
  313. package/dist/src/self-modification/sandbox.d.ts +2 -0
  314. package/dist/src/self-modification/sandbox.js +1 -0
  315. package/dist/src/services/dev-client/target.d.ts +3 -1
  316. package/dist/src/setup/boxes/select-model.d.ts +3 -21
  317. package/dist/src/setup/boxes/select-model.js +1 -1
  318. package/dist/src/setup/cli/prompt-ui.js +4 -4
  319. package/dist/src/setup/cli/select-component.d.ts +1 -1
  320. package/dist/src/setup/cli/select-component.js +1 -1
  321. package/dist/src/setup/flows/model.d.ts +3 -0
  322. package/dist/src/setup/flows/model.js +1 -1
  323. package/dist/src/setup/prompter.js +1 -1
  324. package/dist/src/setup/scaffold/create/project.js +1 -1
  325. package/dist/src/setup/scaffold/update/web-options.js +1 -1
  326. package/dist/src/shared/action-types.d.ts +35 -22
  327. package/dist/src/shared/action-types.js +1 -1
  328. package/dist/src/shared/agent-definition.d.ts +13 -0
  329. package/dist/src/shared/agent-turn-outcome.d.ts +2 -0
  330. package/dist/src/shared/agent-turn-outcome.js +1 -1
  331. package/dist/src/shared/extension-package-contract.d.ts +2 -0
  332. package/dist/src/shared/extension-package-contract.js +1 -1
  333. package/dist/src/shared/gateway-model-catalog.d.ts +21 -0
  334. package/dist/src/shared/gateway-model-catalog.js +1 -0
  335. package/dist/src/shared/sandbox-network-policy.d.ts +1 -1
  336. package/dist/src/shared/token-usage.d.ts +11 -15
  337. package/dist/src/shared/token-usage.js +1 -1
  338. package/dist/src/shared/workflow-tool-context.d.ts +2 -0
  339. package/dist/src/shared/workflow-tool-context.js +1 -0
  340. package/dist/src/subagents/callback-route.js +1 -1
  341. package/dist/src/subagents/event-proxy-step.js +1 -1
  342. package/dist/src/subagents/start-remote.js +1 -1
  343. package/dist/src/subagents/token-budget.js +1 -1
  344. package/dist/src/svelte/index.js +1 -1
  345. package/dist/src/svelte/use-eve-agent.js +1 -1
  346. package/dist/src/tasks/types.d.ts +18 -1
  347. package/dist/src/tasks/types.js +1 -1
  348. package/dist/src/tools/behavior.d.ts +5 -0
  349. package/dist/src/tools/definition.d.ts +16 -12
  350. package/dist/src/tools/definition.js +1 -1
  351. package/dist/src/tools/dynamic.d.ts +2 -2
  352. package/dist/src/tools/provided/sleep.d.ts +4 -4
  353. package/dist/src/tools/provided/sleep.js +1 -1
  354. package/dist/src/tools/task.d.ts +28 -80
  355. package/dist/src/tools/task.js +1 -1
  356. package/dist/src/tools/workflow-definition.d.ts +60 -0
  357. package/dist/src/tools/workflow-definition.js +1 -0
  358. package/dist/src/vue/index.js +1 -1
  359. package/dist/src/vue/use-eve-agent.js +1 -1
  360. package/docs/agent-config.md +24 -19
  361. package/docs/channels/eve.mdx +1 -1
  362. package/docs/channels/mcp.mdx +25 -3
  363. package/docs/concepts/built-in-tools.md +1 -1
  364. package/docs/concepts/execution-model-and-durability.mdx +13 -2
  365. package/docs/concepts/sessions-runs-and-streaming.md +9 -1
  366. package/docs/guides/client/messages.mdx +1 -1
  367. package/docs/guides/client/streaming.mdx +1 -1
  368. package/docs/guides/deployment/vercel.mdx +3 -1
  369. package/docs/guides/frontend/overview.mdx +1 -1
  370. package/docs/memory/overview.mdx +41 -12
  371. package/docs/reference/cli.md +31 -33
  372. package/docs/reference/meta.json +1 -4
  373. package/docs/reference/telemetry.md +56 -0
  374. package/docs/reference/typescript-api.md +38 -35
  375. package/docs/sandbox.mdx +1 -1
  376. package/docs/tools/overview.mdx +59 -18
  377. package/docs/tools/workflows.mdx +146 -70
  378. package/package.json +38 -19
  379. package/dist/src/compiled/@vercel/sandbox-delete/api-client/index.d.ts +0 -2
  380. package/dist/src/compiled/@vercel/sandbox-delete/index.js +0 -9
  381. package/dist/src/compiled/@vercel/sandbox-stable/LICENSE +0 -201
  382. package/dist/src/compiled/@vercel/sandbox-stable/_async-retry.d.ts +0 -8
  383. package/dist/src/compiled/@vercel/sandbox-stable/_workflow-serde.d.ts +0 -5
  384. package/dist/src/compiled/@vercel/sandbox-stable/api-client/api-client.d.ts +0 -1456
  385. package/dist/src/compiled/@vercel/sandbox-stable/api-client/api-error.d.ts +0 -29
  386. package/dist/src/compiled/@vercel/sandbox-stable/api-client/base-client.d.ts +0 -39
  387. package/dist/src/compiled/@vercel/sandbox-stable/api-client/file-writer.d.ts +0 -66
  388. package/dist/src/compiled/@vercel/sandbox-stable/api-client/index.d.ts +0 -2
  389. package/dist/src/compiled/@vercel/sandbox-stable/api-client/validators.d.ts +0 -899
  390. package/dist/src/compiled/@vercel/sandbox-stable/api-client/with-retry.d.ts +0 -10
  391. package/dist/src/compiled/@vercel/sandbox-stable/auth/error.d.ts +0 -15
  392. package/dist/src/compiled/@vercel/sandbox-stable/auth/file.d.ts +0 -18
  393. package/dist/src/compiled/@vercel/sandbox-stable/auth/index.d.ts +0 -6
  394. package/dist/src/compiled/@vercel/sandbox-stable/auth/oauth.d.ts +0 -111
  395. package/dist/src/compiled/@vercel/sandbox-stable/auth/poll-for-token.d.ts +0 -28
  396. package/dist/src/compiled/@vercel/sandbox-stable/auth/project.d.ts +0 -40
  397. package/dist/src/compiled/@vercel/sandbox-stable/command.d.ts +0 -292
  398. package/dist/src/compiled/@vercel/sandbox-stable/constants.d.ts +0 -5
  399. package/dist/src/compiled/@vercel/sandbox-stable/execution-context.d.ts +0 -116
  400. package/dist/src/compiled/@vercel/sandbox-stable/filesystem.d.ts +0 -258
  401. package/dist/src/compiled/@vercel/sandbox-stable/index.d.ts +0 -12
  402. package/dist/src/compiled/@vercel/sandbox-stable/index.js +0 -1
  403. package/dist/src/compiled/@vercel/sandbox-stable/network-policy.d.ts +0 -169
  404. package/dist/src/compiled/@vercel/sandbox-stable/proxy.d.ts +0 -55
  405. package/dist/src/compiled/@vercel/sandbox-stable/sandbox-user.d.ts +0 -212
  406. package/dist/src/compiled/@vercel/sandbox-stable/sandbox.d.ts +0 -1216
  407. package/dist/src/compiled/@vercel/sandbox-stable/session.d.ts +0 -433
  408. package/dist/src/compiled/@vercel/sandbox-stable/snapshot.d.ts +0 -229
  409. package/dist/src/compiled/@vercel/sandbox-stable/utils/get-credentials.d.ts +0 -21
  410. package/dist/src/compiled/@vercel/sandbox-stable/utils/paginator.d.ts +0 -16
  411. package/dist/src/compiled/@vercel/sandbox-stable/utils/resolveSignal.d.ts +0 -15
  412. package/dist/src/compiled/@vercel/sandbox-stable/utils/sandbox-snapshot.d.ts +0 -11
  413. package/dist/src/compiled/@vercel/sandbox-stable/utils/types.d.ts +0 -11
  414. package/dist/src/compiled/_chunks/node/decode_jwt-Col8JOnf.js +0 -7
  415. package/dist/src/compiled/_chunks/node/version-BYHw-SDY.js +0 -1
  416. package/dist/src/compiled/_chunks/node/version-DH6yRy-M.js +0 -1
  417. package/dist/src/compiled/_chunks/workflow/dist-CgbVZs5l.js +0 -40
  418. package/dist/src/compiled/_chunks/workflow/dist-DjojkP5e.js +0 -3
  419. package/dist/src/compiled/_chunks/workflow/frames-CZ9eHShe.js +0 -3
  420. package/dist/src/compiled/_chunks/workflow/run-DzyAoGh4.js +0 -1
  421. package/dist/src/compiled/_chunks/workflow/sleep-3_A5uOp-.js +0 -1
  422. package/dist/src/compiled/_chunks/workflow/wait-until-BtySPYD0.js +0 -15
  423. package/dist/src/harness/session-token-limits.d.ts +0 -41
  424. package/dist/src/harness/session-token-limits.js +0 -1
  425. package/dist/src/harness/turn-sleep.d.ts +0 -12
  426. package/dist/src/harness/turn-sleep.js +0 -1
  427. package/dist/src/internal/agent-workspace.d.ts +0 -15
  428. package/dist/src/internal/agent-workspace.js +0 -1
  429. package/dist/src/node_modules/.pnpm/@clack_core@1.3.1/node_modules/@clack/core/dist/index.js +0 -16
  430. package/dist/src/node_modules/.pnpm/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/index.js +0 -1
  431. package/dist/src/node_modules/.pnpm/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/utils.js +0 -1
  432. package/dist/src/node_modules/.pnpm/fast-string-width@3.0.2/node_modules/fast-string-width/dist/index.js +0 -1
  433. package/dist/src/node_modules/.pnpm/fast-wrap-ansi@0.2.2/node_modules/fast-wrap-ansi/lib/main.js +0 -5
  434. package/dist/src/node_modules/.pnpm/sisteransi@1.0.5/node_modules/sisteransi/src/index.js +0 -1
  435. package/dist/src/public/workflow/index.d.ts +0 -5
  436. package/dist/src/public/workflow/index.js +0 -1
  437. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/LICENSE +0 -0
  438. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/_async-retry.d.ts +0 -0
  439. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/_workflow-serde.d.ts +0 -0
  440. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/api-error.d.ts +0 -0
  441. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/base-client.d.ts +0 -0
  442. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/file-writer.d.ts +0 -0
  443. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/with-retry.d.ts +0 -0
  444. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/error.d.ts +0 -0
  445. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/file.d.ts +0 -0
  446. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/index.d.ts +0 -0
  447. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/oauth.d.ts +0 -0
  448. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/poll-for-token.d.ts +0 -0
  449. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/auth/project.d.ts +0 -0
  450. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/command.d.ts +0 -0
  451. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/execution-context.d.ts +0 -0
  452. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/filesystem.d.ts +0 -0
  453. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/network-policy.d.ts +0 -0
  454. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/proxy.d.ts +0 -0
  455. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/sandbox-user.d.ts +0 -0
  456. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/session.d.ts +0 -0
  457. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/snapshot.d.ts +0 -0
  458. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/utils/get-credentials.d.ts +0 -0
  459. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/utils/paginator.d.ts +0 -0
  460. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/utils/resolveSignal.d.ts +0 -0
  461. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/utils/sandbox-snapshot.d.ts +0 -0
  462. /package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/utils/types.d.ts +0 -0
@@ -3,8 +3,7 @@ import { CommandData, CommandFinishedData, CommandFinishedResponse, CommandRespo
3
3
  import { FileWriter } from "./file-writer.js";
4
4
  import { NetworkPolicy } from "../network-policy.js";
5
5
  import { WithPrivate } from "../utils/types.js";
6
- import { RUNTIMES } from "../constants.js";
7
- import { BaseCreateSandboxParams } from "../sandbox.js";
6
+ import { RUNTIMES, SandboxRegion } from "../constants.js";
8
7
  import { z } from "#compiled/zod/index.js";
9
8
  import { Readable } from "stream";
10
9
 
@@ -34,13 +33,13 @@ declare class APIClient extends BaseClient {
34
33
  memory: number;
35
34
  vcpus: number;
36
35
  region: string;
37
- runtime: string;
38
36
  timeout: number;
39
37
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
40
38
  requestedAt: number;
41
39
  createdAt: number;
42
40
  cwd: string;
43
41
  updatedAt: number;
42
+ runtime?: string | undefined;
44
43
  startedAt?: number | undefined;
45
44
  requestedStopAt?: number | undefined;
46
45
  stoppedAt?: number | undefined;
@@ -181,7 +180,8 @@ declare class APIClient extends BaseClient {
181
180
  expiration?: number;
182
181
  deleteEvicted?: boolean;
183
182
  };
184
- mounts?: BaseCreateSandboxParams["mounts"];
183
+ region?: SandboxRegion;
184
+ failoverRegions?: SandboxRegion[];
185
185
  signal?: AbortSignal;
186
186
  }>): Promise<Parsed<{
187
187
  sandbox: {
@@ -192,6 +192,7 @@ declare class APIClient extends BaseClient {
192
192
  currentSessionId: string;
193
193
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
194
194
  region?: string | undefined;
195
+ failoverRegions?: string[] | undefined;
195
196
  vcpus?: number | undefined;
196
197
  memory?: number | undefined;
197
198
  runtime?: string | undefined;
@@ -292,10 +293,6 @@ declare class APIClient extends BaseClient {
292
293
  statusUpdatedAt?: number | undefined;
293
294
  cwd?: string | undefined;
294
295
  tags?: Record<string, string> | undefined;
295
- mounts?: Record<string, {
296
- drive: string;
297
- mode?: "read-only" | "read-write" | undefined;
298
- }> | undefined;
299
296
  snapshotExpiration?: number | undefined;
300
297
  keepLastSnapshots?: {
301
298
  count: number;
@@ -309,13 +306,13 @@ declare class APIClient extends BaseClient {
309
306
  memory: number;
310
307
  vcpus: number;
311
308
  region: string;
312
- runtime: string;
313
309
  timeout: number;
314
310
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
315
311
  requestedAt: number;
316
312
  createdAt: number;
317
313
  cwd: string;
318
314
  updatedAt: number;
315
+ runtime?: string | undefined;
319
316
  startedAt?: number | undefined;
320
317
  requestedStopAt?: number | undefined;
321
318
  stoppedAt?: number | undefined;
@@ -443,6 +440,8 @@ declare class APIClient extends BaseClient {
443
440
  expiration?: number;
444
441
  deleteEvicted?: boolean;
445
442
  };
443
+ region?: SandboxRegion;
444
+ failoverRegions?: SandboxRegion[];
446
445
  signal?: AbortSignal;
447
446
  }>): Promise<Parsed<{
448
447
  sandbox: {
@@ -453,6 +452,7 @@ declare class APIClient extends BaseClient {
453
452
  currentSessionId: string;
454
453
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
455
454
  region?: string | undefined;
455
+ failoverRegions?: string[] | undefined;
456
456
  vcpus?: number | undefined;
457
457
  memory?: number | undefined;
458
458
  runtime?: string | undefined;
@@ -553,10 +553,6 @@ declare class APIClient extends BaseClient {
553
553
  statusUpdatedAt?: number | undefined;
554
554
  cwd?: string | undefined;
555
555
  tags?: Record<string, string> | undefined;
556
- mounts?: Record<string, {
557
- drive: string;
558
- mode?: "read-only" | "read-write" | undefined;
559
- }> | undefined;
560
556
  snapshotExpiration?: number | undefined;
561
557
  keepLastSnapshots?: {
562
558
  count: number;
@@ -570,13 +566,13 @@ declare class APIClient extends BaseClient {
570
566
  memory: number;
571
567
  vcpus: number;
572
568
  region: string;
573
- runtime: string;
574
569
  timeout: number;
575
570
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
576
571
  requestedAt: number;
577
572
  createdAt: number;
578
573
  cwd: string;
579
574
  updatedAt: number;
575
+ runtime?: string | undefined;
580
576
  startedAt?: number | undefined;
581
577
  requestedStopAt?: number | undefined;
582
578
  stoppedAt?: number | undefined;
@@ -772,13 +768,13 @@ declare class APIClient extends BaseClient {
772
768
  memory: number;
773
769
  vcpus: number;
774
770
  region: string;
775
- runtime: string;
776
771
  timeout: number;
777
772
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
778
773
  requestedAt: number;
779
774
  createdAt: number;
780
775
  cwd: string;
781
776
  updatedAt: number;
777
+ runtime?: string | undefined;
782
778
  startedAt?: number | undefined;
783
779
  requestedStopAt?: number | undefined;
784
780
  stoppedAt?: number | undefined;
@@ -917,6 +913,7 @@ declare class APIClient extends BaseClient {
917
913
  sizeBytes: number;
918
914
  createdAt: number;
919
915
  updatedAt: number;
916
+ regions?: string[] | undefined;
920
917
  expiresAt?: number | undefined;
921
918
  lastUsedAt?: number | undefined;
922
919
  creationMethod?: string | undefined;
@@ -955,6 +952,7 @@ declare class APIClient extends BaseClient {
955
952
  sizeBytes: number;
956
953
  createdAt: number;
957
954
  updatedAt: number;
955
+ regions?: string[] | undefined;
958
956
  expiresAt?: number | undefined;
959
957
  lastUsedAt?: number | undefined;
960
958
  creationMethod?: string | undefined;
@@ -968,6 +966,7 @@ declare class APIClient extends BaseClient {
968
966
  sizeBytes: number;
969
967
  createdAt: number;
970
968
  updatedAt: number;
969
+ regions?: string[] | undefined;
971
970
  expiresAt?: number | undefined;
972
971
  lastUsedAt?: number | undefined;
973
972
  creationMethod?: string | undefined;
@@ -988,6 +987,7 @@ declare class APIClient extends BaseClient {
988
987
  sizeBytes: number;
989
988
  createdAt: number;
990
989
  updatedAt: number;
990
+ regions?: string[] | undefined;
991
991
  expiresAt?: number | undefined;
992
992
  lastUsedAt?: number | undefined;
993
993
  creationMethod?: string | undefined;
@@ -1001,6 +1001,7 @@ declare class APIClient extends BaseClient {
1001
1001
  sizeBytes: number;
1002
1002
  createdAt: number;
1003
1003
  updatedAt: number;
1004
+ regions?: string[] | undefined;
1004
1005
  expiresAt?: number | undefined;
1005
1006
  lastUsedAt?: number | undefined;
1006
1007
  creationMethod?: string | undefined;
@@ -1009,47 +1010,6 @@ declare class APIClient extends BaseClient {
1009
1010
  count: string;
1010
1011
  } | undefined;
1011
1012
  }>>;
1012
- listDrives(params: {
1013
- projectId: string;
1014
- limit?: number;
1015
- cursor?: string | number;
1016
- since?: number | string;
1017
- until?: number | string;
1018
- sortBy?: "createdAt" | "updatedAt" | "name";
1019
- sortOrder?: "asc" | "desc";
1020
- namePrefix?: string;
1021
- signal?: AbortSignal;
1022
- }): Promise<Parsed<{
1023
- drives: {
1024
- name: string;
1025
- projectId: string;
1026
- maxSizeBytes: number;
1027
- createdAt: number;
1028
- updatedAt: number;
1029
- currentSessionId?: string | undefined;
1030
- currentSandboxName?: string | undefined;
1031
- }[];
1032
- pagination: {
1033
- count: number;
1034
- next: string | null;
1035
- };
1036
- }>>;
1037
- getOrCreateDrive(params: {
1038
- projectId: string;
1039
- name: string;
1040
- maxSizeBytes?: number;
1041
- signal?: AbortSignal;
1042
- }): Promise<Parsed<{
1043
- drive: {
1044
- name: string;
1045
- projectId: string;
1046
- maxSizeBytes: number;
1047
- createdAt: number;
1048
- updatedAt: number;
1049
- currentSessionId?: string | undefined;
1050
- currentSandboxName?: string | undefined;
1051
- };
1052
- }>>;
1053
1013
  writeFiles(params: {
1054
1014
  sessionId: string;
1055
1015
  cwd: string;
@@ -1132,6 +1092,7 @@ declare class APIClient extends BaseClient {
1132
1092
  currentSessionId: string;
1133
1093
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1134
1094
  region?: string | undefined;
1095
+ failoverRegions?: string[] | undefined;
1135
1096
  vcpus?: number | undefined;
1136
1097
  memory?: number | undefined;
1137
1098
  runtime?: string | undefined;
@@ -1232,10 +1193,6 @@ declare class APIClient extends BaseClient {
1232
1193
  statusUpdatedAt?: number | undefined;
1233
1194
  cwd?: string | undefined;
1234
1195
  tags?: Record<string, string> | undefined;
1235
- mounts?: Record<string, {
1236
- drive: string;
1237
- mode?: "read-only" | "read-write" | undefined;
1238
- }> | undefined;
1239
1196
  snapshotExpiration?: number | undefined;
1240
1197
  keepLastSnapshots?: {
1241
1198
  count: number;
@@ -1249,13 +1206,13 @@ declare class APIClient extends BaseClient {
1249
1206
  memory: number;
1250
1207
  vcpus: number;
1251
1208
  region: string;
1252
- runtime: string;
1253
1209
  timeout: number;
1254
1210
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1255
1211
  requestedAt: number;
1256
1212
  createdAt: number;
1257
1213
  cwd: string;
1258
1214
  updatedAt: number;
1215
+ runtime?: string | undefined;
1259
1216
  startedAt?: number | undefined;
1260
1217
  requestedStopAt?: number | undefined;
1261
1218
  stoppedAt?: number | undefined;
@@ -1363,14 +1320,19 @@ declare class APIClient extends BaseClient {
1363
1320
  }[];
1364
1321
  resumed?: boolean | undefined;
1365
1322
  }>>;
1366
- listSandboxes(params: {
1323
+ listSandboxes<Tags extends Record<string, string>>(params: {
1367
1324
  projectId: string;
1368
1325
  limit?: number;
1369
1326
  sortBy?: "createdAt" | "name" | "statusUpdatedAt";
1370
1327
  sortOrder?: "asc" | "desc";
1371
1328
  namePrefix?: string;
1372
1329
  cursor?: string;
1373
- tags?: Record<string, string>;
1330
+ /**
1331
+ * Filter sandboxes by tag. Only a single `{ key: value }` tag filter is
1332
+ * currently supported.
1333
+ * @example { env: "staging" }
1334
+ */
1335
+ tags?: Tags & SingleTagFilter<Tags>;
1374
1336
  signal?: AbortSignal;
1375
1337
  }): Promise<Parsed<{
1376
1338
  sandboxes: {
@@ -1381,6 +1343,7 @@ declare class APIClient extends BaseClient {
1381
1343
  currentSessionId: string;
1382
1344
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1383
1345
  region?: string | undefined;
1346
+ failoverRegions?: string[] | undefined;
1384
1347
  vcpus?: number | undefined;
1385
1348
  memory?: number | undefined;
1386
1349
  runtime?: string | undefined;
@@ -1481,10 +1444,6 @@ declare class APIClient extends BaseClient {
1481
1444
  statusUpdatedAt?: number | undefined;
1482
1445
  cwd?: string | undefined;
1483
1446
  tags?: Record<string, string> | undefined;
1484
- mounts?: Record<string, {
1485
- drive: string;
1486
- mode?: "read-only" | "read-write" | undefined;
1487
- }> | undefined;
1488
1447
  snapshotExpiration?: number | undefined;
1489
1448
  keepLastSnapshots?: {
1490
1449
  count: number;
@@ -1497,21 +1456,6 @@ declare class APIClient extends BaseClient {
1497
1456
  next: string | null;
1498
1457
  };
1499
1458
  }>>;
1500
- deleteDrive(params: {
1501
- projectId: string;
1502
- name: string;
1503
- signal?: AbortSignal;
1504
- }): Promise<Parsed<{
1505
- drive: {
1506
- name: string;
1507
- projectId: string;
1508
- maxSizeBytes: number;
1509
- createdAt: number;
1510
- updatedAt: number;
1511
- currentSessionId?: string | undefined;
1512
- currentSandboxName?: string | undefined;
1513
- };
1514
- }>>;
1515
1459
  updateSandbox(params: {
1516
1460
  name: string;
1517
1461
  projectId: string;
@@ -1520,7 +1464,6 @@ declare class APIClient extends BaseClient {
1520
1464
  vcpus?: number;
1521
1465
  memory?: number;
1522
1466
  };
1523
- runtime?: RUNTIMES | (string & {});
1524
1467
  timeout?: number;
1525
1468
  networkPolicy?: NetworkPolicy;
1526
1469
  tags?: Record<string, string>;
@@ -1532,6 +1475,8 @@ declare class APIClient extends BaseClient {
1532
1475
  deleteEvicted?: boolean;
1533
1476
  } | null;
1534
1477
  currentSnapshotId?: string;
1478
+ region?: SandboxRegion;
1479
+ failoverRegions?: SandboxRegion[];
1535
1480
  signal?: AbortSignal;
1536
1481
  }): Promise<Parsed<{
1537
1482
  sandbox: {
@@ -1542,6 +1487,7 @@ declare class APIClient extends BaseClient {
1542
1487
  currentSessionId: string;
1543
1488
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1544
1489
  region?: string | undefined;
1490
+ failoverRegions?: string[] | undefined;
1545
1491
  vcpus?: number | undefined;
1546
1492
  memory?: number | undefined;
1547
1493
  runtime?: string | undefined;
@@ -1642,10 +1588,6 @@ declare class APIClient extends BaseClient {
1642
1588
  statusUpdatedAt?: number | undefined;
1643
1589
  cwd?: string | undefined;
1644
1590
  tags?: Record<string, string> | undefined;
1645
- mounts?: Record<string, {
1646
- drive: string;
1647
- mode?: "read-only" | "read-write" | undefined;
1648
- }> | undefined;
1649
1591
  snapshotExpiration?: number | undefined;
1650
1592
  keepLastSnapshots?: {
1651
1593
  count: number;
@@ -1662,6 +1604,7 @@ declare class APIClient extends BaseClient {
1662
1604
  deleteSandbox(params: {
1663
1605
  name: string;
1664
1606
  projectId: string;
1607
+ deleteOrphanSnapshots?: boolean;
1665
1608
  signal?: AbortSignal;
1666
1609
  }): Promise<Parsed<{
1667
1610
  sandbox: {
@@ -1672,6 +1615,7 @@ declare class APIClient extends BaseClient {
1672
1615
  currentSessionId: string;
1673
1616
  status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1674
1617
  region?: string | undefined;
1618
+ failoverRegions?: string[] | undefined;
1675
1619
  vcpus?: number | undefined;
1676
1620
  memory?: number | undefined;
1677
1621
  runtime?: string | undefined;
@@ -1772,10 +1716,6 @@ declare class APIClient extends BaseClient {
1772
1716
  statusUpdatedAt?: number | undefined;
1773
1717
  cwd?: string | undefined;
1774
1718
  tags?: Record<string, string> | undefined;
1775
- mounts?: Record<string, {
1776
- drive: string;
1777
- mode?: "read-only" | "read-write" | undefined;
1778
- }> | undefined;
1779
1719
  snapshotExpiration?: number | undefined;
1780
1720
  keepLastSnapshots?: {
1781
1721
  count: number;
@@ -1790,6 +1730,8 @@ declare class APIClient extends BaseClient {
1790
1730
  }[] | undefined;
1791
1731
  }>>;
1792
1732
  }
1733
+ type UnionToIntersection<Union> = (Union extends unknown ? (arg: Union) => void : never) extends ((arg: infer Intersection) => void) ? Intersection : never;
1734
+ type SingleTagFilter<Tags> = [keyof Tags] extends [UnionToIntersection<keyof Tags>] ? Tags : "Error: filtering by multiple tags is not supported. Pass a single `{ key: value }` tag.";
1793
1735
  //#endregion
1794
- export { APIClient, WithFetchOptions };
1736
+ export { APIClient, SingleTagFilter, WithFetchOptions };
1795
1737
  //# sourceMappingURL=api-client.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import { RequestOptions } from "./with-retry.js";
2
- import { Options } from "../_async-retry.js";
3
2
  import "#compiled/zod/index.js";
3
+ import { Options } from "../_async-retry.js";
4
4
 
5
5
  //#region src/api-client/base-client.d.ts
6
6
  interface RequestParams extends RequestInit {
@@ -1,2 +1,2 @@
1
- import { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, Drive, DriveMetadata, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse } from "./validators.js";
1
+ import { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse } from "./validators.js";
2
2
  import { APIClient } from "./api-client.js";
@@ -7,7 +7,7 @@ declare const Session: z.ZodObject<{
7
7
  memory: z.ZodNumber;
8
8
  vcpus: z.ZodNumber;
9
9
  region: z.ZodString;
10
- runtime: z.ZodString;
10
+ runtime: z.ZodOptional<z.ZodString>;
11
11
  timeout: z.ZodNumber;
12
12
  status: z.ZodEnum<{
13
13
  pending: "pending";
@@ -130,6 +130,7 @@ declare const Snapshot: z.ZodObject<{
130
130
  id: z.ZodString;
131
131
  sourceSessionId: z.ZodString;
132
132
  region: z.ZodString;
133
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
133
134
  status: z.ZodEnum<{
134
135
  failed: "failed";
135
136
  created: "created";
@@ -160,7 +161,7 @@ declare const SessionResponse: z.ZodObject<{
160
161
  memory: z.ZodNumber;
161
162
  vcpus: z.ZodNumber;
162
163
  region: z.ZodString;
163
- runtime: z.ZodString;
164
+ runtime: z.ZodOptional<z.ZodString>;
164
165
  timeout: z.ZodNumber;
165
166
  status: z.ZodEnum<{
166
167
  pending: "pending";
@@ -329,6 +330,7 @@ declare const SnapshotTreeNode: z.ZodObject<{
329
330
  id: z.ZodString;
330
331
  sourceSessionId: z.ZodString;
331
332
  region: z.ZodString;
333
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
332
334
  status: z.ZodEnum<{
333
335
  failed: "failed";
334
336
  created: "created";
@@ -346,6 +348,7 @@ declare const SnapshotTreeNode: z.ZodObject<{
346
348
  id: z.ZodString;
347
349
  sourceSessionId: z.ZodString;
348
350
  region: z.ZodString;
351
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
349
352
  status: z.ZodEnum<{
350
353
  failed: "failed";
351
354
  created: "created";
@@ -367,6 +370,7 @@ declare const CreateSnapshotResponse: z.ZodObject<{
367
370
  id: z.ZodString;
368
371
  sourceSessionId: z.ZodString;
369
372
  region: z.ZodString;
373
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
370
374
  status: z.ZodEnum<{
371
375
  failed: "failed";
372
376
  created: "created";
@@ -385,7 +389,7 @@ declare const CreateSnapshotResponse: z.ZodObject<{
385
389
  memory: z.ZodNumber;
386
390
  vcpus: z.ZodNumber;
387
391
  region: z.ZodString;
388
- runtime: z.ZodString;
392
+ runtime: z.ZodOptional<z.ZodString>;
389
393
  timeout: z.ZodNumber;
390
394
  status: z.ZodEnum<{
391
395
  pending: "pending";
@@ -503,6 +507,7 @@ declare const SnapshotResponse: z.ZodObject<{
503
507
  id: z.ZodString;
504
508
  sourceSessionId: z.ZodString;
505
509
  region: z.ZodString;
510
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
506
511
  status: z.ZodEnum<{
507
512
  failed: "failed";
508
513
  created: "created";
@@ -517,20 +522,11 @@ declare const SnapshotResponse: z.ZodObject<{
517
522
  parentId: z.ZodOptional<z.ZodString>;
518
523
  }, z.core.$strip>;
519
524
  }, z.core.$strip>;
520
- declare const Drive: z.ZodObject<{
521
- name: z.ZodString;
522
- projectId: z.ZodString;
523
- maxSizeBytes: z.ZodNumber;
524
- currentSessionId: z.ZodOptional<z.ZodString>;
525
- currentSandboxName: z.ZodOptional<z.ZodString>;
526
- createdAt: z.ZodNumber;
527
- updatedAt: z.ZodNumber;
528
- }, z.core.$strip>;
529
- type DriveMetadata = z.infer<typeof Drive>;
530
525
  declare const Sandbox: z.ZodObject<{
531
526
  name: z.ZodString;
532
527
  persistent: z.ZodBoolean;
533
528
  region: z.ZodOptional<z.ZodString>;
529
+ failoverRegions: z.ZodOptional<z.ZodArray<z.ZodString>>;
534
530
  vcpus: z.ZodOptional<z.ZodNumber>;
535
531
  memory: z.ZodOptional<z.ZodNumber>;
536
532
  runtime: z.ZodOptional<z.ZodString>;
@@ -640,13 +636,6 @@ declare const Sandbox: z.ZodObject<{
640
636
  statusUpdatedAt: z.ZodOptional<z.ZodNumber>;
641
637
  cwd: z.ZodOptional<z.ZodString>;
642
638
  tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
643
- mounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
644
- drive: z.ZodString;
645
- mode: z.ZodOptional<z.ZodEnum<{
646
- "read-only": "read-only";
647
- "read-write": "read-write";
648
- }>>;
649
- }, z.core.$strip>>>;
650
639
  snapshotExpiration: z.ZodOptional<z.ZodNumber>;
651
640
  keepLastSnapshots: z.ZodOptional<z.ZodObject<{
652
641
  count: z.ZodNumber;
@@ -661,7 +650,7 @@ declare const StopSessionResponse: z.ZodObject<{
661
650
  memory: z.ZodNumber;
662
651
  vcpus: z.ZodNumber;
663
652
  region: z.ZodString;
664
- runtime: z.ZodString;
653
+ runtime: z.ZodOptional<z.ZodString>;
665
654
  timeout: z.ZodNumber;
666
655
  status: z.ZodEnum<{
667
656
  pending: "pending";
@@ -777,6 +766,7 @@ declare const StopSessionResponse: z.ZodObject<{
777
766
  name: z.ZodString;
778
767
  persistent: z.ZodBoolean;
779
768
  region: z.ZodOptional<z.ZodString>;
769
+ failoverRegions: z.ZodOptional<z.ZodArray<z.ZodString>>;
780
770
  vcpus: z.ZodOptional<z.ZodNumber>;
781
771
  memory: z.ZodOptional<z.ZodNumber>;
782
772
  runtime: z.ZodOptional<z.ZodString>;
@@ -886,13 +876,6 @@ declare const StopSessionResponse: z.ZodObject<{
886
876
  statusUpdatedAt: z.ZodOptional<z.ZodNumber>;
887
877
  cwd: z.ZodOptional<z.ZodString>;
888
878
  tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
889
- mounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
890
- drive: z.ZodString;
891
- mode: z.ZodOptional<z.ZodEnum<{
892
- "read-only": "read-only";
893
- "read-write": "read-write";
894
- }>>;
895
- }, z.core.$strip>>>;
896
879
  snapshotExpiration: z.ZodOptional<z.ZodNumber>;
897
880
  keepLastSnapshots: z.ZodOptional<z.ZodObject<{
898
881
  count: z.ZodNumber;
@@ -904,6 +887,7 @@ declare const StopSessionResponse: z.ZodObject<{
904
887
  id: z.ZodString;
905
888
  sourceSessionId: z.ZodString;
906
889
  region: z.ZodString;
890
+ regions: z.ZodOptional<z.ZodArray<z.ZodString>>;
907
891
  status: z.ZodEnum<{
908
892
  failed: "failed";
909
893
  created: "created";
@@ -919,5 +903,5 @@ declare const StopSessionResponse: z.ZodObject<{
919
903
  }, z.core.$strip>>;
920
904
  }, z.core.$strip>;
921
905
  //#endregion
922
- export { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, Drive, DriveMetadata, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse };
906
+ export { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse };
923
907
  //# sourceMappingURL=validators.d.ts.map
@@ -1,5 +1,15 @@
1
1
  //#region src/constants.d.ts
2
2
  type RUNTIMES = "node26" | "node24" | "node22" | "python3.13";
3
+ type ManagedImage = "universal" | "node:22" | "node:24" | "node:26" | "python:3.14" | "ubuntu" | "arch";
4
+ /**
5
+ * Regions a sandbox can run in. More regions may become available, so any
6
+ * other region string is accepted too.
7
+ */
8
+ type SandboxRegion = "iad1" | "sfo1" | "cle1" | "cdg1" | (string & {});
9
+ /**
10
+ * Region a sandbox runs in when none is requested.
11
+ */
12
+ declare const DEFAULT_SANDBOX_REGION = "iad1";
3
13
  //#endregion
4
- export { RUNTIMES };
14
+ export { DEFAULT_SANDBOX_REGION, ManagedImage, RUNTIMES, SandboxRegion };
5
15
  //# sourceMappingURL=constants.d.ts.map
@@ -1,13 +1,13 @@
1
1
  import { APIError, StreamError } from "./api-client/api-error.js";
2
2
  import { SnapshotTreeNodeData } from "./api-client/validators.js";
3
3
  import { NetworkPolicy, NetworkPolicyKeyValueMatcher, NetworkPolicyMatch, NetworkPolicyMatcher, NetworkPolicyRule, NetworkTransformer } from "./network-policy.js";
4
+ import { DEFAULT_SANDBOX_REGION, SandboxRegion } from "./constants.js";
4
5
  import { Command, CommandFinished, CommandOutput, SerializedCommand, SerializedCommandFinished } from "./command.js";
5
6
  import { SerializedSnapshot, Snapshot } from "./snapshot.js";
6
7
  import { ExecutionContext } from "./execution-context.js";
7
8
  import { Session } from "./session.js";
8
9
  import { FileSystem } from "./filesystem.js";
9
10
  import { SandboxUser, SandboxUserAlreadyExistsError } from "./sandbox-user.js";
10
- import { Sandbox, SandboxMountMode, SandboxMounts, SerializedSandbox } from "./sandbox.js";
11
- import { Drive, SerializedDrive } from "./drive.js";
11
+ import { Sandbox, SerializedSandbox } from "./sandbox.js";
12
12
  import { InvalidRequestProxyHandler, ProxyHandler, ProxyMeta, defineSandboxProxy } from "./proxy.js";
13
- export { APIError, Command, CommandFinished, type CommandOutput, Drive, type ExecutionContext, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, type SandboxMountMode, type SandboxMounts, SandboxUser, SandboxUserAlreadyExistsError, type SerializedCommand, type SerializedCommandFinished, type SerializedDrive, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };
13
+ export { APIError, Command, CommandFinished, type CommandOutput, DEFAULT_SANDBOX_REGION, type ExecutionContext, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, type SandboxRegion, SandboxUser, SandboxUserAlreadyExistsError, type SerializedCommand, type SerializedCommandFinished, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };