@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,548 @@
1
+ import { noteFilesApi, noteFileOperationId, validateNoteFileKey } from '../../api/note-files.js';
2
+ import { noteTransport } from './api-transport.js';
3
+ /**
4
+ * `dreamlake notes files …` — list, upload, download, move, copy, trash.
5
+ *
6
+ * Bytes are never decoded on this path. Upload reads the local file as a
7
+ * Buffer and sends it raw; download writes the response body straight out.
8
+ * Only `--text` touches a string, and the server refuses that for anything not
9
+ * text-typed rather than round-tripping it through UTF-8.
10
+ *
11
+ * Downloads refuse to replace a local file unless asked. Everything else here
12
+ * goes to a recoverable trash; something overwritten on the caller's disk does
13
+ * not come back.
14
+ */
15
+ import { createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, } from "node:fs";
16
+ import { pipeline } from "node:stream/promises";
17
+ import { Readable } from "node:stream";
18
+ import path from "node:path";
19
+ import { ctx, report, resolveNote, seg } from "./index.js";
20
+ import { emitJson, fail } from "../helpers.js";
21
+ import { requestJson, requestRaw } from "../client.js";
22
+ /** Exit code for "the file or path was wrong", distinct from a transport failure. */
23
+ export const EXIT_NO_FILE = 6;
24
+ /** Exit code for a refused overwrite — a script can branch on it and retry. */
25
+ export const EXIT_EXISTS = 7;
26
+ function filesBase(c, id) {
27
+ return `/namespaces/${seg(c.ns)}/notes/${seg(id)}/files`;
28
+ }
29
+ /** Resolve the note every file command needs. */
30
+ async function target(opts) {
31
+ if (!opts.note) {
32
+ fail("say which note: --note <id-or-slug>");
33
+ return null;
34
+ }
35
+ const c = await ctx(opts);
36
+ if (!c)
37
+ return null;
38
+ const id = await resolveNote(c, opts.note);
39
+ if (!id)
40
+ return null;
41
+ return { c, id };
42
+ }
43
+ /**
44
+ * Map a server refusal onto an exit code a script can branch on.
45
+ *
46
+ * The server's own sentence is preferred over the transport's. HttpError's
47
+ * `message` is about the status; the reason lives in the JSON body, and it is
48
+ * the reason that tells a person what to do — "a.zip is application/zip, which
49
+ * has no rendered form" against "Request failed with status 400".
50
+ */
51
+ function reportFile(err, recovery) {
52
+ if (recovery) {
53
+ let operationId = recovery.operationId;
54
+ try {
55
+ operationId ??= operationIdOf(JSON.parse(err.body ?? "").operationId);
56
+ }
57
+ catch { }
58
+ if (operationId)
59
+ process.stderr.write(`operation ${operationId} — inspect with notes files status ${operationId} --note ${recovery.note}${recovery.namespace ? ` --namespace ${JSON.stringify(recovery.namespace)}` : ""}\n`);
60
+ process.stderr.write("Do not resend attachment bytes after an uncertain result; inspect the original operation first.\n");
61
+ }
62
+ const status = err?.status;
63
+ const body = err?.body;
64
+ let detail = err?.message ?? String(err);
65
+ if (body) {
66
+ try {
67
+ const parsed = JSON.parse(body);
68
+ if (parsed.message)
69
+ detail = parsed.message;
70
+ }
71
+ catch {
72
+ // Not JSON; the transport message is all there is.
73
+ }
74
+ }
75
+ if (status === 503 && recovery) {
76
+ // Preserve the existing busy exit code without the Notes body helper
77
+ // falsely diagnosing RTC or suggesting that attachment bytes be resent.
78
+ fail(detail);
79
+ return 4;
80
+ }
81
+ if (status === 409) {
82
+ fail(detail);
83
+ return EXIT_EXISTS;
84
+ }
85
+ if (status === 404 || status === 400 || status === 403) {
86
+ fail(detail);
87
+ return EXIT_NO_FILE;
88
+ }
89
+ return report(err);
90
+ }
91
+ function operationIdOf(value) {
92
+ return noteFileOperationId(value);
93
+ }
94
+ function keyValid(key) {
95
+ try {
96
+ validateNoteFileKey(key);
97
+ return true;
98
+ }
99
+ catch (error) {
100
+ fail(error.message);
101
+ return false;
102
+ }
103
+ }
104
+ function requireFileResult(row) {
105
+ if (!row || typeof row !== "object" || typeof row.id !== "string" || typeof row.path !== "string") {
106
+ throw new Error("Attachment response is unreadable; retain the original operation before recovery");
107
+ }
108
+ }
109
+ function showOperation(operationId) {
110
+ if (operationId)
111
+ process.stderr.write(`operation ${operationId}\n`);
112
+ }
113
+ /** Human-readable size, so a listing is scannable. */
114
+ function human(bytes) {
115
+ if (bytes < 1024)
116
+ return `${bytes}B`;
117
+ const units = ["K", "M", "G"];
118
+ let n = bytes / 1024;
119
+ let i = 0;
120
+ while (n >= 1024 && i < units.length - 1) {
121
+ n /= 1024;
122
+ i++;
123
+ }
124
+ return `${n < 10 ? n.toFixed(1) : Math.round(n)}${units[i]}`;
125
+ }
126
+ // ── list ─────────────────────────────────────────────────────────────────────
127
+ export async function runFilesList(glob, opts) {
128
+ const t = await target(opts);
129
+ if (!t)
130
+ return 1;
131
+ try {
132
+ const qs = new URLSearchParams();
133
+ if (glob)
134
+ qs.set("glob", glob);
135
+ if (opts.trashed)
136
+ qs.set("trashed", "true");
137
+ if (opts.contentType)
138
+ qs.set("contentType", opts.contentType);
139
+ if (opts.limit)
140
+ qs.set("limit", opts.limit);
141
+ if (opts.offset)
142
+ qs.set("offset", opts.offset);
143
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}${qs.toString() ? `?${qs}` : ""}`, { token: t.c.token });
144
+ if (opts.json)
145
+ return emitJson(res), 0;
146
+ if (!res.files.length) {
147
+ process.stderr.write(opts.trashed ? "the trash is empty\n" : "no files\n");
148
+ return 0;
149
+ }
150
+ // Said when a page is not the whole set, on stderr so a piped listing is
151
+ // still only files. A caller that took a truncated list for everything
152
+ // would conclude a file is not there.
153
+ const shown = Number(opts.offset ?? 0) + res.files.length;
154
+ if (shown < res.total) {
155
+ process.stderr.write(`showing ${res.files.length} of ${res.total} — pass --offset ${shown} for the rest\n`);
156
+ }
157
+ const width = Math.max(...res.files.map((f) => f.path.length));
158
+ for (const f of res.files) {
159
+ // The id is printed because every other command takes one, and the
160
+ // preview kind because it is what decides whether a file can be shown
161
+ // at all — neither is derivable from the path.
162
+ process.stdout.write(`${f.path.padEnd(width)} ${human(f.sizeBytes).padStart(6)} ${f.contentType.padEnd(24)}` +
163
+ ` ${f.previewKind ?? "-"} ${f.id}\n`);
164
+ }
165
+ return 0;
166
+ }
167
+ catch (e) {
168
+ return reportFile(e);
169
+ }
170
+ }
171
+ // ── upload ───────────────────────────────────────────────────────────────────
172
+ export async function runFilesUpload(localPath, opts) {
173
+ const t = await target(opts);
174
+ if (!t)
175
+ return 1;
176
+ if (!existsSync(localPath)) {
177
+ fail(`no such file: ${localPath}`);
178
+ return EXIT_NO_FILE;
179
+ }
180
+ try {
181
+ // Streamed from disk, not read into memory. A large attachment should
182
+ // cost a buffer rather than its own size in resident memory, and a file
183
+ // bigger than the heap cannot be read at all.
184
+ //
185
+ // Never through a string on the way: that would corrupt every upload that
186
+ // is not valid UTF-8, silently.
187
+ // The two runtimes disagree about how a streamed body is sent. Node's
188
+ // fetch needs an explicit Content-Length (without one it falls back to
189
+ // chunked, which some proxies reject on a PUT). Bun's fetch *hangs* on a
190
+ // stream paired with one, over HTTP/2 — the request is never sent and the
191
+ // upload dies on the timeout. 0.23.0's fix was Bun.file(), a streamed
192
+ // body Bun does handle, which leaves an explicit Content-Type alone and
193
+ // still does not read the file into memory.
194
+ //
195
+ // This shipped broken in 0.23.0 because the published CLI is a compiled
196
+ // Bun binary while the npm package and the test suite run on Node, and
197
+ // api.dreamlake.ai is the HTTP/2 endpoint no local server imitates — so
198
+ // every check was green and every real upload timed out.
199
+ //
200
+ // The BunFile itself must not be the body. Observed on Bun 1.3.14, Linux,
201
+ // compiled standalone binary: a PUT carrying one crashes the runtime
202
+ // (SIGSEGV, varying address) once the response is in, when a GET on the
203
+ // same host preceded it — the shape the upload path takes, since resolving
204
+ // the note comes first. Whether every upload or another runtime, platform
205
+ // or build mode hits it was not established. `.stream()` reads the same
206
+ // file lazily, without loading it into memory, and did not crash.
207
+ // This code sets no Content-Length under Bun, unchanged from 0.24.5.
208
+ // Whether the HTTP/2 hang above can recur is a separate protocol
209
+ // question, not validated by this change.
210
+ const bun = globalThis.Bun;
211
+ const data = bun ? bun.file(localPath).stream() : createReadStream(localPath);
212
+ const remote = opts.path ?? path.basename(localPath);
213
+ const qs = new URLSearchParams({ path: remote });
214
+ if (opts.contentType)
215
+ qs.set("contentType", opts.contentType);
216
+ if (opts.overwrite)
217
+ qs.set("overwrite", "true");
218
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/content?${qs}`, {
219
+ method: "PUT",
220
+ token: t.c.token,
221
+ body: data,
222
+ headers: {
223
+ "Content-Type": opts.contentType ?? "application/octet-stream",
224
+ ...(bun ? {} : { "Content-Length": String(statSync(localPath).size) }),
225
+ },
226
+ });
227
+ if (opts.json)
228
+ return emitJson(res), 0;
229
+ process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)}, ${res.contentType})\n id ${res.id}\n`);
230
+ return 0;
231
+ }
232
+ catch (e) {
233
+ return reportFile(e);
234
+ }
235
+ }
236
+ // ── download ─────────────────────────────────────────────────────────────────
237
+ export async function runFilesDownload(ref, opts) {
238
+ const t = await target(opts);
239
+ if (!t)
240
+ return 1;
241
+ try {
242
+ const row = await resolveFile(t.c, t.id, ref);
243
+ if (!row)
244
+ return EXIT_NO_FILE;
245
+ // Destination decided BEFORE the transfer: refusing an overwrite after
246
+ // downloading the whole file wastes the transfer, and refusing it after
247
+ // opening the file for writing has already truncated it.
248
+ let dest = opts.output;
249
+ if (dest && dest !== "-") {
250
+ if (existsSync(dest) && statSync(dest).isDirectory()) {
251
+ dest = path.join(dest, row.path.split("/").pop());
252
+ }
253
+ if (existsSync(dest) && !opts.overwrite) {
254
+ // The one thing here DreamLake cannot undo.
255
+ fail(`${dest} already exists; pass --overwrite to replace it`);
256
+ return EXIT_EXISTS;
257
+ }
258
+ }
259
+ const res = await requestRaw(`${t.c.remote}${filesBase(t.c, t.id)}/${seg(row.id)}/content?redirect=false`, { token: t.c.token });
260
+ const body = res.body ? Readable.fromWeb(res.body) : Readable.from([]);
261
+ if (!dest || dest === "-") {
262
+ // To stdout, so it can be piped. Binary is fine; decoding it is not.
263
+ //
264
+ // `{end: false}` matters: pipeline closes its destination when the
265
+ // source finishes, and closing process.stdout silences everything the
266
+ // process prints afterwards — including, in a test runner sharing the
267
+ // process, every other test's output.
268
+ await pipeline(body, process.stdout, { end: false });
269
+ return 0;
270
+ }
271
+ mkdirSync(path.dirname(path.resolve(dest)), { recursive: true });
272
+ // Written beside the target and moved into place, so an interrupted
273
+ // download leaves the destination untouched rather than half a file that
274
+ // looks complete.
275
+ const partial = `${dest}.part`;
276
+ try {
277
+ await pipeline(body, createWriteStream(partial));
278
+ renameSync(partial, dest);
279
+ }
280
+ catch (e) {
281
+ rmSync(partial, { force: true });
282
+ throw e;
283
+ }
284
+ process.stderr.write(`✓ wrote ${dest} (${human(statSync(dest).size)})\n`);
285
+ return 0;
286
+ }
287
+ catch (e) {
288
+ return reportFile(e);
289
+ }
290
+ }
291
+ // ── read as text ─────────────────────────────────────────────────────────────
292
+ export async function runFilesCat(ref, opts) {
293
+ const t = await target(opts);
294
+ if (!t)
295
+ return 1;
296
+ try {
297
+ const row = await resolveFile(t.c, t.id, ref);
298
+ if (!row)
299
+ return EXIT_NO_FILE;
300
+ if (!row.text) {
301
+ // Refused here rather than at the server, so the reason names the local
302
+ // alternative instead of an HTTP status.
303
+ fail(`${row.path} is ${row.contentType}; printing it as text would corrupt it — ` +
304
+ "use 'notes files download' instead");
305
+ return EXIT_NO_FILE;
306
+ }
307
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/text`, { token: t.c.token });
308
+ if (opts.json)
309
+ return emitJson(res), 0;
310
+ process.stdout.write(res.text);
311
+ return 0;
312
+ }
313
+ catch (e) {
314
+ return reportFile(e);
315
+ }
316
+ }
317
+ // ── write text ───────────────────────────────────────────────────────────────
318
+ export async function runFilesWrite(remotePath, opts) {
319
+ if (!keyValid(opts.idempotencyKey))
320
+ return 1;
321
+ const t = await target(opts);
322
+ if (!t)
323
+ return 1;
324
+ const text = opts.text !== undefined
325
+ ? opts.text
326
+ : opts.file
327
+ ? readFileSync(opts.file, "utf-8")
328
+ : undefined;
329
+ if (text === undefined) {
330
+ fail("say what to write: --text or --file");
331
+ return 1;
332
+ }
333
+ let operationId;
334
+ try {
335
+ const res = await requestJson(t.c.remote, filesBase(t.c, t.id), {
336
+ method: "POST",
337
+ token: t.c.token,
338
+ json: {
339
+ path: remotePath,
340
+ text,
341
+ overwrite: Boolean(opts.overwrite),
342
+ ...(opts.contentType ? { contentType: opts.contentType } : {}),
343
+ },
344
+ headers: { ...(opts.ifMatch ? { "If-Match": opts.ifMatch } : {}),
345
+ ...(opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {}) },
346
+ redirect: "manual",
347
+ onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
348
+ });
349
+ requireFileResult(res);
350
+ if (opts.json)
351
+ return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
352
+ showOperation(operationId);
353
+ process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)})\n etag ${res.etag}\n`);
354
+ return 0;
355
+ }
356
+ catch (e) {
357
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
358
+ }
359
+ }
360
+ // ── move / copy ──────────────────────────────────────────────────────────────
361
+ export async function runFilesMove(ref, to, opts) {
362
+ const t = await target(opts);
363
+ if (!t)
364
+ return 1;
365
+ try {
366
+ const row = await resolveFile(t.c, t.id, ref);
367
+ if (!row)
368
+ return EXIT_NO_FILE;
369
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}`, {
370
+ method: "PATCH",
371
+ token: t.c.token,
372
+ json: { path: to, overwrite: Boolean(opts.overwrite) },
373
+ headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
374
+ });
375
+ if (opts.json)
376
+ return emitJson(res), 0;
377
+ process.stdout.write(`✓ ${row.path} -> ${res.path}\n`);
378
+ return 0;
379
+ }
380
+ catch (e) {
381
+ return reportFile(e);
382
+ }
383
+ }
384
+ export async function runFilesCopy(ref, to, opts) {
385
+ if (!keyValid(opts.idempotencyKey))
386
+ return 1;
387
+ const t = await target(opts);
388
+ if (!t)
389
+ return 1;
390
+ let operationId;
391
+ try {
392
+ const row = await resolveFile(t.c, t.id, ref);
393
+ if (!row)
394
+ return EXIT_NO_FILE;
395
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/copy`, {
396
+ method: "POST",
397
+ token: t.c.token,
398
+ json: { path: to, overwrite: Boolean(opts.overwrite) },
399
+ headers: opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {},
400
+ redirect: "manual",
401
+ onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
402
+ });
403
+ requireFileResult(res);
404
+ if (opts.json)
405
+ return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
406
+ showOperation(operationId);
407
+ process.stdout.write(`✓ copied to ${res.path}\n id ${res.id}\n`);
408
+ return 0;
409
+ }
410
+ catch (e) {
411
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
412
+ }
413
+ }
414
+ // ── publication recovery ────────────────────────────────────────────────────
415
+ export async function runFilesOperation(action, operationId, opts) {
416
+ if (!operationIdOf(operationId)) {
417
+ fail("operation must be a 24-character hexadecimal ID");
418
+ return EXIT_NO_FILE;
419
+ }
420
+ const t = await target(opts);
421
+ if (!t)
422
+ return 1;
423
+ try {
424
+ const suffix = action === "status" ? "" : action === "cancel" ? "/abort" : "/reconcile";
425
+ const result = await requestJson(t.c.remote, `${filesBase(t.c, t.id).slice(0, -6)}/file-publications/${seg(operationId)}${suffix}`, { method: action === "status" ? "GET" : "POST", token: t.c.token, redirect: "manual" });
426
+ if (!result || !operationIdOf(result.operationId) || result.operationId.toLowerCase() !== operationId.toLowerCase() ||
427
+ !["admitted", "write-started", "published", "aborted-before-write"].includes(result.state) ||
428
+ typeof result.historicalResult !== "boolean")
429
+ throw new Error("Attachment operation response is unreadable");
430
+ if (opts.json)
431
+ return emitJson(result), 0;
432
+ process.stdout.write(`${result.operationId} ${result.state}${result.historicalResult ? " (historical receipt)" : ""}\n`);
433
+ return 0;
434
+ }
435
+ catch (e) {
436
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
437
+ }
438
+ }
439
+ // ── trash / restore ──────────────────────────────────────────────────────────
440
+ export async function runFilesRm(ref, opts) {
441
+ const t = await target(opts);
442
+ if (!t)
443
+ return 1;
444
+ try {
445
+ const row = await resolveFile(t.c, t.id, ref, { includeTrashed: true });
446
+ if (!row)
447
+ return EXIT_NO_FILE;
448
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}?purge=${opts.purge ? "true" : "false"}`, {
449
+ method: "DELETE",
450
+ token: t.c.token,
451
+ headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
452
+ });
453
+ if (opts.json)
454
+ return emitJson(res), 0;
455
+ process.stdout.write(res.purged
456
+ ? `✓ purged ${row.path} — the bytes are gone\n`
457
+ : `✓ trashed ${row.path} — restore with 'notes files restore ${row.id}'\n`);
458
+ return 0;
459
+ }
460
+ catch (e) {
461
+ return reportFile(e);
462
+ }
463
+ }
464
+ export async function runFilesRestore(ref, opts) {
465
+ const t = await target(opts);
466
+ if (!t)
467
+ return 1;
468
+ try {
469
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(ref)}/restore`, {
470
+ method: "POST",
471
+ token: t.c.token,
472
+ json: opts.path ? { path: opts.path } : {},
473
+ });
474
+ if (opts.json)
475
+ return emitJson(res), 0;
476
+ process.stdout.write(`✓ restored ${res.path}\n`);
477
+ return 0;
478
+ }
479
+ catch (e) {
480
+ return reportFile(e);
481
+ }
482
+ }
483
+ // ── shared ───────────────────────────────────────────────────────────────────
484
+ /**
485
+ * Accept an id OR a path, because both are things a person has in hand.
486
+ *
487
+ * A path is looked up in the listing; an id is used as it is. An ambiguous
488
+ * input cannot happen — an id is an ObjectId and a path is not — so this never
489
+ * has to guess.
490
+ */
491
+ export async function resolveFile(c, noteId, ref, opts = {}) {
492
+ try {
493
+ return await noteFilesApi(noteTransport(c), `/namespaces/${seg(c.ns)}/notes/${seg(noteId)}`).resolve(ref, opts.includeTrashed);
494
+ }
495
+ catch (error) {
496
+ if (error.status !== 404)
497
+ throw error;
498
+ fail(/^[a-f0-9]{24}$/i.test(ref) ? `no file with id ${ref}` : `no file at '${ref}' — 'notes files list --note …' shows what is there`);
499
+ return null;
500
+ }
501
+ }
502
+ /**
503
+ * `dreamlake notes files preview <file> --note N [--share] [--open]`
504
+ *
505
+ * Prints a link that renders the file. The default needs the reader signed in
506
+ * and grants nothing by itself; `--share` returns one that works without
507
+ * signing in and lasts until `--revoke` withdraws it.
508
+ *
509
+ * The URL goes to stdout alone so it can be piped or copied; everything else
510
+ * is on stderr.
511
+ */
512
+ export async function runFilesPreview(ref, opts) {
513
+ const t = await target(opts);
514
+ if (!t)
515
+ return 1;
516
+ try {
517
+ const row = await resolveFile(t.c, t.id, ref);
518
+ if (!row)
519
+ return EXIT_NO_FILE;
520
+ const base = `${filesBase(t.c, t.id)}/${seg(row.id)}/preview`;
521
+ if (opts.revoke) {
522
+ await requestJson(t.c.remote, base, {
523
+ method: "DELETE",
524
+ token: t.c.token,
525
+ });
526
+ process.stderr.write(`✓ withdrew the shared link for ${row.path}\n`);
527
+ return 0;
528
+ }
529
+ const res = await requestJson(t.c.remote, `${base}${opts.share ? "?share=true" : ""}`, { token: t.c.token });
530
+ if (opts.json)
531
+ return emitJson(res), 0;
532
+ process.stdout.write(`${res.url}\n`);
533
+ // Which kind of link this is decides what the reader has to do, so it is
534
+ // said rather than left to be discovered by sending the wrong one.
535
+ process.stderr.write(res.kind === "shared"
536
+ ? "shared link — opens without signing in, until you revoke it\n"
537
+ : "session link — whoever opens it must be signed in and able to read the note\n");
538
+ if (opts.open) {
539
+ const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
540
+ const { spawn } = await import("node:child_process");
541
+ spawn(cmd, [res.url], { stdio: "ignore", detached: true }).unref();
542
+ }
543
+ return 0;
544
+ }
545
+ catch (e) {
546
+ return reportFile(e);
547
+ }
548
+ }
@@ -0,0 +1,9 @@
1
+ export declare function validateHtmlSnapshot(html: string, note: string, scope?: {
2
+ section?: string;
3
+ toc?: boolean;
4
+ tag?: string;
5
+ }): {
6
+ revision: string;
7
+ };
8
+ /** A reading view only: comments are generated hints, never canonical note source. */
9
+ export declare function annotatedMarkdown(html: string): string;
@@ -0,0 +1,90 @@
1
+ /** Validate the server snapshot without reserializing its HTML or source mappings. */
2
+ import { createHash } from "node:crypto";
3
+ function attributeValue(value) {
4
+ if (/&(?!(?:amp|lt|gt|quot|apos|#\d+|#[xX][\da-fA-F]+);)/.test(value))
5
+ throw new Error("unsupported HTML snapshot attribute entity");
6
+ return value.replace(/&(?:amp|lt|gt|quot|apos|#\d+|#[xX][\da-fA-F]+);/g, entity => {
7
+ const names = { "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": '"', "&apos;": "'" };
8
+ if (names[entity.toLowerCase()] !== undefined)
9
+ return names[entity.toLowerCase()];
10
+ const hexadecimal = /^&#x/i.test(entity);
11
+ const point = Number.parseInt(entity.slice(hexadecimal ? 3 : 2, -1), hexadecimal ? 16 : 10);
12
+ if (!Number.isInteger(point) || point < 1 || point > 0x10ffff || (point >= 0xd800 && point <= 0xdfff) || (point >= 0x80 && point <= 0x9f))
13
+ throw new Error("invalid HTML snapshot attribute character reference");
14
+ return String.fromCodePoint(point);
15
+ });
16
+ }
17
+ export function validateHtmlSnapshot(html, note, scope = {}) {
18
+ const root = /^<!doctype html>\s*<html\b([^>]*)>/i.exec(html);
19
+ if (!root || !/<\/html>\s*$/i.test(html))
20
+ throw new Error("server did not return a complete Notes HTML snapshot");
21
+ const attributes = new Map();
22
+ const pattern = /\s+([a-zA-Z][a-zA-Z0-9-]*)="([^"]*)"/g;
23
+ let end = 0;
24
+ for (const match of root[1].matchAll(pattern)) {
25
+ if (match.index !== end)
26
+ throw new Error("invalid HTML snapshot root attributes");
27
+ const name = match[1].toLowerCase();
28
+ if (attributes.has(name))
29
+ throw new Error("duplicate HTML snapshot root attribute");
30
+ attributes.set(name, attributeValue(match[2]));
31
+ end = match.index + match[0].length;
32
+ }
33
+ if (root[1].slice(end).trim())
34
+ throw new Error("invalid HTML snapshot root attributes");
35
+ const revision = attributes.get("data-revision"), hash = attributes.get("data-hash"), source = attributes.get("data-source");
36
+ if (attributes.get("data-note") !== note || !revision || /[\r\n]/.test(revision)
37
+ || !/^sha256:[a-f0-9]{64}$/.test(hash ?? "") || source === undefined
38
+ || attributes.get("data-offset-unit") !== "unicode-code-point"
39
+ || !["markdown", "html"].includes(attributes.get("data-source-type") ?? "")) {
40
+ throw new Error("server did not return the Notes HTML metadata contract; upgrade the server");
41
+ }
42
+ const returnedScope = attributes.get("data-scope");
43
+ let sourceHash = hash;
44
+ if (scope.section || scope.toc || scope.tag) {
45
+ if (!returnedScope || (scope.tag ? returnedScope !== "tag" || attributes.get("data-target-id") !== scope.tag : scope.toc ? returnedScope !== "toc" : !/^s[1-9]\d*(?:\.[1-9]\d*)*$/.test(returnedScope)))
46
+ throw new Error("server did not return the requested HTML scope");
47
+ if (scope.section?.startsWith("s") && /^s[1-9]\d*(?:\.[1-9]\d*)*$/.test(scope.section) && returnedScope !== scope.section)
48
+ throw new Error("server returned a different section");
49
+ if (scope.section && scope.section !== returnedScope && scope.section !== attributes.get("data-section-id"))
50
+ throw new Error("server returned a different section");
51
+ const start = attributes.get("data-source-start"), end = attributes.get("data-source-end");
52
+ if (!/^\d+$/.test(start ?? "") || !/^\d+$/.test(end ?? "") || !Number.isSafeInteger(Number(end)) || Number(end) - Number(start) !== Array.from(source).length)
53
+ throw new Error("invalid scoped source range");
54
+ if (scope.toc && (source !== "" || start !== "0" || end !== "0"))
55
+ throw new Error("invalid TOC source");
56
+ sourceHash = attributes.get("data-source-hash");
57
+ }
58
+ else if (returnedScope && returnedScope !== "article")
59
+ throw new Error("server returned partial HTML for a full read");
60
+ if (`sha256:${createHash("sha256").update(source, "utf8").digest("hex")}` !== sourceHash)
61
+ throw new Error("HTML canonical source does not match its returned hash");
62
+ return { revision };
63
+ }
64
+ /** A reading view only: comments are generated hints, never canonical note source. */
65
+ export function annotatedMarkdown(html) {
66
+ const attrs = (raw) => new Map(Array.from(raw.matchAll(/\s+([a-zA-Z][a-zA-Z0-9-]*)="([^"]*)"/g), m => [m[1], attributeValue(m[2])]));
67
+ const root = attrs(/^<!doctype html>\s*<html\b([^>]*)>/i.exec(html)[1]);
68
+ if (root.get('data-source-type') !== 'markdown')
69
+ throw new Error('annotated Markdown requires a Markdown note; use --view html for HTML source');
70
+ const source = root.get('data-source');
71
+ const origin = Number(root.get('data-source-start') ?? 0);
72
+ const points = Array.from(source);
73
+ const toc = root.get('data-scope') === 'toc';
74
+ const blocks = root.get('data-content-format') === 'literal-markdown'
75
+ ? JSON.parse(root.get('data-addresses') ?? '[]').map(a => new Map(Object.entries(a)))
76
+ : Array.from(html.matchAll(/<(?:h[1-6]|p|ul|ol|li)\b([^>]*)>/g)).map(m => attrs(m[1])).filter(a => a.has('id') && a.has('data-char'));
77
+ const hint = (a) => `<!-- ${a.get('id')} chars=${a.get('data-char')} lines=${a.get('data-lines')}${a.has('data-section-id') ? ` section=${a.get('data-section-id')}` : ''} -->\n`;
78
+ const header = `<!-- notes-reading-view revision=${root.get('data-revision')} hash=${root.get('data-hash')} scope=${root.get('data-scope') ?? 'article'}; generated hints are not source -->\n`;
79
+ if (toc)
80
+ return header + blocks.map(a => hint(a) + (a.get('data-source') ?? '')).join('\n');
81
+ let cursor = 0, output = header;
82
+ for (const a of blocks.sort((a, b) => Number(a.get('data-char').split(':')[0]) - Number(b.get('data-char').split(':')[0]))) {
83
+ const at = Number(a.get('data-char').split(':')[0]) - origin;
84
+ if (at < cursor || at > points.length)
85
+ continue;
86
+ output += points.slice(cursor, at).join('') + hint(a);
87
+ cursor = at;
88
+ }
89
+ return output + points.slice(cursor).join('');
90
+ }