@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,329 @@
1
+ import * as editing from "./note-editing.js";
2
+ import { type NoteLingerOptions, type NoteLingerEvent } from "./note-linger.js";
3
+ import type { Query } from "./common.js";
4
+ import { type NoteSource, type NoteEdit, type NotePatch } from "./note-edits.js";
5
+ export { noteEdits, type NoteSource, type NoteEdit, type NotePatch, } from "./note-edits.js";
6
+ import { type Transport } from "./client.js";
7
+ export interface NoteSearchHit {
8
+ noteId: string;
9
+ noteSlug: string;
10
+ noteName: string;
11
+ etag: string;
12
+ line: number;
13
+ column: number;
14
+ ind: [number, number];
15
+ text: string;
16
+ match: string;
17
+ before: string[];
18
+ after: string[];
19
+ anchor: string;
20
+ }
21
+ export interface NoteSearchPage {
22
+ hits: NoteSearchHit[];
23
+ nextCursor: string | null;
24
+ truncated: boolean;
25
+ notesSearched: number;
26
+ partialNotes: string[];
27
+ staleNotes: number;
28
+ }
29
+ export interface NoteRow {
30
+ id: string;
31
+ name: string;
32
+ slug: string;
33
+ namespaceSlug?: string;
34
+ visibility?: string;
35
+ updatedAt?: string;
36
+ matches?: {
37
+ anchor: string;
38
+ title: string;
39
+ snippet: string;
40
+ }[];
41
+ }
42
+ export interface NoteReadResult {
43
+ note: string;
44
+ hash: string;
45
+ revision: string;
46
+ content?: string;
47
+ base?: string;
48
+ patch?: string;
49
+ format?: "diff" | "inline-dff";
50
+ since?: string;
51
+ }
52
+ export interface NoteVersion {
53
+ id: string;
54
+ hash: string;
55
+ tag: string;
56
+ summary: string;
57
+ parentId: string | null;
58
+ createdAt: string;
59
+ text?: string;
60
+ }
61
+ export interface NoteBody {
62
+ text: string;
63
+ etag: string;
64
+ sizeBytes: number;
65
+ }
66
+ export interface Section {
67
+ anchor: string;
68
+ title: string;
69
+ level: number;
70
+ start: number;
71
+ end: number;
72
+ }
73
+ export interface WriteReceipt {
74
+ etag: string;
75
+ sizeBytes: number;
76
+ sections?: Section[];
77
+ }
78
+ export interface NoteMediaReceipt {
79
+ url: string;
80
+ contentType: string;
81
+ sizeBytes: number;
82
+ }
83
+ export declare function notesApi(t: Transport, namespace: string): {
84
+ linger: (noteId: string, options: NoteLingerOptions, receive: (event: NoteLingerEvent) => void | Promise<void>) => Promise<void>;
85
+ namespace: string;
86
+ /** Resolve the same ID, exact slug or exact title accepted by the CLI in this namespace. */
87
+ resolve: (ref: string) => Promise<string>;
88
+ /** CSS inspection is read-only; selectText publishes a separate agent selection. */
89
+ selectElement: (noteId: string, css: string) => Promise<{
90
+ etag: string;
91
+ tag: string;
92
+ attrs: Record<string, string | null>;
93
+ outer: [number, number];
94
+ inner: [number, number];
95
+ text: string;
96
+ }>;
97
+ source: (noteId: string, at?: string) => Promise<NoteSource>;
98
+ patch: (noteId: string, input: NotePatch) => Promise<{
99
+ note: string;
100
+ hash: string;
101
+ revision: string;
102
+ baseRevision: string;
103
+ mode: "exact" | "merge";
104
+ }>;
105
+ replaceContent: (noteId: string, baseRevision: string, content: string, mode?: "exact" | "merge") => Promise<{
106
+ note: string;
107
+ hash: string;
108
+ revision: string;
109
+ baseRevision: string;
110
+ mode: "exact" | "merge";
111
+ }>;
112
+ replace: (noteId: string, baseRevision: string, text: string, where: editing.Where, mode?: "exact" | "merge") => Promise<{
113
+ note: string;
114
+ hash: string;
115
+ revision: string;
116
+ baseRevision: string;
117
+ mode: "exact" | "merge";
118
+ }>;
119
+ insert: (noteId: string, baseRevision: string, text: string, where: {
120
+ line?: number;
121
+ ind?: number;
122
+ }, mode?: "exact" | "merge") => Promise<{
123
+ note: string;
124
+ hash: string;
125
+ revision: string;
126
+ baseRevision: string;
127
+ mode: "exact" | "merge";
128
+ }>;
129
+ removeText: (noteId: string, baseRevision: string, where: editing.Where, mode?: "exact" | "merge") => Promise<{
130
+ note: string;
131
+ hash: string;
132
+ revision: string;
133
+ baseRevision: string;
134
+ mode: "exact" | "merge";
135
+ }>;
136
+ findInSource: (noteId: string, at: string, query?: string, options?: editing.FindOpts) => Promise<{
137
+ matches: editing.Match[];
138
+ note: string;
139
+ content: string;
140
+ hash: string;
141
+ revision: string;
142
+ }>;
143
+ outline: (noteId: string, at?: string) => Promise<{
144
+ note: string;
145
+ revision: string;
146
+ hash: string;
147
+ entries: import("./note-toc.js").TocEntry[];
148
+ }>;
149
+ get: (noteId: string) => Promise<NoteRow & {
150
+ namespaceSlug: string;
151
+ permissions: Record<string, boolean>;
152
+ }>;
153
+ delete: (noteId: string) => Promise<unknown>;
154
+ shared: () => Promise<{
155
+ notes: NoteRow[];
156
+ }>;
157
+ projects: (noteId: string, view?: "nodes") => Promise<unknown>;
158
+ move: (noteId: string, input: {
159
+ namespace: string;
160
+ projects: string[];
161
+ dryRun?: boolean;
162
+ }) => Promise<unknown>;
163
+ share: (noteId: string) => {
164
+ get: () => Promise<Record<string, unknown>>;
165
+ create: (role?: "read" | "write") => Promise<unknown>;
166
+ revoke: (revokeAccepted?: boolean) => Promise<unknown>;
167
+ visibility: (visibility: "private" | "public" | "team") => Promise<unknown>;
168
+ access: () => Promise<unknown>;
169
+ remove: (userId: string) => Promise<unknown>;
170
+ };
171
+ files: (noteId: string) => {
172
+ list: (query?: import("./note-files.js").NoteFileListOptions) => Promise<import("./note-files.js").NoteFilePage>;
173
+ get: (id: string) => Promise<import("./note-files.js").NoteFile>;
174
+ resolve: (ref: string, includeTrashed?: boolean) => Promise<import("./note-files.js").NoteFile>;
175
+ text: (ref: string) => Promise<{
176
+ text: string;
177
+ etag: string;
178
+ }>;
179
+ cat: (ref: string) => Promise<{
180
+ text: string;
181
+ etag: string;
182
+ }>;
183
+ download: (ref: string, signal?: AbortSignal) => Promise<Response>;
184
+ upload: (path: string, body: NonNullable<import("./client.js").RequestOptions["body"]> | import("stream").Readable, options?: {
185
+ contentType?: string;
186
+ overwrite?: boolean;
187
+ ifMatch?: string;
188
+ contentLength?: number;
189
+ signal?: AbortSignal;
190
+ }) => Promise<import("./note-files.js").NoteFile>;
191
+ write: (input: {
192
+ path: string;
193
+ text: string;
194
+ overwrite?: boolean;
195
+ contentType?: string;
196
+ }, options?: {
197
+ ifMatch?: string;
198
+ idempotencyKey?: string;
199
+ }) => Promise<import("./note-files.js").NoteFileWriteReceipt>;
200
+ move: (ref: string, path: string, options?: {
201
+ overwrite?: boolean;
202
+ ifMatch?: string;
203
+ }) => Promise<import("./note-files.js").NoteFile>;
204
+ copy: (ref: string, path: string, options?: {
205
+ overwrite?: boolean;
206
+ idempotencyKey?: string;
207
+ }) => Promise<import("./note-files.js").NoteFileWriteReceipt>;
208
+ operation: (operationId: string, action?: "status" | "reconcile" | "cancel") => Promise<import("./note-files.js").NoteFileOperationReceipt>;
209
+ status: (id: string) => Promise<import("./note-files.js").NoteFileOperationReceipt>;
210
+ reconcile: (id: string) => Promise<import("./note-files.js").NoteFileOperationReceipt>;
211
+ cancel: (id: string) => Promise<import("./note-files.js").NoteFileOperationReceipt>;
212
+ delete: (ref: string, options?: {
213
+ purge?: boolean;
214
+ ifMatch?: string;
215
+ }) => Promise<{
216
+ id: string;
217
+ purged: boolean;
218
+ }>;
219
+ restore: (ref: string, path?: string) => Promise<import("./note-files.js").NoteFile>;
220
+ preview: (ref: string, share?: boolean) => Promise<import("./note-files.js").NoteFilePreview>;
221
+ revokePreview: (ref: string) => Promise<{
222
+ id: string;
223
+ shared: boolean;
224
+ }>;
225
+ };
226
+ media: (form: FormData) => Promise<NoteMediaReceipt>;
227
+ read: (noteId: string, query?: Query) => Promise<NoteReadResult>;
228
+ html: (noteId: string, options?: {
229
+ at?: string;
230
+ section?: string;
231
+ toc?: boolean;
232
+ tag?: string;
233
+ ifMatch?: string;
234
+ }) => Promise<{
235
+ note: string;
236
+ revision: string;
237
+ html: string;
238
+ bytes: Uint8Array<ArrayBuffer>;
239
+ }>;
240
+ diff: (noteId: string, query: {
241
+ from?: string;
242
+ to?: string;
243
+ since?: string;
244
+ format?: "diff" | "inline-dff";
245
+ }) => Promise<unknown>;
246
+ saveVersion: (noteId: string, input: {
247
+ hash: string;
248
+ tag?: string;
249
+ summary?: string;
250
+ parentId?: string;
251
+ }) => Promise<unknown>;
252
+ find: (query: {
253
+ q: string;
254
+ note?: string;
255
+ cursor?: string;
256
+ limit?: number;
257
+ caseSensitive?: boolean;
258
+ glob?: string;
259
+ regex?: string;
260
+ flags?: string;
261
+ context?: string;
262
+ }) => Promise<NoteSearchPage>;
263
+ create: (input: {
264
+ name: string;
265
+ summary?: string;
266
+ projects?: string[];
267
+ visibility?: "private" | "public";
268
+ }) => Promise<{
269
+ note: NoteRow;
270
+ rtc: {
271
+ rtcDocId: string;
272
+ };
273
+ }>;
274
+ edit: (noteId: string, baseRevision: string, edits: NoteEdit[], mode?: "merge" | "exact") => Promise<{
275
+ note: string;
276
+ hash: string;
277
+ revision: string;
278
+ baseRevision: string;
279
+ mode: "exact" | "merge";
280
+ }>;
281
+ versions: (noteId: string, query?: {
282
+ before?: string;
283
+ }) => Promise<{
284
+ versions: NoteVersion[];
285
+ nextCursor?: string | null;
286
+ }>;
287
+ version: (noteId: string, versionId: string) => Promise<NoteVersion>;
288
+ list: (query?: {
289
+ q?: string;
290
+ limit?: number;
291
+ offset?: number;
292
+ }) => Promise<{
293
+ notes: NoteRow[];
294
+ }>;
295
+ search: (q: string, limit?: number, offset?: number) => Promise<{
296
+ notes: NoteRow[];
297
+ total: number;
298
+ }>;
299
+ body: (noteId: string) => Promise<NoteBody>;
300
+ sections: (noteId: string) => Promise<{
301
+ sections: Section[];
302
+ etag: string;
303
+ }>;
304
+ section: (noteId: string, anchor: string) => Promise<NoteBody & Partial<Section>>;
305
+ /** Replace the whole body, refused with 412 `stale` unless `ifMatch` is the current etag. */
306
+ write: (noteId: string, text: string, ifMatch: string) => Promise<WriteReceipt>;
307
+ /** Read-then-conditional-write append; a concurrent edit refuses with 412 `stale` instead of being overwritten. */
308
+ append: (noteId: string, addition: string, ifMatch?: string) => Promise<WriteReceipt>;
309
+ addSection: (noteId: string, text: string, placement?: {
310
+ before?: string;
311
+ after?: string;
312
+ }, ifMatch?: string) => Promise<WriteReceipt>;
313
+ removeSection: (noteId: string, anchor: string, ifMatch?: string) => Promise<WriteReceipt>;
314
+ presence: {
315
+ (id: string): Promise<import("./note-presence.js").NotePresenceRoster>;
316
+ (id: string, input: Record<string, unknown>): Promise<import("./note-presence.js").NotePresenceReceipt>;
317
+ };
318
+ presenceText: (id: string) => Promise<string>;
319
+ updatePresence: (id: string, input: Record<string, unknown>, options?: import("./client.js").RequestOptions) => Promise<import("./note-presence.js").NotePresenceReceipt>;
320
+ visit: (id: string, options?: {
321
+ intent?: string;
322
+ }) => Promise<import("./note-presence.js").NotePresenceReceipt>;
323
+ activity: (id: string, options?: import("./client.js").RequestOptions) => Promise<{
324
+ activities: import("./note-presence.js").NoteActivity[];
325
+ }>;
326
+ events: (id: string, signal: AbortSignal, receive: (event: import("./note-events.js").NoteEvent) => void) => Promise<void>;
327
+ selectText: (id: string, options: import("./note-presence.js").NoteSelectionOptions) => Promise<import("./note-presence.js").NoteSelectionReceipt>;
328
+ };
329
+ export type NotesApi = ReturnType<typeof notesApi>;
@@ -0,0 +1,209 @@
1
+ import { validateHtmlSnapshot } from "./note-html-read.js";
2
+ import { characterDiff } from "./note-character-plan.js";
3
+ import * as editing from "./note-editing.js";
4
+ import { markdownToc as outline } from "./note-toc.js";
5
+ import { parse as parseHtml, select as selectHtml, textPieces } from './note-html.js';
6
+ /** Notes: search, read, sections, conditional writes. Mirrors the CLI `notes` group. */
7
+ import { noteFilesApi } from "./note-files.js";
8
+ import { notePresenceApi } from "./note-presence.js";
9
+ import { watchNote } from "./note-linger.js";
10
+ import { sharingApi } from "./workspace.js";
11
+ import { createHash } from "node:crypto";
12
+ import { noteEdits, } from "./note-edits.js";
13
+ export { noteEdits, } from "./note-edits.js";
14
+ import { ApiError, isObjectId, seg } from "./client.js";
15
+ export function notesApi(t, namespace) {
16
+ const base = `/namespaces/${seg(namespace)}/notes`;
17
+ const id = (value) => {
18
+ if (!isObjectId(value))
19
+ throw new Error("expected a 24-hex note id");
20
+ return value;
21
+ };
22
+ const source = async (noteId, at) => {
23
+ const value = await t.request("GET", `${base}/${id(noteId)}/body`, { query: { contract: "v2", at } });
24
+ if (value.note !== noteId ||
25
+ typeof value.content !== "string" ||
26
+ typeof value.revision !== "string" ||
27
+ !value.revision ||
28
+ /[\r\n]/.test(value.revision) ||
29
+ (at !== undefined && value.revision !== at) ||
30
+ value.hash !==
31
+ `sha256:${createHash("sha256").update(value.content).digest("hex")}`)
32
+ throw new Error("invalid Notes v2 snapshot");
33
+ return value;
34
+ };
35
+ const patch = async (noteId, input) => {
36
+ if (!input.baseRevision ||
37
+ /[\r\n]/.test(input.baseRevision) ||
38
+ !["exact", "merge"].includes(input.mode))
39
+ throw new Error("original baseRevision and mode required");
40
+ const receipt = await t.request("PATCH", `${base}/${id(noteId)}/body`, { json: input });
41
+ if (receipt.note !== noteId ||
42
+ receipt.baseRevision !== input.baseRevision ||
43
+ receipt.mode !== input.mode ||
44
+ typeof receipt.revision !== "string" ||
45
+ !receipt.revision ||
46
+ !/^sha256:[a-f0-9]{64}$/.test(receipt.hash) ||
47
+ /[\r\n]/.test(receipt.revision))
48
+ throw new ApiError(503, "note_write_receipt_unconfirmed", {
49
+ note: noteId,
50
+ baseRevision: input.baseRevision,
51
+ });
52
+ return receipt;
53
+ };
54
+ return {
55
+ ...notePresenceApi(t, base),
56
+ linger: (noteId, options, receive) => watchNote(t, `${base}/${id(noteId)}`, noteId, options, receive),
57
+ namespace,
58
+ /** Resolve the same ID, exact slug or exact title accepted by the CLI in this namespace. */
59
+ resolve: async (ref) => {
60
+ if (/^[a-f0-9]{24}$/i.test(ref))
61
+ return ref;
62
+ const result = await t.request('GET', base, { query: { limit: 200 } });
63
+ const hit = result.notes.find(row => row.slug === ref || row.id === ref || row.name === ref);
64
+ if (!hit)
65
+ throw new ApiError(404, 'note_not_found', { namespace, ref });
66
+ return hit.id;
67
+ },
68
+ /** CSS inspection is read-only; selectText publishes a separate agent selection. */
69
+ selectElement: async (noteId, css) => {
70
+ const body = await t.request('GET', `${base}/${id(noteId)}/body`);
71
+ const document = parseHtml(body.text), element = selectHtml(document, css);
72
+ return { etag: body.etag, tag: element.tag, attrs: element.attrs, outer: element.outer, inner: element.inner,
73
+ text: textPieces(document, element).map(piece => piece.decoded).join('') };
74
+ },
75
+ source,
76
+ patch,
77
+ replaceContent: async (noteId, baseRevision, content, mode = "exact") => {
78
+ const original = await source(noteId, baseRevision);
79
+ return patch(noteId, noteEdits(original, characterDiff(original.content, content).map((e) => ({
80
+ start: e.start,
81
+ end: e.end,
82
+ text: e.replacementText,
83
+ expected: e.expectedText,
84
+ })), mode));
85
+ },
86
+ replace: async (noteId, baseRevision, text, where, mode = "exact") => {
87
+ const original = await source(noteId, baseRevision), plan = editing.replacementPlan(original.content, text, where);
88
+ return patch(noteId, noteEdits(original, plan.map(([start, end, text]) => ({ start, end, text })), mode));
89
+ },
90
+ insert: async (noteId, baseRevision, text, where, mode = "exact") => {
91
+ const original = await source(noteId, baseRevision), placement = editing.insertPlacement(original.content, text, where);
92
+ return patch(noteId, noteEdits(original, [{ start: placement.at, end: placement.at, text: placement.text }], mode));
93
+ },
94
+ removeText: async (noteId, baseRevision, where, mode = "exact") => {
95
+ const original = await source(noteId, baseRevision), plan = editing.removalPlan(original.content, where);
96
+ return patch(noteId, noteEdits(original, plan.map(([start, end, text]) => ({ start, end, text })), mode));
97
+ },
98
+ findInSource: async (noteId, at, query, options = {}) => {
99
+ const original = await source(noteId, at);
100
+ return {
101
+ ...original,
102
+ matches: editing.find(original.content, query, options),
103
+ };
104
+ },
105
+ outline: async (noteId, at) => {
106
+ const original = await source(noteId, at);
107
+ return {
108
+ note: noteId,
109
+ revision: original.revision,
110
+ hash: original.hash,
111
+ entries: outline(original.content),
112
+ };
113
+ },
114
+ get: (noteId) => t.request("GET", `/notes/${id(noteId)}`),
115
+ delete: (noteId) => t.request("DELETE", `${base}/${id(noteId)}`),
116
+ shared: () => t.request("GET", "/me/notes/shared"),
117
+ projects: (noteId, view) => t.request("GET", `/namespaces/${seg(namespace)}/resources/note/${id(noteId)}/projects`, { query: { view } }),
118
+ move: (noteId, input) => t.request("POST", `${base}/${id(noteId)}/move`, { json: input }),
119
+ share: (noteId) => sharingApi(t, namespace, "notes", id(noteId)),
120
+ files: (noteId) => noteFilesApi(t, `${base}/${id(noteId)}`),
121
+ media: async (form) => {
122
+ const receipt = await t.request('POST', '/notes/media', { body: form, redirect: 'error' });
123
+ if (!receipt || typeof receipt.url !== 'string' || !/^https?:\/\/[^\s]+$/.test(receipt.url) ||
124
+ !['http:', 'https:'].includes(new URL(receipt.url).protocol) || typeof receipt.contentType !== 'string' ||
125
+ !Number.isSafeInteger(receipt.sizeBytes) || receipt.sizeBytes < 0)
126
+ throw new Error('invalid media upload response: expected url, contentType and sizeBytes');
127
+ return receipt;
128
+ },
129
+ read: (noteId, query = {}) => t.request("GET", `${base}/${id(noteId)}/body`, {
130
+ query: { contract: "v2", ...query },
131
+ }),
132
+ html: async (noteId, options = {}) => {
133
+ if (!t.raw)
134
+ throw new Error("transport_does_not_support_streaming");
135
+ const response = await t.raw("GET", `${base}/${id(noteId)}/body`, {
136
+ query: {
137
+ contract: "v2",
138
+ view: "html",
139
+ contentFormat: "literal-markdown",
140
+ at: options.at,
141
+ section: options.section,
142
+ toc: options.toc,
143
+ tag: options.tag,
144
+ },
145
+ headers: {
146
+ Accept: "text/html",
147
+ ...(options.ifMatch ? { "If-Match": options.ifMatch } : {}),
148
+ },
149
+ });
150
+ if (!/^text\/(?:html|plain)(?:;|$)/i.test(response.headers.get("content-type") ?? ""))
151
+ throw new Error("server did not return Notes HTML; upgrade the server");
152
+ const bytes = new Uint8Array(await response.arrayBuffer()), html = new TextDecoder("utf-8", {
153
+ fatal: true,
154
+ ignoreBOM: true,
155
+ }).decode(bytes);
156
+ const snapshot = validateHtmlSnapshot(html, noteId, options);
157
+ if (options.at && snapshot.revision !== options.at)
158
+ throw new Error("server did not return the requested pinned revision");
159
+ if (options.ifMatch && snapshot.revision !== options.ifMatch)
160
+ throw new ApiError(412, "stale", { note: noteId });
161
+ return { note: noteId, revision: snapshot.revision, html, bytes };
162
+ },
163
+ diff: (noteId, query) => t.request("GET", `${base}/${id(noteId)}/diff`, { query }),
164
+ saveVersion: (noteId, input) => t.request("POST", `${base}/${id(noteId)}/versions`, { json: input }),
165
+ find: (query) => t.request("GET", `${base}/search`, { query }),
166
+ create: (input) => t.request("POST", base, {
167
+ json: input,
168
+ }),
169
+ edit: async (noteId, baseRevision, edits, mode = "exact") => patch(noteId, noteEdits(await source(noteId, baseRevision), edits, mode)),
170
+ versions: (noteId, query = {}) => t.request("GET", `${base}/${id(noteId)}/versions`, { query }),
171
+ version: (noteId, versionId) => t.request("GET", `${base}/${id(noteId)}/versions/${seg(versionId)}`),
172
+ list: (query = {}) => t.request("GET", base, { query }),
173
+ search: (q, limit = 50, offset = 0) => t.request("GET", base, {
174
+ query: { q, limit, offset },
175
+ }),
176
+ body: (noteId) => t.request("GET", `${base}/${id(noteId)}/body`),
177
+ sections: (noteId) => t.request("GET", `${base}/${id(noteId)}/sections`),
178
+ section: (noteId, anchor) => t.request("GET", `${base}/${id(noteId)}/sections/${encodeURIComponent(anchor)}`),
179
+ /** Replace the whole body, refused with 412 `stale` unless `ifMatch` is the current etag. */
180
+ write: (noteId, text, ifMatch) => t.request("PUT", `${base}/${id(noteId)}/body`, {
181
+ json: { text },
182
+ headers: { "If-Match": ifMatch },
183
+ }),
184
+ /** Read-then-conditional-write append; a concurrent edit refuses with 412 `stale` instead of being overwritten. */
185
+ append: async (noteId, addition, ifMatch) => {
186
+ const current = await t.request("GET", `${base}/${id(noteId)}/body`);
187
+ const text = (current.text && !current.text.endsWith("\n")
188
+ ? current.text + "\n"
189
+ : current.text) + addition;
190
+ return t.request("PUT", `${base}/${id(noteId)}/body`, {
191
+ json: { text },
192
+ headers: { "If-Match": ifMatch ?? current.etag },
193
+ });
194
+ },
195
+ addSection: async (noteId, text, placement = {}, ifMatch) => {
196
+ const etag = ifMatch ??
197
+ (await t.request("GET", `${base}/${id(noteId)}/body`)).etag;
198
+ return t.request("POST", `${base}/${id(noteId)}/sections`, {
199
+ json: { text, ...placement },
200
+ headers: { "If-Match": etag },
201
+ });
202
+ },
203
+ removeSection: async (noteId, anchor, ifMatch) => {
204
+ const etag = ifMatch ??
205
+ (await t.request("GET", `${base}/${id(noteId)}/body`)).etag;
206
+ return t.request("DELETE", `${base}/${id(noteId)}/sections/${seg(anchor)}`, { headers: { "If-Match": etag } });
207
+ },
208
+ };
209
+ }
@@ -0,0 +1,27 @@
1
+ import { type Transport } from "./client.js";
2
+ export interface OpenResource {
3
+ id: string;
4
+ kind?: string;
5
+ resource: string;
6
+ projectId?: string;
7
+ }
8
+ /** Descriptors are observations only. Each resource goes through the caller's permission-checked API. */
9
+ export declare function openResourcesApi(t: Transport): {
10
+ find(resources: readonly OpenResource[], input: {
11
+ query: string;
12
+ offset?: number;
13
+ limit?: number;
14
+ ifResourcesRevision?: string;
15
+ signal?: AbortSignal;
16
+ }): Promise<{
17
+ results: Record<string, unknown>[];
18
+ skipped: {
19
+ resource: string;
20
+ reason: string;
21
+ }[];
22
+ totalResources: number;
23
+ resourcesRevision: string;
24
+ nextOffset: number | null;
25
+ partial: boolean;
26
+ }>;
27
+ };
@@ -0,0 +1,102 @@
1
+ import { createHash } from "node:crypto";
2
+ import { ApiError } from "./client.js";
3
+ import { notesApi } from "./notes.js";
4
+ import { projectToolsApi } from "./agent.js";
5
+ /** Descriptors are observations only. Each resource goes through the caller's permission-checked API. */
6
+ export function openResourcesApi(t) {
7
+ return {
8
+ async find(resources, input) {
9
+ const offset = input.offset ?? 0, limit = input.limit ?? 5;
10
+ if (!input.query ||
11
+ input.query.length > 200 ||
12
+ !Number.isSafeInteger(offset) ||
13
+ offset < 0 ||
14
+ !Number.isSafeInteger(limit) ||
15
+ limit < 1 ||
16
+ limit > 10)
17
+ throw new ApiError(400, "invalid_open_resource_search", {});
18
+ const descriptors = [
19
+ ...new Map(resources.map((r) => [`${r.kind}:${r.resource}`, r])).values(),
20
+ ];
21
+ const resourcesRevision = "sha256:" +
22
+ createHash("sha256").update(JSON.stringify(descriptors)).digest("hex");
23
+ if (input.ifResourcesRevision &&
24
+ input.ifResourcesRevision !== resourcesRevision)
25
+ throw new ApiError(409, "open_resources_changed", {});
26
+ const results = [], skipped = [];
27
+ for (const item of descriptors.slice(offset, offset + limit)) {
28
+ input.signal?.throwIfAborted();
29
+ const id = item.resource.match(/(?:^|\/)([a-f0-9]{24})$/)?.[1];
30
+ if (!id) {
31
+ skipped.push({
32
+ resource: item.resource,
33
+ reason: "unsupported_resource_kind",
34
+ });
35
+ continue;
36
+ }
37
+ try {
38
+ if (item.kind === "note") {
39
+ const row = await notesApi(t, "unused").get(id);
40
+ if (!row.namespaceSlug)
41
+ throw new ApiError(503, "note_namespace_unavailable", {});
42
+ results.push({
43
+ resource: id,
44
+ tabId: item.id,
45
+ matches: await notesApi(t, row.namespaceSlug).find({
46
+ q: input.query,
47
+ note: id,
48
+ limit: 20,
49
+ }),
50
+ });
51
+ }
52
+ else if (item.kind === "file" && item.projectId) {
53
+ const file = await projectToolsApi(t).readFile(item.projectId, id), text = file.content;
54
+ if (typeof text !== "string")
55
+ throw new ApiError(503, "file_content_unavailable", {});
56
+ const hits = [];
57
+ let at = 0;
58
+ while (hits.length < 20) {
59
+ const start = text.indexOf(input.query, at);
60
+ if (start < 0)
61
+ break;
62
+ at = start + input.query.length;
63
+ hits.push({ start, end: at });
64
+ }
65
+ results.push({
66
+ resource: id,
67
+ tabId: item.id,
68
+ revision: "sha256:" + createHash("sha256").update(text).digest("hex"),
69
+ offsets: "UTF-16",
70
+ hits,
71
+ truncated: text.indexOf(input.query, at) >= 0,
72
+ });
73
+ }
74
+ else
75
+ skipped.push({
76
+ resource: item.resource,
77
+ reason: "unsupported_resource_kind",
78
+ });
79
+ }
80
+ catch (error) {
81
+ input.signal?.throwIfAborted();
82
+ const code = error &&
83
+ typeof error === "object" &&
84
+ "code" in error &&
85
+ typeof error.code === "string"
86
+ ? error.code
87
+ : "content_unavailable";
88
+ skipped.push({ resource: id, reason: code });
89
+ }
90
+ }
91
+ const nextOffset = offset + limit < descriptors.length ? offset + limit : null;
92
+ return {
93
+ results,
94
+ skipped,
95
+ totalResources: descriptors.length,
96
+ resourcesRevision,
97
+ nextOffset,
98
+ partial: skipped.length > 0 || nextOffset !== null,
99
+ };
100
+ },
101
+ };
102
+ }
@@ -0,0 +1,12 @@
1
+ import { type Transport } from "./client.js";
2
+ import { type JsonObject, type Query } from "./common.js";
3
+ export declare function ownershipApi(t: Transport, namespace: string): {
4
+ resource: (kind: "project" | "source", id: string, action?: "inspect" | "manifest" | "restore" | "transfer-plan") => Promise<unknown>;
5
+ capabilities: () => Promise<unknown>;
6
+ list: (direction?: "incoming" | "outgoing") => Promise<unknown>;
7
+ preview: (input: JsonObject) => Promise<unknown>;
8
+ create: (input: JsonObject) => Promise<unknown>;
9
+ status: (id: string) => Promise<unknown>;
10
+ action: (id: string, action: "accept" | "reject" | "cancel" | "resume" | "restore" | "snapshot-cleanup", input?: JsonObject) => Promise<unknown>;
11
+ inspect: (id: string, suffix: "inspect" | "manifest" | "snapshot" | "progress", query?: Query) => Promise<unknown>;
12
+ };