@dreamlake/dreamlake-cli 0.88.1 → 0.89.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 (535) 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 +53 -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 +2330 -0
  18. package/dist/api/index.js +114 -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 +75 -0
  38. package/dist/api/note-files.js +65 -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-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,73 @@
1
+ /**
2
+ * CSS selection over HTML source, with edits that land on the source.
3
+ *
4
+ * The Python SDK's `api/_html.py` with the same rules and the same refusals.
5
+ * The constraint that shapes both: an edit changes the characters it addresses
6
+ * and leaves every other character alone. Parsing into a tree and serialising
7
+ * it back would normalise attribute quoting and respell entities, so a
8
+ * one-word change would arrive as a diff touching the whole file.
9
+ *
10
+ * Nothing here is rebuilt. The scanner records where each tag, text run and
11
+ * entity began in the ORIGINAL string, and an edit is a splice into it.
12
+ *
13
+ * A hand-written scanner rather than a parser dependency: what is needed is
14
+ * source OFFSETS, and the HTML libraries that are pleasant to use are exactly
15
+ * the ones that throw those away. The subset understood is the subset a note
16
+ * contains — tags, attributes, comments, and the raw-text elements whose
17
+ * contents are not markup.
18
+ */
19
+ export declare class SelectorError extends Error {
20
+ }
21
+ export declare class NoElement extends Error {
22
+ }
23
+ export declare class AmbiguousElement extends Error {
24
+ }
25
+ export interface Element {
26
+ tag: string;
27
+ attrs: Record<string, string | null>;
28
+ /** Code point range of the whole element, open tag through close tag. */
29
+ outer: [number, number];
30
+ /** Code point range between the tags; equal endpoints for a void element. */
31
+ inner: [number, number];
32
+ /** Code point range of the open tag alone, for attribute edits. */
33
+ startTag: [number, number];
34
+ depth: number;
35
+ indexOfType: number;
36
+ parent: Element | null;
37
+ }
38
+ export interface TextPiece {
39
+ /** What a reader sees, with entities decoded. */
40
+ decoded: string;
41
+ /** Source span of each decoded character. */
42
+ spans: Array<[number, number]>;
43
+ }
44
+ export interface Document {
45
+ source: string;
46
+ elements: Element[];
47
+ /** (owner, decoded text, source span) for each text or entity run. */
48
+ text: Array<{
49
+ owner: Element | null;
50
+ decoded: string;
51
+ span: [number, number];
52
+ }>;
53
+ }
54
+ /**
55
+ * Scan source into elements and text runs, keeping every offset.
56
+ *
57
+ * Offsets are CODE POINTS throughout, because that is what this API's `ind`
58
+ * means and what the Python client produces. JavaScript's own string indices
59
+ * are UTF-16 units, so they are converted as the scan advances rather than at
60
+ * the end, where an emoji earlier in the file would have shifted everything.
61
+ */
62
+ export declare function parse(source: string): Document;
63
+ export declare function selectAll(doc: Document, selector: string, within?: Element): Element[];
64
+ /** Exactly one element, or a refusal saying which way it went wrong. */
65
+ export declare function select(doc: Document, selector: string, within?: Element): Element;
66
+ /**
67
+ * Decoded text runs under an element, each mapped back to source.
68
+ *
69
+ * One run per text node. They are NOT concatenated across a child tag: a query
70
+ * matching across a tag boundary would produce an edit that cannot be
71
+ * expressed as a change to one span of source.
72
+ */
73
+ export declare function textPieces(doc: Document, el: Element): TextPiece[];
@@ -0,0 +1,381 @@
1
+ /**
2
+ * CSS selection over HTML source, with edits that land on the source.
3
+ *
4
+ * The Python SDK's `api/_html.py` with the same rules and the same refusals.
5
+ * The constraint that shapes both: an edit changes the characters it addresses
6
+ * and leaves every other character alone. Parsing into a tree and serialising
7
+ * it back would normalise attribute quoting and respell entities, so a
8
+ * one-word change would arrive as a diff touching the whole file.
9
+ *
10
+ * Nothing here is rebuilt. The scanner records where each tag, text run and
11
+ * entity began in the ORIGINAL string, and an edit is a splice into it.
12
+ *
13
+ * A hand-written scanner rather than a parser dependency: what is needed is
14
+ * source OFFSETS, and the HTML libraries that are pleasant to use are exactly
15
+ * the ones that throw those away. The subset understood is the subset a note
16
+ * contains — tags, attributes, comments, and the raw-text elements whose
17
+ * contents are not markup.
18
+ */
19
+ import { cpLength } from "./editing.js";
20
+ export class SelectorError extends Error {
21
+ }
22
+ export class NoElement extends Error {
23
+ }
24
+ export class AmbiguousElement extends Error {
25
+ }
26
+ /** Elements HTML5 says never have a closing tag. */
27
+ const VOID = new Set([
28
+ "area", "base", "br", "col", "embed", "hr", "img", "input",
29
+ "link", "meta", "param", "source", "track", "wbr",
30
+ ]);
31
+ /** Elements whose contents are text, not markup. */
32
+ const RAW_TEXT = new Set(["script", "style", "textarea", "title"]);
33
+ const ENTITIES = {
34
+ amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: " ",
35
+ };
36
+ function decodeEntity(raw) {
37
+ const named = /^&([a-zA-Z][a-zA-Z0-9]*);/.exec(raw);
38
+ if (named && ENTITIES[named[1]] !== undefined)
39
+ return ENTITIES[named[1]];
40
+ const dec = /^&#(\d+);/.exec(raw);
41
+ if (dec)
42
+ return String.fromCodePoint(Number(dec[1]));
43
+ const hex = /^&#[xX]([0-9a-fA-F]+);/.exec(raw);
44
+ if (hex)
45
+ return String.fromCodePoint(parseInt(hex[1], 16));
46
+ return null;
47
+ }
48
+ const ATTR_RX = /([^\s=/>]+)(\s*=\s*("([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
49
+ function parseAttrs(tagSource) {
50
+ const out = {};
51
+ // Skip `<tagname`, then read pairs until the closing bracket.
52
+ const body = tagSource.replace(/^<\s*[^\s/>]+/, "").replace(/\/?>$/, "");
53
+ ATTR_RX.lastIndex = 0;
54
+ let m;
55
+ while ((m = ATTR_RX.exec(body)) !== null) {
56
+ const name = m[1].toLowerCase();
57
+ if (!name)
58
+ continue;
59
+ out[name] = m[2] === undefined ? null : (m[4] ?? m[5] ?? m[6] ?? "");
60
+ }
61
+ return out;
62
+ }
63
+ /**
64
+ * Scan source into elements and text runs, keeping every offset.
65
+ *
66
+ * Offsets are CODE POINTS throughout, because that is what this API's `ind`
67
+ * means and what the Python client produces. JavaScript's own string indices
68
+ * are UTF-16 units, so they are converted as the scan advances rather than at
69
+ * the end, where an emoji earlier in the file would have shifted everything.
70
+ */
71
+ export function parse(source) {
72
+ const elements = [];
73
+ const text = [];
74
+ const open = [];
75
+ const typeCounts = [{}];
76
+ const chars = Array.from(source); // index = code point
77
+ const n = chars.length;
78
+ let i = 0;
79
+ /** Raw source between two code point offsets. */
80
+ const slice = (a, b) => chars.slice(a, b).join("");
81
+ const pushText = (decoded, span) => {
82
+ if (decoded === "")
83
+ return;
84
+ text.push({ owner: open.length ? open[open.length - 1] : null, decoded, span });
85
+ };
86
+ while (i < n) {
87
+ if (chars[i] !== "<") {
88
+ // A run of text, up to the next tag or entity.
89
+ const start = i;
90
+ while (i < n && chars[i] !== "<" && chars[i] !== "&")
91
+ i++;
92
+ if (i > start)
93
+ pushText(slice(start, i), [start, i]);
94
+ if (i < n && chars[i] === "&") {
95
+ const rest = slice(i, Math.min(i + 12, n));
96
+ const decoded = decodeEntity(rest);
97
+ if (decoded !== null) {
98
+ const raw = /^&[^;]*;/.exec(rest)[0];
99
+ const width = cpLength(raw);
100
+ pushText(decoded, [i, i + width]);
101
+ i += width;
102
+ }
103
+ else {
104
+ pushText("&", [i, i + 1]);
105
+ i += 1;
106
+ }
107
+ }
108
+ continue;
109
+ }
110
+ // `<!-- ... -->` and `<!doctype ...>` are neither elements nor text.
111
+ if (slice(i, i + 4) === "<!--") {
112
+ const end = source.indexOf("-->", source.length ? chars.slice(0, i).join("").length : 0);
113
+ i = end < 0 ? n : cpLength(source.slice(0, end)) + 3;
114
+ continue;
115
+ }
116
+ if (chars[i + 1] === "!") {
117
+ while (i < n && chars[i] !== ">")
118
+ i++;
119
+ i += 1;
120
+ continue;
121
+ }
122
+ // Closing tag.
123
+ if (chars[i + 1] === "/") {
124
+ let j = i;
125
+ while (j < n && chars[j] !== ">")
126
+ j++;
127
+ const tag = slice(i + 2, j).trim().toLowerCase();
128
+ for (let k = open.length - 1; k >= 0; k--) {
129
+ if (open[k].tag === tag) {
130
+ const el = open[k];
131
+ el.inner = [el.startTag[1], i];
132
+ el.outer = [el.outer[0], j + 1];
133
+ open.length = k;
134
+ typeCounts.length = k + 1;
135
+ break;
136
+ }
137
+ }
138
+ i = j + 1;
139
+ continue;
140
+ }
141
+ // Opening tag.
142
+ let j = i;
143
+ let quote = null;
144
+ while (j < n) {
145
+ const c = chars[j];
146
+ if (quote) {
147
+ if (c === quote)
148
+ quote = null;
149
+ }
150
+ else if (c === '"' || c === "'") {
151
+ quote = c;
152
+ }
153
+ else if (c === ">") {
154
+ break;
155
+ }
156
+ j++;
157
+ }
158
+ const raw = slice(i, j + 1);
159
+ const nameMatch = /^<\s*([^\s/>]+)/.exec(raw);
160
+ if (!nameMatch) {
161
+ pushText("<", [i, i + 1]);
162
+ i += 1;
163
+ continue;
164
+ }
165
+ const tag = nameMatch[1].toLowerCase();
166
+ const end = j + 1;
167
+ const selfClosing = /\/\s*>$/.test(raw);
168
+ const counts = typeCounts[typeCounts.length - 1];
169
+ counts[tag] = (counts[tag] ?? 0) + 1;
170
+ const el = {
171
+ tag,
172
+ attrs: parseAttrs(raw),
173
+ outer: [i, end],
174
+ inner: [end, end],
175
+ startTag: [i, end],
176
+ depth: open.length,
177
+ indexOfType: counts[tag],
178
+ parent: open.length ? open[open.length - 1] : null,
179
+ };
180
+ elements.push(el);
181
+ i = end;
182
+ if (VOID.has(tag) || selfClosing)
183
+ continue;
184
+ if (RAW_TEXT.has(tag)) {
185
+ // Contents are text, so `<` inside a script is not a tag.
186
+ const closeAt = source.toLowerCase().indexOf(`</${tag}`, chars.slice(0, i).join("").length);
187
+ const closeCp = closeAt < 0 ? n : cpLength(source.slice(0, closeAt));
188
+ if (closeCp > i)
189
+ pushText(slice(i, closeCp), [i, closeCp]);
190
+ el.inner = [i, closeCp];
191
+ let k = closeCp;
192
+ while (k < n && chars[k] !== ">")
193
+ k++;
194
+ el.outer = [el.outer[0], Math.min(k + 1, n)];
195
+ i = Math.min(k + 1, n);
196
+ continue;
197
+ }
198
+ open.push(el);
199
+ typeCounts.push({});
200
+ }
201
+ // Anything still open at EOF runs to the end, which is what a browser does.
202
+ for (const el of open) {
203
+ el.inner = [el.startTag[1], n];
204
+ el.outer = [el.outer[0], n];
205
+ }
206
+ return { source, elements, text };
207
+ }
208
+ const PIECE = /#([\w-]+)|\.([\w-]+)|\[([^\]]+)\]|:nth-of-type\((\d+)\)/g;
209
+ function parseSelector(sel) {
210
+ if (!sel.trim())
211
+ throw new SelectorError("empty selector");
212
+ if (sel.includes(",")) {
213
+ throw new SelectorError("selector lists (',') are not supported; select one element");
214
+ }
215
+ if (sel.includes("::") || /:(?!nth-of-type\()/.test(sel)) {
216
+ throw new SelectorError(`unsupported pseudo-selector in ${JSON.stringify(sel)}`);
217
+ }
218
+ const tokens = sel.trim().split(/\s*(>)\s*|\s+/).filter(Boolean);
219
+ const steps = [];
220
+ let child = false;
221
+ for (const tok of tokens) {
222
+ if (tok === ">") {
223
+ child = true;
224
+ continue;
225
+ }
226
+ const tagMatch = /^([A-Za-z][\w-]*|\*)?/.exec(tok);
227
+ const tag = tagMatch[1];
228
+ const rest = tok.slice(tagMatch[0].length);
229
+ if (!tag && !rest)
230
+ throw new SelectorError(`unsupported selector fragment: ${tok}`);
231
+ const step = {
232
+ tag: !tag || tag === "*" ? null : tag.toLowerCase(),
233
+ ids: [], classes: [], attrs: [], nth: null, child,
234
+ };
235
+ let consumed = 0;
236
+ PIECE.lastIndex = 0;
237
+ let m;
238
+ while ((m = PIECE.exec(rest)) !== null) {
239
+ consumed += m[0].length;
240
+ if (m[1])
241
+ step.ids.push(m[1]);
242
+ else if (m[2])
243
+ step.classes.push(m[2]);
244
+ else if (m[3]) {
245
+ const a = /^\s*([\w-]+)\s*(?:([~|^$*]?=)\s*(.*?)\s*)?$/.exec(m[3]);
246
+ if (!a)
247
+ throw new SelectorError(`unsupported attribute selector: [${m[3]}]`);
248
+ if (a[2] && a[2] !== "=") {
249
+ throw new SelectorError(`attribute operator '${a[2]}' is not supported; use [attr] or [attr=value]`);
250
+ }
251
+ step.attrs.push([a[1].toLowerCase(), a[3] === undefined ? null : a[3].replace(/^["']|["']$/g, "")]);
252
+ }
253
+ else if (m[4])
254
+ step.nth = Number(m[4]);
255
+ }
256
+ if (consumed !== rest.length)
257
+ throw new SelectorError(`unsupported selector fragment: ${tok}`);
258
+ steps.push(step);
259
+ child = false;
260
+ }
261
+ return steps;
262
+ }
263
+ function matches(el, step) {
264
+ if (step.tag && el.tag !== step.tag)
265
+ return false;
266
+ for (const id of step.ids)
267
+ if (el.attrs.id !== id)
268
+ return false;
269
+ if (step.classes.length) {
270
+ const have = new Set((el.attrs.class ?? "").split(/\s+/).filter(Boolean));
271
+ for (const c of step.classes)
272
+ if (!have.has(c))
273
+ return false;
274
+ }
275
+ for (const [name, value] of step.attrs) {
276
+ if (!(name in el.attrs))
277
+ return false;
278
+ if (value !== null && el.attrs[name] !== value)
279
+ return false;
280
+ }
281
+ if (step.nth !== null && el.indexOfType !== step.nth)
282
+ return false;
283
+ return true;
284
+ }
285
+ function* ancestors(el) {
286
+ let cur = el.parent;
287
+ while (cur) {
288
+ yield cur;
289
+ cur = cur.parent;
290
+ }
291
+ }
292
+ export function selectAll(doc, selector, within) {
293
+ const steps = parseSelector(selector);
294
+ const last = steps[steps.length - 1];
295
+ const out = [];
296
+ for (const el of doc.elements) {
297
+ if (within && ![...ancestors(el)].includes(within))
298
+ continue;
299
+ if (!matches(el, last))
300
+ continue;
301
+ let cur = el;
302
+ let ok = true;
303
+ for (let s = steps.length - 2; s >= 0; s--) {
304
+ const step = steps[s];
305
+ if (steps[s + 1].child) {
306
+ if (!cur.parent || !matches(cur.parent, step)) {
307
+ ok = false;
308
+ break;
309
+ }
310
+ cur = cur.parent;
311
+ }
312
+ else {
313
+ let found = null;
314
+ for (const anc of ancestors(cur)) {
315
+ if (matches(anc, step)) {
316
+ found = anc;
317
+ break;
318
+ }
319
+ }
320
+ if (!found) {
321
+ ok = false;
322
+ break;
323
+ }
324
+ cur = found;
325
+ }
326
+ }
327
+ if (ok)
328
+ out.push(el);
329
+ }
330
+ return out;
331
+ }
332
+ /** Exactly one element, or a refusal saying which way it went wrong. */
333
+ export function select(doc, selector, within) {
334
+ const found = selectAll(doc, selector, within);
335
+ if (found.length === 0)
336
+ throw new NoElement(`no element matches ${JSON.stringify(selector)}`);
337
+ if (found.length > 1) {
338
+ throw new AmbiguousElement(`${found.length} elements match ${JSON.stringify(selector)} — ` +
339
+ "narrow it, or use :nth-of-type(n)");
340
+ }
341
+ return found[0];
342
+ }
343
+ /**
344
+ * Decoded text runs under an element, each mapped back to source.
345
+ *
346
+ * One run per text node. They are NOT concatenated across a child tag: a query
347
+ * matching across a tag boundary would produce an edit that cannot be
348
+ * expressed as a change to one span of source.
349
+ */
350
+ export function textPieces(doc, el) {
351
+ const [lo, hi] = el.inner;
352
+ const out = [];
353
+ let pending = null;
354
+ let lastEnd = null;
355
+ for (const run of doc.text) {
356
+ const [s, e] = run.span;
357
+ if (!(lo <= s && e <= hi))
358
+ continue;
359
+ // Entities arrive as their own runs; join them onto adjacent text so
360
+ // `a &amp; b` reads as one piece, while each character keeps its own span.
361
+ if (pending && lastEnd === s) {
362
+ pending.decoded += run.decoded;
363
+ }
364
+ else {
365
+ pending = { decoded: run.decoded, spans: [] };
366
+ out.push(pending);
367
+ }
368
+ const chars = Array.from(run.decoded);
369
+ if (chars.length === 1) {
370
+ pending.spans.push([s, e]);
371
+ }
372
+ else {
373
+ const width = (e - s) / Math.max(chars.length, 1);
374
+ for (let k = 0; k < chars.length; k++) {
375
+ pending.spans.push([s + Math.floor(k * width), s + Math.floor((k + 1) * width)]);
376
+ }
377
+ }
378
+ lastEnd = e;
379
+ }
380
+ return out;
381
+ }
@@ -0,0 +1,123 @@
1
+ import { type DocumentReadOptions, type DocumentPatchOptions } from "./document.js";
2
+ import type { Command } from "commander";
3
+ /**
4
+ * Endpoint, credentials and namespace.
5
+ *
6
+ * Routed through `resolveCtx` — the same path the other ported groups take —
7
+ * so `--remote/--token/--debug` mean here what they mean everywhere else, and
8
+ * so a caller is not asked to log in twice for two halves of the same CLI.
9
+ */
10
+ export declare function ctx(opts?: ConnOpts): Promise<{
11
+ token: string;
12
+ remote: string;
13
+ ns: string;
14
+ } | null>;
15
+ /** Connection flags every notes subcommand accepts. */
16
+ export interface ConnOpts {
17
+ namespace?: string;
18
+ remote?: string;
19
+ token?: string;
20
+ debug?: boolean;
21
+ }
22
+ type Ctx = NonNullable<Awaited<ReturnType<typeof ctx>>>;
23
+ /** One path segment, encoded as one — a note name or an anchor is user text,
24
+ * and a `/` in either is a different request rather than a bad argument. */
25
+ export declare function seg(v: string): string;
26
+ /**
27
+ * Map a failure onto an exit code and a sentence worth reading.
28
+ *
29
+ * The three note-specific statuses each mean a different next step, and
30
+ * collapsing them into "request failed" would leave a script no way to tell
31
+ * "wait and retry" from "your copy is out of date".
32
+ */
33
+ export declare function report(err: unknown): number;
34
+ /**
35
+ * A note reference from the command line -> its id.
36
+ *
37
+ * Accepts an id or a slug. A slug is resolved through the listing rather than
38
+ * the server's `q` filter, because `q` matches the NAME and a note's slug is a
39
+ * separate field — matching on the wrong one would open a different note that
40
+ * happens to be titled similarly.
41
+ */
42
+ export declare function resolveNote(c: Ctx, ref: string): Promise<string | null>;
43
+ export declare function registerNotesCommand(program: Command): void;
44
+ export declare function runNotesList(opts: ConnOpts & {
45
+ limit?: string;
46
+ shared?: boolean;
47
+ json?: boolean;
48
+ }): Promise<number>;
49
+ export declare function runNotesSearch(query: string, opts: ConnOpts & {
50
+ limit?: string;
51
+ json?: boolean;
52
+ }): Promise<number>;
53
+ export declare function runNotesSections(ref: string, opts: ConnOpts & {
54
+ json?: boolean;
55
+ }): Promise<number>;
56
+ export declare function runNotesWrite(ref: string, opts: ConnOpts & {
57
+ section?: string;
58
+ file?: string;
59
+ text?: string;
60
+ ifMatch?: string;
61
+ force?: boolean;
62
+ legacy?: boolean;
63
+ baseRevision?: string;
64
+ exact?: boolean;
65
+ json?: boolean;
66
+ dryRun?: boolean;
67
+ }): Promise<number>;
68
+ export declare function runNotesAppend(ref: string, opts: ConnOpts & {
69
+ file?: string;
70
+ text?: string;
71
+ force?: boolean;
72
+ legacy?: boolean;
73
+ baseRevision?: string;
74
+ exact?: boolean;
75
+ json?: boolean;
76
+ dryRun?: boolean;
77
+ }): Promise<number>;
78
+ export declare function runNotesCreate(name: string, opts: ConnOpts & {
79
+ file?: string;
80
+ text?: string;
81
+ public?: boolean;
82
+ json?: boolean;
83
+ project?: string[];
84
+ }): Promise<number>;
85
+ export declare function runNotesAddSection(ref: string, opts: ConnOpts & {
86
+ before?: string;
87
+ after?: string;
88
+ file?: string;
89
+ text?: string;
90
+ ifMatch?: string;
91
+ force?: boolean;
92
+ json?: boolean;
93
+ dryRun?: boolean;
94
+ }): Promise<number>;
95
+ export declare function runNotesRmSection(ref: string, anchor: string, opts: ConnOpts & {
96
+ ifMatch?: string;
97
+ force?: boolean;
98
+ json?: boolean;
99
+ dryRun?: boolean;
100
+ }): Promise<number>;
101
+ /** Explicit compatibility keeps legacy body-only output and ETag semantics available. */
102
+ export declare function runNotesRead(ref: string | undefined, opts: DocumentReadOptions): Promise<number>;
103
+ export declare function runNotesDiff(ref: string | undefined, opts: DocumentReadOptions & {
104
+ context?: string;
105
+ }): Promise<number>;
106
+ export declare function runNotesPatch(ref: string, opts: DocumentPatchOptions): Promise<number>;
107
+ /** Reading the roster never registers presence or maintains a session. */
108
+ export declare function runNotesPresence(ref: string, opts: ConnOpts & {
109
+ json?: boolean;
110
+ }): Promise<number>;
111
+ /** The agent's self-reported purpose, validated before any presence request.
112
+ * undefined means the flag was not given — the server then preserves intent. */
113
+ export declare function presenceIntent(value: string | undefined): {
114
+ summary: string;
115
+ } | undefined;
116
+ /** One-shot participation; linger owns its own maintained lease. */
117
+ export declare function runNotesVisit(ref: string, opts: ConnOpts & {
118
+ json?: boolean;
119
+ intent?: string;
120
+ }): Promise<number>;
121
+ /** Metadata only: no body read, RTC activation, mount, or ownership mutation. */
122
+ export declare function runNotesProjects(id: string, opts: ConnOpts): Promise<number>;
123
+ export {};