@knowzai/cli 0.1.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 (578) hide show
  1. package/LICENSE +21 -0
  2. package/assets/portable/.env.example +250 -0
  3. package/assets/portable/docker-compose.yml +444 -0
  4. package/assets/portable/postgres-initdb/00-databases-and-extensions.sql +16 -0
  5. package/assets/portable/releases.json +37 -0
  6. package/assets/portable/runtime-contract.json +149 -0
  7. package/bin/run.js +4 -0
  8. package/dist/.tsbuildinfo +1 -0
  9. package/dist/base-command.d.ts +47 -0
  10. package/dist/base-command.d.ts.map +1 -0
  11. package/dist/base-command.js +98 -0
  12. package/dist/base-command.js.map +1 -0
  13. package/dist/commands/activate.d.ts +39 -0
  14. package/dist/commands/activate.d.ts.map +1 -0
  15. package/dist/commands/activate.js +103 -0
  16. package/dist/commands/activate.js.map +1 -0
  17. package/dist/commands/ask.d.ts +14 -0
  18. package/dist/commands/ask.d.ts.map +1 -0
  19. package/dist/commands/ask.js +33 -0
  20. package/dist/commands/ask.js.map +1 -0
  21. package/dist/commands/auth/status.d.ts +7 -0
  22. package/dist/commands/auth/status.d.ts.map +1 -0
  23. package/dist/commands/auth/status.js +26 -0
  24. package/dist/commands/auth/status.js.map +1 -0
  25. package/dist/commands/backup.d.ts +15 -0
  26. package/dist/commands/backup.d.ts.map +1 -0
  27. package/dist/commands/backup.js +52 -0
  28. package/dist/commands/backup.js.map +1 -0
  29. package/dist/commands/capture/observe.d.ts +23 -0
  30. package/dist/commands/capture/observe.d.ts.map +1 -0
  31. package/dist/commands/capture/observe.js +68 -0
  32. package/dist/commands/capture/observe.js.map +1 -0
  33. package/dist/commands/capture/seal.d.ts +27 -0
  34. package/dist/commands/capture/seal.d.ts.map +1 -0
  35. package/dist/commands/capture/seal.js +144 -0
  36. package/dist/commands/capture/seal.js.map +1 -0
  37. package/dist/commands/capture/status.d.ts +33 -0
  38. package/dist/commands/capture/status.d.ts.map +1 -0
  39. package/dist/commands/capture/status.js +52 -0
  40. package/dist/commands/capture/status.js.map +1 -0
  41. package/dist/commands/chat.d.ts +21 -0
  42. package/dist/commands/chat.d.ts.map +1 -0
  43. package/dist/commands/chat.js +142 -0
  44. package/dist/commands/chat.js.map +1 -0
  45. package/dist/commands/cmek/decrypt.d.ts +13 -0
  46. package/dist/commands/cmek/decrypt.d.ts.map +1 -0
  47. package/dist/commands/cmek/decrypt.js +25 -0
  48. package/dist/commands/cmek/decrypt.js.map +1 -0
  49. package/dist/commands/cmek/encrypt.d.ts +15 -0
  50. package/dist/commands/cmek/encrypt.d.ts.map +1 -0
  51. package/dist/commands/cmek/encrypt.js +26 -0
  52. package/dist/commands/cmek/encrypt.js.map +1 -0
  53. package/dist/commands/cmek/init.d.ts +13 -0
  54. package/dist/commands/cmek/init.d.ts.map +1 -0
  55. package/dist/commands/cmek/init.js +27 -0
  56. package/dist/commands/cmek/init.js.map +1 -0
  57. package/dist/commands/cmek/status.d.ts +11 -0
  58. package/dist/commands/cmek/status.d.ts.map +1 -0
  59. package/dist/commands/cmek/status.js +23 -0
  60. package/dist/commands/cmek/status.js.map +1 -0
  61. package/dist/commands/completion.d.ts +13 -0
  62. package/dist/commands/completion.d.ts.map +1 -0
  63. package/dist/commands/completion.js +19 -0
  64. package/dist/commands/completion.js.map +1 -0
  65. package/dist/commands/config/get.d.ts +13 -0
  66. package/dist/commands/config/get.d.ts.map +1 -0
  67. package/dist/commands/config/get.js +28 -0
  68. package/dist/commands/config/get.js.map +1 -0
  69. package/dist/commands/config/list.d.ts +7 -0
  70. package/dist/commands/config/list.d.ts.map +1 -0
  71. package/dist/commands/config/list.js +28 -0
  72. package/dist/commands/config/list.js.map +1 -0
  73. package/dist/commands/config/path.d.ts +9 -0
  74. package/dist/commands/config/path.d.ts.map +1 -0
  75. package/dist/commands/config/path.js +15 -0
  76. package/dist/commands/config/path.js.map +1 -0
  77. package/dist/commands/config/set.d.ts +16 -0
  78. package/dist/commands/config/set.d.ts.map +1 -0
  79. package/dist/commands/config/set.js +36 -0
  80. package/dist/commands/config/set.js.map +1 -0
  81. package/dist/commands/doctor.d.ts +56 -0
  82. package/dist/commands/doctor.d.ts.map +1 -0
  83. package/dist/commands/doctor.js +151 -0
  84. package/dist/commands/doctor.js.map +1 -0
  85. package/dist/commands/down.d.ts +30 -0
  86. package/dist/commands/down.d.ts.map +1 -0
  87. package/dist/commands/down.js +20 -0
  88. package/dist/commands/down.js.map +1 -0
  89. package/dist/commands/entities/find.d.ts +16 -0
  90. package/dist/commands/entities/find.d.ts.map +1 -0
  91. package/dist/commands/entities/find.js +27 -0
  92. package/dist/commands/entities/find.js.map +1 -0
  93. package/dist/commands/hooks/install.d.ts +19 -0
  94. package/dist/commands/hooks/install.d.ts.map +1 -0
  95. package/dist/commands/hooks/install.js +53 -0
  96. package/dist/commands/hooks/install.js.map +1 -0
  97. package/dist/commands/index/graph.d.ts +11 -0
  98. package/dist/commands/index/graph.d.ts.map +1 -0
  99. package/dist/commands/index/graph.js +31 -0
  100. package/dist/commands/index/graph.js.map +1 -0
  101. package/dist/commands/index/scan.d.ts +22 -0
  102. package/dist/commands/index/scan.d.ts.map +1 -0
  103. package/dist/commands/index/scan.js +48 -0
  104. package/dist/commands/index/scan.js.map +1 -0
  105. package/dist/commands/index/search.d.ts +18 -0
  106. package/dist/commands/index/search.d.ts.map +1 -0
  107. package/dist/commands/index/search.js +40 -0
  108. package/dist/commands/index/search.js.map +1 -0
  109. package/dist/commands/ingest/add.d.ts +15 -0
  110. package/dist/commands/ingest/add.d.ts.map +1 -0
  111. package/dist/commands/ingest/add.js +50 -0
  112. package/dist/commands/ingest/add.js.map +1 -0
  113. package/dist/commands/knowledge/amend.d.ts +19 -0
  114. package/dist/commands/knowledge/amend.d.ts.map +1 -0
  115. package/dist/commands/knowledge/amend.js +27 -0
  116. package/dist/commands/knowledge/amend.js.map +1 -0
  117. package/dist/commands/knowledge/comment.d.ts +16 -0
  118. package/dist/commands/knowledge/comment.d.ts.map +1 -0
  119. package/dist/commands/knowledge/comment.js +27 -0
  120. package/dist/commands/knowledge/comment.js.map +1 -0
  121. package/dist/commands/knowledge/comments.d.ts +11 -0
  122. package/dist/commands/knowledge/comments.d.ts.map +1 -0
  123. package/dist/commands/knowledge/comments.js +20 -0
  124. package/dist/commands/knowledge/comments.js.map +1 -0
  125. package/dist/commands/knowledge/create.d.ts +18 -0
  126. package/dist/commands/knowledge/create.d.ts.map +1 -0
  127. package/dist/commands/knowledge/create.js +45 -0
  128. package/dist/commands/knowledge/create.js.map +1 -0
  129. package/dist/commands/knowledge/delete.d.ts +14 -0
  130. package/dist/commands/knowledge/delete.d.ts.map +1 -0
  131. package/dist/commands/knowledge/delete.js +30 -0
  132. package/dist/commands/knowledge/delete.js.map +1 -0
  133. package/dist/commands/knowledge/get.d.ts +13 -0
  134. package/dist/commands/knowledge/get.d.ts.map +1 -0
  135. package/dist/commands/knowledge/get.js +20 -0
  136. package/dist/commands/knowledge/get.js.map +1 -0
  137. package/dist/commands/knowledge/list.d.ts +13 -0
  138. package/dist/commands/knowledge/list.d.ts.map +1 -0
  139. package/dist/commands/knowledge/list.js +31 -0
  140. package/dist/commands/knowledge/list.js.map +1 -0
  141. package/dist/commands/knowledge/status.d.ts +11 -0
  142. package/dist/commands/knowledge/status.d.ts.map +1 -0
  143. package/dist/commands/knowledge/status.js +23 -0
  144. package/dist/commands/knowledge/status.js.map +1 -0
  145. package/dist/commands/knowledge/update.d.ts +16 -0
  146. package/dist/commands/knowledge/update.d.ts.map +1 -0
  147. package/dist/commands/knowledge/update.js +32 -0
  148. package/dist/commands/knowledge/update.js.map +1 -0
  149. package/dist/commands/knowledge/versions.d.ts +11 -0
  150. package/dist/commands/knowledge/versions.d.ts.map +1 -0
  151. package/dist/commands/knowledge/versions.js +22 -0
  152. package/dist/commands/knowledge/versions.js.map +1 -0
  153. package/dist/commands/local/info.d.ts +17 -0
  154. package/dist/commands/local/info.d.ts.map +1 -0
  155. package/dist/commands/local/info.js +26 -0
  156. package/dist/commands/local/info.js.map +1 -0
  157. package/dist/commands/local/init.d.ts +16 -0
  158. package/dist/commands/local/init.d.ts.map +1 -0
  159. package/dist/commands/local/init.js +31 -0
  160. package/dist/commands/local/init.js.map +1 -0
  161. package/dist/commands/local/list.d.ts +13 -0
  162. package/dist/commands/local/list.d.ts.map +1 -0
  163. package/dist/commands/local/list.js +29 -0
  164. package/dist/commands/local/list.js.map +1 -0
  165. package/dist/commands/local/reset.d.ts +12 -0
  166. package/dist/commands/local/reset.d.ts.map +1 -0
  167. package/dist/commands/local/reset.js +34 -0
  168. package/dist/commands/local/reset.js.map +1 -0
  169. package/dist/commands/local/show.d.ts +15 -0
  170. package/dist/commands/local/show.d.ts.map +1 -0
  171. package/dist/commands/local/show.js +33 -0
  172. package/dist/commands/local/show.js.map +1 -0
  173. package/dist/commands/login.d.ts +23 -0
  174. package/dist/commands/login.d.ts.map +1 -0
  175. package/dist/commands/login.js +139 -0
  176. package/dist/commands/login.js.map +1 -0
  177. package/dist/commands/logout.d.ts +11 -0
  178. package/dist/commands/logout.d.ts.map +1 -0
  179. package/dist/commands/logout.js +23 -0
  180. package/dist/commands/logout.js.map +1 -0
  181. package/dist/commands/menu.d.ts +10 -0
  182. package/dist/commands/menu.d.ts.map +1 -0
  183. package/dist/commands/menu.js +50 -0
  184. package/dist/commands/menu.js.map +1 -0
  185. package/dist/commands/pg/destroy.d.ts +13 -0
  186. package/dist/commands/pg/destroy.d.ts.map +1 -0
  187. package/dist/commands/pg/destroy.js +36 -0
  188. package/dist/commands/pg/destroy.js.map +1 -0
  189. package/dist/commands/pg/down.d.ts +12 -0
  190. package/dist/commands/pg/down.d.ts.map +1 -0
  191. package/dist/commands/pg/down.js +20 -0
  192. package/dist/commands/pg/down.js.map +1 -0
  193. package/dist/commands/pg/status.d.ts +13 -0
  194. package/dist/commands/pg/status.d.ts.map +1 -0
  195. package/dist/commands/pg/status.js +28 -0
  196. package/dist/commands/pg/status.js.map +1 -0
  197. package/dist/commands/pg/up.d.ts +13 -0
  198. package/dist/commands/pg/up.d.ts.map +1 -0
  199. package/dist/commands/pg/up.js +34 -0
  200. package/dist/commands/pg/up.js.map +1 -0
  201. package/dist/commands/platform/destroy.d.ts +18 -0
  202. package/dist/commands/platform/destroy.d.ts.map +1 -0
  203. package/dist/commands/platform/destroy.js +41 -0
  204. package/dist/commands/platform/destroy.js.map +1 -0
  205. package/dist/commands/platform/doctor.d.ts +11 -0
  206. package/dist/commands/platform/doctor.d.ts.map +1 -0
  207. package/dist/commands/platform/doctor.js +18 -0
  208. package/dist/commands/platform/doctor.js.map +1 -0
  209. package/dist/commands/platform/down.d.ts +26 -0
  210. package/dist/commands/platform/down.d.ts.map +1 -0
  211. package/dist/commands/platform/down.js +16 -0
  212. package/dist/commands/platform/down.js.map +1 -0
  213. package/dist/commands/platform/logs.d.ts +26 -0
  214. package/dist/commands/platform/logs.d.ts.map +1 -0
  215. package/dist/commands/platform/logs.js +24 -0
  216. package/dist/commands/platform/logs.js.map +1 -0
  217. package/dist/commands/platform/reset.d.ts +26 -0
  218. package/dist/commands/platform/reset.d.ts.map +1 -0
  219. package/dist/commands/platform/reset.js +49 -0
  220. package/dist/commands/platform/reset.js.map +1 -0
  221. package/dist/commands/platform/setup.d.ts +24 -0
  222. package/dist/commands/platform/setup.d.ts.map +1 -0
  223. package/dist/commands/platform/setup.js +21 -0
  224. package/dist/commands/platform/setup.js.map +1 -0
  225. package/dist/commands/platform/status.d.ts +28 -0
  226. package/dist/commands/platform/status.d.ts.map +1 -0
  227. package/dist/commands/platform/status.js +37 -0
  228. package/dist/commands/platform/status.js.map +1 -0
  229. package/dist/commands/platform/up.d.ts +42 -0
  230. package/dist/commands/platform/up.d.ts.map +1 -0
  231. package/dist/commands/platform/up.js +22 -0
  232. package/dist/commands/platform/up.js.map +1 -0
  233. package/dist/commands/platform/upgrade.d.ts +14 -0
  234. package/dist/commands/platform/upgrade.d.ts.map +1 -0
  235. package/dist/commands/platform/upgrade.js +22 -0
  236. package/dist/commands/platform/upgrade.js.map +1 -0
  237. package/dist/commands/profile/add.d.ts +18 -0
  238. package/dist/commands/profile/add.d.ts.map +1 -0
  239. package/dist/commands/profile/add.js +26 -0
  240. package/dist/commands/profile/add.js.map +1 -0
  241. package/dist/commands/profile/list.d.ts +10 -0
  242. package/dist/commands/profile/list.d.ts.map +1 -0
  243. package/dist/commands/profile/list.js +20 -0
  244. package/dist/commands/profile/list.js.map +1 -0
  245. package/dist/commands/profile/remove.d.ts +15 -0
  246. package/dist/commands/profile/remove.d.ts.map +1 -0
  247. package/dist/commands/profile/remove.js +19 -0
  248. package/dist/commands/profile/remove.js.map +1 -0
  249. package/dist/commands/profile/use.d.ts +12 -0
  250. package/dist/commands/profile/use.d.ts.map +1 -0
  251. package/dist/commands/profile/use.js +18 -0
  252. package/dist/commands/profile/use.js.map +1 -0
  253. package/dist/commands/recall.d.ts +29 -0
  254. package/dist/commands/recall.d.ts.map +1 -0
  255. package/dist/commands/recall.js +94 -0
  256. package/dist/commands/recall.js.map +1 -0
  257. package/dist/commands/repo/context.d.ts +24 -0
  258. package/dist/commands/repo/context.d.ts.map +1 -0
  259. package/dist/commands/repo/context.js +52 -0
  260. package/dist/commands/repo/context.js.map +1 -0
  261. package/dist/commands/repo/graph.d.ts +24 -0
  262. package/dist/commands/repo/graph.d.ts.map +1 -0
  263. package/dist/commands/repo/graph.js +72 -0
  264. package/dist/commands/repo/graph.js.map +1 -0
  265. package/dist/commands/repo/index/index.d.ts +28 -0
  266. package/dist/commands/repo/index/index.d.ts.map +1 -0
  267. package/dist/commands/repo/index/index.js +76 -0
  268. package/dist/commands/repo/index/index.js.map +1 -0
  269. package/dist/commands/repo/search.d.ts +22 -0
  270. package/dist/commands/repo/search.d.ts.map +1 -0
  271. package/dist/commands/repo/search.js +50 -0
  272. package/dist/commands/repo/search.js.map +1 -0
  273. package/dist/commands/repo/setup.d.ts +41 -0
  274. package/dist/commands/repo/setup.d.ts.map +1 -0
  275. package/dist/commands/repo/setup.js +144 -0
  276. package/dist/commands/repo/setup.js.map +1 -0
  277. package/dist/commands/repo/status.d.ts +31 -0
  278. package/dist/commands/repo/status.d.ts.map +1 -0
  279. package/dist/commands/repo/status.js +60 -0
  280. package/dist/commands/repo/status.js.map +1 -0
  281. package/dist/commands/restore.d.ts +16 -0
  282. package/dist/commands/restore.d.ts.map +1 -0
  283. package/dist/commands/restore.js +53 -0
  284. package/dist/commands/restore.js.map +1 -0
  285. package/dist/commands/search.d.ts +14 -0
  286. package/dist/commands/search.d.ts.map +1 -0
  287. package/dist/commands/search.js +32 -0
  288. package/dist/commands/search.js.map +1 -0
  289. package/dist/commands/setup.d.ts +24 -0
  290. package/dist/commands/setup.d.ts.map +1 -0
  291. package/dist/commands/setup.js +21 -0
  292. package/dist/commands/setup.js.map +1 -0
  293. package/dist/commands/stats.d.ts +6 -0
  294. package/dist/commands/stats.d.ts.map +1 -0
  295. package/dist/commands/stats.js +16 -0
  296. package/dist/commands/stats.js.map +1 -0
  297. package/dist/commands/status.d.ts +20 -0
  298. package/dist/commands/status.d.ts.map +1 -0
  299. package/dist/commands/status.js +33 -0
  300. package/dist/commands/status.js.map +1 -0
  301. package/dist/commands/sync/conflicts.d.ts +14 -0
  302. package/dist/commands/sync/conflicts.d.ts.map +1 -0
  303. package/dist/commands/sync/conflicts.js +23 -0
  304. package/dist/commands/sync/conflicts.js.map +1 -0
  305. package/dist/commands/sync/pull.d.ts +13 -0
  306. package/dist/commands/sync/pull.d.ts.map +1 -0
  307. package/dist/commands/sync/pull.js +26 -0
  308. package/dist/commands/sync/pull.js.map +1 -0
  309. package/dist/commands/sync/push.d.ts +13 -0
  310. package/dist/commands/sync/push.d.ts.map +1 -0
  311. package/dist/commands/sync/push.js +26 -0
  312. package/dist/commands/sync/push.js.map +1 -0
  313. package/dist/commands/sync/recover.d.ts +16 -0
  314. package/dist/commands/sync/recover.d.ts.map +1 -0
  315. package/dist/commands/sync/recover.js +29 -0
  316. package/dist/commands/sync/recover.js.map +1 -0
  317. package/dist/commands/sync/resolve.d.ts +21 -0
  318. package/dist/commands/sync/resolve.d.ts.map +1 -0
  319. package/dist/commands/sync/resolve.js +38 -0
  320. package/dist/commands/sync/resolve.js.map +1 -0
  321. package/dist/commands/sync/run.d.ts +13 -0
  322. package/dist/commands/sync/run.d.ts.map +1 -0
  323. package/dist/commands/sync/run.js +26 -0
  324. package/dist/commands/sync/run.js.map +1 -0
  325. package/dist/commands/sync/status.d.ts +13 -0
  326. package/dist/commands/sync/status.d.ts.map +1 -0
  327. package/dist/commands/sync/status.js +28 -0
  328. package/dist/commands/sync/status.js.map +1 -0
  329. package/dist/commands/topics/list.d.ts +11 -0
  330. package/dist/commands/topics/list.d.ts.map +1 -0
  331. package/dist/commands/topics/list.js +20 -0
  332. package/dist/commands/topics/list.js.map +1 -0
  333. package/dist/commands/tui.d.ts +10 -0
  334. package/dist/commands/tui.d.ts.map +1 -0
  335. package/dist/commands/tui.js +124 -0
  336. package/dist/commands/tui.js.map +1 -0
  337. package/dist/commands/up.d.ts +108 -0
  338. package/dist/commands/up.d.ts.map +1 -0
  339. package/dist/commands/up.js +210 -0
  340. package/dist/commands/up.js.map +1 -0
  341. package/dist/commands/vault/contents.d.ts +14 -0
  342. package/dist/commands/vault/contents.d.ts.map +1 -0
  343. package/dist/commands/vault/contents.js +24 -0
  344. package/dist/commands/vault/contents.js.map +1 -0
  345. package/dist/commands/vault/create.d.ts +15 -0
  346. package/dist/commands/vault/create.d.ts.map +1 -0
  347. package/dist/commands/vault/create.js +26 -0
  348. package/dist/commands/vault/create.js.map +1 -0
  349. package/dist/commands/vault/get.d.ts +10 -0
  350. package/dist/commands/vault/get.d.ts.map +1 -0
  351. package/dist/commands/vault/get.js +25 -0
  352. package/dist/commands/vault/get.js.map +1 -0
  353. package/dist/commands/vault/list.d.ts +7 -0
  354. package/dist/commands/vault/list.d.ts.map +1 -0
  355. package/dist/commands/vault/list.js +17 -0
  356. package/dist/commands/vault/list.js.map +1 -0
  357. package/dist/commands/web.d.ts +14 -0
  358. package/dist/commands/web.d.ts.map +1 -0
  359. package/dist/commands/web.js +50 -0
  360. package/dist/commands/web.js.map +1 -0
  361. package/dist/commands/whoami.d.ts +7 -0
  362. package/dist/commands/whoami.d.ts.map +1 -0
  363. package/dist/commands/whoami.js +24 -0
  364. package/dist/commands/whoami.js.map +1 -0
  365. package/dist/hooks/init/launch-menu.d.ts +10 -0
  366. package/dist/hooks/init/launch-menu.d.ts.map +1 -0
  367. package/dist/hooks/init/launch-menu.js +11 -0
  368. package/dist/hooks/init/launch-menu.js.map +1 -0
  369. package/dist/lib/activate.d.ts +92 -0
  370. package/dist/lib/activate.d.ts.map +1 -0
  371. package/dist/lib/activate.js +292 -0
  372. package/dist/lib/activate.js.map +1 -0
  373. package/dist/lib/browser.d.ts +30 -0
  374. package/dist/lib/browser.d.ts.map +1 -0
  375. package/dist/lib/browser.js +45 -0
  376. package/dist/lib/browser.js.map +1 -0
  377. package/dist/lib/chat.d.ts +41 -0
  378. package/dist/lib/chat.d.ts.map +1 -0
  379. package/dist/lib/chat.js +63 -0
  380. package/dist/lib/chat.js.map +1 -0
  381. package/dist/lib/claude-hooks.d.ts +34 -0
  382. package/dist/lib/claude-hooks.d.ts.map +1 -0
  383. package/dist/lib/claude-hooks.js +85 -0
  384. package/dist/lib/claude-hooks.js.map +1 -0
  385. package/dist/lib/completion.d.ts +9 -0
  386. package/dist/lib/completion.d.ts.map +1 -0
  387. package/dist/lib/completion.js +57 -0
  388. package/dist/lib/completion.js.map +1 -0
  389. package/dist/lib/container-engine.d.ts +45 -0
  390. package/dist/lib/container-engine.d.ts.map +1 -0
  391. package/dist/lib/container-engine.js +348 -0
  392. package/dist/lib/container-engine.js.map +1 -0
  393. package/dist/lib/content.d.ts +9 -0
  394. package/dist/lib/content.d.ts.map +1 -0
  395. package/dist/lib/content.js +20 -0
  396. package/dist/lib/content.js.map +1 -0
  397. package/dist/lib/doctor-fixture.d.ts +8 -0
  398. package/dist/lib/doctor-fixture.d.ts.map +1 -0
  399. package/dist/lib/doctor-fixture.js +50 -0
  400. package/dist/lib/doctor-fixture.js.map +1 -0
  401. package/dist/lib/embedding-guard.d.ts +34 -0
  402. package/dist/lib/embedding-guard.d.ts.map +1 -0
  403. package/dist/lib/embedding-guard.js +50 -0
  404. package/dist/lib/embedding-guard.js.map +1 -0
  405. package/dist/lib/hook-io.d.ts +24 -0
  406. package/dist/lib/hook-io.d.ts.map +1 -0
  407. package/dist/lib/hook-io.js +73 -0
  408. package/dist/lib/hook-io.js.map +1 -0
  409. package/dist/lib/ingest.d.ts +24 -0
  410. package/dist/lib/ingest.d.ts.map +1 -0
  411. package/dist/lib/ingest.js +44 -0
  412. package/dist/lib/ingest.js.map +1 -0
  413. package/dist/lib/login.d.ts +40 -0
  414. package/dist/lib/login.d.ts.map +1 -0
  415. package/dist/lib/login.js +56 -0
  416. package/dist/lib/login.js.map +1 -0
  417. package/dist/lib/pending-captures.d.ts +25 -0
  418. package/dist/lib/pending-captures.d.ts.map +1 -0
  419. package/dist/lib/pending-captures.js +143 -0
  420. package/dist/lib/pending-captures.js.map +1 -0
  421. package/dist/lib/platform-backup.d.ts +110 -0
  422. package/dist/lib/platform-backup.d.ts.map +1 -0
  423. package/dist/lib/platform-backup.js +579 -0
  424. package/dist/lib/platform-backup.js.map +1 -0
  425. package/dist/lib/platform-command-shared.d.ts +132 -0
  426. package/dist/lib/platform-command-shared.d.ts.map +1 -0
  427. package/dist/lib/platform-command-shared.js +159 -0
  428. package/dist/lib/platform-command-shared.js.map +1 -0
  429. package/dist/lib/platform-frontdoor-runtime.d.ts +33 -0
  430. package/dist/lib/platform-frontdoor-runtime.d.ts.map +1 -0
  431. package/dist/lib/platform-frontdoor-runtime.js +285 -0
  432. package/dist/lib/platform-frontdoor-runtime.js.map +1 -0
  433. package/dist/lib/platform-frontdoor.d.ts +155 -0
  434. package/dist/lib/platform-frontdoor.d.ts.map +1 -0
  435. package/dist/lib/platform-frontdoor.js +467 -0
  436. package/dist/lib/platform-frontdoor.js.map +1 -0
  437. package/dist/lib/platform-image-source.d.ts +81 -0
  438. package/dist/lib/platform-image-source.d.ts.map +1 -0
  439. package/dist/lib/platform-image-source.js +143 -0
  440. package/dist/lib/platform-image-source.js.map +1 -0
  441. package/dist/lib/platform-lifecycle.d.ts +112 -0
  442. package/dist/lib/platform-lifecycle.d.ts.map +1 -0
  443. package/dist/lib/platform-lifecycle.js +725 -0
  444. package/dist/lib/platform-lifecycle.js.map +1 -0
  445. package/dist/lib/platform-onboarding.d.ts +128 -0
  446. package/dist/lib/platform-onboarding.d.ts.map +1 -0
  447. package/dist/lib/platform-onboarding.js +227 -0
  448. package/dist/lib/platform-onboarding.js.map +1 -0
  449. package/dist/lib/platform-preflight.d.ts +48 -0
  450. package/dist/lib/platform-preflight.d.ts.map +1 -0
  451. package/dist/lib/platform-preflight.js +90 -0
  452. package/dist/lib/platform-preflight.js.map +1 -0
  453. package/dist/lib/platform-profile-purge.d.ts +18 -0
  454. package/dist/lib/platform-profile-purge.d.ts.map +1 -0
  455. package/dist/lib/platform-profile-purge.js +26 -0
  456. package/dist/lib/platform-profile-purge.js.map +1 -0
  457. package/dist/lib/platform-provider-fields.d.ts +2 -0
  458. package/dist/lib/platform-provider-fields.d.ts.map +1 -0
  459. package/dist/lib/platform-provider-fields.js +2 -0
  460. package/dist/lib/platform-provider-fields.js.map +1 -0
  461. package/dist/lib/platform-provider-probe.d.ts +75 -0
  462. package/dist/lib/platform-provider-probe.d.ts.map +1 -0
  463. package/dist/lib/platform-provider-probe.js +781 -0
  464. package/dist/lib/platform-provider-probe.js.map +1 -0
  465. package/dist/lib/platform-provider-prompt.d.ts +118 -0
  466. package/dist/lib/platform-provider-prompt.d.ts.map +1 -0
  467. package/dist/lib/platform-provider-prompt.js +245 -0
  468. package/dist/lib/platform-provider-prompt.js.map +1 -0
  469. package/dist/lib/platform-release-manifest.d.ts +34 -0
  470. package/dist/lib/platform-release-manifest.d.ts.map +1 -0
  471. package/dist/lib/platform-release-manifest.js +100 -0
  472. package/dist/lib/platform-release-manifest.js.map +1 -0
  473. package/dist/lib/platform-runtime.d.ts +212 -0
  474. package/dist/lib/platform-runtime.d.ts.map +1 -0
  475. package/dist/lib/platform-runtime.js +866 -0
  476. package/dist/lib/platform-runtime.js.map +1 -0
  477. package/dist/lib/poll.d.ts +9 -0
  478. package/dist/lib/poll.d.ts.map +1 -0
  479. package/dist/lib/poll.js +18 -0
  480. package/dist/lib/poll.js.map +1 -0
  481. package/dist/lib/prompt.d.ts +7 -0
  482. package/dist/lib/prompt.d.ts.map +1 -0
  483. package/dist/lib/prompt.js +28 -0
  484. package/dist/lib/prompt.js.map +1 -0
  485. package/dist/lib/provider-presets.d.ts +108 -0
  486. package/dist/lib/provider-presets.d.ts.map +1 -0
  487. package/dist/lib/provider-presets.js +184 -0
  488. package/dist/lib/provider-presets.js.map +1 -0
  489. package/dist/lib/recall.d.ts +32 -0
  490. package/dist/lib/recall.d.ts.map +1 -0
  491. package/dist/lib/recall.js +69 -0
  492. package/dist/lib/recall.js.map +1 -0
  493. package/dist/lib/redact.d.ts +41 -0
  494. package/dist/lib/redact.d.ts.map +1 -0
  495. package/dist/lib/redact.js +130 -0
  496. package/dist/lib/redact.js.map +1 -0
  497. package/dist/lib/render.d.ts +55 -0
  498. package/dist/lib/render.d.ts.map +1 -0
  499. package/dist/lib/render.js +172 -0
  500. package/dist/lib/render.js.map +1 -0
  501. package/dist/lib/repo-binding.d.ts +53 -0
  502. package/dist/lib/repo-binding.d.ts.map +1 -0
  503. package/dist/lib/repo-binding.js +127 -0
  504. package/dist/lib/repo-binding.js.map +1 -0
  505. package/dist/lib/repo-command-support.d.ts +18 -0
  506. package/dist/lib/repo-command-support.d.ts.map +1 -0
  507. package/dist/lib/repo-command-support.js +54 -0
  508. package/dist/lib/repo-command-support.js.map +1 -0
  509. package/dist/lib/seal-core.d.ts +34 -0
  510. package/dist/lib/seal-core.d.ts.map +1 -0
  511. package/dist/lib/seal-core.js +154 -0
  512. package/dist/lib/seal-core.js.map +1 -0
  513. package/dist/lib/setup-console.d.ts +46 -0
  514. package/dist/lib/setup-console.d.ts.map +1 -0
  515. package/dist/lib/setup-console.js +191 -0
  516. package/dist/lib/setup-console.js.map +1 -0
  517. package/dist/lib/setup-page.d.ts +21 -0
  518. package/dist/lib/setup-page.d.ts.map +1 -0
  519. package/dist/lib/setup-page.js +656 -0
  520. package/dist/lib/setup-page.js.map +1 -0
  521. package/dist/lib/setup-plan.d.ts +52 -0
  522. package/dist/lib/setup-plan.d.ts.map +1 -0
  523. package/dist/lib/setup-plan.js +154 -0
  524. package/dist/lib/setup-plan.js.map +1 -0
  525. package/dist/lib/setup-server.d.ts +71 -0
  526. package/dist/lib/setup-server.d.ts.map +1 -0
  527. package/dist/lib/setup-server.js +936 -0
  528. package/dist/lib/setup-server.js.map +1 -0
  529. package/dist/lib/tui.d.ts +77 -0
  530. package/dist/lib/tui.d.ts.map +1 -0
  531. package/dist/lib/tui.js +126 -0
  532. package/dist/lib/tui.js.map +1 -0
  533. package/dist/lib/ui.d.ts +23 -0
  534. package/dist/lib/ui.d.ts.map +1 -0
  535. package/dist/lib/ui.js +100 -0
  536. package/dist/lib/ui.js.map +1 -0
  537. package/dist/lib/vault.d.ts +10 -0
  538. package/dist/lib/vault.d.ts.map +1 -0
  539. package/dist/lib/vault.js +18 -0
  540. package/dist/lib/vault.js.map +1 -0
  541. package/dist/menu/forms.d.ts +13 -0
  542. package/dist/menu/forms.d.ts.map +1 -0
  543. package/dist/menu/forms.js +45 -0
  544. package/dist/menu/forms.js.map +1 -0
  545. package/dist/menu/frontends.d.ts +32 -0
  546. package/dist/menu/frontends.d.ts.map +1 -0
  547. package/dist/menu/frontends.js +31 -0
  548. package/dist/menu/frontends.js.map +1 -0
  549. package/dist/menu/help.d.ts +11 -0
  550. package/dist/menu/help.d.ts.map +1 -0
  551. package/dist/menu/help.js +33 -0
  552. package/dist/menu/help.js.map +1 -0
  553. package/dist/menu/palette.d.ts +28 -0
  554. package/dist/menu/palette.d.ts.map +1 -0
  555. package/dist/menu/palette.js +57 -0
  556. package/dist/menu/palette.js.map +1 -0
  557. package/dist/menu/reducer.d.ts +19 -0
  558. package/dist/menu/reducer.d.ts.map +1 -0
  559. package/dist/menu/reducer.js +37 -0
  560. package/dist/menu/reducer.js.map +1 -0
  561. package/dist/menu/run.d.ts +34 -0
  562. package/dist/menu/run.d.ts.map +1 -0
  563. package/dist/menu/run.js +490 -0
  564. package/dist/menu/run.js.map +1 -0
  565. package/dist/menu/screens.d.ts +15 -0
  566. package/dist/menu/screens.d.ts.map +1 -0
  567. package/dist/menu/screens.js +251 -0
  568. package/dist/menu/screens.js.map +1 -0
  569. package/dist/menu/should-launch.d.ts +19 -0
  570. package/dist/menu/should-launch.d.ts.map +1 -0
  571. package/dist/menu/should-launch.js +22 -0
  572. package/dist/menu/should-launch.js.map +1 -0
  573. package/dist/menu/types.d.ts +95 -0
  574. package/dist/menu/types.d.ts.map +1 -0
  575. package/dist/menu/types.js +7 -0
  576. package/dist/menu/types.js.map +1 -0
  577. package/oclif.manifest.json +7995 -0
  578. package/package.json +133 -0
@@ -0,0 +1,92 @@
1
+ import type { EngineStatus } from './container-engine.js';
2
+ import { type AsyncProcessRunner, type PlatformPaths, type ProcessRunner } from './platform-runtime.js';
3
+ export interface DeviceCodeResponse {
4
+ device_code: string;
5
+ user_code: string;
6
+ verification_uri: string;
7
+ verification_uri_complete?: string;
8
+ interval: number;
9
+ expires_in: number;
10
+ }
11
+ export interface ActivationDeps {
12
+ fetch: typeof globalThis.fetch;
13
+ runner: ProcessRunner | AsyncProcessRunner;
14
+ openBrowser: (url: string) => void;
15
+ now: () => number;
16
+ sleep: (ms: number) => Promise<void>;
17
+ emit: (line: string) => void;
18
+ }
19
+ export interface DeviceFlowOptions {
20
+ scope?: string;
21
+ installationName?: string;
22
+ edition?: string;
23
+ noOpen?: boolean;
24
+ }
25
+ export interface CredentialWriteInvocation {
26
+ command: string;
27
+ args: string[];
28
+ options: {
29
+ cwd: string;
30
+ shell: false;
31
+ input?: string;
32
+ env?: Record<string, string>;
33
+ };
34
+ }
35
+ export interface CredentialWritePlan {
36
+ invocations: CredentialWriteInvocation[];
37
+ environment: Record<string, string>;
38
+ }
39
+ export interface ActivationVerification {
40
+ stackRunning: boolean;
41
+ restarted: boolean;
42
+ linked: boolean;
43
+ displayPlan?: string;
44
+ statusReason?: string;
45
+ leaseExpiresAt?: string;
46
+ }
47
+ export interface InstallationActivationResult {
48
+ credential: string;
49
+ installationId: string;
50
+ account?: string;
51
+ plan?: string;
52
+ }
53
+ export declare function normalizeMothershipOrigin(value: string): string;
54
+ export declare function runDeviceCodeFlow(mothershipUrl: string, deps: ActivationDeps, options?: DeviceFlowOptions): Promise<InstallationActivationResult>;
55
+ export declare function planCredentialWrite(projectName: string, credential: string, installationId: string, store: 'identity' | 'env', engine?: EngineStatus): CredentialWritePlan;
56
+ export declare function persistActivation(input: {
57
+ paths: PlatformPaths;
58
+ projectName: string;
59
+ mothershipUrl: string;
60
+ credential: string;
61
+ installationId: string;
62
+ store: 'identity' | 'env';
63
+ engine?: EngineStatus;
64
+ runner?: ProcessRunner | AsyncProcessRunner;
65
+ }): Promise<void>;
66
+ /** Persist a scoped Cloud AI key only into an existing knowz-cloud runtime. */
67
+ export declare function persistCloudAiCredential(input: {
68
+ paths: PlatformPaths;
69
+ credential: string;
70
+ }): Promise<void>;
71
+ export declare function restartAndVerifyActivation(input: {
72
+ paths: PlatformPaths;
73
+ projectName: string;
74
+ engine: EngineStatus;
75
+ restart: boolean;
76
+ runner?: ProcessRunner | AsyncProcessRunner;
77
+ fetch?: typeof globalThis.fetch;
78
+ now?: () => number;
79
+ sleep?: (ms: number) => Promise<void>;
80
+ timeoutMs?: number;
81
+ }): Promise<ActivationVerification>;
82
+ export declare function resolveActivationLinked(verification: ActivationVerification, _browserMetadata?: {
83
+ account?: string;
84
+ plan?: string;
85
+ }): boolean;
86
+ export declare function formatLinkedStatus(status: {
87
+ linked: boolean;
88
+ account?: string;
89
+ displayPlan?: string;
90
+ mothershipUrl: string;
91
+ }): string;
92
+ //# sourceMappingURL=activate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../src/lib/activate.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC9B,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAA;IAC1C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,GAAG,EAAE,MAAM,MAAM,CAAA;IACjB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CACrF;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,yBAAyB,EAAE,CAAA;IACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAYD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/D;AAMD,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAsFvC;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,UAAU,GAAG,KAAK,EACzB,MAAM,CAAC,EAAE,YAAY,GACpB,mBAAmB,CAmCrB;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,KAAK,EAAE,aAAa,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,UAAU,GAAG,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAA;CAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAED,+EAA+E;AAC/E,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,KAAK,EAAE,aAAa,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAqBD,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,KAAK,EAAE,aAAa,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAA;IAC3C,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsDlC;AAUD,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,sBAAsB,EACpC,gBAAgB,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CAKT"}
@@ -0,0 +1,292 @@
1
+ import { existsSync, readFileSync } from 'node:fs';
2
+ import { ExitCode, KnowzError, validateCloudAiKeyFormat, validateInstallCredentialFormat, } from '@knowzai/core';
3
+ import { nodeProcessRunner, parseEnv, renderEnv, writePrivateFile, } from './platform-runtime.js';
4
+ const INSTALLATION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
5
+ function normalizeInstallationId(value) {
6
+ const installationId = typeof value === 'string' ? value.trim().toLowerCase() : '';
7
+ if (!INSTALLATION_ID_RE.test(installationId)) {
8
+ throw new KnowzError('The mothership returned a missing or malformed installation id.', ExitCode.Auth);
9
+ }
10
+ return installationId;
11
+ }
12
+ export function normalizeMothershipOrigin(value) {
13
+ let url;
14
+ try {
15
+ url = new URL(value);
16
+ }
17
+ catch {
18
+ throw new KnowzError(`Invalid mothership URL: ${value}`, ExitCode.Usage);
19
+ }
20
+ if (url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '::1'].includes(url.hostname))) {
21
+ throw new KnowzError('The mothership URL must use HTTPS (HTTP is allowed only for localhost).', ExitCode.Usage);
22
+ }
23
+ return url.toString().replace(/\/$/, '');
24
+ }
25
+ async function responseBody(response) {
26
+ try {
27
+ return await response.json();
28
+ }
29
+ catch {
30
+ return {};
31
+ }
32
+ }
33
+ export async function runDeviceCodeFlow(mothershipUrl, deps, options = {}) {
34
+ const origin = normalizeMothershipOrigin(mothershipUrl);
35
+ let issueResponse;
36
+ try {
37
+ issueResponse = await deps.fetch(`${origin}/api/v1/auth/device/code`, {
38
+ method: 'POST', headers: { 'content-type': 'application/json' },
39
+ body: JSON.stringify({
40
+ scope: options.scope ?? 'installation',
41
+ installationName: options.installationName ?? 'Knowz portable',
42
+ edition: options.edition ?? 'community',
43
+ }),
44
+ });
45
+ }
46
+ catch (cause) {
47
+ throw new KnowzError(`Could not reach the Knowz mothership at ${origin}. Check the URL and network connection.`, ExitCode.Api, { cause });
48
+ }
49
+ if (issueResponse.status === 404) {
50
+ throw new KnowzError('This Knowz service does not support device activation yet; use `--paste` with a credential from Settings → Installations.', ExitCode.NotFound);
51
+ }
52
+ if (!issueResponse.ok)
53
+ throw new KnowzError('The Knowz mothership refused the device activation request.', ExitCode.Api);
54
+ const issued = await responseBody(issueResponse);
55
+ if (!issued.device_code || !issued.user_code || !issued.verification_uri || issued.expires_in <= 0) {
56
+ throw new KnowzError('The Knowz mothership returned an invalid device activation response.', ExitCode.Api);
57
+ }
58
+ const verificationUrl = issued.verification_uri_complete ?? issued.verification_uri;
59
+ deps.emit(` Visit: ${issued.verification_uri}`);
60
+ deps.emit(` Code: ${issued.user_code}`);
61
+ deps.emit('');
62
+ deps.emit('Waiting for approval… (Ctrl+C to cancel)');
63
+ if (!options.noOpen)
64
+ deps.openBrowser(verificationUrl);
65
+ let interval = Math.max(1, issued.interval || 5);
66
+ const deadline = deps.now() + issued.expires_in * 1000;
67
+ while (deps.now() < deadline) {
68
+ await deps.sleep(interval * 1000);
69
+ if (deps.now() >= deadline)
70
+ break;
71
+ let pollResponse;
72
+ try {
73
+ pollResponse = await deps.fetch(`${origin}/api/v1/auth/device/token`, {
74
+ method: 'POST', headers: { 'content-type': 'application/json' },
75
+ body: JSON.stringify({ device_code: issued.device_code, scope: options.scope ?? 'installation' }),
76
+ });
77
+ }
78
+ catch (cause) {
79
+ throw new KnowzError('The device activation poll could not reach the mothership.', ExitCode.Api, { cause });
80
+ }
81
+ const body = await responseBody(pollResponse);
82
+ const status = String(body.status ?? body.error ?? (body.credential ? 'approved' : ''));
83
+ if (status === 'authorization_pending' || status === 'pending')
84
+ continue;
85
+ if (status === 'slow_down') {
86
+ interval = typeof body.interval === 'number' ? Math.max(interval + 5, body.interval) : interval + 5;
87
+ continue;
88
+ }
89
+ if (status === 'expired' || status === 'expired_token') {
90
+ throw new KnowzError('The device code expired. Run `knowz activate` again.', ExitCode.Auth);
91
+ }
92
+ if (status === 'denied' || status === 'access_denied') {
93
+ const message = options.scope === 'cloud-ai'
94
+ ? 'Knowz Cloud AI is not enabled for this account, or the activation request was denied.'
95
+ : 'The device activation request was denied.';
96
+ throw new KnowzError(message, ExitCode.Auth);
97
+ }
98
+ if (status === 'approved') {
99
+ const credential = String(body.credential ?? '');
100
+ const credentialFormat = options.scope === 'cloud-ai'
101
+ ? validateCloudAiKeyFormat(credential)
102
+ : validateInstallCredentialFormat(credential);
103
+ if (!credentialFormat.ok) {
104
+ const credentialKind = options.scope === 'cloud-ai' ? 'Knowz Cloud AI' : 'installation';
105
+ throw new KnowzError(`The mothership returned a malformed ${credentialKind} credential.`, ExitCode.Auth);
106
+ }
107
+ const account = body.account;
108
+ const plan = body.plan;
109
+ const installationId = normalizeInstallationId(body.installationId);
110
+ const displayPlan = typeof plan?.displayName === 'string'
111
+ ? plan.displayName
112
+ : typeof body.tier === 'string' ? body.tier : undefined;
113
+ return {
114
+ credential,
115
+ installationId,
116
+ ...(typeof account?.displayName === 'string' ? { account: account.displayName } : {}),
117
+ ...(displayPlan ? { plan: displayPlan } : {}),
118
+ };
119
+ }
120
+ throw new KnowzError('The mothership returned an unrecognized device activation status.', ExitCode.Api);
121
+ }
122
+ throw new KnowzError('The device code expired. Run `knowz activate` again.', ExitCode.Auth);
123
+ }
124
+ export function planCredentialWrite(projectName, credential, installationId, store, engine) {
125
+ if (!validateInstallCredentialFormat(credential).ok) {
126
+ throw new KnowzError('Invalid Knowz installation credential.', ExitCode.Usage);
127
+ }
128
+ const normalizedInstallationId = normalizeInstallationId(installationId);
129
+ if (store === 'env') {
130
+ return {
131
+ invocations: [],
132
+ environment: {
133
+ KNOWZ_LICENSING_INSTALL_CREDENTIAL: credential,
134
+ KNOWZ_LICENSING_INSTALLATION_ID: normalizedInstallationId,
135
+ },
136
+ };
137
+ }
138
+ const command = engine?.engine === 'podman' ? 'podman' : 'docker';
139
+ const env = engine?.composeFront?.env;
140
+ const volume = `${projectName}_knowz-portable-identity`;
141
+ const identity = Buffer.from(JSON.stringify({
142
+ installationId: normalizedInstallationId,
143
+ createdAt: new Date().toISOString(),
144
+ }), 'utf8').toString('base64');
145
+ return {
146
+ environment: {},
147
+ invocations: [
148
+ { command, args: ['volume', 'create', volume], options: { cwd: process.cwd(), shell: false, ...(env ? { env } : {}) } },
149
+ {
150
+ command,
151
+ args: ['run', '--rm', '-i', '-v', `${volume}:/identity`, 'alpine', 'sh', '-c',
152
+ // chown to the API container's APP_UID (1654, .NET base image — src/Knowz.API/Dockerfile):
153
+ // this helper runs as root, and a root-owned 0600 file crashes the API on its next restart.
154
+ 'set -eu; umask 077; suffix=$$; identity_tmp="/identity/installation.json.tmp.$suffix"; credential_tmp="/identity/credential.tmp.$suffix"; trap \'rm -f "$identity_tmp" "$credential_tmp"\' EXIT; IFS= read -r identity_b64; IFS= read -r credential; printf "%s" "$identity_b64" | base64 -d > "$identity_tmp"; printf "%s\\n" "$credential" > "$credential_tmp"; chmod 600 "$identity_tmp" "$credential_tmp"; chown 1654:1654 "$identity_tmp" "$credential_tmp"; mv "$credential_tmp" /identity/credential; mv "$identity_tmp" /identity/installation.json; trap - EXIT'],
155
+ options: { cwd: process.cwd(), shell: false, input: `${identity}\n${credential}\n`, ...(env ? { env } : {}) },
156
+ },
157
+ ],
158
+ };
159
+ }
160
+ export async function persistActivation(input) {
161
+ const origin = normalizeMothershipOrigin(input.mothershipUrl);
162
+ const plan = planCredentialWrite(input.projectName, input.credential, input.installationId, input.store, input.engine);
163
+ const runner = input.runner ?? nodeProcessRunner;
164
+ for (const invocation of plan.invocations) {
165
+ const result = await Promise.resolve(runner(invocation.command, invocation.args, invocation.options));
166
+ if (result.status !== 0)
167
+ throw new KnowzError('Could not write the installation credential to the identity volume.', ExitCode.Generic);
168
+ }
169
+ const existing = existsSync(input.paths.envFile) ? parseEnv(readFileSync(input.paths.envFile, 'utf8')) : {};
170
+ writePrivateFile(input.paths.envFile, renderEnv({
171
+ ...existing,
172
+ KNOWZ_LICENSING_MOTHERSHIP_URL: origin,
173
+ ...plan.environment,
174
+ }));
175
+ }
176
+ /** Persist a scoped Cloud AI key only into an existing knowz-cloud runtime. */
177
+ export async function persistCloudAiCredential(input) {
178
+ if (!validateCloudAiKeyFormat(input.credential).ok) {
179
+ throw new KnowzError('Invalid Knowz Cloud AI credential.', ExitCode.Usage);
180
+ }
181
+ let provider;
182
+ try {
183
+ provider = JSON.parse(readFileSync(input.paths.stateFile, 'utf8')).provider;
184
+ }
185
+ catch (cause) {
186
+ throw new KnowzError('No configured portable platform was found for this project.', ExitCode.NotFound, { cause });
187
+ }
188
+ if (provider !== 'knowz-cloud') {
189
+ throw new KnowzError('Cloud AI activation requires a platform configured with the knowz-cloud provider.', ExitCode.Usage);
190
+ }
191
+ const existing = existsSync(input.paths.envFile) ? parseEnv(readFileSync(input.paths.envFile, 'utf8')) : {};
192
+ writePrivateFile(input.paths.envFile, renderEnv({ ...existing, OPENAICOMPAT__APIKEY: input.credential }));
193
+ }
194
+ function composeArgs(paths, projectName, engine, action) {
195
+ if (!engine.composeFront)
196
+ throw new KnowzError('Docker Compose is required to restart the portable services.', ExitCode.Generic);
197
+ return {
198
+ command: engine.composeFront.command,
199
+ args: [
200
+ ...engine.composeFront.baseArgs,
201
+ '--project-name', projectName,
202
+ '--file', paths.composeFile,
203
+ '--env-file', paths.envFile,
204
+ ...action,
205
+ ],
206
+ options: {
207
+ cwd: paths.runtimeDir,
208
+ shell: false,
209
+ ...(engine.composeFront.env ? { env: engine.composeFront.env } : {}),
210
+ },
211
+ };
212
+ }
213
+ export async function restartAndVerifyActivation(input) {
214
+ if (!input.engine.composeFront || !input.engine.daemonReachable) {
215
+ return { stackRunning: false, restarted: false, linked: false };
216
+ }
217
+ const runner = input.runner ?? nodeProcessRunner;
218
+ const run = async (invocation) => Promise.resolve(runner(invocation.command, invocation.args, invocation.options));
219
+ const ps = await run(composeArgs(input.paths, input.projectName, input.engine, ['ps', '--services', '--status', 'running']));
220
+ const services = new Set((ps.stdout ?? '').split(/\r?\n/).map(value => value.trim()).filter(Boolean));
221
+ const stackRunning = ps.status === 0 && services.has('api') && services.has('worker');
222
+ if (!stackRunning)
223
+ return { stackRunning: false, restarted: false, linked: false };
224
+ if (!input.restart)
225
+ return { stackRunning: true, restarted: false, linked: false };
226
+ const restart = await run(composeArgs(input.paths, input.projectName, input.engine, ['restart', 'api', 'worker']));
227
+ if (restart.status !== 0)
228
+ throw new KnowzError('The credential was stored, but API and worker restart failed.', ExitCode.Generic);
229
+ let apiUrl;
230
+ try {
231
+ const state = JSON.parse(readFileSync(input.paths.stateFile, 'utf8'));
232
+ if (typeof state.serviceUrls?.api === 'string')
233
+ apiUrl = state.serviceUrls.api.replace(/\/$/, '');
234
+ }
235
+ catch { /* A missing state file is an honest unverified result. */ }
236
+ if (!apiUrl)
237
+ return { stackRunning: true, restarted: true, linked: false };
238
+ const fetcher = input.fetch ?? globalThis.fetch;
239
+ const now = input.now ?? Date.now;
240
+ const sleep = input.sleep ?? (ms => new Promise(resolve => setTimeout(resolve, ms)));
241
+ const deadline = now() + (input.timeoutMs ?? 30_000);
242
+ let lastStatusReason;
243
+ do {
244
+ try {
245
+ const response = await fetcher(`${apiUrl}/api/info`, { headers: { accept: 'application/json' } });
246
+ const body = await responseBody(response);
247
+ const status = body.licenseStatus;
248
+ if (typeof status?.statusReason === 'string')
249
+ lastStatusReason = status.statusReason;
250
+ if (response.ok && status && isVerifiedLeaseStatus(status)) {
251
+ return {
252
+ stackRunning: true,
253
+ restarted: true,
254
+ linked: true,
255
+ ...(typeof status.displayPlan === 'string' ? { displayPlan: status.displayPlan } : {}),
256
+ ...(typeof status.statusReason === 'string' ? { statusReason: status.statusReason } : {}),
257
+ ...(typeof status.leaseExpiresAt === 'string' ? { leaseExpiresAt: status.leaseExpiresAt } : {}),
258
+ };
259
+ }
260
+ }
261
+ catch { /* Retry until the bounded deadline while the API restarts. */ }
262
+ if (now() >= deadline)
263
+ break;
264
+ await sleep(Math.min(1_000, Math.max(0, deadline - now())));
265
+ } while (now() <= deadline);
266
+ return {
267
+ stackRunning: true,
268
+ restarted: true,
269
+ linked: false,
270
+ ...(lastStatusReason ? { statusReason: lastStatusReason } : {}),
271
+ };
272
+ }
273
+ function isVerifiedLeaseStatus(status) {
274
+ if (status?.linked !== true || typeof status.leaseExpiresAt !== 'string')
275
+ return false;
276
+ const reason = typeof status.statusReason === 'string' ? status.statusReason : '';
277
+ if (['unlinked', 'unavailable', 'invalid', 'revoked', 'lapsed'].includes(reason))
278
+ return false;
279
+ const expiresAt = Date.parse(status.leaseExpiresAt);
280
+ return Number.isFinite(expiresAt) && expiresAt > 0;
281
+ }
282
+ export function resolveActivationLinked(verification, _browserMetadata = {}) {
283
+ return verification.linked;
284
+ }
285
+ export function formatLinkedStatus(status) {
286
+ if (!status.linked)
287
+ return 'Not linked — run `knowz activate`';
288
+ const account = status.account ?? 'your Knowz account';
289
+ const tier = status.displayPlan ?? 'linked plan';
290
+ return `Linked to ${account} — ${tier}\nManage or upgrade your plan: ${normalizeMothershipOrigin(status.mothershipUrl)}/account/plan`;
291
+ }
292
+ //# sourceMappingURL=activate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activate.js","sourceRoot":"","sources":["../../src/lib/activate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EACL,QAAQ,EACR,UAAU,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,gBAAgB,GAIjB,MAAM,uBAAuB,CAAA;AAsD9B,MAAM,kBAAkB,GAAG,iEAAiE,CAAA;AAE5F,SAAS,uBAAuB,CAAC,KAAc;IAC7C,MAAM,cAAc,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAClF,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAAC,iEAAiE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IACxG,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,UAAU,CAAC,2BAA2B,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAAC,CAAC;IAC/G,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACzH,MAAM,IAAI,UAAU,CAAC,yEAAyE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC1C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAkB;IAC5C,IAAI,CAAC;QAAC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAA;IAAC,CAAC;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,aAAqB,EACrB,IAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,MAAM,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAA;IACvD,IAAI,aAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,0BAA0B,EAAE;YACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,cAAc;gBACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,gBAAgB;gBAC9D,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,WAAW;aACxC,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,2CAA2C,MAAM,yCAAyC,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3I,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,2HAA2H,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACtK,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,6DAA6D,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;IACxH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAkC,CAAA;IACjF,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,UAAU,CAAC,sEAAsE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC5G,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,yBAAyB,IAAI,MAAM,CAAC,gBAAgB,CAAA;IACnF,IAAI,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACjD,IAAI,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACb,IAAI,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;IACrD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAA;IAEtD,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,GAAG,IAAI,CAAA;IACtD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;QACjC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,MAAK;QACjC,IAAI,YAAsB,CAAA;QAC1B,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,2BAA2B,EAAE;gBACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,cAAc,EAAE,CAAC;aAClG,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,4DAA4D,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAC7G,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvF,IAAI,MAAM,KAAK,uBAAuB,IAAI,MAAM,KAAK,SAAS;YAAE,SAAQ;QACxE,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAA;YACnG,SAAQ;QACV,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;YACvD,MAAM,IAAI,UAAU,CAAC,sDAAsD,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC7F,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU;gBAC1C,CAAC,CAAC,uFAAuF;gBACzF,CAAC,CAAC,2CAA2C,CAAA;YAC/C,MAAM,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC9C,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;YAChD,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU;gBACnD,CAAC,CAAC,wBAAwB,CAAC,UAAU,CAAC;gBACtC,CAAC,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAA;YAC/C,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;gBACzB,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAA;gBACvF,MAAM,IAAI,UAAU,CAAC,uCAAuC,cAAc,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC1G,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAgD,CAAA;YACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAA6C,CAAA;YAC/D,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YACnE,MAAM,WAAW,GAAG,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ;gBACvD,CAAC,CAAC,IAAI,CAAC,WAAW;gBAClB,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;YACzD,OAAO;gBACL,UAAU;gBACV,cAAc;gBACd,GAAG,CAAC,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAA;QACH,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,mEAAmE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;IACzG,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,sDAAsD,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,UAAkB,EAClB,cAAsB,EACtB,KAAyB,EACzB,MAAqB;IAErB,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAAC,wCAAwC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAChF,CAAC;IACD,MAAM,wBAAwB,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAA;IACxE,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO;YACL,WAAW,EAAE,EAAE;YACf,WAAW,EAAE;gBACX,kCAAkC,EAAE,UAAU;gBAC9C,+BAA+B,EAAE,wBAAwB;aAC1D;SACF,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IACjE,MAAM,GAAG,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,CAAA;IACrC,MAAM,MAAM,GAAG,GAAG,WAAW,0BAA0B,CAAA;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAC1C,cAAc,EAAE,wBAAwB;QACxC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC9B,OAAO;QACL,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACX,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvH;gBACE,OAAO;gBACP,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI;oBAC3E,2FAA2F;oBAC3F,4FAA4F;oBAC5F,0iBAA0iB,CAAC;gBAC7iB,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,KAAK,UAAU,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;aAC9G;SACF;KACF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KASvC;IACC,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,mBAAmB,CAC9B,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,CACb,CAAA;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,iBAAiB,CAAA;IAChD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACrG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,qEAAqE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACxI,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3G,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC;QAC9C,GAAG,QAAQ;QACX,8BAA8B,EAAE,MAAM;QACtC,GAAG,IAAI,CAAC,WAAW;KACpB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAG9C;IACC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,oCAAoC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC5E,CAAC;IACD,IAAI,QAAiB,CAAA;IACrB,IAAI,CAAC;QACH,QAAQ,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAA4B,CAAC,QAAQ,CAAA;IACzG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,6DAA6D,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACnH,CAAC;IACD,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,mFAAmF,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3H,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3G,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,oBAAoB,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;AAC3G,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB,EAAE,WAAmB,EAAE,MAAoB,EAAE,MAAgB;IACpG,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,MAAM,IAAI,UAAU,CAAC,8DAA8D,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChI,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO;QACpC,IAAI,EAAE;YACJ,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ;YAC/B,gBAAgB,EAAE,WAAW;YAC7B,QAAQ,EAAE,KAAK,CAAC,WAAW;YAC3B,YAAY,EAAE,KAAK,CAAC,OAAO;YAC3B,GAAG,MAAM;SACV;QACD,OAAO,EAAE;YACP,GAAG,EAAE,KAAK,CAAC,UAAU;YACrB,KAAK,EAAE,KAAK;YACZ,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE;KACF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAUhD;IACC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAChE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,iBAAiB,CAAA;IAChD,MAAM,GAAG,GAAG,KAAK,EAAE,UAAqC,EAAE,EAAE,CAC1D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;IAClF,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5H,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACrG,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACrF,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAClF,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAElF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAClH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,+DAA+D,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEjI,IAAI,MAA0B,CAAA;IAC9B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAwC,CAAA;QAC5G,IAAI,OAAO,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,QAAQ;YAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACnG,CAAC;IAAC,MAAM,CAAC,CAAC,0DAA0D,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAE1E,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACpF,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,CAAA;IACpD,IAAI,gBAAoC,CAAA;IACxC,GAAG,CAAC;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,MAAM,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;YACjG,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAA;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAoD,CAAA;YACxE,IAAI,OAAO,MAAM,EAAE,YAAY,KAAK,QAAQ;gBAAE,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAA;YACpF,IAAI,QAAQ,CAAC,EAAE,IAAI,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3D,OAAO;oBACL,YAAY,EAAE,IAAI;oBAClB,SAAS,EAAE,IAAI;oBACf,MAAM,EAAE,IAAI;oBACZ,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtF,GAAG,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzF,GAAG,CAAC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChG,CAAA;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,8DAA8D,CAAC,CAAC;QAC1E,IAAI,GAAG,EAAE,IAAI,QAAQ;YAAE,MAAK;QAC5B,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC,QAAQ,GAAG,EAAE,IAAI,QAAQ,EAAC;IAC3B,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAA;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,MAA2C;IACxE,IAAI,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACtF,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IACjF,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAC9F,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IACnD,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,YAAoC,EACpC,mBAAwD,EAAE;IAE1D,OAAO,YAAY,CAAC,MAAM,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAKlC;IACC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAA;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,oBAAoB,CAAA;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,aAAa,CAAA;IAChD,OAAO,aAAa,OAAO,MAAM,IAAI,kCAAkC,yBAAyB,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAA;AACvI,CAAC"}
@@ -0,0 +1,30 @@
1
+ import { type SpawnOptions } from 'node:child_process';
2
+ /** A resolved OS command + argv for opening a URL in the default browser. */
3
+ export interface BrowserInvocation {
4
+ cmd: string;
5
+ args: string[];
6
+ options?: Pick<SpawnOptions, 'windowsVerbatimArguments'>;
7
+ }
8
+ /**
9
+ * Pure platform → launcher mapping. On Windows the launcher is
10
+ * `cmd /c start "" <url>`: `start` treats its first quoted argument as the
11
+ * window title, so the empty `""` title is REQUIRED — without it a URL that
12
+ * contains characters `start` would otherwise consume is swallowed and no
13
+ * browser opens (the previous `spawn('start', [url])` was also broken because
14
+ * `start` is a `cmd` builtin, not an executable).
15
+ */
16
+ export declare function browserCommand(url: string, platform?: NodeJS.Platform): BrowserInvocation;
17
+ /** The minimal child-process surface `openBrowser` relies on (injectable for tests). */
18
+ export interface SpawnedChild {
19
+ on(event: 'error', listener: () => void): void;
20
+ unref(): void;
21
+ }
22
+ export type SpawnFn = (cmd: string, args: string[], opts: SpawnOptions) => SpawnedChild;
23
+ /**
24
+ * Best-effort open of `url` in the default browser. Detached + unref'd so it
25
+ * never blocks the CLI, and a silent no-op when there is no browser (headless /
26
+ * CI): the caller has already printed the URL. `spawnFn` is injectable so the
27
+ * platform mapping can be asserted without launching anything.
28
+ */
29
+ export declare function openBrowser(url: string, spawnFn?: SpawnFn, platform?: NodeJS.Platform): void;
30
+ //# sourceMappingURL=browser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,iBAAiB,CAiBnB;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;CACf;AACD,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAyC,EAClD,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,IAAI,CASN"}
@@ -0,0 +1,45 @@
1
+ import { spawn as nodeSpawn } from 'node:child_process';
2
+ /**
3
+ * Pure platform → launcher mapping. On Windows the launcher is
4
+ * `cmd /c start "" <url>`: `start` treats its first quoted argument as the
5
+ * window title, so the empty `""` title is REQUIRED — without it a URL that
6
+ * contains characters `start` would otherwise consume is swallowed and no
7
+ * browser opens (the previous `spawn('start', [url])` was also broken because
8
+ * `start` is a `cmd` builtin, not an executable).
9
+ */
10
+ export function browserCommand(url, platform = process.platform) {
11
+ switch (platform) {
12
+ case 'darwin':
13
+ return { cmd: 'open', args: [url] };
14
+ case 'win32':
15
+ if (/[&|<>^()]/.test(url)) {
16
+ const quotedUrl = url.replaceAll('"', '""');
17
+ return {
18
+ cmd: 'cmd',
19
+ args: ['/d', '/s', '/c', `start "" "${quotedUrl}"`],
20
+ options: { windowsVerbatimArguments: true },
21
+ };
22
+ }
23
+ return { cmd: 'cmd', args: ['/c', 'start', '""', url] };
24
+ default:
25
+ return { cmd: 'xdg-open', args: [url] };
26
+ }
27
+ }
28
+ /**
29
+ * Best-effort open of `url` in the default browser. Detached + unref'd so it
30
+ * never blocks the CLI, and a silent no-op when there is no browser (headless /
31
+ * CI): the caller has already printed the URL. `spawnFn` is injectable so the
32
+ * platform mapping can be asserted without launching anything.
33
+ */
34
+ export function openBrowser(url, spawnFn = nodeSpawn, platform = process.platform) {
35
+ try {
36
+ const { cmd, args, options } = browserCommand(url, platform);
37
+ const child = spawnFn(cmd, args, { stdio: 'ignore', detached: true, ...options });
38
+ child.on('error', () => { });
39
+ child.unref();
40
+ }
41
+ catch {
42
+ /* headless / no browser — the URL is printed by the caller */
43
+ }
44
+ }
45
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAS3E;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,WAA4B,OAAO,CAAC,QAAQ;IAE5C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,OAAO;YACV,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC5C,OAAO;oBACL,GAAG,EAAE,KAAK;oBACV,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,SAAS,GAAG,CAAC;oBACnD,OAAO,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE;iBAC5C,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1D;YACE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,UAAmB,SAA+B,EAClD,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAClF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}
@@ -0,0 +1,41 @@
1
+ import type { ChatEvent, ChatTurnRequest, AskResult } from '@knowzai/types';
2
+ /** Thrown for a server-emitted `error` SSE event — must NOT trigger fallback. */
3
+ export declare class ChatServerError extends Error {
4
+ constructor(message: string);
5
+ }
6
+ export interface ChatTurnDeps {
7
+ /** Submit the turn and yield typed SSE events. Auth is on the request headers. */
8
+ openStream: (req: ChatTurnRequest, signal?: AbortSignal) => AsyncIterable<ChatEvent>;
9
+ askFallback: (req: {
10
+ question: string;
11
+ vaultId?: string;
12
+ }) => Promise<AskResult>;
13
+ }
14
+ export interface ChatTurnOptions {
15
+ allowFallback: boolean;
16
+ /** Live response tokens as they stream. */
17
+ onToken?: (token: string) => void;
18
+ /** Agentic reasoning steps (mode=Agentic/DeepResearch surface these). */
19
+ onThinking?: (agent: string | undefined, step: string | undefined) => void;
20
+ /** Pipeline status updates ("Searching knowledge base…"). */
21
+ onStatus?: (message: string) => void;
22
+ signal?: AbortSignal;
23
+ vaultId?: string;
24
+ }
25
+ export interface ChatTurnOutput {
26
+ answer: string;
27
+ sources: {
28
+ knowledgeId?: string;
29
+ title: string;
30
+ relevance: number;
31
+ }[];
32
+ conversationId: string;
33
+ viaFallback: boolean;
34
+ }
35
+ /**
36
+ * Run a single chat turn over the agentic SSE stream, with graceful fallback to
37
+ * the synchronous ask endpoint on transport failure. A server `error` event is
38
+ * terminal and never falls back.
39
+ */
40
+ export declare function runChatTurn(req: ChatTurnRequest, deps: ChatTurnDeps, opts: ChatTurnOptions): Promise<ChatTurnOutput>;
41
+ //# sourceMappingURL=chat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/lib/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5E,iFAAiF;AACjF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,UAAU,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;IACrF,WAAW,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,yEAAyE;IACzE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3E,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CA8CzB"}
@@ -0,0 +1,63 @@
1
+ import { KnowzError, ExitCode } from '@knowzai/core';
2
+ /** Thrown for a server-emitted `error` SSE event — must NOT trigger fallback. */
3
+ export class ChatServerError extends Error {
4
+ constructor(message) {
5
+ super(message);
6
+ this.name = 'ChatServerError';
7
+ }
8
+ }
9
+ /**
10
+ * Run a single chat turn over the agentic SSE stream, with graceful fallback to
11
+ * the synchronous ask endpoint on transport failure. A server `error` event is
12
+ * terminal and never falls back.
13
+ */
14
+ export async function runChatTurn(req, deps, opts) {
15
+ try {
16
+ let answer = '';
17
+ let sources = [];
18
+ for await (const ev of deps.openStream(req, opts.signal)) {
19
+ switch (ev.type) {
20
+ case 'token':
21
+ answer += ev.text;
22
+ opts.onToken?.(ev.text);
23
+ break;
24
+ case 'thinking':
25
+ opts.onThinking?.(ev.agent, ev.step);
26
+ break;
27
+ case 'status':
28
+ opts.onStatus?.(ev.message);
29
+ break;
30
+ case 'sources':
31
+ sources = (ev.items ?? []).map((s) => ({
32
+ knowledgeId: s.id,
33
+ title: s.title,
34
+ relevance: s.relevanceScore ?? 0,
35
+ }));
36
+ break;
37
+ case 'error':
38
+ throw new ChatServerError(ev.message);
39
+ case 'done':
40
+ // Terminal marker; the loop also ends when the stream closes.
41
+ break;
42
+ default:
43
+ break; // ping / metadata / warnings / unknown — ignore
44
+ }
45
+ }
46
+ return { answer, sources, conversationId: req.conversationId, viaFallback: false };
47
+ }
48
+ catch (e) {
49
+ if (e instanceof ChatServerError)
50
+ throw new KnowzError(e.message, ExitCode.Api);
51
+ if (!opts.allowFallback) {
52
+ throw e instanceof KnowzError ? e : new KnowzError(`Chat stream failed: ${String(e)}`, ExitCode.Api);
53
+ }
54
+ const res = await deps.askFallback({ question: req.message, vaultId: opts.vaultId });
55
+ return {
56
+ answer: res.answer,
57
+ sources: res.sources,
58
+ conversationId: req.conversationId,
59
+ viaFallback: true,
60
+ };
61
+ }
62
+ }
63
+ //# sourceMappingURL=chat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/lib/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGrD,iFAAiF;AACjF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AA6BD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAoB,EACpB,IAAkB,EAClB,IAAqB;IAErB,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAA8B,EAAE,CAAC;QAC5C,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,OAAO;oBACV,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC;oBAClB,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;oBACxB,MAAM;gBACR,KAAK,UAAU;oBACb,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;oBACrC,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;oBAC5B,MAAM;gBACR,KAAK,SAAS;oBACZ,OAAO,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACrC,WAAW,EAAE,CAAC,CAAC,EAAE;wBACjB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,SAAS,EAAE,CAAC,CAAC,cAAc,IAAI,CAAC;qBACjC,CAAC,CAAC,CAAC;oBACJ,MAAM;gBACR,KAAK,OAAO;oBACV,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBACxC,KAAK,MAAM;oBACT,8DAA8D;oBAC9D,MAAM;gBACR;oBACE,MAAM,CAAC,gDAAgD;YAC3D,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe;YAAE,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,uBAAuB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvG,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}