@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,497 @@
1
+ // The wire contract, checked field by field — and the only shape this CLI ever
2
+ // prints.
3
+ //
4
+ // Two rules, and they are really one rule.
5
+ //
6
+ // Nothing is printed that the contract did not declare. `--json` emits an
7
+ // object BUILT from validated fields, never the response that arrived. A
8
+ // pass-through client forwards whatever it is handed, so a response that one
9
+ // day carried a `credential`, a `secretRef` or a provider account id — a server
10
+ // bug, a middlebox, an endpoint that is not the one the caller thought — would
11
+ // be written straight into the log the caller was piping into. Projecting by
12
+ // name makes that impossible here regardless of what arrives, which is the same
13
+ // discipline the server applies on the way out.
14
+ //
15
+ // Nothing is defaulted. A missing `affectedSourceCount` rendered as `0` reads as
16
+ // "nothing uses this, it is safe to delete". The RFC declares these fields
17
+ // required, so an absent one is a malformed response and is reported as one.
18
+ //
19
+ // The RFC (connection-contract §5, §7) is the authority here, not the server's
20
+ // current JSON schema: several of those response objects do not declare
21
+ // `required` yet — a server gap being closed on its own line — and a client
22
+ // that took the looser schema as the contract would quietly accept a response
23
+ // the contract forbids. Failing closed against the RFC is what keeps this
24
+ // correct across that fix instead of dependent on it.
25
+ import { fail } from "../helpers.js";
26
+ /**
27
+ * §5's three statuses.
28
+ *
29
+ * `unverified` is not a flavour of `unavailable`. §3.1 requires a `target-bound`
30
+ * connector — `s3` is one — to answer it, because that credential cannot be
31
+ * validated without a target, and the bucket belongs to a Source rather than to
32
+ * the Connection. Reporting it as `unavailable` would send a manager to replace
33
+ * a credential nobody found fault with.
34
+ *
35
+ * This client enumerated two statuses for one slice, following §5's DTO before
36
+ * §5 was corrected to match §3.1, and `connection check` failed for every S3
37
+ * Connection as a result. The vocabulary is transcribed from the contract now,
38
+ * whole.
39
+ */
40
+ export const CHECK_STATUSES = ["available", "unavailable", "unverified"];
41
+ export const CHECK_REASONS = [
42
+ "connection-disabled",
43
+ "upstream-auth-failed",
44
+ "upstream-forbidden",
45
+ "upstream-not-found",
46
+ "upstream-rate-limited",
47
+ "upstream-timeout",
48
+ "upstream-unavailable",
49
+ "target-required",
50
+ "unknown",
51
+ ];
52
+ // ─── the checker ──────────────────────────────────────────────────────────────
53
+ export function isObject(v) {
54
+ return typeof v === "object" && v !== null && !Array.isArray(v);
55
+ }
56
+ /**
57
+ * RFC 3339, checked against the calendar — not against `Date.parse`.
58
+ *
59
+ * A pattern alone accepts `2026-02-31` and `2026-01-01T24:00:00Z`, and
60
+ * `Date.parse` does not save it: JavaScript NORMALISES both rather than
61
+ * refusing them, so the check passes and the value that gets rendered is a
62
+ * moment that does not exist, silently moved to March 3rd and to the next day.
63
+ * For an OAuth `expiresAt` that is a deadline the caller is told and cannot
64
+ * rely on. So the fields are extracted and range-checked, February included.
65
+ *
66
+ * RFC 3339's leap second — a literal `:60` — is deliberately NOT accepted. Every
67
+ * timestamp this client reads is produced by `Date#toISOString`, which cannot
68
+ * emit one, and accepting it would mean accepting a value `Date` quietly rolls
69
+ * into the following minute. Revisit if a server ever has a reason to send one.
70
+ */
71
+ const RFC3339 = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:[Zz]|[+-](\d{2}):(\d{2}))$/;
72
+ function daysInMonth(year, month) {
73
+ if (month === 2) {
74
+ const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
75
+ return leap ? 29 : 28;
76
+ }
77
+ return [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
78
+ }
79
+ function isRfc3339(v) {
80
+ const m = RFC3339.exec(v);
81
+ if (!m)
82
+ return false;
83
+ const [year, month, day, hour, minute, second] = m.slice(1, 7).map(Number);
84
+ if (month < 1 || month > 12)
85
+ return false;
86
+ if (day < 1 || day > daysInMonth(year, month))
87
+ return false;
88
+ if (hour > 23 || minute > 59 || second > 59)
89
+ return false;
90
+ if (m[7] !== undefined && (Number(m[7]) > 23 || Number(m[8]) > 59))
91
+ return false;
92
+ return true;
93
+ }
94
+ /**
95
+ * Collects every problem before reporting, rather than stopping at the first.
96
+ *
97
+ * A response that is wrong in four places produces one message naming four
98
+ * fields. Reporting them one at a time turns diagnosing a contract break into
99
+ * four round trips.
100
+ */
101
+ class Fields {
102
+ where;
103
+ o;
104
+ bad = [];
105
+ constructor(where, o) {
106
+ this.where = where;
107
+ this.o = o;
108
+ }
109
+ reject(msg) {
110
+ this.bad.push(msg);
111
+ }
112
+ string(k) {
113
+ const v = this.o[k];
114
+ if (typeof v !== "string" || v === "") {
115
+ this.reject(`${k} must be a non-empty string`);
116
+ return "";
117
+ }
118
+ return v;
119
+ }
120
+ /**
121
+ * An `{id, label}` pair, required whole.
122
+ *
123
+ * Both halves, because half a name is not a name: without `id` there is
124
+ * nothing to match on, and without `label` the row prints blank. The label is
125
+ * judged non-blank on its TRIMMED value but returned as the server sent it —
126
+ * a name made of spaces renders as an empty column, which is
127
+ * indistinguishable from a bug, while trimming it here would make this client
128
+ * the author of a name the server declared.
129
+ */
130
+ named(k) {
131
+ const v = this.o[k];
132
+ if (!isObject(v)) {
133
+ this.reject(`${k} must be an object`);
134
+ return { id: "", label: "" };
135
+ }
136
+ const id = v["id"];
137
+ const label = v["label"];
138
+ if (typeof id !== "string" || id === "") {
139
+ this.reject(`${k}.id must be a non-empty string`);
140
+ }
141
+ if (typeof label !== "string" || label.trim() === "") {
142
+ this.reject(`${k}.label must be a non-blank string`);
143
+ }
144
+ return {
145
+ id: typeof id === "string" ? id : "",
146
+ label: typeof label === "string" ? label : "",
147
+ };
148
+ }
149
+ oneOf(k, allowed) {
150
+ const v = this.o[k];
151
+ if (typeof v !== "string" || !allowed.includes(v)) {
152
+ this.reject(`${k} must be one of: ${allowed.join(", ")}`);
153
+ return allowed[0];
154
+ }
155
+ return v;
156
+ }
157
+ optionalOneOf(k, allowed) {
158
+ if (this.o[k] === undefined)
159
+ return undefined;
160
+ return this.oneOf(k, allowed);
161
+ }
162
+ optionalString(k) {
163
+ const v = this.o[k];
164
+ if (v === undefined)
165
+ return undefined;
166
+ if (typeof v !== "string") {
167
+ this.reject(`${k} must be a string when present`);
168
+ return undefined;
169
+ }
170
+ return v === "" ? undefined : v;
171
+ }
172
+ /** A non-negative safe integer — a count, or a revision about to be CAS. */
173
+ count(k) {
174
+ const v = this.o[k];
175
+ if (typeof v !== "number" || !Number.isSafeInteger(v) || v < 0) {
176
+ this.reject(`${k} must be a non-negative integer`);
177
+ return -1;
178
+ }
179
+ return v;
180
+ }
181
+ bool(k) {
182
+ const v = this.o[k];
183
+ if (typeof v !== "boolean") {
184
+ this.reject(`${k} must be a boolean`);
185
+ return false;
186
+ }
187
+ return v;
188
+ }
189
+ timestamp(k) {
190
+ const v = this.o[k];
191
+ if (typeof v !== "string" || !isRfc3339(v)) {
192
+ this.reject(`${k} must be an RFC 3339 timestamp`);
193
+ return "";
194
+ }
195
+ return v;
196
+ }
197
+ capabilities(k) {
198
+ const v = this.o[k];
199
+ const out = {
200
+ manage: true,
201
+ reconnect: false,
202
+ disable: false,
203
+ enable: false,
204
+ delete: false,
205
+ };
206
+ if (!isObject(v)) {
207
+ this.reject(`${k} must be an object`);
208
+ return out;
209
+ }
210
+ for (const name of ["disable", "enable", "delete"]) {
211
+ const flag = v[name];
212
+ if (typeof flag !== "boolean") {
213
+ this.reject(`${k}.${name} must be a boolean`);
214
+ continue;
215
+ }
216
+ out[name] = flag;
217
+ }
218
+ // `reconnect` is an ordinary boolean: a credential-less Connection has no
219
+ // credential to replace, so `false` is a real answer.
220
+ const reconnect = v["reconnect"];
221
+ if (typeof reconnect !== "boolean") {
222
+ this.reject(`${k}.reconnect must be a boolean`);
223
+ }
224
+ else {
225
+ out.reconnect = reconnect;
226
+ }
227
+ // Not `boolean` — `true`. See the Capabilities doc comment.
228
+ if (v["manage"] !== true) {
229
+ this.reject(`${k}.manage must be true — these DTOs only reach a manager`);
230
+ }
231
+ return out;
232
+ }
233
+ configured(k) {
234
+ const v = this.o[k];
235
+ const out = {};
236
+ if (!isObject(v)) {
237
+ this.reject(`${k} must be an object`);
238
+ return out;
239
+ }
240
+ for (const [name, value] of Object.entries(v)) {
241
+ if (value !== null &&
242
+ typeof value !== "string" &&
243
+ typeof value !== "number" &&
244
+ typeof value !== "boolean") {
245
+ // The masking guarantee, enforced on arrival. Anything structured under
246
+ // this key is not a presence flag.
247
+ this.reject(`${k}.${name} must be a string, number, boolean or null`);
248
+ continue;
249
+ }
250
+ out[name] = value;
251
+ }
252
+ return out;
253
+ }
254
+ /**
255
+ * `nextCursor` — present, and either a cursor or an explicit null.
256
+ *
257
+ * An absent key is not the same as `null`. "There is no next page" is a fact
258
+ * the server states; a missing field means the client is guessing, and the
259
+ * guess ends a paged read early and silently. That is precisely the shape of
260
+ * "this Connection appears to be gone".
261
+ */
262
+ cursor(k) {
263
+ if (!(k in this.o)) {
264
+ this.reject(`${k} must be present — a cursor, or null on the last page`);
265
+ return null;
266
+ }
267
+ const v = this.o[k];
268
+ if (v === null)
269
+ return null;
270
+ if (typeof v !== "string" || v === "") {
271
+ this.reject(`${k} must be a non-empty string or null`);
272
+ return null;
273
+ }
274
+ return v;
275
+ }
276
+ /**
277
+ * `lifecycleCounts` — present, and either three numbers or an explicit null.
278
+ *
279
+ * Absent is not `null` here either. `null` is the server stating it could not
280
+ * count; an absent key would leave this client deciding what to print, and
281
+ * "no numbers" and "an older server" are not the same fact.
282
+ */
283
+ counts(k) {
284
+ if (!(k in this.o)) {
285
+ this.reject(`${k} must be present — three counts, or null when uncounted`);
286
+ return null;
287
+ }
288
+ const v = this.o[k];
289
+ if (v === null)
290
+ return null;
291
+ if (!isObject(v)) {
292
+ this.reject(`${k} must be an object or null`);
293
+ return null;
294
+ }
295
+ const out = { all: -1, active: -1, disabled: -1 };
296
+ let usable = true;
297
+ for (const name of ["all", "active", "disabled"]) {
298
+ const n = v[name];
299
+ if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 0) {
300
+ this.reject(`${k}.${name} must be a non-negative integer`);
301
+ usable = false;
302
+ continue;
303
+ }
304
+ out[name] = n;
305
+ }
306
+ /*
307
+ * `all === active + disabled`, which the contract states as a guarantee
308
+ * rather than a hint — `all` is derived from the other two rather than
309
+ * queried, so a set that violates it did not come from the counting logic
310
+ * working. Refused rather than shown: three numbers that contradict each
311
+ * other are not a degraded answer, they are an answer nobody can act on,
312
+ * and picking which two to believe is not this client's decision.
313
+ */
314
+ if (usable && out.all !== out.active + out.disabled) {
315
+ this.reject(`${k} does not add up: all=${out.all}, active=${out.active}, disabled=${out.disabled}`);
316
+ }
317
+ return out;
318
+ }
319
+ ok() {
320
+ if (this.bad.length === 0)
321
+ return true;
322
+ fail(`${this.where}: ${this.bad.join("; ")}`);
323
+ return false;
324
+ }
325
+ }
326
+ function fields(res, where) {
327
+ if (!isObject(res)) {
328
+ fail(`${where}: expected an object`);
329
+ return null;
330
+ }
331
+ return new Fields(where, res);
332
+ }
333
+ // ─── the projections ──────────────────────────────────────────────────────────
334
+ function summaryOf(f) {
335
+ return {
336
+ id: f.string("id"),
337
+ label: f.string("label"),
338
+ connectorKind: f.string("connectorKind"),
339
+ category: f.string("category"),
340
+ authKind: f.string("authKind"),
341
+ provider: f.named("provider"),
342
+ authentication: f.named("authentication"),
343
+ lifecycle: f.oneOf("lifecycle", ["active", "disabled"]),
344
+ settingsRevision: f.count("settingsRevision"),
345
+ credentialVersion: f.count("credentialVersion"),
346
+ affectedSourceCount: f.count("affectedSourceCount"),
347
+ createdAt: f.timestamp("createdAt"),
348
+ updatedAt: f.timestamp("updatedAt"),
349
+ capabilities: f.capabilities("capabilities"),
350
+ };
351
+ }
352
+ export function parseSummary(res, where) {
353
+ const f = fields(res, where);
354
+ if (!f)
355
+ return null;
356
+ const out = summaryOf(f);
357
+ return f.ok() ? out : null;
358
+ }
359
+ export function parseDetail(res, where) {
360
+ const f = fields(res, where);
361
+ if (!f)
362
+ return null;
363
+ const out = { ...summaryOf(f), configured: f.configured("configured") };
364
+ return f.ok() ? out : null;
365
+ }
366
+ export function parseAffected(res, where) {
367
+ const f = fields(res, where);
368
+ if (!f)
369
+ return null;
370
+ const out = {
371
+ sourceId: f.string("sourceId"),
372
+ name: f.string("name"),
373
+ lifecycle: f.string("lifecycle"),
374
+ };
375
+ return f.ok() ? out : null;
376
+ }
377
+ /**
378
+ * A page.
379
+ *
380
+ * `withCounts` is passed only where the contract declares `lifecycleCounts` —
381
+ * the Connection list has it, affected-sources does not — so asking for it is
382
+ * never a guess about which endpoint this is.
383
+ */
384
+ export function parsePage(res, where, item, withCounts = false) {
385
+ const f = fields(res, where);
386
+ if (!f)
387
+ return null;
388
+ const raw = res.items;
389
+ if (!Array.isArray(raw)) {
390
+ fail(`${where}: items must be an array`);
391
+ return null;
392
+ }
393
+ const nextCursor = f.cursor("nextCursor");
394
+ const lifecycleCounts = withCounts ? f.counts("lifecycleCounts") : undefined;
395
+ if (!f.ok())
396
+ return null;
397
+ const items = [];
398
+ for (const one of raw) {
399
+ const parsed = item(one, where);
400
+ if (!parsed)
401
+ return null;
402
+ items.push(parsed);
403
+ }
404
+ return withCounts ? { items, nextCursor, lifecycleCounts } : { items, nextCursor };
405
+ }
406
+ export function parseCheck(res, where) {
407
+ const f = fields(res, where);
408
+ if (!f)
409
+ return null;
410
+ const out = {
411
+ status: f.oneOf("status", CHECK_STATUSES),
412
+ detectedAccess: f.optionalOneOf("detectedAccess", ["read", "read-write", "unknown"]),
413
+ reason: f.optionalOneOf("reason", CHECK_REASONS),
414
+ retryable: f.bool("retryable"),
415
+ checkedAt: f.timestamp("checkedAt"),
416
+ managementHint: f.optionalString("managementHint"),
417
+ };
418
+ return f.ok() ? out : null;
419
+ }
420
+ export function parseBegin(res, where) {
421
+ const f = fields(res, where);
422
+ if (!f)
423
+ return null;
424
+ const out = {
425
+ operationId: f.string("operationId"),
426
+ authorizationUrl: f.string("authorizationUrl"),
427
+ expiresAt: f.timestamp("expiresAt"),
428
+ };
429
+ if (!f.ok())
430
+ return null;
431
+ /*
432
+ * The URL is built by the server's adapter from the connector descriptor's
433
+ * declared endpoint, never from request input — but this process is about to
434
+ * hand it to a browser, so the one property that matters here is checked, and
435
+ * checked by parsing rather than by prefix. `startsWith("https://")` is a
436
+ * string test standing in for a scheme test, and it is wrong in both
437
+ * directions: it accepts the bare `"https://"`, which has no host and is not
438
+ * a URL at all, and it rejects `HTTPS://…`, which is the same URL with the
439
+ * scheme spelled in capitals. Parsing asks the question the browser will
440
+ * ask. A downgrade would put the authorization request, and the state token
441
+ * in its query string, on the wire in the clear.
442
+ */
443
+ let parsed;
444
+ try {
445
+ parsed = new URL(out.authorizationUrl);
446
+ }
447
+ catch {
448
+ fail(`${where}: authorizationUrl is not a URL`);
449
+ return null;
450
+ }
451
+ if (parsed.protocol !== "https:") {
452
+ fail(`${where}: authorizationUrl must be https, got ${parsed.protocol}//`);
453
+ return null;
454
+ }
455
+ return out;
456
+ }
457
+ /**
458
+ * The operation union, with the invariant enforced at the edge.
459
+ *
460
+ * `succeeded` implies a Connection and `failed` implies an error. Checking that
461
+ * here — rather than in whichever branch happens to render — is what stops a
462
+ * `--json` consumer from being handed `{"state":"succeeded"}` with nothing in
463
+ * it, which is what a silently dropped `connection` looks like on the wire.
464
+ *
465
+ * The failure `code` is NOT checked against a list of known codes. A code this
466
+ * build has never heard of is still the server's stable identity for what went
467
+ * wrong, and refusing to print it would turn a new server-side failure into a
468
+ * client-side one.
469
+ */
470
+ export function parseOAuthStatus(res, where) {
471
+ const f = fields(res, where);
472
+ if (!f)
473
+ return null;
474
+ const state = f.oneOf("state", ["pending", "exchanging", "succeeded", "failed"]);
475
+ if (!f.ok())
476
+ return null;
477
+ const o = res;
478
+ if (state === "succeeded") {
479
+ const connection = parseDetail(o.connection, `${where}: connection`);
480
+ if (!connection)
481
+ return null;
482
+ return { state, connection };
483
+ }
484
+ if (state === "failed") {
485
+ const e = fields(o.error, `${where}: error`);
486
+ if (!e)
487
+ return null;
488
+ const error = {
489
+ code: e.string("code"),
490
+ message: e.string("message"),
491
+ retryable: e.bool("retryable"),
492
+ requestId: e.string("requestId"),
493
+ };
494
+ return e.ok() ? { state, error } : null;
495
+ }
496
+ return { state };
497
+ }
@@ -0,0 +1,50 @@
1
+ import type { Command } from "commander";
2
+ import { type ConnectionDetail } from "./dto.js";
3
+ export declare function ctx(nsFlag?: string): Promise<{
4
+ token: string;
5
+ remote: string;
6
+ ns: string;
7
+ } | null>;
8
+ export type Ctx = NonNullable<Awaited<ReturnType<typeof ctx>>>;
9
+ /**
10
+ * One path segment, encoded as one path segment.
11
+ *
12
+ * Ids are ObjectId hex and namespace slugs are constrained, but both arrive
13
+ * here from a command line, and a `/` or a `?` in either would not be a bad
14
+ * argument — it would be a DIFFERENT request. `show 'x/../../other/connections/y'`
15
+ * interpolated raw is a read of another namespace's object wearing a typo's
16
+ * clothes. Encoding is what keeps a malformed argument a 404.
17
+ */
18
+ export declare function seg(v: string): string;
19
+ export declare function connectionPath(c: Ctx, id: string): string;
20
+ /**
21
+ * Every route in this module is credential-manager only, so a 403 here means
22
+ * something different from a 403 on the Source read plane — telling the caller
23
+ * they "need read access" would send them to ask for a permission that would
24
+ * not help. The server's own typed message is more specific than anything this
25
+ * layer could invent, so only 401 and 404 are rewritten.
26
+ */
27
+ export declare function explain(err: unknown): string;
28
+ /** Commander's default is to ignore extra positional arguments. */
29
+ export declare function strictArgs(cmd: Command): Command;
30
+ export declare function runConnectionList(opts: {
31
+ namespace?: string;
32
+ limit?: string;
33
+ cursor?: string;
34
+ labelContains?: string;
35
+ lifecycle?: string;
36
+ json?: boolean;
37
+ }): Promise<number>;
38
+ /** Fetch one Connection. Shared with every command that needs its revision. */
39
+ export declare function fetchConnection(c: Ctx, id: string): Promise<ConnectionDetail | null>;
40
+ export declare function runConnectionShow(id: string, opts: {
41
+ namespace?: string;
42
+ json?: boolean;
43
+ }): Promise<number>;
44
+ export declare function runConnectionAffected(id: string, opts: {
45
+ namespace?: string;
46
+ limit?: string;
47
+ cursor?: string;
48
+ json?: boolean;
49
+ }): Promise<number>;
50
+ export declare function registerConnectionCommand(program: Command): void;