@stateset/sandbox-cli 1.0.6 → 3.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (411) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/LICENSE +22 -0
  3. package/README.md +590 -6
  4. package/dist/client.d.ts +761 -10
  5. package/dist/client.d.ts.map +1 -1
  6. package/dist/client.js +684 -12
  7. package/dist/client.js.map +1 -1
  8. package/dist/commands/alias.d.ts +5 -0
  9. package/dist/commands/alias.d.ts.map +1 -0
  10. package/dist/commands/alias.js +131 -0
  11. package/dist/commands/alias.js.map +1 -0
  12. package/dist/commands/api-key.d.ts +3 -0
  13. package/dist/commands/api-key.d.ts.map +1 -0
  14. package/dist/commands/api-key.js +119 -0
  15. package/dist/commands/api-key.js.map +1 -0
  16. package/dist/commands/artifact.d.ts.map +1 -1
  17. package/dist/commands/artifact.js +105 -46
  18. package/dist/commands/artifact.js.map +1 -1
  19. package/dist/commands/audit.d.ts +3 -0
  20. package/dist/commands/audit.d.ts.map +1 -0
  21. package/dist/commands/audit.js +191 -0
  22. package/dist/commands/audit.js.map +1 -0
  23. package/dist/commands/auth.d.ts +3 -0
  24. package/dist/commands/auth.d.ts.map +1 -0
  25. package/dist/commands/auth.js +126 -0
  26. package/dist/commands/auth.js.map +1 -0
  27. package/dist/commands/benchmark.d.ts +3 -0
  28. package/dist/commands/benchmark.d.ts.map +1 -0
  29. package/dist/commands/benchmark.js +166 -0
  30. package/dist/commands/benchmark.js.map +1 -0
  31. package/dist/commands/billing.d.ts +3 -0
  32. package/dist/commands/billing.d.ts.map +1 -0
  33. package/dist/commands/billing.js +139 -0
  34. package/dist/commands/billing.js.map +1 -0
  35. package/dist/commands/checkpoint.d.ts.map +1 -1
  36. package/dist/commands/checkpoint.js +105 -48
  37. package/dist/commands/checkpoint.js.map +1 -1
  38. package/dist/commands/completion.d.ts +3 -0
  39. package/dist/commands/completion.d.ts.map +1 -0
  40. package/dist/commands/completion.js +134 -0
  41. package/dist/commands/completion.js.map +1 -0
  42. package/dist/commands/computer-use.d.ts +3 -0
  43. package/dist/commands/computer-use.d.ts.map +1 -0
  44. package/dist/commands/computer-use.js +124 -0
  45. package/dist/commands/computer-use.js.map +1 -0
  46. package/dist/commands/config.d.ts.map +1 -1
  47. package/dist/commands/config.js +2 -1
  48. package/dist/commands/config.js.map +1 -1
  49. package/dist/commands/context.d.ts +3 -0
  50. package/dist/commands/context.d.ts.map +1 -0
  51. package/dist/commands/context.js +98 -0
  52. package/dist/commands/context.js.map +1 -0
  53. package/dist/commands/cp.d.ts +3 -0
  54. package/dist/commands/cp.d.ts.map +1 -0
  55. package/dist/commands/cp.js +165 -0
  56. package/dist/commands/cp.js.map +1 -0
  57. package/dist/commands/deploy.d.ts +3 -0
  58. package/dist/commands/deploy.d.ts.map +1 -1
  59. package/dist/commands/deploy.js +68 -20
  60. package/dist/commands/deploy.js.map +1 -1
  61. package/dist/commands/diff.d.ts +3 -0
  62. package/dist/commands/diff.d.ts.map +1 -0
  63. package/dist/commands/diff.js +186 -0
  64. package/dist/commands/diff.js.map +1 -0
  65. package/dist/commands/doctor.d.ts +30 -0
  66. package/dist/commands/doctor.d.ts.map +1 -1
  67. package/dist/commands/doctor.js +177 -207
  68. package/dist/commands/doctor.js.map +1 -1
  69. package/dist/commands/egress.d.ts +3 -0
  70. package/dist/commands/egress.d.ts.map +1 -0
  71. package/dist/commands/egress.js +155 -0
  72. package/dist/commands/egress.js.map +1 -0
  73. package/dist/commands/env.d.ts +3 -0
  74. package/dist/commands/env.d.ts.map +1 -0
  75. package/dist/commands/env.js +169 -0
  76. package/dist/commands/env.js.map +1 -0
  77. package/dist/commands/governance.d.ts +47 -0
  78. package/dist/commands/governance.d.ts.map +1 -0
  79. package/dist/commands/governance.js +345 -0
  80. package/dist/commands/governance.js.map +1 -0
  81. package/dist/commands/grade.d.ts +41 -0
  82. package/dist/commands/grade.d.ts.map +1 -1
  83. package/dist/commands/grade.js +255 -160
  84. package/dist/commands/grade.js.map +1 -1
  85. package/dist/commands/history.d.ts +4 -0
  86. package/dist/commands/history.d.ts.map +1 -0
  87. package/dist/commands/history.js +157 -0
  88. package/dist/commands/history.js.map +1 -0
  89. package/dist/commands/images.d.ts +8 -0
  90. package/dist/commands/images.d.ts.map +1 -0
  91. package/dist/commands/images.js +145 -0
  92. package/dist/commands/images.js.map +1 -0
  93. package/dist/commands/info.d.ts +3 -0
  94. package/dist/commands/info.d.ts.map +1 -0
  95. package/dist/commands/info.js +86 -0
  96. package/dist/commands/info.js.map +1 -0
  97. package/dist/commands/init.d.ts +3 -0
  98. package/dist/commands/init.d.ts.map +1 -0
  99. package/dist/commands/init.js +185 -0
  100. package/dist/commands/init.js.map +1 -0
  101. package/dist/commands/logs.d.ts +3 -0
  102. package/dist/commands/logs.d.ts.map +1 -0
  103. package/dist/commands/logs.js +129 -0
  104. package/dist/commands/logs.js.map +1 -0
  105. package/dist/commands/mcp.d.ts +3 -0
  106. package/dist/commands/mcp.d.ts.map +1 -0
  107. package/dist/commands/mcp.js +141 -0
  108. package/dist/commands/mcp.js.map +1 -0
  109. package/dist/commands/open.d.ts +3 -0
  110. package/dist/commands/open.d.ts.map +1 -0
  111. package/dist/commands/open.js +96 -0
  112. package/dist/commands/open.js.map +1 -0
  113. package/dist/commands/platform-status.d.ts +25 -5
  114. package/dist/commands/platform-status.d.ts.map +1 -1
  115. package/dist/commands/platform-status.js +199 -149
  116. package/dist/commands/platform-status.js.map +1 -1
  117. package/dist/commands/plugin.d.ts +5 -0
  118. package/dist/commands/plugin.d.ts.map +1 -0
  119. package/dist/commands/plugin.js +126 -0
  120. package/dist/commands/plugin.js.map +1 -0
  121. package/dist/commands/pool.d.ts.map +1 -1
  122. package/dist/commands/pool.js +52 -66
  123. package/dist/commands/pool.js.map +1 -1
  124. package/dist/commands/profile.d.ts +3 -0
  125. package/dist/commands/profile.d.ts.map +1 -0
  126. package/dist/commands/profile.js +107 -0
  127. package/dist/commands/profile.js.map +1 -0
  128. package/dist/commands/repl.d.ts +3 -0
  129. package/dist/commands/repl.d.ts.map +1 -0
  130. package/dist/commands/repl.js +390 -0
  131. package/dist/commands/repl.js.map +1 -0
  132. package/dist/commands/run.d.ts +3 -0
  133. package/dist/commands/run.d.ts.map +1 -0
  134. package/dist/commands/run.js +121 -0
  135. package/dist/commands/run.js.map +1 -0
  136. package/dist/commands/sandbox-processes.d.ts +27 -0
  137. package/dist/commands/sandbox-processes.d.ts.map +1 -0
  138. package/dist/commands/sandbox-processes.js +195 -0
  139. package/dist/commands/sandbox-processes.js.map +1 -0
  140. package/dist/commands/sandbox.d.ts.map +1 -1
  141. package/dist/commands/sandbox.js +506 -98
  142. package/dist/commands/sandbox.js.map +1 -1
  143. package/dist/commands/secret.d.ts +3 -0
  144. package/dist/commands/secret.d.ts.map +1 -0
  145. package/dist/commands/secret.js +128 -0
  146. package/dist/commands/secret.js.map +1 -0
  147. package/dist/commands/session.d.ts.map +1 -1
  148. package/dist/commands/session.js +285 -52
  149. package/dist/commands/session.js.map +1 -1
  150. package/dist/commands/snapshot.d.ts +3 -0
  151. package/dist/commands/snapshot.d.ts.map +1 -0
  152. package/dist/commands/snapshot.js +253 -0
  153. package/dist/commands/snapshot.js.map +1 -0
  154. package/dist/commands/ssh.d.ts +5 -0
  155. package/dist/commands/ssh.d.ts.map +1 -0
  156. package/dist/commands/ssh.js +154 -0
  157. package/dist/commands/ssh.js.map +1 -0
  158. package/dist/commands/template.d.ts +3 -0
  159. package/dist/commands/template.d.ts.map +1 -0
  160. package/dist/commands/template.js +102 -0
  161. package/dist/commands/template.js.map +1 -0
  162. package/dist/commands/terminal.d.ts +53 -0
  163. package/dist/commands/terminal.d.ts.map +1 -0
  164. package/dist/commands/terminal.js +381 -0
  165. package/dist/commands/terminal.js.map +1 -0
  166. package/dist/commands/top.d.ts +3 -0
  167. package/dist/commands/top.d.ts.map +1 -0
  168. package/dist/commands/top.js +116 -0
  169. package/dist/commands/top.js.map +1 -0
  170. package/dist/commands/tunnel.d.ts.map +1 -1
  171. package/dist/commands/tunnel.js +73 -26
  172. package/dist/commands/tunnel.js.map +1 -1
  173. package/dist/commands/update.d.ts +3 -0
  174. package/dist/commands/update.d.ts.map +1 -0
  175. package/dist/commands/update.js +51 -0
  176. package/dist/commands/update.js.map +1 -0
  177. package/dist/commands/wait.d.ts +3 -0
  178. package/dist/commands/wait.d.ts.map +1 -0
  179. package/dist/commands/wait.js +64 -0
  180. package/dist/commands/wait.js.map +1 -0
  181. package/dist/commands/webhook.d.ts +3 -0
  182. package/dist/commands/webhook.d.ts.map +1 -0
  183. package/dist/commands/webhook.js +169 -0
  184. package/dist/commands/webhook.js.map +1 -0
  185. package/dist/config.d.ts +14 -6
  186. package/dist/config.d.ts.map +1 -1
  187. package/dist/config.js +109 -16
  188. package/dist/config.js.map +1 -1
  189. package/dist/index.js +165 -11
  190. package/dist/index.js.map +1 -1
  191. package/dist/sandboxctl.d.ts +3 -0
  192. package/dist/sandboxctl.d.ts.map +1 -0
  193. package/dist/sandboxctl.js +37 -0
  194. package/dist/sandboxctl.js.map +1 -0
  195. package/dist/utils/context.d.ts +23 -0
  196. package/dist/utils/context.d.ts.map +1 -0
  197. package/dist/utils/context.js +48 -0
  198. package/dist/utils/context.js.map +1 -0
  199. package/dist/utils/credentials.d.ts +8 -0
  200. package/dist/utils/credentials.d.ts.map +1 -0
  201. package/dist/utils/credentials.js +120 -0
  202. package/dist/utils/credentials.js.map +1 -0
  203. package/dist/utils/dry-run.d.ts +4 -0
  204. package/dist/utils/dry-run.d.ts.map +1 -0
  205. package/dist/utils/dry-run.js +24 -0
  206. package/dist/utils/dry-run.js.map +1 -0
  207. package/dist/utils/egress-policy.d.ts +31 -0
  208. package/dist/utils/egress-policy.d.ts.map +1 -0
  209. package/dist/utils/egress-policy.js +83 -0
  210. package/dist/utils/egress-policy.js.map +1 -0
  211. package/dist/utils/errors.d.ts +53 -0
  212. package/dist/utils/errors.d.ts.map +1 -0
  213. package/dist/utils/errors.js +278 -0
  214. package/dist/utils/errors.js.map +1 -0
  215. package/dist/utils/file-content.d.ts +10 -0
  216. package/dist/utils/file-content.d.ts.map +1 -0
  217. package/dist/utils/file-content.js +14 -0
  218. package/dist/utils/file-content.js.map +1 -0
  219. package/dist/utils/grade-target.d.ts +12 -0
  220. package/dist/utils/grade-target.d.ts.map +1 -0
  221. package/dist/utils/grade-target.js +106 -0
  222. package/dist/utils/grade-target.js.map +1 -0
  223. package/dist/utils/health-report.d.ts +18 -0
  224. package/dist/utils/health-report.d.ts.map +1 -0
  225. package/dist/utils/health-report.js +43 -0
  226. package/dist/utils/health-report.js.map +1 -0
  227. package/dist/utils/output.d.ts +20 -0
  228. package/dist/utils/output.d.ts.map +1 -0
  229. package/dist/utils/output.js +123 -0
  230. package/dist/utils/output.js.map +1 -0
  231. package/dist/utils/plugins.d.ts +17 -0
  232. package/dist/utils/plugins.d.ts.map +1 -0
  233. package/dist/utils/plugins.js +57 -0
  234. package/dist/utils/plugins.js.map +1 -0
  235. package/dist/utils/resource-class.d.ts +12 -0
  236. package/dist/utils/resource-class.d.ts.map +1 -0
  237. package/dist/utils/resource-class.js +17 -0
  238. package/dist/utils/resource-class.js.map +1 -0
  239. package/dist/utils/shutdown.d.ts +14 -0
  240. package/dist/utils/shutdown.d.ts.map +1 -0
  241. package/dist/utils/shutdown.js +54 -0
  242. package/dist/utils/shutdown.js.map +1 -0
  243. package/dist/utils/tty.d.ts +44 -0
  244. package/dist/utils/tty.d.ts.map +1 -0
  245. package/dist/utils/tty.js +93 -0
  246. package/dist/utils/tty.js.map +1 -0
  247. package/dist/utils/warnings.d.ts +4 -0
  248. package/dist/utils/warnings.d.ts.map +1 -0
  249. package/dist/utils/warnings.js +22 -0
  250. package/dist/utils/warnings.js.map +1 -0
  251. package/dist/utils/watch.d.ts +7 -0
  252. package/dist/utils/watch.d.ts.map +1 -0
  253. package/dist/utils/watch.js +55 -0
  254. package/dist/utils/watch.js.map +1 -0
  255. package/dist/workbench/actions.d.ts +26 -0
  256. package/dist/workbench/actions.d.ts.map +1 -0
  257. package/dist/workbench/actions.js +38 -0
  258. package/dist/workbench/actions.js.map +1 -0
  259. package/dist/workbench/agent-chat.d.ts +71 -0
  260. package/dist/workbench/agent-chat.d.ts.map +1 -0
  261. package/dist/workbench/agent-chat.js +223 -0
  262. package/dist/workbench/agent-chat.js.map +1 -0
  263. package/dist/workbench/batch-uploads.d.ts +36 -0
  264. package/dist/workbench/batch-uploads.d.ts.map +1 -0
  265. package/dist/workbench/batch-uploads.js +154 -0
  266. package/dist/workbench/batch-uploads.js.map +1 -0
  267. package/dist/workbench/commands.d.ts +6 -0
  268. package/dist/workbench/commands.d.ts.map +1 -0
  269. package/dist/workbench/commands.js +511 -0
  270. package/dist/workbench/commands.js.map +1 -0
  271. package/dist/workbench/connection-failure.d.ts +9 -0
  272. package/dist/workbench/connection-failure.d.ts.map +1 -0
  273. package/dist/workbench/connection-failure.js +27 -0
  274. package/dist/workbench/connection-failure.js.map +1 -0
  275. package/dist/workbench/connection.d.ts +4 -0
  276. package/dist/workbench/connection.d.ts.map +1 -0
  277. package/dist/workbench/connection.js +28 -0
  278. package/dist/workbench/connection.js.map +1 -0
  279. package/dist/workbench/creation.d.ts +22 -0
  280. package/dist/workbench/creation.d.ts.map +1 -0
  281. package/dist/workbench/creation.js +102 -0
  282. package/dist/workbench/creation.js.map +1 -0
  283. package/dist/workbench/credits.d.ts +11 -0
  284. package/dist/workbench/credits.d.ts.map +1 -0
  285. package/dist/workbench/credits.js +132 -0
  286. package/dist/workbench/credits.js.map +1 -0
  287. package/dist/workbench/docker.d.ts +18 -0
  288. package/dist/workbench/docker.d.ts.map +1 -0
  289. package/dist/workbench/docker.js +207 -0
  290. package/dist/workbench/docker.js.map +1 -0
  291. package/dist/workbench/execution.d.ts +14 -0
  292. package/dist/workbench/execution.d.ts.map +1 -0
  293. package/dist/workbench/execution.js +24 -0
  294. package/dist/workbench/execution.js.map +1 -0
  295. package/dist/workbench/files.d.ts +51 -0
  296. package/dist/workbench/files.d.ts.map +1 -0
  297. package/dist/workbench/files.js +80 -0
  298. package/dist/workbench/files.js.map +1 -0
  299. package/dist/workbench/history.d.ts +34 -0
  300. package/dist/workbench/history.d.ts.map +1 -0
  301. package/dist/workbench/history.js +50 -0
  302. package/dist/workbench/history.js.map +1 -0
  303. package/dist/workbench/input-batch-commands.d.ts +6 -0
  304. package/dist/workbench/input-batch-commands.d.ts.map +1 -0
  305. package/dist/workbench/input-batch-commands.js +41 -0
  306. package/dist/workbench/input-batch-commands.js.map +1 -0
  307. package/dist/workbench/kitty-diacritics.d.ts +2 -0
  308. package/dist/workbench/kitty-diacritics.d.ts.map +1 -0
  309. package/dist/workbench/kitty-diacritics.js +22 -0
  310. package/dist/workbench/kitty-diacritics.js.map +1 -0
  311. package/dist/workbench/kitty-graphics.d.ts +59 -0
  312. package/dist/workbench/kitty-graphics.d.ts.map +1 -0
  313. package/dist/workbench/kitty-graphics.js +263 -0
  314. package/dist/workbench/kitty-graphics.js.map +1 -0
  315. package/dist/workbench/live-execution.d.ts +51 -0
  316. package/dist/workbench/live-execution.d.ts.map +1 -0
  317. package/dist/workbench/live-execution.js +222 -0
  318. package/dist/workbench/live-execution.js.map +1 -0
  319. package/dist/workbench/model.d.ts +106 -0
  320. package/dist/workbench/model.d.ts.map +1 -0
  321. package/dist/workbench/model.js +236 -0
  322. package/dist/workbench/model.js.map +1 -0
  323. package/dist/workbench/overview.d.ts +11 -0
  324. package/dist/workbench/overview.d.ts.map +1 -0
  325. package/dist/workbench/overview.js +92 -0
  326. package/dist/workbench/overview.js.map +1 -0
  327. package/dist/workbench/png.d.ts +10 -0
  328. package/dist/workbench/png.d.ts.map +1 -0
  329. package/dist/workbench/png.js +51 -0
  330. package/dist/workbench/png.js.map +1 -0
  331. package/dist/workbench/python-task.d.ts +21 -0
  332. package/dist/workbench/python-task.d.ts.map +1 -0
  333. package/dist/workbench/python-task.js +52 -0
  334. package/dist/workbench/python-task.js.map +1 -0
  335. package/dist/workbench/registry-commands.d.ts +8 -0
  336. package/dist/workbench/registry-commands.d.ts.map +1 -0
  337. package/dist/workbench/registry-commands.js +93 -0
  338. package/dist/workbench/registry-commands.js.map +1 -0
  339. package/dist/workbench/registry.d.ts +76 -0
  340. package/dist/workbench/registry.d.ts.map +1 -0
  341. package/dist/workbench/registry.js +353 -0
  342. package/dist/workbench/registry.js.map +1 -0
  343. package/dist/workbench/renderer.d.ts +6 -0
  344. package/dist/workbench/renderer.d.ts.map +1 -0
  345. package/dist/workbench/renderer.js +18 -0
  346. package/dist/workbench/renderer.js.map +1 -0
  347. package/dist/workbench/results.d.ts +15 -0
  348. package/dist/workbench/results.d.ts.map +1 -0
  349. package/dist/workbench/results.js +29 -0
  350. package/dist/workbench/results.js.map +1 -0
  351. package/dist/workbench/task-archive.d.ts +23 -0
  352. package/dist/workbench/task-archive.d.ts.map +1 -0
  353. package/dist/workbench/task-archive.js +56 -0
  354. package/dist/workbench/task-archive.js.map +1 -0
  355. package/dist/workbench/task-board.d.ts +26 -0
  356. package/dist/workbench/task-board.d.ts.map +1 -0
  357. package/dist/workbench/task-board.js +43 -0
  358. package/dist/workbench/task-board.js.map +1 -0
  359. package/dist/workbench/task-monitor.d.ts +35 -0
  360. package/dist/workbench/task-monitor.d.ts.map +1 -0
  361. package/dist/workbench/task-monitor.js +176 -0
  362. package/dist/workbench/task-monitor.js.map +1 -0
  363. package/dist/workbench/tasks.d.ts +93 -0
  364. package/dist/workbench/tasks.d.ts.map +1 -0
  365. package/dist/workbench/tasks.js +195 -0
  366. package/dist/workbench/tasks.js.map +1 -0
  367. package/dist/workbench/terminal.d.ts +82 -0
  368. package/dist/workbench/terminal.d.ts.map +1 -0
  369. package/dist/workbench/terminal.js +2577 -0
  370. package/dist/workbench/terminal.js.map +1 -0
  371. package/dist/workbench/text.d.ts +10 -0
  372. package/dist/workbench/text.d.ts.map +1 -0
  373. package/dist/workbench/text.js +72 -0
  374. package/dist/workbench/text.js.map +1 -0
  375. package/dist/workbench/uploads.d.ts +12 -0
  376. package/dist/workbench/uploads.d.ts.map +1 -0
  377. package/dist/workbench/uploads.js +16 -0
  378. package/dist/workbench/uploads.js.map +1 -0
  379. package/dist/workbench/worker-launch.d.ts +10 -0
  380. package/dist/workbench/worker-launch.d.ts.map +1 -0
  381. package/dist/workbench/worker-launch.js +30 -0
  382. package/dist/workbench/worker-launch.js.map +1 -0
  383. package/dist/workbench/worker-monitor.d.ts +33 -0
  384. package/dist/workbench/worker-monitor.d.ts.map +1 -0
  385. package/dist/workbench/worker-monitor.js +142 -0
  386. package/dist/workbench/worker-monitor.js.map +1 -0
  387. package/dist/workbench/worker-output.d.ts +8 -0
  388. package/dist/workbench/worker-output.d.ts.map +1 -0
  389. package/dist/workbench/worker-output.js +32 -0
  390. package/dist/workbench/worker-output.js.map +1 -0
  391. package/dist/workbench/worker-result.d.ts +29 -0
  392. package/dist/workbench/worker-result.d.ts.map +1 -0
  393. package/dist/workbench/worker-result.js +85 -0
  394. package/dist/workbench/worker-result.js.map +1 -0
  395. package/dist/workbench/workers.d.ts +49 -0
  396. package/dist/workbench/workers.d.ts.map +1 -0
  397. package/dist/workbench/workers.js +53 -0
  398. package/dist/workbench/workers.js.map +1 -0
  399. package/package.json +38 -17
  400. package/dist/__tests__/client.test.d.ts +0 -2
  401. package/dist/__tests__/client.test.d.ts.map +0 -1
  402. package/dist/__tests__/client.test.js +0 -198
  403. package/dist/__tests__/client.test.js.map +0 -1
  404. package/dist/__tests__/config.test.d.ts +0 -2
  405. package/dist/__tests__/config.test.d.ts.map +0 -1
  406. package/dist/__tests__/config.test.js +0 -74
  407. package/dist/__tests__/config.test.js.map +0 -1
  408. package/dist/__tests__/utils-cli.test.d.ts +0 -2
  409. package/dist/__tests__/utils-cli.test.d.ts.map +0 -1
  410. package/dist/__tests__/utils-cli.test.js +0 -35
  411. package/dist/__tests__/utils-cli.test.js.map +0 -1
@@ -0,0 +1,253 @@
1
+ import { Command } from 'commander';
2
+ import chalk from 'chalk';
3
+ import ora from 'ora';
4
+ import { getClient } from '../client.js';
5
+ import { formatDateTime, parseIntOption } from '../utils/cli.js';
6
+ import { withRetry, handleCommandError } from '../utils/errors.js';
7
+ export const snapshotCommand = new Command('snapshot')
8
+ .description('Manage Firecracker snapshots');
9
+ snapshotCommand
10
+ .command('list')
11
+ .description('List all snapshot profiles')
12
+ .option('--json', 'Output as JSON')
13
+ .action(async (options) => {
14
+ const spinner = ora('Fetching snapshot list...').start();
15
+ try {
16
+ const client = getClient();
17
+ const result = await withRetry(() => client.snapshots.list(), { spinner });
18
+ spinner.stop();
19
+ if (options.json) {
20
+ console.log(JSON.stringify(result, null, 2));
21
+ return;
22
+ }
23
+ console.log(chalk.bold('Snapshot Profiles'));
24
+ console.log(chalk.gray(`Enabled: ${result.enabled ? 'yes' : 'no'}`));
25
+ console.log(chalk.gray(`Total: ${result.total}`));
26
+ console.log();
27
+ for (const snapshot of result.snapshots) {
28
+ console.log(chalk.green(snapshot.profileKey));
29
+ console.log(chalk.gray(` Created: ${formatDateTime(snapshot.createdAt)}`));
30
+ console.log(chalk.gray(` vCPU: ${snapshot.vcpuCount}`));
31
+ console.log(chalk.gray(` Memory: ${snapshot.memSizeMib} MiB`));
32
+ }
33
+ }
34
+ catch (error) {
35
+ handleCommandError(error, spinner);
36
+ }
37
+ });
38
+ snapshotCommand
39
+ .command('status')
40
+ .description('Show snapshot status and configuration')
41
+ .option('--json', 'Output as JSON')
42
+ .action(async (options) => {
43
+ const spinner = ora('Fetching snapshot status...').start();
44
+ try {
45
+ const client = getClient();
46
+ const status = await withRetry(() => client.snapshots.status(), { spinner });
47
+ spinner.stop();
48
+ if (options.json) {
49
+ console.log(JSON.stringify(status, null, 2));
50
+ return;
51
+ }
52
+ console.log(chalk.bold('Snapshot Status'));
53
+ console.log(chalk.gray(`Enabled: ${status.enabled ? 'yes' : 'no'}`));
54
+ console.log(chalk.gray(`Count: ${status.snapshotCount}`));
55
+ console.log(chalk.gray(`Directory: ${status.snapshotDir}`));
56
+ console.log(chalk.gray(`Backend: ${status.memoryBackend}`));
57
+ console.log(chalk.gray(`Type: ${status.snapshotType}`));
58
+ }
59
+ catch (error) {
60
+ handleCommandError(error, spinner);
61
+ }
62
+ });
63
+ snapshotCommand
64
+ .command('create')
65
+ .description('Create a snapshot profile')
66
+ .option('-p, --profile <profile>', 'Profile key (for example 2vcpu-2048mb)')
67
+ .option('--vcpu-count <count>', 'CPU count for generated profile key')
68
+ .option('--mem-size-mib <size>', 'Memory size in MiB')
69
+ .option('--kernel-path <path>', 'Kernel path to attach in metadata')
70
+ .option('--rootfs-path <path>', 'Rootfs path to attach in metadata')
71
+ .option('--dry-run', 'Preview without creating')
72
+ .action(async (options) => {
73
+ const spinner = ora('Creating snapshot...').start();
74
+ try {
75
+ const payload = {};
76
+ if (options.profile) {
77
+ payload.profile = options.profile;
78
+ }
79
+ if (options.vcpuCount) {
80
+ payload.vcpu_count = parseIntOption(options.vcpuCount, { label: 'vcpu-count', min: 1 });
81
+ }
82
+ if (options.memSizeMib) {
83
+ payload.mem_size_mib = parseIntOption(options.memSizeMib, { label: 'mem-size-mib', min: 1 });
84
+ }
85
+ if (options.kernelPath) {
86
+ payload.kernel_path = options.kernelPath;
87
+ }
88
+ if (options.rootfsPath) {
89
+ payload.rootfs_path = options.rootfsPath;
90
+ }
91
+ const client = getClient();
92
+ const snapshot = await withRetry(() => client.snapshots.create(payload), { spinner });
93
+ const output = {
94
+ Profile: snapshot.profileKey,
95
+ MemoryPath: snapshot.memoryPath,
96
+ StatePath: snapshot.statePath,
97
+ 'Created At': formatDateTime(snapshot.createdAt),
98
+ Vcpus: snapshot.vcpuCount,
99
+ 'Memory (MiB)': snapshot.memSizeMib,
100
+ 'Snapshot Type': snapshot.snapshotType,
101
+ 'Memory Backend': snapshot.memoryBackend,
102
+ };
103
+ spinner.stop();
104
+ console.log(chalk.bold('Snapshot created'));
105
+ for (const [key, value] of Object.entries(output)) {
106
+ console.log(chalk.gray(`${key}:`), String(value));
107
+ }
108
+ console.log(chalk.gray(`Version: ${snapshot.version}`));
109
+ }
110
+ catch (error) {
111
+ handleCommandError(error, spinner);
112
+ }
113
+ });
114
+ snapshotCommand
115
+ .command('get <profileKey>')
116
+ .description('Get snapshot metadata')
117
+ .option('--json', 'Output as JSON')
118
+ .action(async (profileKey, options) => {
119
+ const spinner = ora('Fetching snapshot metadata...').start();
120
+ try {
121
+ const client = getClient();
122
+ const snapshot = await withRetry(() => client.snapshots.get(profileKey), { spinner });
123
+ spinner.stop();
124
+ if (options.json) {
125
+ console.log(JSON.stringify(snapshot, null, 2));
126
+ return;
127
+ }
128
+ console.log(chalk.bold('Snapshot'));
129
+ console.log(chalk.gray(`Profile: ${snapshot.profileKey}`));
130
+ console.log(chalk.gray(`Memory Path: ${snapshot.memoryPath}`));
131
+ console.log(chalk.gray(`State Path: ${snapshot.statePath}`));
132
+ console.log(chalk.gray(`Created At: ${formatDateTime(snapshot.createdAt)}`));
133
+ console.log(chalk.gray(`CPU: ${snapshot.vcpuCount}`));
134
+ console.log(chalk.gray(`Memory: ${snapshot.memSizeMib} MiB`));
135
+ console.log(chalk.gray(`Snapshot Type: ${snapshot.snapshotType}`));
136
+ console.log(chalk.gray(`Memory Backend: ${snapshot.memoryBackend}`));
137
+ }
138
+ catch (error) {
139
+ handleCommandError(error, spinner);
140
+ }
141
+ });
142
+ snapshotCommand
143
+ .command('delete <profileKey>')
144
+ .alias('rm')
145
+ .description('Delete a snapshot profile')
146
+ .option('--dry-run', 'Preview without deleting')
147
+ .action(async (profileKey, options) => {
148
+ if (options.dryRun) {
149
+ console.log(chalk.yellow(`[dry-run] Would delete snapshot ${profileKey}`));
150
+ return;
151
+ }
152
+ const spinner = ora('Deleting snapshot...').start();
153
+ try {
154
+ const client = getClient();
155
+ const result = await withRetry(() => client.snapshots.delete(profileKey), { spinner });
156
+ spinner.succeed(result.message);
157
+ }
158
+ catch (error) {
159
+ handleCommandError(error, spinner);
160
+ }
161
+ });
162
+ snapshotCommand
163
+ .command('restore <profileKey>')
164
+ .description('Restore a snapshot profile and return runtime attach details')
165
+ .option('--json', 'Output as JSON')
166
+ .option('--dry-run', 'Preview without restoring')
167
+ .action(async (profileKey, options) => {
168
+ const spinner = ora('Restoring snapshot...').start();
169
+ try {
170
+ const client = getClient();
171
+ const result = await withRetry(() => client.snapshots.restore(profileKey), { spinner });
172
+ spinner.stop();
173
+ if (options.json) {
174
+ console.log(JSON.stringify(result, null, 2));
175
+ return;
176
+ }
177
+ console.log(chalk.bold('Restore Success'));
178
+ console.log(chalk.gray(`VM ID: ${result.vmId}`));
179
+ console.log(chalk.gray(`Profile: ${result.profileKey}`));
180
+ console.log(chalk.gray(`Socket: ${result.socketPath}`));
181
+ console.log(chalk.gray(`Restore Duration: ${result.restoreDurationMs}ms`));
182
+ }
183
+ catch (error) {
184
+ handleCommandError(error, spinner);
185
+ }
186
+ });
187
+ snapshotCommand
188
+ .command('warm')
189
+ .description('Warm snapshot cache up to configured profiles')
190
+ .option('-c, --count <count>', 'Number of profiles to warm')
191
+ .option('--dry-run', 'Preview without warming')
192
+ .action(async (options) => {
193
+ const spinner = ora('Warming snapshots...').start();
194
+ try {
195
+ const payload = {};
196
+ if (options.count !== undefined) {
197
+ payload.count = parseIntOption(options.count, { label: 'count', min: 0 });
198
+ }
199
+ const client = getClient();
200
+ const result = await withRetry(() => client.snapshots.warm(payload), { spinner });
201
+ spinner.stop();
202
+ console.log(chalk.green(result.message));
203
+ console.log(chalk.gray(`Requested: ${result.profiles_requested}`));
204
+ console.log(chalk.gray(`Warmed: ${result.profiles_warmed}`));
205
+ console.log(chalk.gray(`Created: ${result.profiles_created}`));
206
+ }
207
+ catch (error) {
208
+ handleCommandError(error, spinner);
209
+ }
210
+ });
211
+ snapshotCommand
212
+ .command('cleanup')
213
+ .description('Remove old snapshots by age or keep-most-recent policy')
214
+ .option('--max-age-seconds <seconds>', 'Delete snapshots older than this many seconds')
215
+ .option('--keep-most-recent <count>', 'Keep only this many most recent snapshots')
216
+ .option('--dry-run', 'Preview deletions without removing files')
217
+ .action(async (options) => {
218
+ const spinner = ora('Cleaning up snapshots...').start();
219
+ try {
220
+ const payload = {};
221
+ if (options.maxAgeSeconds) {
222
+ payload.max_age_seconds = parseIntOption(options.maxAgeSeconds, { label: 'max-age-seconds', min: 0 });
223
+ }
224
+ if (options.keepMostRecent) {
225
+ payload.keep_most_recent = parseIntOption(options.keepMostRecent, { label: 'keep-most-recent', min: 1 });
226
+ }
227
+ if (payload.max_age_seconds === undefined && payload.keep_most_recent === undefined) {
228
+ spinner.fail('Either --max-age-seconds or --keep-most-recent is required');
229
+ process.exit(1);
230
+ }
231
+ payload.dry_run = Boolean(options.dryRun);
232
+ const client = getClient();
233
+ const result = await withRetry(() => client.snapshots.cleanup(payload), { spinner });
234
+ spinner.stop();
235
+ console.log(chalk.green(result.message));
236
+ console.log(chalk.gray(`Mode: ${result.dry_run ? 'dry-run' : 'delete'}`));
237
+ console.log(chalk.gray(`Found: ${result.total_found}`));
238
+ console.log(chalk.gray(`Remaining: ${result.total_remaining}`));
239
+ console.log(chalk.gray(`Removed: ${result.profiles_removed}`));
240
+ console.log(chalk.gray(`By Age: ${result.profiles_removed_by_age}`));
241
+ console.log(chalk.gray(`By Limit: ${result.profiles_removed_by_keep_limit}`));
242
+ if (result.removed_profiles.length > 0) {
243
+ console.log(chalk.gray('Removed profiles:'));
244
+ for (const profile of result.removed_profiles) {
245
+ console.log(chalk.gray(`- ${profile}`));
246
+ }
247
+ }
248
+ }
249
+ catch (error) {
250
+ handleCommandError(error, spinner);
251
+ }
252
+ });
253
+ //# sourceMappingURL=snapshot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { Command } from 'commander';
2
+ /** True when the failure means "no terminal sessions here", not "something broke". */
3
+ export declare function terminalUnavailable(error: unknown): boolean;
4
+ export declare const sshCommand: Command;
5
+ //# sourceMappingURL=ssh.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../../src/commands/ssh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI3D;AAED,eAAO,MAAM,UAAU,SAgJnB,CAAC"}
@@ -0,0 +1,154 @@
1
+ import { Command } from 'commander';
2
+ import chalk from 'chalk';
3
+ import ora from 'ora';
4
+ import { createInterface } from 'readline';
5
+ import { getClient } from '../client.js';
6
+ import { withRetry, handleCommandError } from '../utils/errors.js';
7
+ import { getShutdownManager } from '../utils/shutdown.js';
8
+ import { runAttached } from './terminal.js';
9
+ /** True when the failure means "no terminal sessions here", not "something broke". */
10
+ export function terminalUnavailable(error) {
11
+ const e = error;
12
+ return e?.code === 'TERMINAL_UNSUPPORTED' || e?.status === 501 || e?.statusCode === 501
13
+ || /does not support terminal sessions/.test(e?.message ?? '');
14
+ }
15
+ export const sshCommand = new Command('ssh')
16
+ .description('Open an interactive shell in a sandbox')
17
+ .argument('<sandbox-id>', 'Sandbox to connect to')
18
+ .option('-c, --command <cmd>', 'Execute a single command and exit')
19
+ .option('--cwd <dir>', 'Working directory', '/workspace')
20
+ .option('--shell <shell>', 'Shell to use', '/bin/bash')
21
+ .option('--line-mode', 'Run each line as its own command instead of opening a terminal')
22
+ .action(async (sandboxId, options) => {
23
+ const client = getClient();
24
+ // Single command mode
25
+ if (options.command) {
26
+ const spinner = ora('Executing...').start();
27
+ try {
28
+ const result = await withRetry(() => client.sandbox.execute(sandboxId, [options.shell, '-c', options.command]), { spinner });
29
+ spinner.stop();
30
+ if (result.stdout)
31
+ process.stdout.write(result.stdout);
32
+ if (result.stderr)
33
+ process.stderr.write(result.stderr);
34
+ process.exit(result.exit_code);
35
+ }
36
+ catch (error) {
37
+ handleCommandError(error, spinner);
38
+ }
39
+ return;
40
+ }
41
+ // Interactive shell mode
42
+ const spinner = ora('Connecting to sandbox...').start();
43
+ try {
44
+ // Verify sandbox is running
45
+ const info = await withRetry(() => client.sandbox.get(sandboxId), { spinner });
46
+ const status = info.status ?? info.sandbox?.status;
47
+ if (status && status !== 'running') {
48
+ spinner.fail(`Sandbox is ${status}, not running`);
49
+ process.exit(1);
50
+ }
51
+ spinner.succeed('Connected');
52
+ }
53
+ catch (error) {
54
+ handleCommandError(error, spinner);
55
+ }
56
+ // A real terminal when this is one and the sandbox can provide one:
57
+ // job control, full-screen programs, a session that outlives the connection.
58
+ if (process.stdin.isTTY && !options.lineMode) {
59
+ const terminals = client.sandbox.terminals;
60
+ let terminalId;
61
+ try {
62
+ if (!terminals)
63
+ throw new Error('Installed SDK does not support terminal sessions');
64
+ const terminal = await terminals().create(sandboxId, {
65
+ command: [options.shell, '-l'],
66
+ workingDir: options.cwd,
67
+ cols: process.stdout.columns,
68
+ rows: process.stdout.rows,
69
+ });
70
+ terminalId = terminal.terminal_id;
71
+ }
72
+ catch (error) {
73
+ if (!terminalUnavailable(error))
74
+ handleCommandError(error);
75
+ console.log(chalk.gray('This sandbox has no terminal sessions; using line mode (each line runs as its own command).'));
76
+ }
77
+ if (terminalId) {
78
+ try {
79
+ await runAttached(sandboxId, terminalId, { offset: 0 });
80
+ }
81
+ catch (error) {
82
+ handleCommandError(error);
83
+ }
84
+ return;
85
+ }
86
+ }
87
+ console.log(chalk.gray(`Interactive shell on sandbox ${sandboxId.substring(0, 12)}...`));
88
+ console.log(chalk.gray(`Working directory: ${options.cwd}`));
89
+ console.log(chalk.gray('Type "exit" or press Ctrl+D to disconnect.\n'));
90
+ const manager = getShutdownManager();
91
+ let cwd = options.cwd;
92
+ const rl = createInterface({
93
+ input: process.stdin,
94
+ output: process.stdout,
95
+ prompt: chalk.green(`sandbox:${cwd}$ `),
96
+ terminal: process.stdin.isTTY ?? false,
97
+ });
98
+ manager.register('ssh-readline', () => {
99
+ rl.close();
100
+ });
101
+ rl.prompt();
102
+ rl.on('line', async (line) => {
103
+ const cmd = line.trim();
104
+ if (!cmd) {
105
+ rl.prompt();
106
+ return;
107
+ }
108
+ if (cmd === 'exit' || cmd === 'quit') {
109
+ console.log(chalk.gray('Disconnected.'));
110
+ rl.close();
111
+ process.exit(0);
112
+ }
113
+ try {
114
+ // Handle cd specially to track working directory
115
+ if (cmd.startsWith('cd ')) {
116
+ const target = cmd.slice(3).trim().replace(/^~/, '/root');
117
+ const result = await client.sandbox.execute(sandboxId, [
118
+ options.shell, '-c', `cd "${cwd}" && cd "${target}" && pwd`,
119
+ ]);
120
+ if (result.exit_code === 0 && result.stdout.trim()) {
121
+ cwd = result.stdout.trim();
122
+ rl.setPrompt(chalk.green(`sandbox:${cwd}$ `));
123
+ }
124
+ else {
125
+ if (result.stderr)
126
+ process.stderr.write(chalk.red(result.stderr));
127
+ }
128
+ }
129
+ else {
130
+ const result = await client.sandbox.execute(sandboxId, [
131
+ options.shell, '-c', `cd "${cwd}" && ${cmd}`,
132
+ ]);
133
+ if (result.stdout)
134
+ process.stdout.write(result.stdout);
135
+ if (result.stderr)
136
+ process.stderr.write(chalk.red(result.stderr));
137
+ if (result.exit_code !== 0) {
138
+ console.log(chalk.gray(`exit: ${result.exit_code}`));
139
+ }
140
+ }
141
+ }
142
+ catch (error) {
143
+ const msg = error instanceof Error ? error.message : String(error);
144
+ console.error(chalk.red(`Error: ${msg}`));
145
+ }
146
+ rl.prompt();
147
+ });
148
+ rl.on('close', () => {
149
+ console.log(chalk.gray('\nDisconnected.'));
150
+ manager.deregister('ssh-readline');
151
+ process.exit(0);
152
+ });
153
+ });
154
+ //# sourceMappingURL=ssh.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../src/commands/ssh.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from 'commander';
2
+ export declare const templateCommand: Command;
3
+ //# sourceMappingURL=template.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,eAAe,SACc,CAAC"}
@@ -0,0 +1,102 @@
1
+ import { Command } from 'commander';
2
+ import chalk from 'chalk';
3
+ import ora from 'ora';
4
+ import { table } from 'table';
5
+ import { getClient } from '../client.js';
6
+ import { withRetry, handleCommandError } from '../utils/errors.js';
7
+ export const templateCommand = new Command('template')
8
+ .description('Browse sandbox templates');
9
+ templateCommand
10
+ .command('list')
11
+ .description('List available templates')
12
+ .option('-c, --category <category>', 'Filter by category')
13
+ .option('-s, --search <query>', 'Search templates')
14
+ .option('--json', 'Output as JSON')
15
+ .action(async (options) => {
16
+ const spinner = ora('Fetching templates...').start();
17
+ try {
18
+ const client = getClient();
19
+ const result = await withRetry(() => client.templates.list({
20
+ category: options.category,
21
+ search: options.search,
22
+ }), { spinner });
23
+ spinner.stop();
24
+ if (options.json) {
25
+ console.log(JSON.stringify(result, null, 2));
26
+ return;
27
+ }
28
+ if (result.templates.length === 0) {
29
+ console.log(chalk.yellow('No templates found'));
30
+ return;
31
+ }
32
+ const rows = [
33
+ ['ID', 'Name', 'Category', 'CPUs', 'Memory', 'Tags'].map((h) => chalk.bold(h)),
34
+ ...result.templates.map((t) => [
35
+ t.id,
36
+ t.name,
37
+ t.category,
38
+ t.config.cpus,
39
+ t.config.memory,
40
+ (t.tags || []).join(', ') || chalk.gray('-'),
41
+ ]),
42
+ ];
43
+ console.log(table(rows));
44
+ }
45
+ catch (error) {
46
+ handleCommandError(error, spinner);
47
+ }
48
+ });
49
+ templateCommand
50
+ .command('describe <template-id>')
51
+ .description('Show detailed information about a template')
52
+ .option('--json', 'Output as JSON')
53
+ .action(async (templateId, options) => {
54
+ const spinner = ora('Fetching template...').start();
55
+ try {
56
+ const client = getClient();
57
+ const tmpl = await withRetry(() => client.templates.get(templateId), { spinner });
58
+ spinner.stop();
59
+ if (options.json) {
60
+ console.log(JSON.stringify(tmpl, null, 2));
61
+ return;
62
+ }
63
+ console.log(chalk.bold(tmpl.name));
64
+ console.log(chalk.gray(tmpl.description));
65
+ console.log();
66
+ console.log(` ${chalk.gray('ID:')} ${tmpl.id}`);
67
+ console.log(` ${chalk.gray('Category:')} ${tmpl.category}`);
68
+ if (tmpl.tags?.length) {
69
+ console.log(` ${chalk.gray('Tags:')} ${tmpl.tags.join(', ')}`);
70
+ }
71
+ console.log();
72
+ console.log(chalk.bold('Configuration'));
73
+ console.log(` ${chalk.gray('CPUs:')} ${tmpl.config.cpus}`);
74
+ console.log(` ${chalk.gray('Memory:')} ${tmpl.config.memory}`);
75
+ console.log(` ${chalk.gray('Timeout:')} ${tmpl.config.timeout_seconds}s`);
76
+ if (tmpl.config.env && Object.keys(tmpl.config.env).length > 0) {
77
+ console.log();
78
+ console.log(chalk.bold('Environment Variables'));
79
+ for (const [key, val] of Object.entries(tmpl.config.env)) {
80
+ console.log(` ${chalk.cyan(key)}: ${val}`);
81
+ }
82
+ }
83
+ if (tmpl.config.setup_commands?.length) {
84
+ console.log();
85
+ console.log(chalk.bold('Setup Commands'));
86
+ for (const cmd of tmpl.config.setup_commands) {
87
+ console.log(` ${chalk.gray('$')} ${cmd}`);
88
+ }
89
+ }
90
+ if (tmpl.files?.length) {
91
+ console.log();
92
+ console.log(chalk.bold(`Files (${tmpl.files.length})`));
93
+ for (const f of tmpl.files) {
94
+ console.log(` ${chalk.cyan(f.path)}`);
95
+ }
96
+ }
97
+ }
98
+ catch (error) {
99
+ handleCommandError(error, spinner);
100
+ }
101
+ });
102
+ //# sourceMappingURL=template.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { Command } from 'commander';
2
+ import { type CliTerminals, type TerminalInfo } from '../client.js';
3
+ /** Ctrl-]: the detach key, as in telnet. Typed on its own it never reaches the terminal. */
4
+ export declare const DETACH_KEY = 29;
5
+ /** How much earlier output an attach replays when the screen itself cannot be had. */
6
+ export declare const ATTACH_REPLAY_BYTES: number;
7
+ interface AttachInput {
8
+ isTTY?: boolean;
9
+ setRawMode?: (mode: boolean) => unknown;
10
+ resume: () => unknown;
11
+ pause: () => unknown;
12
+ on: (event: 'data' | 'end', listener: (chunk?: Buffer) => void) => unknown;
13
+ removeListener: (event: 'data' | 'end', listener: (chunk?: Buffer) => void) => unknown;
14
+ }
15
+ interface AttachOutput {
16
+ isTTY?: boolean;
17
+ columns?: number;
18
+ rows?: number;
19
+ write: (data: Uint8Array | string) => unknown;
20
+ on: (event: 'resize', listener: () => void) => unknown;
21
+ removeListener: (event: 'resize', listener: () => void) => unknown;
22
+ }
23
+ export interface AttachOptions {
24
+ /**
25
+ * Where to start reading. Default: draw the terminal's current screen and
26
+ * follow from there (or, where screens are not available, replay the last
27
+ * ATTACH_REPLAY_BYTES of output).
28
+ */
29
+ offset?: number;
30
+ stdin?: AttachInput;
31
+ stdout?: AttachOutput;
32
+ /** After piped (non-terminal) input ends, how long to keep printing output. */
33
+ pipedDrainMs?: number;
34
+ }
35
+ export interface AttachResult {
36
+ /** The user detached (or piped input ran out): the terminal is still running. */
37
+ detached: boolean;
38
+ /** The terminal as it ended, when it did. */
39
+ terminal?: TerminalInfo;
40
+ /** Typing failed (the terminal ended, access was lost). */
41
+ inputError?: unknown;
42
+ }
43
+ /**
44
+ * Join this process's terminal to a sandbox terminal until it ends or the
45
+ * user detaches. Keystrokes go out in order, one request at a time, with
46
+ * whatever was typed meanwhile sent together.
47
+ */
48
+ export declare function attachTerminal(terminals: CliTerminals, sandboxId: string, terminalId: string, options?: AttachOptions): Promise<AttachResult>;
49
+ /** Attach, then say how it ended and set the exit code. */
50
+ export declare function runAttached(sandboxId: string, terminalId: string, options?: AttachOptions): Promise<void>;
51
+ export declare const terminalCommand: Command;
52
+ export {};
53
+ //# sourceMappingURL=terminal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/commands/terminal.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAK/E,4FAA4F;AAC5F,eAAO,MAAM,UAAU,KAAO,CAAC;AAC/B,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAY7C,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC;CACxF;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,KAAK,OAAO,CAAC;IAC9C,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IACvD,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;CACpE;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAsHvB;AAED,2DAA2D;AAC3D,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnH;AAYD,eAAO,MAAM,eAAe,SAEgE,CAAC"}