cartethyia 2.5.10 → 2.6.1

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 (369) hide show
  1. package/.env.example +8 -0
  2. package/dist/dashboard/assets/{BannedPage-Cd30Z0b9.js → BannedPage-wr370U7a.js} +1 -1
  3. package/dist/dashboard/assets/BannedPage-wr370U7a.js.gz +0 -0
  4. package/dist/dashboard/assets/{CliToolDetailPage-wf5u-ww6.js → CliToolDetailPage-D1sCezWa.js} +1 -1
  5. package/dist/dashboard/assets/CliToolDetailPage-D1sCezWa.js.gz +0 -0
  6. package/dist/dashboard/assets/{CliToolsPage-DykPvuck.js → CliToolsPage-DVWbJPEQ.js} +1 -1
  7. package/dist/dashboard/assets/CliToolsPage-DVWbJPEQ.js.gz +0 -0
  8. package/dist/dashboard/assets/{CombosPage-DwvSD3vs.js → CombosPage-CZc7fyMe.js} +1 -1
  9. package/dist/dashboard/assets/CombosPage-CZc7fyMe.js.gz +0 -0
  10. package/dist/dashboard/assets/{ConsoleLogPage-CIr7KDex.js → ConsoleLogPage-OPN3qRCa.js} +1 -1
  11. package/dist/dashboard/assets/ConsoleLogPage-OPN3qRCa.js.gz +0 -0
  12. package/dist/dashboard/assets/{CustomizationPage-82X0DDdH.js → CustomizationPage-DGTSqmwm.js} +1 -1
  13. package/dist/dashboard/assets/CustomizationPage-DGTSqmwm.js.gz +0 -0
  14. package/dist/dashboard/assets/HealthEventsModal-BujG2QP4.js +1 -0
  15. package/dist/dashboard/assets/HealthEventsModal-BujG2QP4.js.gz +0 -0
  16. package/dist/dashboard/assets/{LoginPage-CS5mPuVF.js → LoginPage-C_Jd_KgP.js} +1 -1
  17. package/dist/dashboard/assets/LoginPage-C_Jd_KgP.js.gz +0 -0
  18. package/dist/dashboard/assets/{ModelPicker-C0UCUsVJ.js → ModelPicker-DVny4S5_.js} +1 -1
  19. package/dist/dashboard/assets/ModelPicker-DVny4S5_.js.gz +0 -0
  20. package/dist/dashboard/assets/OverviewPage-Bpbu-VeU.js +1 -0
  21. package/dist/dashboard/assets/OverviewPage-Bpbu-VeU.js.gz +0 -0
  22. package/dist/dashboard/assets/ProviderDetailPage-BEhXOO4L.js +3 -0
  23. package/dist/dashboard/assets/ProviderDetailPage-BEhXOO4L.js.gz +0 -0
  24. package/dist/dashboard/assets/{ProvidersPage-vdja5ZPK.js → ProvidersPage-DbQnexQd.js} +1 -1
  25. package/dist/dashboard/assets/ProvidersPage-DbQnexQd.js.gz +0 -0
  26. package/dist/dashboard/assets/{ProxyPage-BB4CNm4-.js → ProxyPage-ByprzADo.js} +1 -1
  27. package/dist/dashboard/assets/ProxyPage-ByprzADo.js.gz +0 -0
  28. package/dist/dashboard/assets/QuotaPage-CvSfv6tP.js +1 -0
  29. package/dist/dashboard/assets/QuotaPage-CvSfv6tP.js.gz +0 -0
  30. package/dist/dashboard/assets/SettingsPage-_NzLq3C-.js +1 -0
  31. package/dist/dashboard/assets/SettingsPage-_NzLq3C-.js.gz +0 -0
  32. package/dist/dashboard/assets/{SetupPage-FadUOl9S.js → SetupPage-Bg9DcG-G.js} +1 -1
  33. package/dist/dashboard/assets/SetupPage-Bg9DcG-G.js.gz +0 -0
  34. package/dist/dashboard/assets/{SortableList-Cfy6_Khv.js → SortableList-C2PWPzJm.js} +1 -1
  35. package/dist/dashboard/assets/SortableList-C2PWPzJm.js.gz +0 -0
  36. package/dist/dashboard/assets/{StudioPage-CM92fgJf.js → StudioPage-Dky1zZMt.js} +1 -1
  37. package/dist/dashboard/assets/StudioPage-Dky1zZMt.js.gz +0 -0
  38. package/dist/dashboard/assets/{UsagePage-BT4MyQeT.js → UsagePage-C5Vdpd_c.js} +2 -2
  39. package/dist/dashboard/assets/UsagePage-C5Vdpd_c.js.gz +0 -0
  40. package/dist/dashboard/assets/{api-keys-DQYLQxpW.js → api-keys-C23S9sgp.js} +1 -1
  41. package/dist/dashboard/assets/api-keys-C23S9sgp.js.gz +0 -0
  42. package/dist/dashboard/assets/{app-B7pVRhJ1.js → app-2KhtHCv9.js} +1 -1
  43. package/dist/dashboard/assets/{app-B7pVRhJ1.js.gz → app-2KhtHCv9.js.gz} +0 -0
  44. package/dist/dashboard/assets/app-CEeaMHOy.css +2 -0
  45. package/dist/dashboard/assets/app-CEeaMHOy.css.gz +0 -0
  46. package/dist/dashboard/assets/{assert-C9FD_JwJ.js → assert-DU6qrMA_.js} +1 -1
  47. package/dist/dashboard/assets/assert-DU6qrMA_.js.gz +0 -0
  48. package/dist/dashboard/assets/{badge-Bvyr7D0u.js → badge-CKsF123d.js} +1 -1
  49. package/dist/dashboard/assets/badge-CKsF123d.js.gz +0 -0
  50. package/dist/dashboard/assets/{banner-DIvKAZih.js → banner-8j7uChA9.js} +1 -1
  51. package/dist/dashboard/assets/banner-8j7uChA9.js.gz +0 -0
  52. package/dist/dashboard/assets/{card-D5_gYIS_.js → card-CdsSlWA3.js} +1 -1
  53. package/dist/dashboard/assets/card-CdsSlWA3.js.gz +0 -0
  54. package/dist/dashboard/assets/{cli-tools-CNqzrfdb.js → cli-tools-BaFUuFFF.js} +1 -1
  55. package/dist/dashboard/assets/cli-tools-BaFUuFFF.js.gz +0 -0
  56. package/dist/dashboard/assets/{clipboard-button-B6vDBtbm.js → clipboard-button-uL5aYLfW.js} +1 -1
  57. package/dist/dashboard/assets/clipboard-button-uL5aYLfW.js.gz +0 -0
  58. package/dist/dashboard/assets/{dialog-CpjrgdwJ.js → dialog-C07hr5_G.js} +1 -1
  59. package/dist/dashboard/assets/dialog-C07hr5_G.js.gz +0 -0
  60. package/dist/dashboard/assets/{drawer-BWmt3b5y.js → drawer-BPO1TcKH.js} +1 -1
  61. package/dist/dashboard/assets/drawer-BPO1TcKH.js.gz +0 -0
  62. package/dist/dashboard/assets/entry-BNFjUjQ0.js +4 -0
  63. package/dist/dashboard/assets/entry-BNFjUjQ0.js.gz +0 -0
  64. package/dist/dashboard/assets/{entry-C_oakV3z.js → entry-Bz_CtDfC.js} +1 -1
  65. package/dist/dashboard/assets/entry-Bz_CtDfC.js.gz +0 -0
  66. package/dist/dashboard/assets/entry-GJRbmrpA.js +1 -0
  67. package/dist/dashboard/assets/entry-GJRbmrpA.js.gz +0 -0
  68. package/dist/dashboard/assets/{github-badge-RRHHWGxh.js → github-badge-DmQreSDd.js} +1 -1
  69. package/dist/dashboard/assets/github-badge-DmQreSDd.js.gz +0 -0
  70. package/dist/dashboard/assets/{index-Bhey_rg_.js → index-DyllNVCY.js} +2 -2
  71. package/dist/dashboard/assets/index-DyllNVCY.js.gz +0 -0
  72. package/dist/dashboard/assets/{inline-C2_EQ5Uf.js → inline-C9dCYaBZ.js} +1 -1
  73. package/dist/dashboard/assets/inline-C9dCYaBZ.js.gz +0 -0
  74. package/dist/dashboard/assets/{input-BMRlQ450.js → input-CjCnXweJ.js} +1 -1
  75. package/dist/dashboard/assets/input-CjCnXweJ.js.gz +0 -0
  76. package/dist/dashboard/assets/{layout-XR5xP8ew.js → layout-V6y8DAkl.js} +1 -1
  77. package/dist/dashboard/assets/layout-V6y8DAkl.js.gz +0 -0
  78. package/dist/dashboard/assets/{list-row-Cw07dioc.js → list-row-CM1AaG_y.js} +1 -1
  79. package/dist/dashboard/assets/list-row-CM1AaG_y.js.gz +0 -0
  80. package/dist/dashboard/assets/{live-BivGfuUs.js → live-ta6GMb-8.js} +1 -1
  81. package/dist/dashboard/assets/live-ta6GMb-8.js.gz +0 -0
  82. package/dist/dashboard/assets/{model-bans-CmffjLuG.js → model-bans-BmYTmbAk.js} +1 -1
  83. package/dist/dashboard/assets/model-bans-BmYTmbAk.js.gz +0 -0
  84. package/dist/dashboard/assets/{mutation-46P0oWMe.js → mutation-g_fduiNw.js} +1 -1
  85. package/dist/dashboard/assets/mutation-g_fduiNw.js.gz +0 -0
  86. package/dist/dashboard/assets/{numbers-DrdA9oSM.js → numbers-BOevJzdz.js} +1 -1
  87. package/dist/dashboard/assets/numbers-BOevJzdz.js.gz +0 -0
  88. package/dist/dashboard/assets/{query-keys-BFhGpwR1.js → query-keys-UETqfytp.js} +1 -1
  89. package/dist/dashboard/assets/query-keys-UETqfytp.js.gz +0 -0
  90. package/dist/dashboard/assets/{routing-CAb4F37R.js → routing-BPUo-W8d.js} +1 -1
  91. package/dist/dashboard/assets/routing-BPUo-W8d.js.gz +0 -0
  92. package/dist/dashboard/assets/{select-CxVVB__N.js → select-DAhoTabv.js} +1 -1
  93. package/dist/dashboard/assets/select-DAhoTabv.js.gz +0 -0
  94. package/dist/dashboard/assets/{settings-DNX9sydi.js → settings--3hxSyry.js} +1 -1
  95. package/dist/dashboard/assets/settings--3hxSyry.js.gz +0 -0
  96. package/dist/dashboard/assets/{stack-uPOwM9Hs.js → stack-_gfTdLVB.js} +1 -1
  97. package/dist/dashboard/assets/stack-_gfTdLVB.js.gz +0 -0
  98. package/dist/dashboard/assets/{state-D1Yz79iL.js → state-2c5V4zo7.js} +1 -1
  99. package/dist/dashboard/assets/state-2c5V4zo7.js.gz +0 -0
  100. package/dist/dashboard/assets/{switch-sevsRrRo.js → switch-Dkke7Naf.js} +1 -1
  101. package/dist/dashboard/assets/switch-Dkke7Naf.js.gz +0 -0
  102. package/dist/dashboard/assets/{useMutation-Dem0lXQj.js → useMutation-EDFRkn1i.js} +1 -1
  103. package/dist/dashboard/assets/useMutation-EDFRkn1i.js.gz +0 -0
  104. package/dist/dashboard/index.html +1 -1
  105. package/dist/dashboard/index.html.gz +0 -0
  106. package/dist/dashboard/precompressed-assets.json +51 -51
  107. package/migrations/README.md +52 -52
  108. package/migrations/full-postgres/0020_add_telemetry_event_analytics.sql +77 -0
  109. package/migrations/full-postgres/0021_add_api_key_concurrency_tolerance.sql +13 -0
  110. package/migrations/full-postgres/0022_add_inferhub_config_key.sql +17 -0
  111. package/migrations/full-postgres/0023_drop_api_key_concurrency_tolerance.sql +13 -0
  112. package/migrations/lite-sqlite3/0020_add_telemetry_event_analytics.sql +69 -0
  113. package/migrations/lite-sqlite3/0021_add_api_key_concurrency_tolerance.sql +13 -0
  114. package/migrations/lite-sqlite3/0022_add_inferhub_config_key.sql +17 -0
  115. package/migrations/lite-sqlite3/0023_drop_api_key_concurrency_tolerance.sql +13 -0
  116. package/package.json +96 -95
  117. package/scripts/cli/admin.ts +126 -128
  118. package/scripts/cli/autostart.ts +237 -237
  119. package/scripts/cli/background.ts +123 -110
  120. package/scripts/cli/bin/carte.cjs +8 -8
  121. package/scripts/cli/bin/cartethyia.cjs +177 -167
  122. package/scripts/cli/console-menu.ts +45 -30
  123. package/scripts/cli/controller.ts +145 -0
  124. package/scripts/cli/env.ts +99 -99
  125. package/scripts/cli/gateway.ts +264 -260
  126. package/scripts/cli/instance.ts +234 -224
  127. package/scripts/cli/main.ts +195 -167
  128. package/scripts/cli/platform.ts +64 -64
  129. package/scripts/cli/prompt.ts +217 -79
  130. package/scripts/cli/services.ts +88 -88
  131. package/scripts/cli/setup.ts +445 -445
  132. package/scripts/cli/start.ts +85 -85
  133. package/scripts/cli/startup-signal.ts +23 -23
  134. package/scripts/cli/telemetry.ts +70 -0
  135. package/scripts/cli/tray/hidden-window.vbs +16 -2
  136. package/scripts/cli/tray/index.ts +263 -263
  137. package/scripts/cli/tray/windows.ps1 +107 -107
  138. package/scripts/cli/tray.ts +29 -4
  139. package/scripts/cli/update.ts +39 -39
  140. package/scripts/cli/version.ts +67 -67
  141. package/scripts/cli/wordmark.ts +58 -58
  142. package/src/boot/app.ts +16 -1
  143. package/src/boot/dependencies.ts +128 -25
  144. package/src/config/resources.ts +137 -0
  145. package/src/config/runtime.ts +133 -76
  146. package/src/config/spec.ts +30 -29
  147. package/src/config/telemetry.ts +0 -25
  148. package/src/console/api-keys/bucket-spend.ts +14 -17
  149. package/src/console/api-keys/contracts.ts +410 -410
  150. package/src/console/api-keys/routes.ts +12 -0
  151. package/src/console/audit/store.ts +2 -3
  152. package/src/console/auth/setup-service.ts +8 -1
  153. package/src/console/backup/routes.ts +7 -0
  154. package/src/console/backup/service.ts +463 -463
  155. package/src/console/backup/store.ts +16 -11
  156. package/src/console/backup/validate.ts +1 -4
  157. package/src/console/cli-tools/fs-ops.ts +18 -2
  158. package/src/console/data-management/contracts.ts +1 -8
  159. package/src/console/data-management/operations.ts +61 -48
  160. package/src/console/data-management/routes.ts +4 -2
  161. package/src/console/domain-registration.ts +25 -3
  162. package/src/console/inferhub/client.ts +139 -0
  163. package/src/console/inferhub/key-store.ts +129 -0
  164. package/src/console/inferhub/normalize.ts +347 -0
  165. package/src/console/inferhub/routes.ts +411 -0
  166. package/src/console/inferhub/store.ts +109 -0
  167. package/src/console/inferhub/types.ts +183 -0
  168. package/src/console/observability/contracts.ts +2 -41
  169. package/src/console/observability/store.ts +176 -371
  170. package/src/console/providers/catalog/public-model-store.ts +0 -0
  171. package/src/console/providers/catalog/store.ts +23 -36
  172. package/src/console/quota/account-quota-shared.ts +52 -52
  173. package/src/console/quota/account-quota-tenant.ts +16 -24
  174. package/src/console/quota/refresh.ts +441 -441
  175. package/src/console/routing/pools/import-parse.ts +206 -206
  176. package/src/console/routing/pools/operations.ts +543 -543
  177. package/src/console/routing/pools/probe-verdict.ts +132 -132
  178. package/src/console/routing/pools/routes.ts +181 -181
  179. package/src/console/settings/contracts.ts +42 -40
  180. package/src/console/settings/store.ts +25 -25
  181. package/src/console/share/share-stats.ts +22 -4
  182. package/src/console/share/share-usage.ts +30 -4
  183. package/src/console/shared/cursor.ts +15 -0
  184. package/src/console/updates/routes.ts +12 -0
  185. package/src/main.ts +13 -5
  186. package/src/network/pool/resolver.ts +1104 -1104
  187. package/src/observability/client-name.ts +22 -0
  188. package/src/observability/event-log.ts +5 -29
  189. package/src/observability/event-query.ts +690 -0
  190. package/src/observability/log-ring.ts +26 -2
  191. package/src/observability/log-sanitize.ts +118 -0
  192. package/src/observability/logger.ts +17 -13
  193. package/src/observability/metrics.ts +35 -0
  194. package/src/observability/payload-capture.ts +114 -41
  195. package/src/observability/payload-store.ts +249 -24
  196. package/src/observability/raw-event-writer.ts +118 -0
  197. package/src/observability/runtime-metrics.ts +71 -1
  198. package/src/observability/telemetry-buffer.ts +100 -17
  199. package/src/observability/telemetry-reconciliation.ts +417 -0
  200. package/src/persistence/boot.ts +20 -9
  201. package/src/persistence/db-pg.ts +13 -0
  202. package/src/persistence/db-sqlite.ts +569 -497
  203. package/src/persistence/dialect.ts +3 -2
  204. package/src/persistence/migrate.ts +181 -181
  205. package/src/persistence/schema.ts +1496 -1406
  206. package/src/persistence/shared-cache.ts +5 -1
  207. package/src/persistence/stores/api-key-store.ts +581 -581
  208. package/src/persistence/stores/telemetry-store.ts +124 -63
  209. package/src/protocol/reasoning-text.ts +30 -0
  210. package/src/protocol/response/chat.ts +33 -7
  211. package/src/protocol/response/codex.ts +14 -2
  212. package/src/protocol/response/messages.ts +5 -2
  213. package/src/providers/authentication/oauth-flow-store.ts +3 -10
  214. package/src/providers/bundled-discovery-providers.ts +122 -122
  215. package/src/providers/default-registry.ts +10 -0
  216. package/src/providers/discovery/catalog/catalog-blob.ts +18 -18
  217. package/src/providers/discovery/models-dev-catalog.ts +354 -354
  218. package/src/providers/discovery/probe-phases.ts +43 -7
  219. package/src/providers/discovery/probing-service.ts +70 -32
  220. package/src/providers/integrations/antigravity/antigravity.ts +9 -2
  221. package/src/providers/integrations/buddy/buddy-catalog-shared.ts +85 -17
  222. package/src/providers/integrations/buddy/buddy-chat-shared.ts +934 -934
  223. package/src/providers/integrations/buddy/buddy-checkin.ts +5 -9
  224. package/src/providers/integrations/buddy/buddy-discovery-shared.ts +3 -7
  225. package/src/providers/integrations/buddy/buddy-quota-shared.ts +3 -1
  226. package/src/providers/integrations/buddy/codebuddy/cn-provider.ts +57 -49
  227. package/src/providers/integrations/buddy/codebuddy/provider.ts +180 -180
  228. package/src/providers/integrations/buddy/workbuddy/provider.ts +206 -206
  229. package/src/providers/integrations/buddy/workbuddy/quota.ts +161 -161
  230. package/src/providers/integrations/claude/claude-quota.ts +2 -2
  231. package/src/providers/integrations/claude/claude-user-profiles.ts +3 -2
  232. package/src/providers/integrations/claude/claude.ts +3 -4
  233. package/src/providers/integrations/cline/cline.ts +94 -8
  234. package/src/providers/integrations/codex/codex.ts +61 -37
  235. package/src/providers/integrations/cursor/cursor-catalog.ts +368 -368
  236. package/src/providers/integrations/cursor/cursor-http2.ts +300 -300
  237. package/src/providers/integrations/cursor/cursor-identity.ts +2 -4
  238. package/src/providers/integrations/cursor/cursor-request.ts +11 -0
  239. package/src/providers/integrations/cursor/cursor.ts +29 -17
  240. package/src/providers/integrations/cursor/protocol/framing.ts +129 -129
  241. package/src/providers/integrations/cursor/protocol/messages.ts +2380 -2380
  242. package/src/providers/integrations/cursor/protocol/struct.ts +305 -305
  243. package/src/providers/integrations/cursor/protocol/tool-canonical.ts +275 -0
  244. package/src/providers/integrations/grok/grok-quota.ts +279 -279
  245. package/src/providers/integrations/grok/grok-ratelimit-store.ts +73 -73
  246. package/src/providers/integrations/grok/grok-ratelimit.ts +218 -218
  247. package/src/providers/integrations/hermes.ts +7 -1
  248. package/src/providers/integrations/inferhub.ts +201 -73
  249. package/src/providers/integrations/kilo/kilo.ts +152 -152
  250. package/src/providers/integrations/kiro/kiro-machine-id.ts +2 -4
  251. package/src/providers/integrations/openrouter/provider.ts +129 -129
  252. package/src/providers/integrations/qoder/qoder-quota.ts +193 -192
  253. package/src/providers/integrations/qoder/qoder-realm.ts +106 -106
  254. package/src/providers/integrations/trae/trae-oauth.ts +4 -26
  255. package/src/providers/integrations/trae/trae-quota.ts +389 -384
  256. package/src/providers/integrations/trae/trae-realm.ts +15 -2
  257. package/src/providers/integrations/xiaomi-mimo/think-stream.ts +100 -24
  258. package/src/providers/integrations/zcode/oauth.ts +1 -1
  259. package/src/providers/operations/account-health-service.ts +605 -279
  260. package/src/providers/provider-metadata.ts +12 -1
  261. package/src/providers/provider-model-definition.ts +373 -373
  262. package/src/providers/quota/quota-contracts.ts +3 -7
  263. package/src/providers/search/search-provider.ts +2 -6
  264. package/src/security/admission/contracts.ts +10 -0
  265. package/src/security/admission/in-memory-store.ts +89 -14
  266. package/src/security/admission/lua.ts +191 -182
  267. package/src/security/admission/redis-store.ts +30 -0
  268. package/src/security/admission/service.ts +18 -0
  269. package/src/security/api-key-auth-cache.ts +96 -0
  270. package/src/security/api-key-auth.ts +11 -100
  271. package/src/security/client-router-fingerprint.ts +3 -7
  272. package/src/security/ip-boundary.ts +7 -3
  273. package/src/shared/coerce.ts +67 -0
  274. package/src/shared/hash.ts +6 -0
  275. package/src/shared/time.ts +7 -0
  276. package/src/transport/dispatch/attempt-finalize.ts +26 -138
  277. package/src/transport/dispatch/attempt-loop.ts +103 -81
  278. package/src/transport/dispatch/capture-policy.ts +78 -0
  279. package/src/transport/dispatch/proxy-request.ts +4 -2
  280. package/src/transport/dispatch/streaming/encoder.ts +111 -5
  281. package/src/transport/dispatch/streaming/stream.ts +19 -2
  282. package/src/transport/dispatch/streaming/thinking-loop.ts +300 -0
  283. package/src/transport/failure-policy.ts +27 -0
  284. package/src/transport/guards/abuse-guard.ts +2 -2
  285. package/src/transport/guards/auth-guard.ts +17 -0
  286. package/src/transport/guards/body-policy.ts +3 -2
  287. package/src/transport/guards/concurrency-guard.ts +89 -13
  288. package/src/transport/guards/early-rejection-capture.ts +43 -3
  289. package/src/transport/guards/error-lifecycle.ts +10 -2
  290. package/src/transport/guards/guard-errors.ts +23 -0
  291. package/src/transport/guards/headroom-guard.ts +41 -7
  292. package/src/transport/guards/pipeline.ts +24 -0
  293. package/src/transport/guards/request-context.ts +2 -1
  294. package/src/transport/routing/admission.ts +51 -9
  295. package/src/transport/routing/bounded-lru.ts +49 -0
  296. package/src/transport/routing/candidate-index.ts +88 -0
  297. package/src/transport/routing/reservations.ts +121 -7
  298. package/src/transport/routing/round-robin.ts +10 -22
  299. package/src/transport/routing/route-catalog.ts +26 -13
  300. package/src/transport/routing/route-model.ts +22 -2
  301. package/src/transport/routing/router.ts +53 -31
  302. package/src/transport/surface/chat/encode.ts +2 -3
  303. package/src/transport/surface/chat/parse.ts +2 -1
  304. package/src/transport/surface/dialects.ts +11 -3
  305. package/src/transport/surface/messages/encode.ts +2 -1
  306. package/src/transport/surface/messages/parse.ts +3 -1
  307. package/src/transport/surface/messages/stream.ts +2 -6
  308. package/src/workers/maintenance-lease.ts +200 -0
  309. package/src/workers/scheduler.ts +101 -1
  310. package/dist/dashboard/assets/BannedPage-Cd30Z0b9.js.gz +0 -0
  311. package/dist/dashboard/assets/CliToolDetailPage-wf5u-ww6.js.gz +0 -0
  312. package/dist/dashboard/assets/CliToolsPage-DykPvuck.js.gz +0 -0
  313. package/dist/dashboard/assets/CombosPage-DwvSD3vs.js.gz +0 -0
  314. package/dist/dashboard/assets/ConsoleLogPage-CIr7KDex.js.gz +0 -0
  315. package/dist/dashboard/assets/CustomizationPage-82X0DDdH.js.gz +0 -0
  316. package/dist/dashboard/assets/HealthEventsModal-BYPucTTn.js +0 -1
  317. package/dist/dashboard/assets/HealthEventsModal-BYPucTTn.js.gz +0 -0
  318. package/dist/dashboard/assets/LoginPage-CS5mPuVF.js.gz +0 -0
  319. package/dist/dashboard/assets/ModelPicker-C0UCUsVJ.js.gz +0 -0
  320. package/dist/dashboard/assets/OverviewPage-Dk_ew3YU.js +0 -1
  321. package/dist/dashboard/assets/OverviewPage-Dk_ew3YU.js.gz +0 -0
  322. package/dist/dashboard/assets/ProviderDetailPage-CAiRn2Q0.js +0 -3
  323. package/dist/dashboard/assets/ProviderDetailPage-CAiRn2Q0.js.gz +0 -0
  324. package/dist/dashboard/assets/ProvidersPage-vdja5ZPK.js.gz +0 -0
  325. package/dist/dashboard/assets/ProxyPage-BB4CNm4-.js.gz +0 -0
  326. package/dist/dashboard/assets/QuotaPage-FEc4iNyq.js +0 -1
  327. package/dist/dashboard/assets/QuotaPage-FEc4iNyq.js.gz +0 -0
  328. package/dist/dashboard/assets/SettingsPage-Dlfi5L4N.js +0 -1
  329. package/dist/dashboard/assets/SettingsPage-Dlfi5L4N.js.gz +0 -0
  330. package/dist/dashboard/assets/SetupPage-FadUOl9S.js.gz +0 -0
  331. package/dist/dashboard/assets/SortableList-Cfy6_Khv.js.gz +0 -0
  332. package/dist/dashboard/assets/StudioPage-CM92fgJf.js.gz +0 -0
  333. package/dist/dashboard/assets/UsagePage-BT4MyQeT.js.gz +0 -0
  334. package/dist/dashboard/assets/api-keys-DQYLQxpW.js.gz +0 -0
  335. package/dist/dashboard/assets/app-CX_Z8cMs.css +0 -2
  336. package/dist/dashboard/assets/app-CX_Z8cMs.css.gz +0 -0
  337. package/dist/dashboard/assets/assert-C9FD_JwJ.js.gz +0 -0
  338. package/dist/dashboard/assets/badge-Bvyr7D0u.js.gz +0 -0
  339. package/dist/dashboard/assets/banner-DIvKAZih.js.gz +0 -0
  340. package/dist/dashboard/assets/card-D5_gYIS_.js.gz +0 -0
  341. package/dist/dashboard/assets/cli-tools-CNqzrfdb.js.gz +0 -0
  342. package/dist/dashboard/assets/clipboard-button-B6vDBtbm.js.gz +0 -0
  343. package/dist/dashboard/assets/dialog-CpjrgdwJ.js.gz +0 -0
  344. package/dist/dashboard/assets/drawer-BWmt3b5y.js.gz +0 -0
  345. package/dist/dashboard/assets/entry-B-gvimrg.js +0 -1
  346. package/dist/dashboard/assets/entry-B-gvimrg.js.gz +0 -0
  347. package/dist/dashboard/assets/entry-C_oakV3z.js.gz +0 -0
  348. package/dist/dashboard/assets/entry-Dj0cHfEc.js +0 -4
  349. package/dist/dashboard/assets/entry-Dj0cHfEc.js.gz +0 -0
  350. package/dist/dashboard/assets/github-badge-RRHHWGxh.js.gz +0 -0
  351. package/dist/dashboard/assets/index-Bhey_rg_.js.gz +0 -0
  352. package/dist/dashboard/assets/inline-C2_EQ5Uf.js.gz +0 -0
  353. package/dist/dashboard/assets/input-BMRlQ450.js.gz +0 -0
  354. package/dist/dashboard/assets/layout-XR5xP8ew.js.gz +0 -0
  355. package/dist/dashboard/assets/list-row-Cw07dioc.js.gz +0 -0
  356. package/dist/dashboard/assets/live-BivGfuUs.js.gz +0 -0
  357. package/dist/dashboard/assets/model-bans-CmffjLuG.js.gz +0 -0
  358. package/dist/dashboard/assets/mutation-46P0oWMe.js.gz +0 -0
  359. package/dist/dashboard/assets/numbers-DrdA9oSM.js.gz +0 -0
  360. package/dist/dashboard/assets/query-keys-BFhGpwR1.js.gz +0 -0
  361. package/dist/dashboard/assets/routing-CAb4F37R.js.gz +0 -0
  362. package/dist/dashboard/assets/select-CxVVB__N.js.gz +0 -0
  363. package/dist/dashboard/assets/settings-DNX9sydi.js.gz +0 -0
  364. package/dist/dashboard/assets/stack-uPOwM9Hs.js.gz +0 -0
  365. package/dist/dashboard/assets/state-D1Yz79iL.js.gz +0 -0
  366. package/dist/dashboard/assets/switch-sevsRrRo.js.gz +0 -0
  367. package/dist/dashboard/assets/useMutation-Dem0lXQj.js.gz +0 -0
  368. package/src/observability/event-compaction.ts +0 -317
  369. package/src/observability/event-day-index.ts +0 -439
@@ -2,108 +2,246 @@ import Enquirer from "enquirer";
2
2
 
3
3
  /**
4
4
  * One row in a menu: an action the caller can run, or a rule between groups.
5
- *
6
- * Rules are rendered by `enquirer`'s own separator role and are never
7
- * selectable, so the caller's action list stays a plain array indexed by the
8
- * rows the operator can actually pick.
5
+ * Rules are never selectable and are not included in the returned action index.
9
6
  */
10
7
  export type MenuRow =
11
8
  | { readonly kind: "action"; readonly label: string; readonly hint?: string }
12
9
  | { readonly kind: "rule" };
13
10
 
14
- /**
15
- * A single-select menu driven by the arrow keys and Enter.
16
- *
17
- * Built on `enquirer` rather than a hand-rolled raw-mode listener: a raw
18
- * `process.stdin.on("keypress")` handler never fires unless something first
19
- * calls `readline.emitKeypressEvents`, and the menu rendered as inert text for
20
- * exactly that reason. `enquirer` owns the keypress plumbing, including Ctrl-C.
21
- *
22
- * `header` is printed once here and never handed to `enquirer`: enquirer
23
- * redraws its whole frame on every keypress, so a header inside the prompt
24
- * repeated once per keystroke and stacked the wordmark down the terminal.
25
- *
26
- * Returns -1 when stdin is not a TTY (piped, CI, or a non-interactive run) or
27
- * when the operator cancels, so the caller can drain and exit either way.
28
- */
29
- /**
30
- * Options for `chooseFromMenu`. `initialIndex` is an **action** index, not a
31
- * row index — the caller numbers from the actions it exposes, which is also
32
- * what the function returns. Rules (separators) are not indexed.
33
- */
11
+ /** Options for {@link chooseFromMenu}. Indices count actions, not rules. */
34
12
  export interface MenuOptions {
35
13
  readonly initialIndex?: number;
14
+ /** Short status retained below the menu after an action completes. */
15
+ readonly status?: { readonly tone: "success" | "error"; readonly text: string };
16
+ }
17
+
18
+ interface MouseEvent {
19
+ readonly button: number;
20
+ readonly column: number;
21
+ readonly row: number;
22
+ readonly release: boolean;
36
23
  }
37
24
 
25
+ const CURSOR_HOME = "\u001b[H";
26
+ const CLEAR_SCREEN = "\u001b[2J";
27
+ const CLEAR_LINE = "\u001b[2K";
28
+ const HIDE_CURSOR = "\u001b[?25l";
29
+ const SHOW_CURSOR = "\u001b[?25h";
30
+ const ENABLE_MOUSE = "\u001b[?1000h\u001b[?1006h";
31
+ const DISABLE_MOUSE = "\u001b[?1006l\u001b[?1000l";
32
+ const RESET = "\u001b[0m";
33
+ const MOUSE_PATTERN = /\u001b\[<(\d+);(\d+);(\d+)([Mm])/g;
34
+
35
+ function parseMouseEvents(sequence: string): MouseEvent[] {
36
+ return [...sequence.matchAll(MOUSE_PATTERN)].map((match) => ({
37
+ button: Number(match[1]),
38
+ column: Number(match[2]),
39
+ row: Number(match[3]),
40
+ release: match[4] === "m",
41
+ }));
42
+ }
43
+
44
+ function clamp(value: number, minimum: number, maximum: number): number {
45
+ return Math.max(minimum, Math.min(maximum, value));
46
+ }
47
+
48
+ function plainText(value: string, width: number): string {
49
+ return value.length <= width ? value : width <= 1 ? value.slice(0, width) : `${value.slice(0, width - 1)}…`;
50
+ }
51
+
52
+ /**
53
+ * An interactive terminal menu with keyboard and xterm SGR mouse support.
54
+ *
55
+ * A single click focuses on press and activates on release over the same row,
56
+ * matching ordinary desktop buttons. Terminals without mouse reporting retain
57
+ * the complete arrow-key/Enter interface. stdin is restored even on Ctrl-C or
58
+ * Esc so the caller can drain the gateway normally.
59
+ */
38
60
  export async function chooseFromMenu(
39
61
  header: string | readonly string[],
40
62
  rows: readonly MenuRow[],
41
63
  options: MenuOptions = {},
42
64
  ): Promise<number> {
43
- if (!process.stdin.isTTY) return -1;
65
+ const input = process.stdin;
66
+ const output = process.stdout;
67
+ if (!input.isTTY) return -1;
44
68
 
45
- const headerLines = typeof header === "string" ? [header] : header;
46
- process.stdout.write("\u001b[2J\u001b[H");
47
- for (const line of headerLines) process.stdout.write(`${line}\n`);
48
- process.stdout.write("\n");
49
-
50
- // Enquirer indexes the rows it renders, rules included, so the action index
51
- // has to be recovered from the label rather than from the position.
52
- const labels = rows.flatMap((row) => (row.kind === "action" ? [row.label] : []));
53
- // Translate the action-index the caller passed into the row-index enquirer
54
- // wants (which counts rules). An out-of-range or unspecified initial index
55
- // falls back to the first action.
56
- const clampedActionIndex = (() => {
57
- if (options.initialIndex === undefined) return 0;
58
- if (options.initialIndex < 0) return 0;
59
- if (options.initialIndex >= labels.length) return labels.length - 1;
60
- return options.initialIndex;
61
- })();
62
- let seenActions = 0;
63
- let rowInitial = 0;
64
- for (let i = 0; i < rows.length; i += 1) {
65
- const row = rows[i];
66
- if (row === undefined || row.kind !== "action") continue;
67
- if (seenActions === clampedActionIndex) {
68
- rowInitial = i;
69
- break;
69
+ const actionRows = rows.flatMap((row, rowIndex) => row.kind === "action" ? [rowIndex] : []);
70
+ if (actionRows.length === 0) return -1;
71
+ let selected = clamp(options.initialIndex ?? 0, 0, actionRows.length - 1);
72
+ let pressedAction: number | null = null;
73
+ let settled = false;
74
+ let frameTop = 0;
75
+ let menuWidth = 0;
76
+ const color = output.isTTY === true && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb";
77
+ const paint = (code: string, value: string): string => color ? `\u001b[${code}m${value}${RESET}` : value;
78
+ const muted = (value: string): string => paint("2;38;2;130;148;165", value);
79
+ const accent = (value: string): string => paint("38;2;145;200;240", value);
80
+ const selectedPaint = (value: string): string => paint("1;38;2;225;242;255;48;2;43;75;106", value);
81
+ const status = options.status === undefined ? undefined : {
82
+ ...options.status,
83
+ text: options.status.text.replace(/\s+/g, " ").trim(),
84
+ };
85
+
86
+ const render = (): void => {
87
+ const columns = Math.max(32, output.columns || 80);
88
+ const labelWidth = Math.max(...rows.flatMap((row) => row.kind === "action" ? [row.label.length] : [0]));
89
+ const contentWidth = Math.max(...rows.map((row) => row.kind === "rule"
90
+ ? 24
91
+ : labelWidth + (row.hint?.length ?? 0) + 7));
92
+ const innerWidth = Math.min(contentWidth, columns - 4);
93
+ menuWidth = innerWidth + 2;
94
+ const lines = [accent(`╭─ Actions ${"─".repeat(Math.max(0, innerWidth - 10))}╮`)];
95
+
96
+ rows.forEach((row, rowIndex) => {
97
+ if (row.kind === "rule") {
98
+ lines.push(muted(`│ ${"─".repeat(Math.max(0, innerWidth - 4))} │`));
99
+ return;
100
+ }
101
+ const hintWidth = Math.max(0, innerWidth - labelWidth - 7);
102
+ const hint = plainText(row.hint ?? "", hintWidth).padEnd(hintWidth);
103
+ const isSelected = actionRows[selected] === rowIndex;
104
+ const pointer = isSelected ? "❯" : " ";
105
+ const text = ` ${pointer} ${row.label.padEnd(labelWidth)} ${hint} `;
106
+ const content = plainText(text, innerWidth).padEnd(innerWidth);
107
+ lines.push(isSelected ? `│${selectedPaint(content)}│` : `│${content}│`);
108
+ });
109
+ lines.push(accent(`╰${"─".repeat(innerWidth)}╯`));
110
+ if (status !== undefined) {
111
+ const prefix = status.tone === "success" ? "✓ " : "✗ ";
112
+ const text = plainText(`${prefix}${status.text}`, columns - 2);
113
+ lines.push(paint(status.tone === "success" ? "38;2;135;205;160" : "38;2;240;145;145", text));
70
114
  }
71
- seenActions += 1;
72
- }
115
+ lines.push(muted(" ↑ ↓ navigate · Enter select · Click to open · Esc cancel"));
116
+
117
+ const cursor = `\u001b[${frameTop};1H`;
118
+ output.write(`${cursor}${lines.map((line) => `${CLEAR_LINE}${line}`).join("\n")}`);
119
+ };
120
+
121
+ const actionAtScreenPosition = (column: number, screenRow: number): number | null => {
122
+ if (column < 1 || column > menuWidth) return null;
123
+ const rowIndex = screenRow - frameTop - 1;
124
+ if (rowIndex < 0 || rowIndex >= rows.length) return null;
125
+ const actionIndex = actionRows.indexOf(rowIndex);
126
+ return actionIndex < 0 ? null : actionIndex;
127
+ };
128
+
129
+ const headerLines = typeof header === "string" ? [header] : header;
130
+ output.write(`${CLEAR_SCREEN}${CURSOR_HOME}`);
131
+ for (const line of headerLines) output.write(`${line}\n`);
132
+ output.write("\n");
133
+ frameTop = headerLines.length + 2;
134
+ output.write(HIDE_CURSOR + ENABLE_MOUSE);
135
+ render();
136
+
137
+ const wasRaw = input.isRaw;
138
+ input.setEncoding("utf8");
139
+ if (input.isTTY) input.setRawMode(true);
140
+ input.resume();
73
141
 
142
+ const onKeypress = (_sequence: string, key: { readonly name: string | undefined }): void => {
143
+ if (key.name === "\u0003" || key.name === "escape") {
144
+ finish(-1);
145
+ return;
146
+ }
147
+ if (key.name === "up" || key.name === "k") move(-1);
148
+ else if (key.name === "down" || key.name === "j") move(1);
149
+ else if (key.name === "home") { selected = 0; render(); }
150
+ else if (key.name === "end") { selected = actionRows.length - 1; render(); }
151
+ else if (key.name === "return" || key.name === "enter" || key.name === "space") finish(selected);
152
+ };
153
+ const onMouseSequence = (sequence: string): void => {
154
+ for (const mouse of parseMouseEvents(sequence)) {
155
+ if ((mouse.button & 32) !== 0) continue;
156
+ if ((mouse.button & 64) !== 0) {
157
+ move((mouse.button & 1) === 0 ? -1 : 1);
158
+ continue;
159
+ }
160
+ if ((mouse.button & 3) !== 0) continue;
161
+ const actionIndex = actionAtScreenPosition(mouse.column, mouse.row);
162
+ if (mouse.release) {
163
+ if (pressedAction !== null && pressedAction === actionIndex) finish(actionIndex);
164
+ pressedAction = null;
165
+ continue;
166
+ }
167
+ pressedAction = actionIndex;
168
+ if (actionIndex !== null && actionIndex !== selected) {
169
+ selected = actionIndex;
170
+ render();
171
+ }
172
+ }
173
+ };
174
+ let resolveMenu: (actionIndex: number) => void = () => undefined;
175
+ const finish = (actionIndex: number): void => {
176
+ if (settled) return;
177
+ settled = true;
178
+ resolveMenu(actionIndex);
179
+ };
180
+ const move = (delta: number): void => {
181
+ selected = (selected + delta + actionRows.length) % actionRows.length;
182
+ pressedAction = null;
183
+ render();
184
+ };
185
+ // Keypress parsing also consumes mouse sequences, so mouse reporting owns
186
+ // the data stream while this menu is active. Keyboard escape sequences are
187
+ // decoded here as well instead of relying on two competing data listeners.
188
+ let pendingInput = "";
189
+ const onRawData = (chunk: Buffer | string): void => {
190
+ pendingInput += String(chunk);
191
+ const names: Record<string, string> = {
192
+ "\u001b[A": "up", "\u001b[B": "down", "\u001b[H": "home", "\u001b[F": "end",
193
+ "\u001bOA": "up", "\u001bOB": "down", "\u001bOH": "home", "\u001bOF": "end",
194
+ };
195
+ while (pendingInput.length > 0 && !settled) {
196
+ if (pendingInput.startsWith("\u001b[<")) {
197
+ const mouse = /^\u001b\[<\d+;\d+;\d+[Mm]/.exec(pendingInput);
198
+ if (mouse === null) {
199
+ if (pendingInput.length < 32) return;
200
+ pendingInput = pendingInput.slice(1);
201
+ continue;
202
+ }
203
+ onMouseSequence(mouse[0]);
204
+ pendingInput = pendingInput.slice(mouse[0].length);
205
+ continue;
206
+ }
207
+ if (pendingInput.startsWith("\u001b[") || pendingInput.startsWith("\u001bO")) {
208
+ const sequence = Object.keys(names).find((candidate) => pendingInput.startsWith(candidate));
209
+ if (sequence === undefined) {
210
+ if (pendingInput.length < 3) return;
211
+ pendingInput = pendingInput.slice(1);
212
+ continue;
213
+ }
214
+ onKeypress(sequence, { name: names[sequence] });
215
+ pendingInput = pendingInput.slice(sequence.length);
216
+ continue;
217
+ }
218
+ if (pendingInput.startsWith("\r\n")) pendingInput = pendingInput.slice(1);
219
+ const character = pendingInput[0]!;
220
+ const name = character === "\r" || character === "\n" ? "return" : character === "\u001b" ? "escape" : character;
221
+ onKeypress(character, { name });
222
+ pendingInput = pendingInput.slice(1);
223
+ }
224
+ };
74
225
 
75
226
  try {
76
- const answer = await Enquirer.prompt<{ choice: string }>({
77
- type: "select",
78
- name: "choice",
79
- message: "Select an action",
80
- choices: rows.map((row) =>
81
- row.kind === "rule"
82
- ? { name: "rule", message: "", role: "separator" }
83
- : {
84
- name: row.label,
85
- message: row.label,
86
- ...(row.hint === undefined ? {} : { hint: row.hint }),
87
- },
88
- ),
89
- initial: rowInitial,
227
+ input.on("data", onRawData);
228
+ return await new Promise<number>((resolve) => {
229
+ resolveMenu = resolve;
90
230
  });
91
- return labels.indexOf(answer.choice);
92
- } catch {
93
- // Enquirer rejects on Esc and on its own Ctrl-C handling. Return -1 so the
94
- // caller drains the gateway rather than leaving a detached process behind.
95
- process.stdout.write("\u001b[2J\u001b[H");
96
- return -1;
231
+ } finally {
232
+ input.removeListener("data", onRawData);
233
+ if (input.isTTY) input.setRawMode(wasRaw);
234
+ // Always release the resumed stdin. A listener-less but flowing TTY keeps
235
+ // the CLI alive after Hide to Tray or another terminal action completes.
236
+ // The next menu resumes it explicitly, so preserving a flowing state here
237
+ // provides no benefit and leaves the terminal looking stuck.
238
+ input.pause();
239
+ if (settled) output.write(`\n${DISABLE_MOUSE}${SHOW_CURSOR}${RESET}`);
240
+ else output.write(`${CLEAR_SCREEN}${CURSOR_HOME}${DISABLE_MOUSE}${SHOW_CURSOR}${RESET}`);
97
241
  }
98
242
  }
99
243
 
100
- /**
101
- * Asks the operator to type an exact word before a destructive action runs.
102
- *
103
- * Enter alone must not be enough: the reset deletes every console credential,
104
- * so the operator types the word rather than confirming a highlight. Returns
105
- * false on cancel, on a mismatch, or when stdin is not a TTY.
106
- */
244
+ /** Asks the operator to type an exact word before a destructive action runs. */
107
245
  export async function confirmByTyping(word: string, message: string): Promise<boolean> {
108
246
  if (!process.stdin.isTTY) return false;
109
247
  try {
@@ -1,88 +1,88 @@
1
- /**
2
- * TCP reachability checks for the services setup and doctor ask about.
3
- *
4
- * These are extracted from the env helpers so the dotenv reader and the probe
5
- * stay independent: doctor can be imported without pulling in `.env` parsing.
6
- */
7
-
8
- export interface ProbeResult {
9
- success: boolean;
10
- error?: string;
11
- }
12
-
13
- /**
14
- * Opens a TCP connection to `host:port` and resolves once it connects, errors,
15
- * or the timeout elapses. The socket is always closed so a probe never leaves a
16
- * half-open connection behind.
17
- */
18
- export async function probeTcpService(
19
- host: string,
20
- port: number,
21
- timeoutMs: number,
22
- ): Promise<ProbeResult> {
23
- const { promise, resolve } = Promise.withResolvers<ProbeResult>();
24
-
25
- const timeoutHandle = setTimeout(() => {
26
- resolve({ success: false, error: "timeout" });
27
- }, timeoutMs);
28
-
29
- Bun.connect({
30
- hostname: host,
31
- port: port,
32
- socket: {
33
- open: () => {
34
- clearTimeout(timeoutHandle);
35
- resolve({ success: true });
36
- },
37
- data: () => {},
38
- error: (err) => {
39
- clearTimeout(timeoutHandle);
40
- resolve({ success: false, error: String(err) });
41
- },
42
- },
43
- })
44
- .then((socket) => {
45
- socket.end();
46
- })
47
- .catch((err) => {
48
- clearTimeout(timeoutHandle);
49
- resolve({ success: false, error: String(err) });
50
- });
51
-
52
- return promise;
53
- }
54
-
55
- /**
56
- * Local PostgreSQL ports worth probing before asking for a URL. 5432 is the
57
- * server default (Laragon, Homebrew, systemd); 5433 is the usual second
58
- * instance when 5432 is already taken.
59
- */
60
- export const LOCAL_POSTGRES_CANDIDATES = [
61
- { host: "127.0.0.1", port: 5432 },
62
- { host: "127.0.0.1", port: 5433 },
63
- ] as const;
64
-
65
- /** First local PostgreSQL that accepts a TCP connection, or null. */
66
- export async function detectLocalPostgres(
67
- timeoutMs: number,
68
- ): Promise<{ host: string; port: number } | null> {
69
- for (const candidate of LOCAL_POSTGRES_CANDIDATES) {
70
- const probe = await probeTcpService(candidate.host, candidate.port, timeoutMs);
71
- if (probe.success) return candidate;
72
- }
73
- return null;
74
- }
75
-
76
- /**
77
- * Parses a service URL and requires an explicit host and port.
78
- * Returns null if the URL is invalid or incomplete.
79
- */
80
- export function parseServiceUrl(url: string): { host: string; port: number } | null {
81
- try {
82
- const urlObj = new URL(url);
83
- if (!urlObj.hostname || !urlObj.port) return null;
84
- return { host: urlObj.hostname, port: Number(urlObj.port) };
85
- } catch {
86
- return null;
87
- }
88
- }
1
+ /**
2
+ * TCP reachability checks for the services setup and doctor ask about.
3
+ *
4
+ * These are extracted from the env helpers so the dotenv reader and the probe
5
+ * stay independent: doctor can be imported without pulling in `.env` parsing.
6
+ */
7
+
8
+ export interface ProbeResult {
9
+ success: boolean;
10
+ error?: string;
11
+ }
12
+
13
+ /**
14
+ * Opens a TCP connection to `host:port` and resolves once it connects, errors,
15
+ * or the timeout elapses. The socket is always closed so a probe never leaves a
16
+ * half-open connection behind.
17
+ */
18
+ export async function probeTcpService(
19
+ host: string,
20
+ port: number,
21
+ timeoutMs: number,
22
+ ): Promise<ProbeResult> {
23
+ const { promise, resolve } = Promise.withResolvers<ProbeResult>();
24
+
25
+ const timeoutHandle = setTimeout(() => {
26
+ resolve({ success: false, error: "timeout" });
27
+ }, timeoutMs);
28
+
29
+ Bun.connect({
30
+ hostname: host,
31
+ port: port,
32
+ socket: {
33
+ open: () => {
34
+ clearTimeout(timeoutHandle);
35
+ resolve({ success: true });
36
+ },
37
+ data: () => {},
38
+ error: (err) => {
39
+ clearTimeout(timeoutHandle);
40
+ resolve({ success: false, error: String(err) });
41
+ },
42
+ },
43
+ })
44
+ .then((socket) => {
45
+ socket.end();
46
+ })
47
+ .catch((err) => {
48
+ clearTimeout(timeoutHandle);
49
+ resolve({ success: false, error: String(err) });
50
+ });
51
+
52
+ return promise;
53
+ }
54
+
55
+ /**
56
+ * Local PostgreSQL ports worth probing before asking for a URL. 5432 is the
57
+ * server default (Laragon, Homebrew, systemd); 5433 is the usual second
58
+ * instance when 5432 is already taken.
59
+ */
60
+ export const LOCAL_POSTGRES_CANDIDATES = [
61
+ { host: "127.0.0.1", port: 5432 },
62
+ { host: "127.0.0.1", port: 5433 },
63
+ ] as const;
64
+
65
+ /** First local PostgreSQL that accepts a TCP connection, or null. */
66
+ export async function detectLocalPostgres(
67
+ timeoutMs: number,
68
+ ): Promise<{ host: string; port: number } | null> {
69
+ for (const candidate of LOCAL_POSTGRES_CANDIDATES) {
70
+ const probe = await probeTcpService(candidate.host, candidate.port, timeoutMs);
71
+ if (probe.success) return candidate;
72
+ }
73
+ return null;
74
+ }
75
+
76
+ /**
77
+ * Parses a service URL and requires an explicit host and port.
78
+ * Returns null if the URL is invalid or incomplete.
79
+ */
80
+ export function parseServiceUrl(url: string): { host: string; port: number } | null {
81
+ try {
82
+ const urlObj = new URL(url);
83
+ if (!urlObj.hostname || !urlObj.port) return null;
84
+ return { host: urlObj.hostname, port: Number(urlObj.port) };
85
+ } catch {
86
+ return null;
87
+ }
88
+ }