@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,575 @@
1
+ import { collectionList } from "../collection-list.js";
2
+ // `dreamlake runnable …` — the read side of the Runnable collection, plus the
3
+ // one write that `declare` cannot express.
4
+ //
5
+ // A Runnable is named code you invoke. It has two layers:
6
+ //
7
+ // Runnable the mutable head — name, kind, description, and a
8
+ // denormalised `latestVersion` pointer.
9
+ // RunnableVersion immutable history, keyed by `version`, which IS
10
+ // sha256(source) in lowercase hex.
11
+ //
12
+ // That identity is the whole design. Registration is idempotent BY CONTENT:
13
+ // posting bytes that are already stored returns 200 and changes nothing, so a
14
+ // second caller holding the same source cannot silently replace what the first
15
+ // one stored. `version push` reports 200 and 201 differently for exactly this
16
+ // reason — the difference is the information.
17
+ //
18
+ // `kind` is a LIFETIME discriminator — `udf` (one-shot), `session` (long-lived
19
+ // with a pipe), `agent` (a session plus a policy). It says nothing about
20
+ // whether the function is sync, async, a generator or an async generator; the
21
+ // registry has no field for that today.
22
+ //
23
+ // Registry routes store declarations. run.ts bridges a pinned UDF version to
24
+ // the existing managed-host execution path without changing registration.
25
+ import { registerRunnableUpload } from "./upload.js";
26
+ import { createHash } from "node:crypto";
27
+ import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
28
+ import path from "node:path";
29
+ import { HttpError, requestJson } from "../client.js";
30
+ import { resolveNamespace, resolveRemote, resolveToken } from "../config.js";
31
+ import { emitJson, fail, ok, renderTable, warn } from "../helpers.js";
32
+ import { namespaceFromPath, resolveRunnablePath } from "./path.js";
33
+ import { registerRunnableRun } from "./run.js";
34
+ // ─── shared context resolution ───────────────────────────────────────────────
35
+ async function ctx(nsFlag) {
36
+ const token = resolveToken();
37
+ if (!token) {
38
+ fail("not authenticated — run 'dreamlake login' first");
39
+ return null;
40
+ }
41
+ const remote = resolveRemote();
42
+ const ns = await resolveNamespace(nsFlag, { token, remote });
43
+ if (!ns) {
44
+ fail("could not resolve namespace — run 'dreamlake login' or pass --namespace");
45
+ return null;
46
+ }
47
+ return { token, remote, ns };
48
+ }
49
+ /** A runnable name is dotted and user-supplied; it goes in a path segment. */
50
+ function seg(value) {
51
+ return encodeURIComponent(value);
52
+ }
53
+ /** Table-only abbreviation. `show` always prints the full 64 characters. */
54
+ function short(hash) {
55
+ if (!hash)
56
+ return "—";
57
+ return hash.length > 12 ? hash.slice(0, 12) : hash;
58
+ }
59
+ /** Pull the server's own `{ error }` string off a thrown HttpError. */
60
+ function serverError(err) {
61
+ try {
62
+ const parsed = JSON.parse(err.body);
63
+ return typeof parsed.error === "string" ? parsed.error : null;
64
+ }
65
+ catch {
66
+ return null;
67
+ }
68
+ }
69
+ // ─── runnable list ───────────────────────────────────────────────────────────
70
+ export async function runRunnableList(opts) {
71
+ const c = await ctx(opts.namespace);
72
+ if (!c)
73
+ return 1;
74
+ try {
75
+ const res = await requestJson(c.remote, `/namespaces/${c.ns}/runnables`, { token: c.token, query: { kind: opts.kind, module: opts.module, pageSize: 200 } });
76
+ if (opts.json) {
77
+ emitJson(res.runnables);
78
+ return 0;
79
+ }
80
+ if (res.runnables.length === 0) {
81
+ process.stdout.write("No runnables found.\n");
82
+ return 0;
83
+ }
84
+ const rows = res.runnables.map((r) => ({
85
+ name: r.name,
86
+ kind: r.kind,
87
+ latestVersion: short(r.latestVersion),
88
+ updatedAt: r.updatedAt.slice(0, 10),
89
+ }));
90
+ process.stdout.write(renderTable(rows, ["name", "kind", "latestVersion", "updatedAt"]));
91
+ process.stdout.write(`\n ${res.runnables.length} runnable(s)\n`);
92
+ return 0;
93
+ }
94
+ catch (err) {
95
+ if (err instanceof HttpError && err.status === 404) {
96
+ fail(`namespace '${c.ns}' not found on ${c.remote}`);
97
+ return 1;
98
+ }
99
+ fail(err.message);
100
+ return 1;
101
+ }
102
+ }
103
+ // ─── runnable show ───────────────────────────────────────────────────────────
104
+ // `<name>` here is an ADDRESS, not just a name. A bare dotted name still works
105
+ // exactly as it always did (one request, same 404 wording); a full
106
+ // `udf/<ns>/<name>@<version>` path takes its namespace from the path — beating
107
+ // --namespace — and has its kind verified against the stored row. See path.ts.
108
+ export async function runRunnableShow(name, opts) {
109
+ // A namespace in the path beats --namespace, and it also RELIEVES the
110
+ // connection context of having to produce one: an address is self-contained
111
+ // by design, so it must resolve even when the active login has no namespace.
112
+ const c = await ctx(namespaceFromPath(name) ?? opts.namespace);
113
+ if (!c)
114
+ return 1;
115
+ const resolved = await resolveRunnablePath(name, {
116
+ remote: c.remote,
117
+ token: c.token,
118
+ namespace: c.ns,
119
+ version: opts.version,
120
+ });
121
+ if (!resolved.ok) {
122
+ fail(resolved.message);
123
+ return 1;
124
+ }
125
+ const r = resolved.value.head;
126
+ if (opts.json) {
127
+ emitJson(r);
128
+ return 0;
129
+ }
130
+ process.stdout.write(`Runnable: ${r.name}\n`);
131
+ // The global address, ready to paste: namespace-qualified, so it means the
132
+ // same thing wherever it is written.
133
+ process.stdout.write(` path: ${resolved.value.address}\n`);
134
+ process.stdout.write(` kind: ${r.kind}\n`);
135
+ process.stdout.write(` module: ${r.module}\n`);
136
+ process.stdout.write(` qualname: ${r.qualname}\n`);
137
+ process.stdout.write(` description: ${r.description || "—"}\n`);
138
+ // Full hash, never truncated. A short prefix is now resolvable, but only
139
+ // client-side and only when it is unambiguous — the SERVER still addresses a
140
+ // version by all 64 characters and nothing else.
141
+ process.stdout.write(` latestVersion: ${r.latestVersion || "— (no versions registered)"}\n`);
142
+ if (r.kind === "agent") {
143
+ process.stdout.write(` channel.kind: ${r.channel?.kind || "—"}\n`);
144
+ process.stdout.write(` channel.target: ${r.channel?.target || "—"}\n`);
145
+ process.stdout.write(` markdown: ${r.markdown ? `${r.markdown.length} characters` : "—"}\n`);
146
+ }
147
+ process.stdout.write(` created: ${r.createdAt.slice(0, 10)}\n`);
148
+ process.stdout.write(` updated: ${r.updatedAt.slice(0, 10)}\n`);
149
+ for (const w of resolved.value.warnings)
150
+ warn(w);
151
+ return 0;
152
+ }
153
+ // ─── runnable version push ───────────────────────────────────────────────────
154
+ //
155
+ // The one command in this group that writes. It uses `fetch` directly rather
156
+ // than `requestJson` because the STATUS is the payload: 201 means a new
157
+ // immutable row and a moved `latestVersion`; 200 means these exact bytes were
158
+ // already stored and nothing changed. `requestJson` throws away the status.
159
+ export async function runRunnableVersionPush(name, opts) {
160
+ const c = await ctx(opts.namespace);
161
+ if (!c)
162
+ return 1;
163
+ let bytes;
164
+ try {
165
+ bytes = readFileSync(path.resolve(opts.source));
166
+ }
167
+ catch {
168
+ fail(`cannot read --source file: ${opts.source}`);
169
+ return 1;
170
+ }
171
+ // The version IS the content hash. Computed here, never supplied by a flag.
172
+ const version = createHash("sha256").update(bytes).digest("hex");
173
+ const body = {
174
+ version,
175
+ source: bytes.toString("utf8"),
176
+ };
177
+ if (opts.signature) {
178
+ let raw;
179
+ try {
180
+ raw = readFileSync(path.resolve(opts.signature), "utf8");
181
+ }
182
+ catch {
183
+ fail(`cannot read --signature file: ${opts.signature}`);
184
+ return 1;
185
+ }
186
+ try {
187
+ const parsed = JSON.parse(raw);
188
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
189
+ fail("--signature must be a JSON object, e.g. {\"params\":[],\"returns\":null,\"doc\":\"…\"}");
190
+ return 1;
191
+ }
192
+ body.signature = parsed;
193
+ }
194
+ catch (err) {
195
+ fail(`--signature is not valid JSON: ${err.message}`);
196
+ return 1;
197
+ }
198
+ }
199
+ const url = `${c.remote}/namespaces/${c.ns}/runnables/${seg(name)}/versions`;
200
+ let res;
201
+ try {
202
+ res = await fetch(url, {
203
+ method: "POST",
204
+ headers: {
205
+ Authorization: `Bearer ${c.token}`,
206
+ "Content-Type": "application/json",
207
+ },
208
+ body: JSON.stringify(body),
209
+ signal: AbortSignal.timeout(30000),
210
+ });
211
+ }
212
+ catch (err) {
213
+ fail(err.message);
214
+ return 1;
215
+ }
216
+ if (res.status === 403) {
217
+ fail(`registering a version needs runnable:update on namespace '${c.ns}' — READ is not enough`);
218
+ return 1;
219
+ }
220
+ if (res.status === 404) {
221
+ fail(`runnable '${name}' not found in namespace '${c.ns}' — declare the head row first with 'dreamlake declare'`);
222
+ return 1;
223
+ }
224
+ if (res.status !== 200 && res.status !== 201) {
225
+ const text = await res.text().catch(() => "");
226
+ fail(new HttpError(res.status, text).message);
227
+ return 1;
228
+ }
229
+ const row = (await res.json().catch(() => ({})));
230
+ const created = res.status === 201;
231
+ if (opts.json) {
232
+ emitJson({ ...row, status: created ? "created" : "unchanged" });
233
+ return 0;
234
+ }
235
+ if (created) {
236
+ ok(`registered version ${version} of ${name}`);
237
+ process.stdout.write(" latestVersion is now this version\n");
238
+ }
239
+ else {
240
+ warn(`version ${version} already registered — unchanged`);
241
+ process.stdout.write(" registration is idempotent by content: the version IS sha256(source),\n" +
242
+ " so identical bytes cannot overwrite a stored row\n");
243
+ }
244
+ return 0;
245
+ }
246
+ // ─── runnable version list ───────────────────────────────────────────────────
247
+ export async function runRunnableVersionList(name, opts) {
248
+ const c = await ctx(opts.namespace);
249
+ if (!c)
250
+ return 1;
251
+ try {
252
+ const res = await requestJson(c.remote, `/namespaces/${c.ns}/runnables/${seg(name)}/versions`, { token: c.token, query: { pageSize: 200 } });
253
+ if (opts.json) {
254
+ emitJson(res.versions);
255
+ return 0;
256
+ }
257
+ if (res.versions.length === 0) {
258
+ process.stdout.write("No versions found.\n");
259
+ return 0;
260
+ }
261
+ // `source` is never in a list projection — 200 rows of source is
262
+ // megabytes. `hasSource` reports whether the detail route would serve one.
263
+ const rows = res.versions.map((v) => ({
264
+ version: short(v.version),
265
+ hasSource: v.source ? "yes" : "—",
266
+ createdAt: v.createdAt.slice(0, 10),
267
+ }));
268
+ process.stdout.write(renderTable(rows, ["version", "hasSource", "createdAt"]));
269
+ process.stdout.write(`\n ${res.versions.length} version(s)\n`);
270
+ return 0;
271
+ }
272
+ catch (err) {
273
+ if (err instanceof HttpError && err.status === 404) {
274
+ fail(`runnable '${name}' not found in namespace '${c.ns}'`);
275
+ return 1;
276
+ }
277
+ fail(err.message);
278
+ return 1;
279
+ }
280
+ }
281
+ // ─── runnable version show ───────────────────────────────────────────────────
282
+ export async function runRunnableVersionShow(name, version, opts) {
283
+ const c = await ctx(namespaceFromPath(name) ?? opts.namespace);
284
+ if (!c)
285
+ return 1;
286
+ // The positional argument and --version are aliases for the same thing; the
287
+ // positional wins, and an `@suffix` on the name wins over both.
288
+ const asked = version ?? opts.version;
289
+ let ns = c.ns;
290
+ let target = name;
291
+ let pinned = asked ?? "";
292
+ // FAST PATH — and it is the pre-existing behaviour, kept deliberately: a
293
+ // bare name plus a full 64-hex addresses the detail route in ONE request,
294
+ // and the server's two distinct 404s ("runnable not found" vs "version not
295
+ // found") stay distinguishable. Anything else — a path, `latest`, a short
296
+ // prefix, or no version at all — has to read the head first.
297
+ const needsResolution = name.includes("/") ||
298
+ name.includes("@") ||
299
+ asked === undefined ||
300
+ !/^[0-9a-f]{64}$/.test(asked);
301
+ if (needsResolution) {
302
+ const resolved = await resolveRunnablePath(name, {
303
+ remote: c.remote,
304
+ token: c.token,
305
+ namespace: c.ns,
306
+ version: asked,
307
+ resolveVersion: true,
308
+ });
309
+ if (!resolved.ok) {
310
+ fail(resolved.code === "no-versions"
311
+ ? `${resolved.message} — register one with 'dreamlake runnable version push'`
312
+ : resolved.message);
313
+ return 1;
314
+ }
315
+ ns = resolved.value.namespace;
316
+ target = resolved.value.name;
317
+ pinned = resolved.value.version;
318
+ // No agent warning here on purpose: every output mode of this command is
319
+ // machine-readable (a JSON row, or raw source bytes under --source-only),
320
+ // so there is no prose channel to put it on. `runnable show` and
321
+ // `runnable import` carry it.
322
+ }
323
+ try {
324
+ const row = await requestJson(c.remote, `/namespaces/${ns}/runnables/${seg(target)}/versions/${seg(pinned)}`, { token: c.token });
325
+ if (opts.sourceOnly) {
326
+ if (row.source == null) {
327
+ fail(`version ${pinned} of '${target}' has no stored source`);
328
+ return 1;
329
+ }
330
+ // Raw, undecorated, exactly the stored bytes — so
331
+ // dreamlake runnable version show a b --source-only > udf.py
332
+ // round-trips to the same sha256.
333
+ process.stdout.write(row.source);
334
+ return 0;
335
+ }
336
+ emitJson(row);
337
+ return 0;
338
+ }
339
+ catch (err) {
340
+ if (err instanceof HttpError && err.status === 404) {
341
+ // The server distinguishes "runnable not found" from "version not
342
+ // found" and the difference matters: one is a typo in the name, the
343
+ // other is a hash that was never registered.
344
+ const detail = serverError(err);
345
+ if (detail === "version not found") {
346
+ fail(`version not found: ${pinned} is not a registered version of '${target}'`);
347
+ }
348
+ else if (detail === "runnable not found") {
349
+ fail(`runnable not found: '${target}' does not exist in namespace '${ns}'`);
350
+ }
351
+ else {
352
+ fail(`not found: ${detail ?? `'${target}' @ ${pinned}`}`);
353
+ }
354
+ return 1;
355
+ }
356
+ fail(err.message);
357
+ return 1;
358
+ }
359
+ }
360
+ // ─── runnable import ─────────────────────────────────────────────────────────
361
+ //
362
+ // A composition of the GETs above, not a new capability. Import-by-name is
363
+ // STILL two round trips — read `latestVersion` off the head, echo it back —
364
+ // and the address form does not change that: `latestVersion` is a plain column
365
+ // and the server has no `?version=latest`. A short `@prefix` costs a third.
366
+ export async function runRunnableImport(name, opts) {
367
+ const c = await ctx(namespaceFromPath(name) ?? opts.namespace);
368
+ if (!c)
369
+ return 1;
370
+ // One resolution step covers all four input shapes: a bare name, a full
371
+ // path, `--version <64hex>` and `--version latest|<prefix>`. It fetches the
372
+ // head exactly once, which import needs anyway for `qualname` and `kind`.
373
+ const resolved = await resolveRunnablePath(name, {
374
+ remote: c.remote,
375
+ token: c.token,
376
+ namespace: c.ns,
377
+ version: opts.version,
378
+ resolveVersion: true,
379
+ });
380
+ if (!resolved.ok) {
381
+ fail(resolved.code === "no-versions"
382
+ ? `${resolved.message} — nothing to import. ` +
383
+ `Register one with 'dreamlake runnable version push'.`
384
+ : resolved.message);
385
+ return 1;
386
+ }
387
+ const { head, namespace: ns, address } = resolved.value;
388
+ const target = resolved.value.name;
389
+ const version = resolved.value.version;
390
+ let row;
391
+ try {
392
+ row = await requestJson(c.remote, `/namespaces/${ns}/runnables/${seg(target)}/versions/${seg(version)}`, { token: c.token });
393
+ }
394
+ catch (err) {
395
+ if (err instanceof HttpError && err.status === 404) {
396
+ const detail = serverError(err);
397
+ fail(detail === "version not found"
398
+ ? `version not found: ${version} is not a registered version of '${target}'`
399
+ : `not found: ${detail ?? `'${target}' @ ${version}`}`);
400
+ return 1;
401
+ }
402
+ fail(err.message);
403
+ return 1;
404
+ }
405
+ const stem = head.qualname || target.split(".").pop() || "runnable";
406
+ const outDir = path.resolve(opts.out);
407
+ const sourcePath = path.join(outDir, `${stem}.py`);
408
+ const signaturePath = path.join(outDir, "signature.json");
409
+ const pinnedPath = path.join(outDir, "PINNED.json");
410
+ try {
411
+ mkdirSync(outDir, { recursive: true });
412
+ writeFileSync(sourcePath, row.source ?? "");
413
+ writeFileSync(signaturePath, JSON.stringify(row.signature ?? {}, null, 2) + "\n");
414
+ writeFileSync(pinnedPath, JSON.stringify({
415
+ remote: c.remote,
416
+ namespace: ns,
417
+ name: head.name,
418
+ kind: head.kind,
419
+ version,
420
+ // The one-token form of the four fields above it. A pin you can
421
+ // paste is a pin someone will actually quote.
422
+ path: address,
423
+ importedAt: new Date().toISOString(),
424
+ }, null, 2) + "\n");
425
+ }
426
+ catch (err) {
427
+ fail(`cannot write to ${outDir}: ${err.message}`);
428
+ return 1;
429
+ }
430
+ const files = [sourcePath, signaturePath, pinnedPath];
431
+ if (opts.json) {
432
+ emitJson({ name: head.name, version, path: address, files });
433
+ return 0;
434
+ }
435
+ for (const f of files)
436
+ process.stdout.write(` wrote ${f}\n`);
437
+ ok(`imported ${address}`);
438
+ for (const w of resolved.value.warnings)
439
+ warn(w);
440
+ return 0;
441
+ }
442
+ // ─── registration ────────────────────────────────────────────────────────────
443
+ //
444
+ // WHY THE FLAG IS `--at` AND NOT `--version`. It cannot be `--version`:
445
+ // `program.version(VERSION, "-v, --version")` in cli/index.ts registers a
446
+ // version option that Commander resolves from ANY descendant command, so
447
+ // `dreamlake runnable import foo --version <sha>` prints "0.6.0" and exits 0
448
+ // without importing anything. That was true of the pre-existing `--version`
449
+ // flag on `import` too — it has never worked from a shell, only from the tests,
450
+ // which call the run* functions directly and never parse argv.
451
+ //
452
+ // The `@` suffix is the primary form regardless, because it is one token. `--at`
453
+ // is the flag alias for it. `runnable-path.test.ts` guards the rename: no
454
+ // command in this tree may declare a `--version` option again.
455
+ export function registerRunnableCommand(program) {
456
+ const runnable = program
457
+ .command("runnable")
458
+ .description("browse runnables (udf | session | agent), their versions, and import them");
459
+ registerRunnableRun(runnable);
460
+ collectionList(runnable, "list")
461
+ .description("list runnables in a namespace")
462
+ .option("--kind <kind>", "filter by lifetime: udf | session | agent")
463
+ .option("--module <module>", "filter by module (the part of the name before the last dot)")
464
+ .option("--namespace <slug>", "namespace slug (default: active login)")
465
+ .option("--json", "emit JSON")
466
+ .addHelpText("after", [
467
+ "",
468
+ "`latestVersion` is truncated to 12 characters in the table so the columns fit.",
469
+ "Use `dreamlake runnable show <name>` for the full 64-character hash — that is",
470
+ "the only form that addresses anything.",
471
+ ].join("\n"))
472
+ .action(async (opts) => process.exit(await runRunnableList(opts)));
473
+ runnable
474
+ .command("show").alias("read")
475
+ .description("show one runnable, including its full latestVersion hash and its global path")
476
+ .argument("<name>", "dotted name, \"<module>.<qualname>\", a 24-hex id, or a path udf/<ns>/<name>[@<version>]")
477
+ .option("--at <latest|prefix|sha256>", "resolve a version too. Alias for the '@' suffix; the suffix wins if both are given.")
478
+ .option("--namespace <slug>", "namespace slug (default: active login)")
479
+ .option("--json", "emit JSON")
480
+ .addHelpText("after", [
481
+ "",
482
+ "A runnable's global address is <kind>/<namespace>/<name>[@<version>] —",
483
+ "one token, namespace-qualified, so it means the same thing wherever it is",
484
+ "written. The kind segment is VERIFIED against the stored row, never guessed:",
485
+ "a path that says udf/ cannot quietly resolve to an agent.",
486
+ "",
487
+ " dreamlake runnable show udf/chengdu/examples.cpu.add@latest",
488
+ " dreamlake runnable show examples.cpu.add --namespace chengdu",
489
+ "",
490
+ "A namespace in the path beats --namespace. Resolution is client-side: the",
491
+ "server still only accepts a full 64-character hash.",
492
+ ].join("\n"))
493
+ .action(async (name, opts) => process.exit(await runRunnableShow(name, { ...opts, version: opts.at })));
494
+ registerRunnableUpload(runnable);
495
+ // ── runnable version ──
496
+ const version = runnable
497
+ .command("version")
498
+ .description("register and inspect immutable versions of a runnable");
499
+ version
500
+ .command("push")
501
+ .description("register a version of a runnable from a source file")
502
+ .argument("<name>", "dotted name of an already-declared runnable")
503
+ .requiredOption("--source <file>", "the source file. Its bytes become both the stored source and the version key")
504
+ .option("--signature <file>", "optional JSON file, shape { params, returns, doc }. Owned by the SDK and passed through untouched.")
505
+ .option("--namespace <slug>", "namespace slug (default: active login)")
506
+ .option("--json", "emit JSON (the stored row, plus status: created | unchanged)")
507
+ .addHelpText("after", [
508
+ "",
509
+ "There is deliberately no --version flag. RunnableVersion.version must stay",
510
+ "byte-identical to the control plane's Function.version, so it is computed",
511
+ "here as sha256 of the file's bytes and can never be supplied by hand.",
512
+ "",
513
+ "That makes registration idempotent by content. Pushing bytes that are already",
514
+ "stored returns 200 and changes nothing — printed as \"already registered —",
515
+ "unchanged\" — so a second caller cannot silently replace source that the hash",
516
+ "says is identical. A new hash returns 201 and moves latestVersion.",
517
+ "",
518
+ "Registering a version needs runnable:update, not runnable:create: an org",
519
+ "MEMBER with READ can list versions but cannot push one.",
520
+ ].join("\n"))
521
+ .action(async (name, opts) => process.exit(await runRunnableVersionPush(name, opts)));
522
+ collectionList(version, "list")
523
+ .description("list a runnable's versions, newest first (source is not included)")
524
+ .argument("<name>", "dotted name of the runnable")
525
+ .option("--namespace <slug>", "namespace slug (default: active login)")
526
+ .option("--json", "emit JSON")
527
+ .action(async (name, opts) => process.exit(await runRunnableVersionList(name, opts)));
528
+ version
529
+ .command("show")
530
+ .description("show one version, including its full source")
531
+ .argument("<name>", "dotted name of the runnable, or a path udf/<ns>/<name>[@<version>]")
532
+ .argument("[version]", "'latest', a >=8-character hex prefix, or the full 64-character sha256. Defaults to latest.")
533
+ .option("--at <latest|prefix|sha256>", "same as the positional argument")
534
+ .option("--source-only", "write only the stored source to stdout, undecorated — safe to redirect into a file")
535
+ .option("--namespace <slug>", "namespace slug (default: active login)")
536
+ .option("--json", "emit JSON (the default output already is JSON)")
537
+ .addHelpText("after", [
538
+ "",
539
+ "The SERVER still addresses versions by the full 64-character hash and nothing",
540
+ "else — there is no ?version=latest, no tag and no prefix match on the route.",
541
+ "`latest` and a short prefix are resolved HERE, client-side: latest reads the",
542
+ "head's latestVersion (one extra request), a prefix lists the versions and",
543
+ "matches on it (two extra), and an ambiguous prefix is an error rather than a",
544
+ "guess. A bare name plus a full hash still takes exactly one request.",
545
+ "",
546
+ " dreamlake runnable version show udf/chengdu/examples.cpu.add@latest --source-only > udf.py",
547
+ " dreamlake runnable version show examples.embed.embed_frames <sha256> --source-only > udf.py",
548
+ ].join("\n"))
549
+ .action(async (name, ver, opts) => process.exit(await runRunnableVersionShow(name, ver, { ...opts, version: opts.at })));
550
+ runnable
551
+ .command("import")
552
+ .description("fetch a runnable's source and signature into a directory, pinned to one version")
553
+ .argument("<name>", "dotted name of the runnable, or a path udf/<ns>/<name>[@<version>]")
554
+ .option("--at <latest|prefix|sha256>", "the version to import. Defaults to the head's latestVersion, read in a separate request.")
555
+ .requiredOption("--out <dir>", "directory to write into (created if missing)")
556
+ .option("--namespace <slug>", "namespace slug (default: active login)")
557
+ .option("--json", "emit JSON ({ name, version, files })")
558
+ .addHelpText("after", [
559
+ "",
560
+ "Writes three files:",
561
+ " <qualname>.py the stored source, byte for byte",
562
+ " signature.json { params, returns, doc } — {} when the version has none",
563
+ " PINNED.json { remote, namespace, name, kind, version, path, importedAt }",
564
+ " `path` is the one-token address, e.g.",
565
+ " udf/chengdu/examples.cpu.add@<sha256>",
566
+ "",
567
+ "PINNED.json exists because a pin that lives only in shell history is not a pin.",
568
+ "Commit it next to the source and the next reader can prove what they are running.",
569
+ "",
570
+ "Import does not fetch a RunConfig. No route joins a Runnable to one, and there",
571
+ "is no ?include= — a RunConfig is referenced by name, on purpose. Fetch it",
572
+ "separately with `dreamlake runconfig show`.",
573
+ ].join("\n"))
574
+ .action(async (name, opts) => process.exit(await runRunnableImport(name, { ...opts, version: opts.at })));
575
+ }