@dreamlake/dreamlake-cli 0.88.1 → 0.90.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 (541) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +54 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2362 -0
  18. package/dist/api/index.js +116 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +102 -0
  38. package/dist/api/note-files.js +107 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-linger.d.ts +83 -0
  44. package/dist/api/note-linger.js +270 -0
  45. package/dist/api/note-presence.d.ts +82 -0
  46. package/dist/api/note-presence.js +72 -0
  47. package/dist/api/note-toc.d.ts +2 -0
  48. package/dist/api/note-toc.js +2 -0
  49. package/dist/api/notes.d.ts +329 -0
  50. package/dist/api/notes.js +209 -0
  51. package/dist/api/open-resources.d.ts +27 -0
  52. package/dist/api/open-resources.js +102 -0
  53. package/dist/api/ownership.d.ts +12 -0
  54. package/dist/api/ownership.js +24 -0
  55. package/dist/api/platform.d.ts +83 -0
  56. package/dist/api/platform.js +56 -0
  57. package/dist/api/presigned-transfer.d.ts +2 -0
  58. package/dist/api/presigned-transfer.js +2 -0
  59. package/dist/api/registered-runs.d.ts +48 -0
  60. package/dist/api/registered-runs.js +33 -0
  61. package/dist/api/sessions.d.ts +299 -0
  62. package/dist/api/sessions.js +105 -0
  63. package/dist/api/storage.d.ts +46 -0
  64. package/dist/api/storage.js +34 -0
  65. package/dist/api/streams.d.ts +18 -0
  66. package/dist/api/streams.js +70 -0
  67. package/dist/api/vault.d.ts +93 -0
  68. package/dist/api/vault.js +79 -0
  69. package/dist/api/workspace.d.ts +180 -0
  70. package/dist/api/workspace.js +146 -0
  71. package/dist/cli/agent-identity.d.ts +4 -0
  72. package/dist/cli/agent-identity.js +21 -0
  73. package/dist/cli/agents/identity.d.ts +50 -0
  74. package/dist/cli/agents/identity.js +105 -0
  75. package/dist/cli/agents/index.d.ts +31 -0
  76. package/dist/cli/agents/index.js +580 -0
  77. package/dist/cli/agents/manage.d.ts +43 -0
  78. package/dist/cli/agents/manage.js +376 -0
  79. package/dist/cli/agents/spec.d.ts +104 -0
  80. package/dist/cli/agents/spec.js +280 -0
  81. package/dist/cli/agents/web.d.ts +7 -0
  82. package/dist/cli/agents/web.js +109 -0
  83. package/dist/cli/artifact/incremental.d.ts +21 -0
  84. package/dist/cli/artifact/incremental.js +80 -0
  85. package/dist/cli/artifact/index.d.ts +52 -0
  86. package/dist/cli/artifact/index.js +405 -0
  87. package/dist/cli/artifact/meta.d.ts +69 -0
  88. package/dist/cli/artifact/meta.js +189 -0
  89. package/dist/cli/auth/commands.d.ts +29 -0
  90. package/dist/cli/auth/commands.js +327 -0
  91. package/dist/cli/auth/constants.d.ts +13 -0
  92. package/dist/cli/auth/constants.js +18 -0
  93. package/dist/cli/auth/credentials.d.ts +37 -0
  94. package/dist/cli/auth/credentials.js +155 -0
  95. package/dist/cli/auth/device-flow.d.ts +32 -0
  96. package/dist/cli/auth/device-flow.js +154 -0
  97. package/dist/cli/auth/device-secret.d.ts +6 -0
  98. package/dist/cli/auth/device-secret.js +26 -0
  99. package/dist/cli/auth/machine.d.ts +15 -0
  100. package/dist/cli/auth/machine.js +126 -0
  101. package/dist/cli/auth/materialized.d.ts +32 -0
  102. package/dist/cli/auth/materialized.js +102 -0
  103. package/dist/cli/auth/migrate.d.ts +10 -0
  104. package/dist/cli/auth/migrate.js +75 -0
  105. package/dist/cli/client.d.ts +102 -0
  106. package/dist/cli/client.js +206 -0
  107. package/dist/cli/collection-list.d.ts +3 -0
  108. package/dist/cli/collection-list.js +25 -0
  109. package/dist/cli/compat/ctx.d.ts +26 -0
  110. package/dist/cli/compat/ctx.js +76 -0
  111. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  112. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  113. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  114. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  115. package/dist/cli/compat/dreamdb.d.ts +112 -0
  116. package/dist/cli/compat/dreamdb.js +219 -0
  117. package/dist/cli/compat/flags.d.ts +2 -0
  118. package/dist/cli/compat/flags.js +13 -0
  119. package/dist/cli/compat/http.d.ts +23 -0
  120. package/dist/cli/compat/http.js +137 -0
  121. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  122. package/dist/cli/compat/presignedTransfer.js +580 -0
  123. package/dist/cli/compat/s3-backend.d.ts +73 -0
  124. package/dist/cli/compat/s3-backend.js +132 -0
  125. package/dist/cli/config.d.ts +22 -0
  126. package/dist/cli/config.js +96 -0
  127. package/dist/cli/connection/dto.d.ts +159 -0
  128. package/dist/cli/connection/dto.js +497 -0
  129. package/dist/cli/connection/index.d.ts +50 -0
  130. package/dist/cli/connection/index.js +413 -0
  131. package/dist/cli/connection/oauth.d.ts +23 -0
  132. package/dist/cli/connection/oauth.js +290 -0
  133. package/dist/cli/connection/write.d.ts +47 -0
  134. package/dist/cli/connection/write.js +573 -0
  135. package/dist/cli/create/index.d.ts +19 -0
  136. package/dist/cli/create/index.js +209 -0
  137. package/dist/cli/declare/index.d.ts +29 -0
  138. package/dist/cli/declare/index.js +304 -0
  139. package/dist/cli/delete/index.d.ts +18 -0
  140. package/dist/cli/delete/index.js +232 -0
  141. package/dist/cli/download/index.d.ts +9 -0
  142. package/dist/cli/download/index.js +128 -0
  143. package/dist/cli/env/compose.d.ts +88 -0
  144. package/dist/cli/env/compose.js +402 -0
  145. package/dist/cli/env/index.d.ts +176 -0
  146. package/dist/cli/env/index.js +1011 -0
  147. package/dist/cli/experiments/index.d.ts +11 -0
  148. package/dist/cli/experiments/index.js +168 -0
  149. package/dist/cli/glob.d.ts +1 -0
  150. package/dist/cli/glob.js +45 -0
  151. package/dist/cli/graphql-helpers.d.ts +23 -0
  152. package/dist/cli/graphql-helpers.js +42 -0
  153. package/dist/cli/graphql.d.ts +10 -0
  154. package/dist/cli/graphql.js +47 -0
  155. package/dist/cli/help-examples.generated.d.ts +1 -0
  156. package/dist/cli/help-examples.generated.js +192 -0
  157. package/dist/cli/helpers.d.ts +8 -0
  158. package/dist/cli/helpers.js +106 -0
  159. package/dist/cli/hosts/api.d.ts +29 -0
  160. package/dist/cli/hosts/api.js +54 -0
  161. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  162. package/dist/cli/hosts/bootstrap-source.js +2 -0
  163. package/dist/cli/hosts/catalog.d.ts +26 -0
  164. package/dist/cli/hosts/catalog.js +55 -0
  165. package/dist/cli/hosts/config.d.ts +45 -0
  166. package/dist/cli/hosts/config.js +179 -0
  167. package/dist/cli/hosts/credentials.d.ts +19 -0
  168. package/dist/cli/hosts/credentials.js +173 -0
  169. package/dist/cli/hosts/enroll.d.ts +17 -0
  170. package/dist/cli/hosts/enroll.js +109 -0
  171. package/dist/cli/hosts/enrollments.d.ts +25 -0
  172. package/dist/cli/hosts/enrollments.js +54 -0
  173. package/dist/cli/hosts/index.d.ts +6 -0
  174. package/dist/cli/hosts/index.js +279 -0
  175. package/dist/cli/hosts/inventory.d.ts +40 -0
  176. package/dist/cli/hosts/inventory.js +91 -0
  177. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  178. package/dist/cli/hosts/lifecycle.js +108 -0
  179. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  180. package/dist/cli/hosts/metrics-source.js +89 -0
  181. package/dist/cli/hosts/observations.d.ts +39 -0
  182. package/dist/cli/hosts/observations.js +102 -0
  183. package/dist/cli/hosts/remote.d.ts +5 -0
  184. package/dist/cli/hosts/remote.js +66 -0
  185. package/dist/cli/hosts/ssh.d.ts +63 -0
  186. package/dist/cli/hosts/ssh.js +276 -0
  187. package/dist/cli/index.d.ts +1 -0
  188. package/dist/cli/index.js +288 -0
  189. package/dist/cli/infra/api.d.ts +95 -0
  190. package/dist/cli/infra/api.js +291 -0
  191. package/dist/cli/infra/index.d.ts +5 -0
  192. package/dist/cli/infra/index.js +102 -0
  193. package/dist/cli/infra/move.d.ts +15 -0
  194. package/dist/cli/infra/move.js +123 -0
  195. package/dist/cli/infra/transfer.d.ts +15 -0
  196. package/dist/cli/infra/transfer.js +280 -0
  197. package/dist/cli/jobs/api.d.ts +69 -0
  198. package/dist/cli/jobs/api.js +121 -0
  199. package/dist/cli/jobs/index.d.ts +5 -0
  200. package/dist/cli/jobs/index.js +140 -0
  201. package/dist/cli/lakeshore/index.d.ts +98 -0
  202. package/dist/cli/lakeshore/index.js +502 -0
  203. package/dist/cli/launch/index.d.ts +43 -0
  204. package/dist/cli/launch/index.js +270 -0
  205. package/dist/cli/layout/index.d.ts +2 -0
  206. package/dist/cli/layout/index.js +44 -0
  207. package/dist/cli/layout/transport.d.ts +12 -0
  208. package/dist/cli/layout/transport.js +70 -0
  209. package/dist/cli/library/add.d.ts +60 -0
  210. package/dist/cli/library/add.js +348 -0
  211. package/dist/cli/library/cache.d.ts +26 -0
  212. package/dist/cli/library/cache.js +88 -0
  213. package/dist/cli/library/config.d.ts +75 -0
  214. package/dist/cli/library/config.js +198 -0
  215. package/dist/cli/library/digest.d.ts +5 -0
  216. package/dist/cli/library/digest.js +19 -0
  217. package/dist/cli/library/discover.d.ts +87 -0
  218. package/dist/cli/library/discover.js +534 -0
  219. package/dist/cli/library/freshness.d.ts +35 -0
  220. package/dist/cli/library/freshness.js +109 -0
  221. package/dist/cli/library/generation.d.ts +35 -0
  222. package/dist/cli/library/generation.js +211 -0
  223. package/dist/cli/library/index.d.ts +2 -0
  224. package/dist/cli/library/index.js +36 -0
  225. package/dist/cli/library/info.d.ts +69 -0
  226. package/dist/cli/library/info.js +311 -0
  227. package/dist/cli/library/list.d.ts +33 -0
  228. package/dist/cli/library/list.js +86 -0
  229. package/dist/cli/library/manifest.d.ts +81 -0
  230. package/dist/cli/library/manifest.js +200 -0
  231. package/dist/cli/library/manifestCache.d.ts +45 -0
  232. package/dist/cli/library/manifestCache.js +169 -0
  233. package/dist/cli/library/pull.d.ts +30 -0
  234. package/dist/cli/library/pull.js +438 -0
  235. package/dist/cli/library/push.d.ts +72 -0
  236. package/dist/cli/library/push.js +642 -0
  237. package/dist/cli/library/rm.d.ts +31 -0
  238. package/dist/cli/library/rm.js +200 -0
  239. package/dist/cli/library/search.d.ts +18 -0
  240. package/dist/cli/library/search.js +181 -0
  241. package/dist/cli/library/stat.d.ts +15 -0
  242. package/dist/cli/library/stat.js +127 -0
  243. package/dist/cli/library/tools.d.ts +104 -0
  244. package/dist/cli/library/tools.js +163 -0
  245. package/dist/cli/library/wire.d.ts +47 -0
  246. package/dist/cli/library/wire.js +120 -0
  247. package/dist/cli/list/index.d.ts +26 -0
  248. package/dist/cli/list/index.js +256 -0
  249. package/dist/cli/notes/api-transport.d.ts +5 -0
  250. package/dist/cli/notes/api-transport.js +20 -0
  251. package/dist/cli/notes/character-plan.d.ts +22 -0
  252. package/dist/cli/notes/character-plan.js +232 -0
  253. package/dist/cli/notes/document.d.ts +73 -0
  254. package/dist/cli/notes/document.js +306 -0
  255. package/dist/cli/notes/edit-commands.d.ts +106 -0
  256. package/dist/cli/notes/edit-commands.js +623 -0
  257. package/dist/cli/notes/editing.d.ts +81 -0
  258. package/dist/cli/notes/editing.js +305 -0
  259. package/dist/cli/notes/events.d.ts +36 -0
  260. package/dist/cli/notes/events.js +54 -0
  261. package/dist/cli/notes/files-commands.d.ts +97 -0
  262. package/dist/cli/notes/files-commands.js +548 -0
  263. package/dist/cli/notes/html-read.d.ts +9 -0
  264. package/dist/cli/notes/html-read.js +90 -0
  265. package/dist/cli/notes/html.d.ts +73 -0
  266. package/dist/cli/notes/html.js +381 -0
  267. package/dist/cli/notes/index.d.ts +123 -0
  268. package/dist/cli/notes/index.js +1300 -0
  269. package/dist/cli/notes/linger.d.ts +4 -0
  270. package/dist/cli/notes/linger.js +96 -0
  271. package/dist/cli/notes/media-commands.d.ts +5 -0
  272. package/dist/cli/notes/media-commands.js +51 -0
  273. package/dist/cli/notes/move-command.d.ts +83 -0
  274. package/dist/cli/notes/move-command.js +259 -0
  275. package/dist/cli/notes/rm-command.d.ts +22 -0
  276. package/dist/cli/notes/rm-command.js +110 -0
  277. package/dist/cli/notes/select-command.d.ts +12 -0
  278. package/dist/cli/notes/select-command.js +63 -0
  279. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  280. package/dist/cli/notes/suggest-diff.js +311 -0
  281. package/dist/cli/notes/toc.d.ts +38 -0
  282. package/dist/cli/notes/toc.js +144 -0
  283. package/dist/cli/notes/transfer-command.d.ts +6 -0
  284. package/dist/cli/notes/transfer-command.js +9 -0
  285. package/dist/cli/notes/version-commands.d.ts +19 -0
  286. package/dist/cli/notes/version-commands.js +178 -0
  287. package/dist/cli/nymph/index.d.ts +74 -0
  288. package/dist/cli/nymph/index.js +349 -0
  289. package/dist/cli/org/index.d.ts +34 -0
  290. package/dist/cli/org/index.js +341 -0
  291. package/dist/cli/ownership/index.d.ts +12 -0
  292. package/dist/cli/ownership/index.js +122 -0
  293. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  294. package/dist/cli/ownership/metadata-transfer.js +159 -0
  295. package/dist/cli/page/index.d.ts +58 -0
  296. package/dist/cli/page/index.js +387 -0
  297. package/dist/cli/pipeline/index.d.ts +69 -0
  298. package/dist/cli/pipeline/index.js +604 -0
  299. package/dist/cli/progress.d.ts +60 -0
  300. package/dist/cli/progress.js +276 -0
  301. package/dist/cli/project/attachments.d.ts +10 -0
  302. package/dist/cli/project/attachments.js +39 -0
  303. package/dist/cli/project/grants.d.ts +10 -0
  304. package/dist/cli/project/grants.js +39 -0
  305. package/dist/cli/project/index.d.ts +8 -0
  306. package/dist/cli/project/index.js +92 -0
  307. package/dist/cli/project/move.d.ts +57 -0
  308. package/dist/cli/project/move.js +242 -0
  309. package/dist/cli/project/output.d.ts +2 -0
  310. package/dist/cli/project/output.js +29 -0
  311. package/dist/cli/project/stream.d.ts +55 -0
  312. package/dist/cli/project/stream.js +207 -0
  313. package/dist/cli/project/transfer-preview.d.ts +8 -0
  314. package/dist/cli/project/transfer-preview.js +10 -0
  315. package/dist/cli/prompt.d.ts +1 -0
  316. package/dist/cli/prompt.js +17 -0
  317. package/dist/cli/provider/dreamdir.d.ts +52 -0
  318. package/dist/cli/provider/dreamdir.js +138 -0
  319. package/dist/cli/provider/index.d.ts +4 -0
  320. package/dist/cli/provider/index.js +419 -0
  321. package/dist/cli/provider/jump-worker.d.ts +9 -0
  322. package/dist/cli/provider/jump-worker.js +141 -0
  323. package/dist/cli/provider/lifecycle.d.ts +149 -0
  324. package/dist/cli/provider/lifecycle.js +1390 -0
  325. package/dist/cli/provider/machine.d.ts +17 -0
  326. package/dist/cli/provider/machine.js +116 -0
  327. package/dist/cli/provider/ssh.d.ts +105 -0
  328. package/dist/cli/provider/ssh.js +305 -0
  329. package/dist/cli/provider/terraform.d.ts +140 -0
  330. package/dist/cli/provider/terraform.js +288 -0
  331. package/dist/cli/providers/index.d.ts +18 -0
  332. package/dist/cli/providers/index.js +422 -0
  333. package/dist/cli/python.d.ts +61 -0
  334. package/dist/cli/python.js +255 -0
  335. package/dist/cli/queues/index.d.ts +33 -0
  336. package/dist/cli/queues/index.js +248 -0
  337. package/dist/cli/queues/slurm.d.ts +10 -0
  338. package/dist/cli/queues/slurm.js +134 -0
  339. package/dist/cli/resources.d.ts +72 -0
  340. package/dist/cli/resources.js +137 -0
  341. package/dist/cli/run/index.d.ts +15 -0
  342. package/dist/cli/run/index.js +163 -0
  343. package/dist/cli/run/input.d.ts +34 -0
  344. package/dist/cli/run/input.js +135 -0
  345. package/dist/cli/run/recovery.d.ts +2 -0
  346. package/dist/cli/run/recovery.js +18 -0
  347. package/dist/cli/run/setup.d.ts +3 -0
  348. package/dist/cli/run/setup.js +62 -0
  349. package/dist/cli/runconfig/index.d.ts +12 -0
  350. package/dist/cli/runconfig/index.js +130 -0
  351. package/dist/cli/runnable/index.d.ts +35 -0
  352. package/dist/cli/runnable/index.js +575 -0
  353. package/dist/cli/runnable/path.d.ts +115 -0
  354. package/dist/cli/runnable/path.js +288 -0
  355. package/dist/cli/runnable/run.d.ts +91 -0
  356. package/dist/cli/runnable/run.js +239 -0
  357. package/dist/cli/runnable/upload.d.ts +43 -0
  358. package/dist/cli/runnable/upload.js +342 -0
  359. package/dist/cli/runnable/worker.d.ts +1 -0
  360. package/dist/cli/runnable/worker.js +44 -0
  361. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  362. package/dist/cli/self-update/index.d.ts +5 -0
  363. package/dist/cli/self-update/index.js +107 -0
  364. package/dist/cli/self-update/install.d.ts +60 -0
  365. package/dist/cli/self-update/install.js +428 -0
  366. package/dist/cli/self-update/paths.d.ts +40 -0
  367. package/dist/cli/self-update/paths.js +87 -0
  368. package/dist/cli/self-update/releases.d.ts +41 -0
  369. package/dist/cli/self-update/releases.js +153 -0
  370. package/dist/cli/self-update/settings.d.ts +16 -0
  371. package/dist/cli/self-update/settings.js +68 -0
  372. package/dist/cli/self-update/update.d.ts +18 -0
  373. package/dist/cli/self-update/update.js +241 -0
  374. package/dist/cli/service-accounts/index.d.ts +3 -0
  375. package/dist/cli/service-accounts/index.js +149 -0
  376. package/dist/cli/session-affiliation.d.ts +26 -0
  377. package/dist/cli/session-affiliation.js +135 -0
  378. package/dist/cli/sessions/affiliation.d.ts +8 -0
  379. package/dist/cli/sessions/affiliation.js +66 -0
  380. package/dist/cli/sessions/api.d.ts +55 -0
  381. package/dist/cli/sessions/api.js +88 -0
  382. package/dist/cli/sessions/control.d.ts +6 -0
  383. package/dist/cli/sessions/control.js +159 -0
  384. package/dist/cli/sessions/conversation.d.ts +15 -0
  385. package/dist/cli/sessions/conversation.js +118 -0
  386. package/dist/cli/sessions/index.d.ts +2 -0
  387. package/dist/cli/sessions/index.js +209 -0
  388. package/dist/cli/sessions/managed.d.ts +39 -0
  389. package/dist/cli/sessions/managed.js +63 -0
  390. package/dist/cli/sessions/redaction.d.ts +2 -0
  391. package/dist/cli/sessions/redaction.js +11 -0
  392. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  393. package/dist/cli/sessions/runner/exec.js +335 -0
  394. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  395. package/dist/cli/sessions/runner/journal.js +49 -0
  396. package/dist/cli/sessions/runner/native.d.ts +48 -0
  397. package/dist/cli/sessions/runner/native.js +170 -0
  398. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  399. package/dist/cli/sessions/runner/pod.js +129 -0
  400. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  401. package/dist/cli/sessions/runner/serve.js +558 -0
  402. package/dist/cli/sessions/sync.d.ts +47 -0
  403. package/dist/cli/sessions/sync.js +80 -0
  404. package/dist/cli/sessions/transport.d.ts +14 -0
  405. package/dist/cli/sessions/transport.js +116 -0
  406. package/dist/cli/share.d.ts +15 -0
  407. package/dist/cli/share.js +139 -0
  408. package/dist/cli/skill/catalog.d.ts +141 -0
  409. package/dist/cli/skill/catalog.js +442 -0
  410. package/dist/cli/skill/files.d.ts +89 -0
  411. package/dist/cli/skill/files.js +264 -0
  412. package/dist/cli/skill/index.d.ts +268 -0
  413. package/dist/cli/skill/index.js +1216 -0
  414. package/dist/cli/skill/manifest.d.ts +30 -0
  415. package/dist/cli/skill/manifest.js +101 -0
  416. package/dist/cli/skill/prefs.d.ts +9 -0
  417. package/dist/cli/skill/prefs.js +32 -0
  418. package/dist/cli/skill/reminders.d.ts +15 -0
  419. package/dist/cli/skill/reminders.js +105 -0
  420. package/dist/cli/skill/tar.d.ts +17 -0
  421. package/dist/cli/skill/tar.js +195 -0
  422. package/dist/cli/snapshot/index.d.ts +24 -0
  423. package/dist/cli/snapshot/index.js +146 -0
  424. package/dist/cli/source/access.d.ts +45 -0
  425. package/dist/cli/source/access.js +563 -0
  426. package/dist/cli/source/control.d.ts +103 -0
  427. package/dist/cli/source/control.js +546 -0
  428. package/dist/cli/source/delete.d.ts +89 -0
  429. package/dist/cli/source/delete.js +463 -0
  430. package/dist/cli/source/index.d.ts +288 -0
  431. package/dist/cli/source/index.js +1348 -0
  432. package/dist/cli/source/share.d.ts +65 -0
  433. package/dist/cli/source/share.js +530 -0
  434. package/dist/cli/source/upload.d.ts +62 -0
  435. package/dist/cli/source/upload.js +258 -0
  436. package/dist/cli/source/write.d.ts +77 -0
  437. package/dist/cli/source/write.js +335 -0
  438. package/dist/cli/spawn.d.ts +28 -0
  439. package/dist/cli/spawn.js +81 -0
  440. package/dist/cli/target.d.ts +22 -0
  441. package/dist/cli/target.js +85 -0
  442. package/dist/cli/tasks/index.d.ts +38 -0
  443. package/dist/cli/tasks/index.js +365 -0
  444. package/dist/cli/team/index.d.ts +37 -0
  445. package/dist/cli/team/index.js +407 -0
  446. package/dist/cli/telemetry.d.ts +23 -0
  447. package/dist/cli/telemetry.js +262 -0
  448. package/dist/cli/telemetryJournal.d.ts +26 -0
  449. package/dist/cli/telemetryJournal.js +104 -0
  450. package/dist/cli/update/index.d.ts +21 -0
  451. package/dist/cli/update/index.js +284 -0
  452. package/dist/cli/upload/index.d.ts +11 -0
  453. package/dist/cli/upload/index.js +261 -0
  454. package/dist/cli/upload/kinds.d.ts +10 -0
  455. package/dist/cli/upload/kinds.js +85 -0
  456. package/dist/cli/upload/multipart.d.ts +21 -0
  457. package/dist/cli/upload/multipart.js +248 -0
  458. package/dist/cli/vault/affected-preview.d.ts +15 -0
  459. package/dist/cli/vault/affected-preview.js +38 -0
  460. package/dist/cli/vault/cloud.d.ts +55 -0
  461. package/dist/cli/vault/cloud.js +287 -0
  462. package/dist/cli/vault/format.d.ts +18 -0
  463. package/dist/cli/vault/format.js +104 -0
  464. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  465. package/dist/cli/vault/hostCredentials.js +71 -0
  466. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  467. package/dist/cli/vault/hostSupersessions.js +68 -0
  468. package/dist/cli/vault/import.d.ts +3 -0
  469. package/dist/cli/vault/import.js +79 -0
  470. package/dist/cli/vault/index.d.ts +14 -0
  471. package/dist/cli/vault/index.js +225 -0
  472. package/dist/cli/vault/keys.d.ts +5 -0
  473. package/dist/cli/vault/keys.js +165 -0
  474. package/dist/cli/vault/kms.d.ts +6 -0
  475. package/dist/cli/vault/kms.js +169 -0
  476. package/dist/cli/vault/list.d.ts +13 -0
  477. package/dist/cli/vault/list.js +60 -0
  478. package/dist/cli/vault/listView.d.ts +21 -0
  479. package/dist/cli/vault/listView.js +123 -0
  480. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  481. package/dist/cli/vault/managementMetadata.js +23 -0
  482. package/dist/cli/vault/mutations.d.ts +8 -0
  483. package/dist/cli/vault/mutations.js +151 -0
  484. package/dist/cli/vault/otp.d.ts +6 -0
  485. package/dist/cli/vault/otp.js +62 -0
  486. package/dist/cli/vault/otpIntent.d.ts +23 -0
  487. package/dist/cli/vault/otpIntent.js +76 -0
  488. package/dist/cli/vault/passImport.d.ts +25 -0
  489. package/dist/cli/vault/passImport.js +129 -0
  490. package/dist/cli/vault/passOtp.d.ts +51 -0
  491. package/dist/cli/vault/passOtp.js +101 -0
  492. package/dist/cli/vault/passStore.d.ts +26 -0
  493. package/dist/cli/vault/passStore.js +134 -0
  494. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  495. package/dist/cli/vault/passwordCommand.js +101 -0
  496. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  497. package/dist/cli/vault/passwordProbe.js +282 -0
  498. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  499. package/dist/cli/vault/passwordRotation.js +273 -0
  500. package/dist/cli/vault/rotationApi.d.ts +13 -0
  501. package/dist/cli/vault/rotationApi.js +58 -0
  502. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  503. package/dist/cli/vault/rotationCommand.js +75 -0
  504. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  505. package/dist/cli/vault/rotationEngine.js +65 -0
  506. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  507. package/dist/cli/vault/rotationHelperSource.js +3 -0
  508. package/dist/cli/vault/rotationInput.d.ts +11 -0
  509. package/dist/cli/vault/rotationInput.js +48 -0
  510. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  511. package/dist/cli/vault/rotationJournal.js +183 -0
  512. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  513. package/dist/cli/vault/rotationKeys.js +48 -0
  514. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  515. package/dist/cli/vault/rotationPrepare.js +108 -0
  516. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  517. package/dist/cli/vault/rotationRemote.js +156 -0
  518. package/dist/cli/vault/rotationState.d.ts +42 -0
  519. package/dist/cli/vault/rotationState.js +115 -0
  520. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  521. package/dist/cli/vault/rotationTransport.js +71 -0
  522. package/dist/cli/vault/sshSource.d.ts +18 -0
  523. package/dist/cli/vault/sshSource.js +196 -0
  524. package/dist/cli/vault/sshSync.d.ts +17 -0
  525. package/dist/cli/vault/sshSync.js +224 -0
  526. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  527. package/dist/cli/vault/sshTransfer.js +140 -0
  528. package/dist/cli/vault/terraformState.d.ts +66 -0
  529. package/dist/cli/vault/terraformState.js +252 -0
  530. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  531. package/dist/cli/vault/terraformStateCommand.js +61 -0
  532. package/dist/cli/vault/tree.d.ts +43 -0
  533. package/dist/cli/vault/tree.js +292 -0
  534. package/dist/cli/version.d.ts +1 -0
  535. package/dist/cli/version.js +9 -0
  536. package/dist/cli/workflow/index.d.ts +76 -0
  537. package/dist/cli/workflow/index.js +826 -0
  538. package/dist/cli/workflow/validate.d.ts +19 -0
  539. package/dist/cli/workflow/validate.js +353 -0
  540. package/dist/package.json +1 -0
  541. package/package.json +28 -10
@@ -0,0 +1,463 @@
1
+ /**
2
+ * Deleting managed objects and managed prefixes.
3
+ *
4
+ * Contract: api-contract §10. Two endpoints with genuinely different execution
5
+ * models, so two commands rather than one with `-r`:
6
+ *
7
+ * - `delete-object` is synchronous and physical. One object, `204`, done.
8
+ * - `delete-prefix` queues an operation and returns its id. It is not atomic,
9
+ * it records failure so it can be retried, and the retry reuses the same
10
+ * operation record rather than making a second one.
11
+ *
12
+ * A flag would have implied those are the same thing with a different scope.
13
+ * They are not: one returns a result, the other returns a handle.
14
+ *
15
+ * What deletion does NOT let this command claim is as important as what it
16
+ * does. Removing an internal object can uncover an external one at the same
17
+ * path, so "deleted" does not mean "gone" and a listing may be the same length
18
+ * afterwards. The server does not report whether anything reappeared, so
19
+ * neither does this.
20
+ */
21
+ import { randomUUID } from "node:crypto";
22
+ import { requestJson } from "../client.js";
23
+ import { emitJson, fail } from "../helpers.js";
24
+ import { bad, ctx, isObject, resolveSource, strictArgs, seg, } from "./index.js";
25
+ import { explainWrite } from "./write.js";
26
+ const MAX_IDEMPOTENCY_KEY = 255;
27
+ const STATES = ["queued", "running", "failed", "succeeded"];
28
+ /**
29
+ * The 202 from `managed-directory-deletions`.
30
+ *
31
+ * Two fields, and neither of them is `id`. Validating this with the full
32
+ * operation shape rejects every real response — the endpoint does not send
33
+ * `id`, `path` or `sourceId` — so the command would fail on a server that
34
+ * behaved exactly as specified.
35
+ */
36
+ export function assertCreatedOperation(res, where) {
37
+ if (!isObject(res))
38
+ bad(`${where}: expected an object`);
39
+ if (typeof res.operationId !== "string" || res.operationId === "") {
40
+ bad(`${where}: missing operationId`);
41
+ }
42
+ // The contract fixes this literal. A different state here would mean the
43
+ // server did something other than queue the deletion.
44
+ if (res.state !== "queued")
45
+ bad(`${where}: expected state 'queued'`);
46
+ return res;
47
+ }
48
+ function isNonNegativeInteger(v) {
49
+ return typeof v === "number" && Number.isSafeInteger(v) && v >= 0;
50
+ }
51
+ /**
52
+ * A full operation, as `GET` and `:retry` return it.
53
+ *
54
+ * `expectedId` is required rather than optional: both callers know which
55
+ * operation they asked about, and an answer describing a different one is not
56
+ * an answer to their question. Accepting it would let a poll silently follow
57
+ * the server to another record — and from `:retry` it would mean a second
58
+ * operation was created, which §10 says never happens and which is where the
59
+ * fencing token comes from.
60
+ */
61
+ export function assertOperation(res, where, expectedId) {
62
+ if (!isObject(res))
63
+ bad(`${where}: expected an object`);
64
+ if (typeof res.id !== "string" || res.id === "")
65
+ bad(`${where}: missing id`);
66
+ if (res.id !== expectedId)
67
+ bad(`${where}: answered about ${res.id}, not ${expectedId}`);
68
+ if (typeof res.path !== "string")
69
+ bad(`${where}: missing path`);
70
+ if (!STATES.includes(res.state))
71
+ bad(`${where}: unknown state`);
72
+ /*
73
+ * Counts are non-negative integers (§4's identical rule for lifecycle
74
+ * counts, and for the same reason): a count comes from counting, and
75
+ * counting produces neither negatives nor fractions. A value that did would
76
+ * be printed to the caller as though someone had counted it.
77
+ */
78
+ if (res.deletedCount !== undefined && !isNonNegativeInteger(res.deletedCount)) {
79
+ bad(`${where}: deletedCount must be a non-negative integer`);
80
+ }
81
+ // Validated because it is PRINTED. An error object missing its code is not
82
+ // something to render half of.
83
+ if (res.safeError !== undefined) {
84
+ const e = res.safeError;
85
+ if (!isObject(e))
86
+ bad(`${where}.safeError: expected an object`);
87
+ if (typeof e.code !== "string" || e.code === "")
88
+ bad(`${where}.safeError: missing code`);
89
+ if (typeof e.message !== "string")
90
+ bad(`${where}.safeError: missing message`);
91
+ if (typeof e.retryable !== "boolean")
92
+ bad(`${where}.safeError: missing retryable`);
93
+ if (typeof e.requestId !== "string")
94
+ bad(`${where}.safeError: missing requestId`);
95
+ }
96
+ return res;
97
+ }
98
+ function idempotencyKey(override) {
99
+ // Absent means "a new command, invent an identity". An explicit empty value
100
+ // means "the same command as before", and inventing one there turns what the
101
+ // caller believed was a retry into a second request.
102
+ if (override === undefined)
103
+ return { ok: true, key: randomUUID() };
104
+ const key = override.trim();
105
+ if (key === "") {
106
+ fail("--idempotency-key is empty — omit it to start a new command");
107
+ return { ok: false };
108
+ }
109
+ if (key.length > MAX_IDEMPOTENCY_KEY) {
110
+ fail(`--idempotency-key is longer than ${MAX_IDEMPOTENCY_KEY} characters`);
111
+ return { ok: false };
112
+ }
113
+ return { ok: true, key };
114
+ }
115
+ function neverAnswered(err) {
116
+ if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
117
+ return true;
118
+ }
119
+ return err instanceof TypeError;
120
+ }
121
+ /**
122
+ * What a caller can conclude from a successful delete, and what they cannot.
123
+ *
124
+ * §10: "删除后下层external可显露". So the object is gone and the PATH may not
125
+ * be. Saying "deleted" alone invites someone to browse, still see the name, and
126
+ * conclude the command failed. Saying external content HAS appeared would be
127
+ * inventing a fact the server never reported — it returns `204` and nothing
128
+ * else.
129
+ */
130
+ const UNCOVER_NOTE = " The path may still resolve: deleting a managed object can uncover external\n" +
131
+ " content that was hidden underneath it.";
132
+ // ── source delete-object ──────────────────────────────────────────────────────
133
+ export async function runDeleteObject(path, opts) {
134
+ const c = await ctx(opts.namespace);
135
+ if (!c)
136
+ return 1;
137
+ const key = idempotencyKey(opts.idempotencyKey);
138
+ if (!key.ok)
139
+ return 1;
140
+ try {
141
+ const source = await resolveSource(c, opts.source);
142
+ // `requestJson` returns undefined for an empty body, which is what a 204
143
+ // is. `requestRaw` is for signed capability reads and only speaks GET/HEAD.
144
+ await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/managed-object`, {
145
+ method: "DELETE",
146
+ token: c.token,
147
+ query: { path },
148
+ headers: { "Idempotency-Key": key.key },
149
+ });
150
+ if (opts.json) {
151
+ // The same fact the directory JSON carries, and the same fact the human
152
+ // line carries. A reader should not have to know which command produced
153
+ // the object to learn whether the path might still resolve.
154
+ emitJson({ deleted: path, pathMayStillResolve: true });
155
+ }
156
+ else
157
+ process.stdout.write(`Deleted managed object '${path}'\n${UNCOVER_NOTE}\n`);
158
+ return 0;
159
+ }
160
+ catch (err) {
161
+ if (neverAnswered(err)) {
162
+ /*
163
+ * §10 is explicit that this command is not exactly-once: it spans MongoDB
164
+ * and object storage, and in the residual window a repeat with the same
165
+ * key can flip from success to `SOURCE_EXTERNAL_READ_ONLY` because the
166
+ * external layer has re-emerged. So the key is offered, and nothing is
167
+ * retried automatically.
168
+ */
169
+ fail(`${explainWrite(err)}\n` +
170
+ ` The server may or may not have deleted it. Retry with the SAME key:\n` +
171
+ ` --idempotency-key ${key.key}`);
172
+ return 1;
173
+ }
174
+ /*
175
+ * The server's own words, and no second attempt.
176
+ *
177
+ * `SOURCE_EXTERNAL_READ_ONLY` says this path is not deletable by this
178
+ * product at all — not that a different endpoint would work — and §10 fixes
179
+ * the decision order so that answer is never a mis-classified kind
180
+ * conflict. Repeating it, or reaching for the directory endpoint on the
181
+ * caller's behalf, would act on a guess about which one they meant.
182
+ */
183
+ fail(explainWrite(err));
184
+ return 1;
185
+ }
186
+ }
187
+ // ── source delete-prefix ──────────────────────────────────────────────────────
188
+ /**
189
+ * `pathMayStillResolve` is a field, not a sentence.
190
+ *
191
+ * The human branch has always said it; a script reading `--json` had no way to
192
+ * learn it, and `delete-status` on a finished operation did not say it at all.
193
+ * It is true of every SUCCESSFUL managed deletion — §10: the external layer
194
+ * underneath can re-emerge — and false of one that did not delete anything, so
195
+ * it is derived from the state rather than pasted onto every response.
196
+ */
197
+ function operationJson(op, extra = {}) {
198
+ return {
199
+ operationId: op.id,
200
+ path: op.path,
201
+ state: op.state,
202
+ ...(op.deletedCount === undefined ? {} : { deletedCount: op.deletedCount }),
203
+ /*
204
+ * Projected, not forwarded.
205
+ *
206
+ * The validator checks four fields; spreading the object publishes whatever
207
+ * else the server attached — a provider URL, an upstream detail — through a
208
+ * client that never decided to. Only what was verified is emitted, so a new
209
+ * field arrives by someone adding it here rather than by nobody noticing.
210
+ */
211
+ ...(op.safeError === undefined
212
+ ? {}
213
+ : {
214
+ error: {
215
+ code: op.safeError.code,
216
+ message: op.safeError.message,
217
+ retryable: op.safeError.retryable,
218
+ requestId: op.safeError.requestId,
219
+ },
220
+ }),
221
+ ...(op.state === "succeeded" ? { pathMayStillResolve: true } : {}),
222
+ ...extra,
223
+ };
224
+ }
225
+ function reportOperation(op, json, prefix) {
226
+ if (json) {
227
+ emitJson(operationJson(op));
228
+ return;
229
+ }
230
+ process.stdout.write(`${prefix} ${op.id}\n path ${op.path}\n state ${op.state}\n`);
231
+ if (op.deletedCount !== undefined) {
232
+ process.stdout.write(` deleted ${op.deletedCount} object(s)\n`);
233
+ }
234
+ if (op.safeError) {
235
+ process.stdout.write(` error ${op.safeError.code} ${op.safeError.message}\n`);
236
+ }
237
+ }
238
+ /** How long `--wait` will watch before handing the operation back. */
239
+ export const WAIT_TIMEOUT_MS = 10 * 60 * 1000;
240
+ const POLL_MS = 2_000;
241
+ async function readOperation(c, operationId) {
242
+ return assertOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/managed-directory-delete-operations/${seg(operationId)}`, { token: c.token }), "operation", operationId);
243
+ }
244
+ export async function runDeletePrefix(path, opts) {
245
+ const c = await ctx(opts.namespace);
246
+ if (!c)
247
+ return 1;
248
+ const key = idempotencyKey(opts.idempotencyKey);
249
+ if (!key.ok)
250
+ return 1;
251
+ let created;
252
+ try {
253
+ const source = await resolveSource(c, opts.source);
254
+ created = assertCreatedOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/managed-directory-deletions`, {
255
+ method: "POST",
256
+ token: c.token,
257
+ headers: { "Idempotency-Key": key.key },
258
+ json: { path },
259
+ }), "managed-directory-deletions");
260
+ }
261
+ catch (err) {
262
+ if (neverAnswered(err)) {
263
+ fail(`${explainWrite(err)}\n` +
264
+ ` The server may or may not have queued it. Retry with the SAME key:\n` +
265
+ ` --idempotency-key ${key.key}`);
266
+ return 1;
267
+ }
268
+ // An external winner returns this and creates NO operation (§10), so there
269
+ // is no handle to report and nothing was started.
270
+ fail(explainWrite(err));
271
+ return 1;
272
+ }
273
+ /*
274
+ * The handle, before anything that can be interrupted — on stderr under
275
+ * `--json`.
276
+ *
277
+ * `--wait` polls, and a caller who presses Ctrl-C during the poll must still
278
+ * be holding the operation id, or the command started work they can no longer
279
+ * name, check, or retry. Under `--json` that line cannot go to stdout: the
280
+ * promise there is that stdout parses whole, and a handle printed beside the
281
+ * final object would break every reader of it.
282
+ */
283
+ const announce = `Queued directory deletion ${created.operationId}\n path ${path}\n`;
284
+ /*
285
+ * Only the WAITING JSON caller needs this on stderr.
286
+ *
287
+ * Without `--wait` the id is already in the object on stdout, and there is
288
+ * nothing to interrupt — a second copy on stderr would be noise the caller
289
+ * has to explain to their own logs.
290
+ */
291
+ if (!opts.json)
292
+ process.stdout.write(announce);
293
+ else if (opts.wait)
294
+ process.stderr.write(announce);
295
+ if (!opts.wait) {
296
+ if (opts.json) {
297
+ emitJson({ operationId: created.operationId, path, state: created.state });
298
+ }
299
+ else {
300
+ process.stdout.write(` state ${created.state}\n` +
301
+ ` Check it with:\n` +
302
+ ` dreamlake source delete-status ${created.operationId}\n${UNCOVER_NOTE}\n`);
303
+ }
304
+ return 0;
305
+ }
306
+ const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
307
+ const now = opts.now ?? (() => Date.now());
308
+ const deadline = now() + WAIT_TIMEOUT_MS;
309
+ let latest = null;
310
+ let state = created.state;
311
+ while (state === "queued" || state === "running") {
312
+ if (now() >= deadline) {
313
+ /*
314
+ * A bounded wait, and the handle again on the way out.
315
+ *
316
+ * Waiting forever turns a command that succeeded into one that appears
317
+ * hung, and the operation is still perfectly checkable — so the timeout
318
+ * hands the handle back rather than failing the deletion. Under `--json`
319
+ * that has to be the one object on stdout, with the fact that the wait
320
+ * gave up stated as a field rather than as prose nobody can parse.
321
+ */
322
+ if (opts.json) {
323
+ emitJson(latest
324
+ ? operationJson(latest, { waitTimedOut: true })
325
+ : { operationId: created.operationId, path, state, waitTimedOut: true });
326
+ }
327
+ else {
328
+ process.stdout.write(` still ${state} after ${Math.round(WAIT_TIMEOUT_MS / 1000)}s — check it with:\n` +
329
+ ` dreamlake source delete-status ${created.operationId}\n`);
330
+ }
331
+ return 0;
332
+ }
333
+ await sleep(POLL_MS);
334
+ try {
335
+ latest = await readOperation(c, created.operationId);
336
+ state = latest.state;
337
+ }
338
+ catch (err) {
339
+ // The deletion is running regardless of whether this poll worked.
340
+ fail(`${explainWrite(err)}\n` +
341
+ ` The deletion is still ${state}. Check it with:\n` +
342
+ ` dreamlake source delete-status ${created.operationId}`);
343
+ return 1;
344
+ }
345
+ }
346
+ // The loop only exits on a terminal state, which only a poll can produce.
347
+ if (!latest)
348
+ return 0;
349
+ reportOperation(latest, opts.json === true, "Directory deletion");
350
+ if (!opts.json && latest.state === "succeeded")
351
+ process.stdout.write(`${UNCOVER_NOTE}\n`);
352
+ // A failed operation is a real failure, and Retry is the way forward — the
353
+ // command does not start a second one.
354
+ if (latest.state === "failed") {
355
+ if (!opts.json) {
356
+ process.stdout.write(` Retry it with:\n dreamlake source delete-retry ${latest.id}\n`);
357
+ }
358
+ return 1;
359
+ }
360
+ return 0;
361
+ }
362
+ // ── source delete-status ──────────────────────────────────────────────────────
363
+ export async function runDeleteStatus(operationId, opts) {
364
+ const c = await ctx(opts.namespace);
365
+ if (!c)
366
+ return 1;
367
+ try {
368
+ const op = await readOperation(c, operationId);
369
+ reportOperation(op, opts.json === true, "Directory deletion");
370
+ // Reading the state and waiting for it should teach the same thing: the
371
+ // managed content is gone and the path may not be.
372
+ if (!opts.json && op.state === "succeeded")
373
+ process.stdout.write(`${UNCOVER_NOTE}\n`);
374
+ return op.state === "failed" ? 1 : 0;
375
+ }
376
+ catch (err) {
377
+ fail(explainWrite(err));
378
+ return 1;
379
+ }
380
+ }
381
+ // ── source delete-retry ───────────────────────────────────────────────────────
382
+ export async function runDeleteRetry(operationId, opts) {
383
+ const c = await ctx(opts.namespace);
384
+ if (!c)
385
+ return 1;
386
+ const key = idempotencyKey(opts.idempotencyKey);
387
+ if (!key.ok)
388
+ return 1;
389
+ try {
390
+ /*
391
+ * The server's retry, not a new deletion.
392
+ *
393
+ * §10: this never creates a second operation record — the same one goes
394
+ * from `failed` back to `queued` with its attempt incremented, and that
395
+ * counter is the fencing token that stops two workers deleting one prefix.
396
+ * Posting `managed-directory-deletions` again would defeat exactly that.
397
+ */
398
+ const op = assertOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/managed-directory-delete-operations/${seg(operationId)}:retry`, { method: "POST", token: c.token, headers: { "Idempotency-Key": key.key } }), "retry",
399
+ /*
400
+ * The same record has to come back.
401
+ *
402
+ * A different id means a second operation exists, which is the one thing
403
+ * §10 says retry never does — and the attempt counter that fences two
404
+ * workers off one prefix belongs to the first record, so the new one
405
+ * carries no protection at all.
406
+ */
407
+ operationId);
408
+ reportOperation(op, opts.json === true, "Retrying directory deletion");
409
+ return 0;
410
+ }
411
+ catch (err) {
412
+ if (neverAnswered(err)) {
413
+ /*
414
+ * The request may already have moved the operation back to `queued`.
415
+ *
416
+ * Without the key the caller cannot repeat this attempt safely — and
417
+ * repeating it without one asks the server to reschedule an operation
418
+ * that may already be running again.
419
+ */
420
+ fail(`${explainWrite(err)}\n` +
421
+ ` The server may or may not have rescheduled it. Retry with the SAME key:\n` +
422
+ ` --idempotency-key ${key.key}`);
423
+ return 1;
424
+ }
425
+ // Retry requires `failed`. Anything else is a state this command must not
426
+ // move, so the server's own message is what the caller gets.
427
+ fail(explainWrite(err));
428
+ return 1;
429
+ }
430
+ }
431
+ // ── registration ──────────────────────────────────────────────────────────────
432
+ export function registerSourceDeleteCommands(source) {
433
+ strictArgs(source.command("delete-object"))
434
+ .description("delete one managed object (immediate, physical)")
435
+ .argument("<path>", "path within the source")
436
+ .requiredOption("--source <name>", "source name (see 'dreamlake source list')")
437
+ .option("--namespace <slug>", "namespace slug (default: active login)")
438
+ .option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
439
+ .option("--json", "emit JSON")
440
+ .action(async (path, opts) => process.exit(await runDeleteObject(path, opts)));
441
+ strictArgs(source.command("delete-prefix"))
442
+ .description("queue a recursive delete of one managed directory")
443
+ .argument("<path>", "directory path within the source")
444
+ .requiredOption("--source <name>", "source name (see 'dreamlake source list')")
445
+ .option("--wait", "watch until the operation finishes")
446
+ .option("--namespace <slug>", "namespace slug (default: active login)")
447
+ .option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
448
+ .option("--json", "emit JSON")
449
+ .action(async (path, opts) => process.exit(await runDeletePrefix(path, opts)));
450
+ strictArgs(source.command("delete-status"))
451
+ .description("read a directory-deletion operation")
452
+ .argument("<operationId>", "operation id from 'source delete-prefix'")
453
+ .option("--namespace <slug>", "namespace slug (default: active login)")
454
+ .option("--json", "emit JSON")
455
+ .action(async (id, opts) => process.exit(await runDeleteStatus(id, opts)));
456
+ strictArgs(source.command("delete-retry"))
457
+ .description("retry a failed directory-deletion operation")
458
+ .argument("<operationId>", "operation id from 'source delete-prefix'")
459
+ .option("--namespace <slug>", "namespace slug (default: active login)")
460
+ .option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
461
+ .option("--json", "emit JSON")
462
+ .action(async (id, opts) => process.exit(await runDeleteRetry(id, opts)));
463
+ }