@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,115 @@
1
+ export type RunnableKind = "udf" | "agent";
2
+ export interface RunnablePath {
3
+ /** `udf` | `agent`, or null for the bare-name shorthand. */
4
+ kind: RunnableKind | null;
5
+ /** Namespace slug, or null when the shorthand is used. */
6
+ namespace: string | null;
7
+ /** Runnable.name — already `"<module>.<qualname>"`. */
8
+ name: string;
9
+ /** `latest`, a hex prefix, the full 64-hex, or null when absent. */
10
+ version: string | null;
11
+ }
12
+ export declare class RunnablePathError extends Error {
13
+ constructor(message: string);
14
+ }
15
+ /** Validate a version token from either the `@suffix` or the `--version` flag. */
16
+ export declare function assertVersionShape(value: string, where: string): void;
17
+ /**
18
+ * Parse an address. Throws RunnablePathError with a message meant to be shown
19
+ * verbatim; every caller in this CLI catches it and turns it into rc 1.
20
+ */
21
+ export declare function parseRunnablePath(raw: string): RunnablePath;
22
+ /**
23
+ * The namespace segment, if the argument is a canonical path — for callers
24
+ * that must resolve their connection context BEFORE they can resolve anything
25
+ * else. Never throws: a malformed path returns null here and produces its real
26
+ * error later, from parseRunnablePath, where the message can be specific.
27
+ *
28
+ * This is what makes an address self-contained. `dreamlake runnable show
29
+ * udf/chengdu/examples.cpu.add` has to work whether or not the active login
30
+ * resolves to a namespace, because the string already says which one.
31
+ */
32
+ export declare function namespaceFromPath(raw: string): string | null;
33
+ /**
34
+ * Render the canonical address. A `session` runnable has no path prefix in
35
+ * this scheme, so it renders as the bare name — printing `session/…` would
36
+ * produce a string that parseRunnablePath then rejects.
37
+ */
38
+ export declare function formatRunnablePath(kind: string, namespace: string, name: string, version?: string | null): string;
39
+ export interface RunnableHead {
40
+ id: string;
41
+ namespaceId: string;
42
+ name: string;
43
+ module: string;
44
+ qualname: string;
45
+ kind: string;
46
+ description?: string | null;
47
+ markdown?: string | null;
48
+ channel?: {
49
+ kind?: string;
50
+ target?: string;
51
+ config?: unknown;
52
+ } | null;
53
+ latestVersion?: string | null;
54
+ metadata?: unknown;
55
+ createdAt: string;
56
+ updatedAt: string;
57
+ }
58
+ export declare const AGENT_PIN_WARNING: string;
59
+ export interface ResolvedRunnable {
60
+ /** The namespace actually used: the path's, else the caller's fallback. */
61
+ namespace: string;
62
+ /** Runnable.name, as parsed (an id in the <name> slot resolves server-side). */
63
+ name: string;
64
+ /** The head row, already fetched — callers must not fetch it again. */
65
+ head: RunnableHead;
66
+ /** The full 64-hex version, or null when none was asked for. */
67
+ version: string | null;
68
+ /** Lines the caller prints with warn(), and only when it has a prose channel. */
69
+ warnings: string[];
70
+ /** The canonical address, ready to paste. */
71
+ address: string;
72
+ }
73
+ /**
74
+ * Why the failure carries a `code` as well as a message: the same failure
75
+ * reads differently depending on the verb. "no registered versions" is
76
+ * "nothing to import" for `import` and "nothing for '@latest' to point at"
77
+ * for `version show`, and the caller owns that wording.
78
+ */
79
+ export type ResolveFailureCode = "bad-path" | "not-found" | "kind-mismatch" | "no-versions" | "ambiguous-prefix" | "no-prefix-match" | "request-failed";
80
+ export type ResolveOutcome = {
81
+ ok: true;
82
+ value: ResolvedRunnable;
83
+ } | {
84
+ ok: false;
85
+ code: ResolveFailureCode;
86
+ message: string;
87
+ };
88
+ export interface ResolveOpts {
89
+ remote: string;
90
+ token: string;
91
+ /** Namespace used when the path carries none. */
92
+ namespace: string;
93
+ /** The `--version` flag. An `@suffix` in the path wins over it. */
94
+ version?: string;
95
+ /**
96
+ * Resolve a concrete 64-hex version. Defaults to "only if one was asked
97
+ * for", which keeps a bare `runnable show <name>` at exactly one request.
98
+ */
99
+ resolveVersion?: boolean;
100
+ }
101
+ /**
102
+ * Resolve an address against the routes that exist today. No server change, no
103
+ * schema change, no migration.
104
+ *
105
+ * 1. assert kind ∈ { udf, agent } (parse, no request)
106
+ * 2. GET /namespaces/<ns>/runnables/<name> (request 1)
107
+ * findRunnable() tries a 24-hex ObjectId first, then the name
108
+ * (declarations.ts:332-338), so an id works in the <name> slot too
109
+ * 3. assert row.kind === kind — verified, never guessed
110
+ * 4. latest → row.latestVersion
111
+ * 64 hex → as given
112
+ * 8..63 → GET …/versions, filter by prefix, exactly one match (request 2)
113
+ * 5. the caller GETs …/versions/<full 64 hex> — the only route with `source`
114
+ */
115
+ export declare function resolveRunnablePath(raw: string, opts: ResolveOpts): Promise<ResolveOutcome>;
@@ -0,0 +1,288 @@
1
+ // The global address of a runnable:
2
+ //
3
+ // <kind>/<namespace>/<name>[@<version>]
4
+ //
5
+ // udf/chengdu/examples.cpu.add
6
+ // udf/chengdu/examples.cpu.add@latest
7
+ // udf/chengdu/examples.cpu.add@8fa3c1d2
8
+ // udf/chengdu/examples.cpu.add@8fa3c1d2…(64 hex)…
9
+ // agent/chengdu/ops.triage.reviewer@latest
10
+ //
11
+ // WHY A PATH AT ALL. A reference is only useful if it survives being ONE
12
+ // lexical token: pasted into Slack, typed into a Makefile, written in prose,
13
+ // passed as a single CLI argument. `--namespace x --version y name` is three
14
+ // tokens and cannot be copy-pasted as one.
15
+ //
16
+ // WHY EACH SEGMENT IS WHAT IT IS:
17
+ //
18
+ // <kind> literal `udf` or `agent`. It is a CHECK, not a lookup key —
19
+ // nothing resolves by kind, and a mismatch against the stored
20
+ // row is an error rather than a silent reinterpretation. That
21
+ // is the whole value of carrying it: a path in a Makefile that
22
+ // says `udf/` cannot quietly start meaning an agent.
23
+ // <namespace> required in the canonical form; a bare <name> with no slashes
24
+ // stays valid and falls back to --namespace / the active login.
25
+ // THE NAMESPACE IS IN THE PATH, deliberately:
26
+ // `udf/chengdu/x` and `udf/tokyo/x` are two different UDFs and
27
+ // both are legal. That is exactly the existing database
28
+ // constraint @@unique([namespaceId, name, deletedAt]) rendered
29
+ // as a string, so collisions are impossible by construction and
30
+ // no global name broker is needed. "Everyone can use the path"
31
+ // means anyone with read permission on that namespace resolves
32
+ // that exact string to that exact thing.
33
+ // <name> already `"<module>.<qualname>"` and already unique per
34
+ // namespace (schema.prisma:957). It decomposes for free into
35
+ // the module ("repo-ish") half and the function half, so no new
36
+ // field and no new parsing convention is invented on top of one
37
+ // that already exists.
38
+ // @<version> `latest` (the default when absent), a >= 8-char lowercase hex
39
+ // prefix, or the full 64-hex sha256 of the source.
40
+ //
41
+ // WHY `@`. It is the separator npm, Docker, Go modules and PEP 508 already
42
+ // trained everyone on, and it cannot occur in a lowercase hex digest, in
43
+ // `latest`, or in a Python dotted name — so a single lastIndexOf('@') parses it
44
+ // unambiguously.
45
+ //
46
+ // WHAT THIS DOES AND DOES NOT FIX. Resolution is entirely client-side and
47
+ // needs no server change and no migration. It closes the "full 64-hex is the
48
+ // only addressable form" gap FOR CALLERS. It does NOT close these, and nothing
49
+ // here should be read as claiming otherwise:
50
+ //
51
+ // * import-by-name is still TWO round trips (three for a short prefix),
52
+ // because `latestVersion` is a plain column and there is no `?version=latest`
53
+ // on the server;
54
+ // * `RunConfig` is not versioned at all;
55
+ // * an agent's `markdown` and `channel` live on the MUTABLE head and have no
56
+ // history, so pinning an agent pins its code and not its instructions. That
57
+ // one is at least made visible — AGENT_PIN_WARNING below is emitted on every
58
+ // agent resolution.
59
+ import { HttpError, requestJson } from "../client.js";
60
+ /** The two kinds that can appear as a path prefix. `session` has no prefix. */
61
+ const PATH_KINDS = ["udf", "agent"];
62
+ const HEX_VERSION = /^[0-9a-f]{8,64}$/;
63
+ const FULL_VERSION = /^[0-9a-f]{64}$/;
64
+ export class RunnablePathError extends Error {
65
+ constructor(message) {
66
+ super(message);
67
+ this.name = "RunnablePathError";
68
+ }
69
+ }
70
+ const VERSION_SHAPE = "expected 'latest', a lowercase hex prefix of at least 8 characters, or the " +
71
+ "full 64-character sha256";
72
+ /** Validate a version token from either the `@suffix` or the `--version` flag. */
73
+ export function assertVersionShape(value, where) {
74
+ if (value === "latest")
75
+ return;
76
+ if (!HEX_VERSION.test(value)) {
77
+ throw new RunnablePathError(`bad version '${value}' in ${where} — ${VERSION_SHAPE}`);
78
+ }
79
+ }
80
+ /**
81
+ * Parse an address. Throws RunnablePathError with a message meant to be shown
82
+ * verbatim; every caller in this CLI catches it and turns it into rc 1.
83
+ */
84
+ export function parseRunnablePath(raw) {
85
+ const text = raw.trim();
86
+ if (!text) {
87
+ throw new RunnablePathError("empty runnable path");
88
+ }
89
+ // One lastIndexOf('@'): '@' cannot occur in a hex digest, in `latest`, or in
90
+ // a Python dotted name, so there is exactly one place it can be.
91
+ let body = text;
92
+ let version = null;
93
+ const at = text.lastIndexOf("@");
94
+ if (at >= 0) {
95
+ body = text.slice(0, at);
96
+ const v = text.slice(at + 1);
97
+ if (!v) {
98
+ throw new RunnablePathError(`empty version in '${raw}' — write '@latest' or '@<sha256 prefix>', or drop the '@'`);
99
+ }
100
+ assertVersionShape(v, `'${raw}'`);
101
+ version = v;
102
+ }
103
+ const parts = body.split("/");
104
+ if (parts.length === 1) {
105
+ const name = parts[0].trim();
106
+ if (!name) {
107
+ throw new RunnablePathError(`empty runnable name in '${raw}'`);
108
+ }
109
+ return { kind: null, namespace: null, name, version };
110
+ }
111
+ // Two segments is the shape people reach for by analogy with `ns/name`, and
112
+ // it is rejected on purpose: it is ambiguous with `kind/name`, and guessing
113
+ // which one was meant would make the kind check worthless.
114
+ if (parts.length !== 3) {
115
+ throw new RunnablePathError(`bad runnable path '${raw}' — expected '<kind>/<namespace>/<name>[@<version>]' ` +
116
+ `(e.g. udf/chengdu/examples.cpu.add@latest) or a bare name`);
117
+ }
118
+ const [kindSeg, nsSeg, nameSeg] = parts;
119
+ if (!PATH_KINDS.includes(kindSeg)) {
120
+ throw new RunnablePathError(`unknown kind '${kindSeg}' in '${raw}' — the first segment must be ` +
121
+ `${PATH_KINDS.map((k) => `'${k}'`).join(" or ")}`);
122
+ }
123
+ const namespace = nsSeg.trim();
124
+ const name = nameSeg.trim();
125
+ if (!namespace) {
126
+ throw new RunnablePathError(`empty namespace in '${raw}'`);
127
+ }
128
+ if (!name) {
129
+ throw new RunnablePathError(`empty runnable name in '${raw}'`);
130
+ }
131
+ return { kind: kindSeg, namespace, name, version };
132
+ }
133
+ /**
134
+ * The namespace segment, if the argument is a canonical path — for callers
135
+ * that must resolve their connection context BEFORE they can resolve anything
136
+ * else. Never throws: a malformed path returns null here and produces its real
137
+ * error later, from parseRunnablePath, where the message can be specific.
138
+ *
139
+ * This is what makes an address self-contained. `dreamlake runnable show
140
+ * udf/chengdu/examples.cpu.add` has to work whether or not the active login
141
+ * resolves to a namespace, because the string already says which one.
142
+ */
143
+ export function namespaceFromPath(raw) {
144
+ try {
145
+ return parseRunnablePath(raw).namespace;
146
+ }
147
+ catch {
148
+ return null;
149
+ }
150
+ }
151
+ /**
152
+ * Render the canonical address. A `session` runnable has no path prefix in
153
+ * this scheme, so it renders as the bare name — printing `session/…` would
154
+ * produce a string that parseRunnablePath then rejects.
155
+ */
156
+ export function formatRunnablePath(kind, namespace, name, version) {
157
+ const head = PATH_KINDS.includes(kind)
158
+ ? `${kind}/${namespace}/${name}`
159
+ : name;
160
+ return version ? `${head}@${version}` : head;
161
+ }
162
+ export const AGENT_PIN_WARNING = "this version pins the SOURCE ONLY — an agent's markdown and channel live on " +
163
+ "the mutable head and have no history, so pinning an agent does not pin its " +
164
+ "instructions";
165
+ /** A runnable name is dotted and user-supplied; it goes in a path segment. */
166
+ function seg(value) {
167
+ return encodeURIComponent(value);
168
+ }
169
+ /**
170
+ * Resolve an address against the routes that exist today. No server change, no
171
+ * schema change, no migration.
172
+ *
173
+ * 1. assert kind ∈ { udf, agent } (parse, no request)
174
+ * 2. GET /namespaces/<ns>/runnables/<name> (request 1)
175
+ * findRunnable() tries a 24-hex ObjectId first, then the name
176
+ * (declarations.ts:332-338), so an id works in the <name> slot too
177
+ * 3. assert row.kind === kind — verified, never guessed
178
+ * 4. latest → row.latestVersion
179
+ * 64 hex → as given
180
+ * 8..63 → GET …/versions, filter by prefix, exactly one match (request 2)
181
+ * 5. the caller GETs …/versions/<full 64 hex> — the only route with `source`
182
+ */
183
+ export async function resolveRunnablePath(raw, opts) {
184
+ let parsed;
185
+ try {
186
+ parsed = parseRunnablePath(raw);
187
+ }
188
+ catch (err) {
189
+ return { ok: false, code: "bad-path", message: err.message };
190
+ }
191
+ // The `@suffix` wins over `--version`: it is the more specific of the two and
192
+ // the one that survives being copy-pasted as a single token.
193
+ let wanted = parsed.version;
194
+ if (!wanted && opts.version) {
195
+ const flagValue = opts.version.trim();
196
+ try {
197
+ assertVersionShape(flagValue, "--version");
198
+ }
199
+ catch (err) {
200
+ return { ok: false, code: "bad-path", message: err.message };
201
+ }
202
+ wanted = flagValue;
203
+ }
204
+ const ns = parsed.namespace ?? opts.namespace;
205
+ let head;
206
+ try {
207
+ head = await requestJson(opts.remote, `/namespaces/${ns}/runnables/${seg(parsed.name)}`, { token: opts.token });
208
+ }
209
+ catch (err) {
210
+ if (err instanceof HttpError && err.status === 404) {
211
+ return {
212
+ ok: false,
213
+ code: "not-found",
214
+ message: `runnable '${parsed.name}' not found in namespace '${ns}'`,
215
+ };
216
+ }
217
+ return { ok: false, code: "request-failed", message: err.message };
218
+ }
219
+ if (parsed.kind && head.kind !== parsed.kind) {
220
+ return {
221
+ ok: false,
222
+ code: "kind-mismatch",
223
+ message: `'${raw}' says kind '${parsed.kind}', but '${head.name}' in namespace ` +
224
+ `'${ns}' is a '${head.kind}' — the prefix is verified, never guessed`,
225
+ };
226
+ }
227
+ const needVersion = opts.resolveVersion ?? wanted != null;
228
+ let version = null;
229
+ if (needVersion) {
230
+ const want = wanted ?? "latest";
231
+ if (want === "latest") {
232
+ version = head.latestVersion || null;
233
+ if (!version) {
234
+ return {
235
+ ok: false,
236
+ code: "no-versions",
237
+ message: `runnable '${head.name}' has no registered versions`,
238
+ };
239
+ }
240
+ }
241
+ else if (FULL_VERSION.test(want)) {
242
+ version = want;
243
+ }
244
+ else {
245
+ // A short prefix costs one extra request, because there is no prefix
246
+ // lookup on the server — the whole list comes back and is filtered here.
247
+ let rows;
248
+ try {
249
+ const res = await requestJson(opts.remote, `/namespaces/${ns}/runnables/${seg(parsed.name)}/versions`, { token: opts.token, query: { pageSize: 200 } });
250
+ rows = res?.versions ?? [];
251
+ }
252
+ catch (err) {
253
+ return { ok: false, code: "request-failed", message: err.message };
254
+ }
255
+ const matches = rows.filter((v) => v.version.startsWith(want));
256
+ if (matches.length === 0) {
257
+ return {
258
+ ok: false,
259
+ code: "no-prefix-match",
260
+ message: `no version of '${head.name}' starts with '${want}'`,
261
+ };
262
+ }
263
+ if (matches.length > 1) {
264
+ return {
265
+ ok: false,
266
+ code: "ambiguous-prefix",
267
+ message: `ambiguous — ${matches.length} versions start with '${want}'; ` +
268
+ `use more characters or the full 64-character sha256`,
269
+ };
270
+ }
271
+ version = matches[0].version;
272
+ }
273
+ }
274
+ const warnings = [];
275
+ if (version && head.kind === "agent")
276
+ warnings.push(AGENT_PIN_WARNING);
277
+ return {
278
+ ok: true,
279
+ value: {
280
+ namespace: ns,
281
+ name: parsed.name,
282
+ head,
283
+ version,
284
+ warnings,
285
+ address: formatRunnablePath(head.kind, ns, head.name, version),
286
+ },
287
+ };
288
+ }
@@ -0,0 +1,91 @@
1
+ import type { Command } from "commander";
2
+ export declare const RUNTIME_ARGV: string[];
3
+ export declare const sha256: (value: string | Buffer) => string;
4
+ export declare function canonical(value: any): string;
5
+ export declare function pinnedReference(ref: string): {
6
+ namespace: string;
7
+ name: string;
8
+ version: string;
9
+ };
10
+ export interface RunOptions {
11
+ target: string;
12
+ enrollmentId: string;
13
+ requestId: string;
14
+ timeoutSeconds?: number;
15
+ inputs: any;
16
+ }
17
+ export interface Binding {
18
+ protocol: "dreamlake-registered-udf-v1";
19
+ namespace: string;
20
+ namespaceId: string;
21
+ runnableId: string;
22
+ name: string;
23
+ versionId: string;
24
+ version: string;
25
+ codeDigest: string;
26
+ repo: {
27
+ id: string;
28
+ name: string;
29
+ remote: string;
30
+ };
31
+ registrySnapshotId: null;
32
+ executionSnapshotId: null;
33
+ sourceFile: string;
34
+ entrypoint: string;
35
+ delivery: {
36
+ kind: "tracked-run-inline-source";
37
+ path: string;
38
+ sha256: string;
39
+ };
40
+ runtime: {
41
+ kind: "uv-run";
42
+ argv: string[];
43
+ runnerDigest: string;
44
+ timeoutSeconds: number;
45
+ };
46
+ inputsDigest: string;
47
+ }
48
+ export declare function buildRegisteredRun(ref: string, head: any, version: any, repo: any, options: RunOptions): {
49
+ binding: Binding;
50
+ payload: {
51
+ requestId: string;
52
+ target: string;
53
+ enrollmentId: string;
54
+ execution: {
55
+ kind: string;
56
+ argv: string[];
57
+ };
58
+ source: {
59
+ files: {
60
+ path: any;
61
+ contentBase64: string;
62
+ sha256: string;
63
+ mode: number;
64
+ }[];
65
+ };
66
+ timeoutSeconds: number;
67
+ };
68
+ };
69
+ export declare function submitRegisteredRun(ref: string, options: RunOptions): Promise<any>;
70
+ export declare function readRegisteredReceipt(ref: string, request?: (path: string) => Promise<any>): Promise<{
71
+ binding: Binding;
72
+ execution: {
73
+ kind: string;
74
+ id: any;
75
+ namespace: string;
76
+ };
77
+ requestId: any;
78
+ target: any;
79
+ worker: any;
80
+ status: any;
81
+ exitCode: any;
82
+ createdAt: any;
83
+ completedAt: any;
84
+ resolvedRuntime: any;
85
+ verifiedCodeDigest: any;
86
+ result: any;
87
+ error: any;
88
+ receiptRef: string;
89
+ logsRef: string;
90
+ }>;
91
+ export declare function registerRunnableRun(runnable: Command): void;