cartethyia 2.5.9 → 2.6.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 (386) hide show
  1. package/.env.example +15 -42
  2. package/README.md +11 -10
  3. package/dist/dashboard/assets/{BannedPage-Brvuj_Eb.js → BannedPage-l6XMnfr9.js} +1 -1
  4. package/dist/dashboard/assets/BannedPage-l6XMnfr9.js.gz +0 -0
  5. package/dist/dashboard/assets/{CliToolDetailPage-CqfXtI3y.js → CliToolDetailPage-DwOzAW45.js} +1 -1
  6. package/dist/dashboard/assets/CliToolDetailPage-DwOzAW45.js.gz +0 -0
  7. package/dist/dashboard/assets/{CliToolsPage-GQeS91bg.js → CliToolsPage-BT3Up3QA.js} +1 -1
  8. package/dist/dashboard/assets/CliToolsPage-BT3Up3QA.js.gz +0 -0
  9. package/dist/dashboard/assets/{CombosPage-BDRsTXBB.js → CombosPage-6kYIUpzR.js} +1 -1
  10. package/dist/dashboard/assets/CombosPage-6kYIUpzR.js.gz +0 -0
  11. package/dist/dashboard/assets/{ConsoleLogPage-zP8AFHX0.js → ConsoleLogPage-zRnj1mlR.js} +1 -1
  12. package/dist/dashboard/assets/ConsoleLogPage-zRnj1mlR.js.gz +0 -0
  13. package/dist/dashboard/assets/{CustomizationPage-BmfrNZ14.js → CustomizationPage-C7m-H1Rz.js} +1 -1
  14. package/dist/dashboard/assets/CustomizationPage-C7m-H1Rz.js.gz +0 -0
  15. package/dist/dashboard/assets/HealthEventsModal-C8MR_BdB.js +1 -0
  16. package/dist/dashboard/assets/HealthEventsModal-C8MR_BdB.js.gz +0 -0
  17. package/dist/dashboard/assets/{LoginPage-DoreIgm8.js → LoginPage-CbphLvjg.js} +1 -1
  18. package/dist/dashboard/assets/LoginPage-CbphLvjg.js.gz +0 -0
  19. package/dist/dashboard/assets/{ModelPicker-C7pDb41R.js → ModelPicker-DVny4S5_.js} +1 -1
  20. package/dist/dashboard/assets/ModelPicker-DVny4S5_.js.gz +0 -0
  21. package/dist/dashboard/assets/OverviewPage-DABu2Wgt.js +1 -0
  22. package/dist/dashboard/assets/OverviewPage-DABu2Wgt.js.gz +0 -0
  23. package/dist/dashboard/assets/ProviderDetailPage-C15x9q13.js +3 -0
  24. package/dist/dashboard/assets/ProviderDetailPage-C15x9q13.js.gz +0 -0
  25. package/dist/dashboard/assets/{ProvidersPage-BnoPgA7w.js → ProvidersPage-Dfb2896L.js} +1 -1
  26. package/dist/dashboard/assets/ProvidersPage-Dfb2896L.js.gz +0 -0
  27. package/dist/dashboard/assets/{ProxyPage-Bq_TGgdb.js → ProxyPage-BaCIdAUt.js} +1 -1
  28. package/dist/dashboard/assets/ProxyPage-BaCIdAUt.js.gz +0 -0
  29. package/dist/dashboard/assets/QuotaPage-BsdoCIw1.js +1 -0
  30. package/dist/dashboard/assets/QuotaPage-BsdoCIw1.js.gz +0 -0
  31. package/dist/dashboard/assets/SettingsPage-KVJFh3Ip.js +1 -0
  32. package/dist/dashboard/assets/SettingsPage-KVJFh3Ip.js.gz +0 -0
  33. package/dist/dashboard/assets/{SetupPage-Day3mCOn.js → SetupPage-D4g6vOGc.js} +1 -1
  34. package/dist/dashboard/assets/SetupPage-D4g6vOGc.js.gz +0 -0
  35. package/dist/dashboard/assets/{SortableList-DQxllnB5.js → SortableList-C93i14BD.js} +1 -1
  36. package/dist/dashboard/assets/SortableList-C93i14BD.js.gz +0 -0
  37. package/dist/dashboard/assets/{StudioPage-uMExoWu1.js → StudioPage-SgQpymjm.js} +1 -1
  38. package/dist/dashboard/assets/{StudioPage-uMExoWu1.js.gz → StudioPage-SgQpymjm.js.gz} +0 -0
  39. package/dist/dashboard/assets/{UsagePage-DXa1oR-4.js → UsagePage-BFME-eba.js} +2 -2
  40. package/dist/dashboard/assets/UsagePage-BFME-eba.js.gz +0 -0
  41. package/dist/dashboard/assets/{api-keys-DQYLQxpW.js → api-keys-C23S9sgp.js} +1 -1
  42. package/dist/dashboard/assets/api-keys-C23S9sgp.js.gz +0 -0
  43. package/dist/dashboard/assets/{app-BIt446yE.js → app-2KhtHCv9.js} +1 -1
  44. package/dist/dashboard/assets/{app-BIt446yE.js.gz → app-2KhtHCv9.js.gz} +0 -0
  45. package/dist/dashboard/assets/app-CEeaMHOy.css +2 -0
  46. package/dist/dashboard/assets/app-CEeaMHOy.css.gz +0 -0
  47. package/dist/dashboard/assets/{assert-C9FD_JwJ.js → assert-DU6qrMA_.js} +1 -1
  48. package/dist/dashboard/assets/assert-DU6qrMA_.js.gz +0 -0
  49. package/dist/dashboard/assets/{badge-CR72dasT.js → badge-CKsF123d.js} +1 -1
  50. package/dist/dashboard/assets/badge-CKsF123d.js.gz +0 -0
  51. package/dist/dashboard/assets/{banner-CI9_eSfO.js → banner-8j7uChA9.js} +1 -1
  52. package/dist/dashboard/assets/banner-8j7uChA9.js.gz +0 -0
  53. package/dist/dashboard/assets/{card-DS7CQEsO.js → card-CdsSlWA3.js} +1 -1
  54. package/dist/dashboard/assets/card-CdsSlWA3.js.gz +0 -0
  55. package/dist/dashboard/assets/{cli-tools-CNqzrfdb.js → cli-tools-BaFUuFFF.js} +1 -1
  56. package/dist/dashboard/assets/cli-tools-BaFUuFFF.js.gz +0 -0
  57. package/dist/dashboard/assets/{clipboard-button-611pSsaX.js → clipboard-button-uL5aYLfW.js} +1 -1
  58. package/dist/dashboard/assets/clipboard-button-uL5aYLfW.js.gz +0 -0
  59. package/dist/dashboard/assets/{dialog-k37exjNt.js → dialog-C07hr5_G.js} +1 -1
  60. package/dist/dashboard/assets/dialog-C07hr5_G.js.gz +0 -0
  61. package/dist/dashboard/assets/{drawer-CX7N8ucR.js → drawer-BPO1TcKH.js} +1 -1
  62. package/dist/dashboard/assets/drawer-BPO1TcKH.js.gz +0 -0
  63. package/dist/dashboard/assets/{entry-CTP8AyiS.js → entry-Bz_CtDfC.js} +1 -1
  64. package/dist/dashboard/assets/entry-Bz_CtDfC.js.gz +0 -0
  65. package/dist/dashboard/assets/entry-CwPRKk0d.js +4 -0
  66. package/dist/dashboard/assets/entry-CwPRKk0d.js.gz +0 -0
  67. package/dist/dashboard/assets/entry-GJRbmrpA.js +1 -0
  68. package/dist/dashboard/assets/entry-GJRbmrpA.js.gz +0 -0
  69. package/dist/dashboard/assets/{github-badge-sltk1qUi.js → github-badge-DmQreSDd.js} +1 -1
  70. package/dist/dashboard/assets/github-badge-DmQreSDd.js.gz +0 -0
  71. package/dist/dashboard/assets/{index-z3zDOSMM.js → index-Bblu6erR.js} +2 -2
  72. package/dist/dashboard/assets/index-Bblu6erR.js.gz +0 -0
  73. package/dist/dashboard/assets/{inline-BhY2sSnO.js → inline-C9dCYaBZ.js} +1 -1
  74. package/dist/dashboard/assets/inline-C9dCYaBZ.js.gz +0 -0
  75. package/dist/dashboard/assets/{input-V1umFiBk.js → input-CjCnXweJ.js} +1 -1
  76. package/dist/dashboard/assets/input-CjCnXweJ.js.gz +0 -0
  77. package/dist/dashboard/assets/{layout-BBOYycyS.js → layout-V6y8DAkl.js} +1 -1
  78. package/dist/dashboard/assets/layout-V6y8DAkl.js.gz +0 -0
  79. package/dist/dashboard/assets/{list-row-1zzZYM0B.js → list-row-CM1AaG_y.js} +1 -1
  80. package/dist/dashboard/assets/list-row-CM1AaG_y.js.gz +0 -0
  81. package/dist/dashboard/assets/{live-BivGfuUs.js → live-ta6GMb-8.js} +1 -1
  82. package/dist/dashboard/assets/live-ta6GMb-8.js.gz +0 -0
  83. package/dist/dashboard/assets/{model-bans-CmffjLuG.js → model-bans-BmYTmbAk.js} +1 -1
  84. package/dist/dashboard/assets/model-bans-BmYTmbAk.js.gz +0 -0
  85. package/dist/dashboard/assets/{mutation-46P0oWMe.js → mutation-g_fduiNw.js} +1 -1
  86. package/dist/dashboard/assets/mutation-g_fduiNw.js.gz +0 -0
  87. package/dist/dashboard/assets/{numbers-DkfMR5Qs.js → numbers-BOevJzdz.js} +1 -1
  88. package/dist/dashboard/assets/numbers-BOevJzdz.js.gz +0 -0
  89. package/dist/dashboard/assets/{query-keys-BFhGpwR1.js → query-keys-UETqfytp.js} +1 -1
  90. package/dist/dashboard/assets/query-keys-UETqfytp.js.gz +0 -0
  91. package/dist/dashboard/assets/{routing-CAb4F37R.js → routing-BPUo-W8d.js} +1 -1
  92. package/dist/dashboard/assets/routing-BPUo-W8d.js.gz +0 -0
  93. package/dist/dashboard/assets/{select-C6MMiaio.js → select-C980c4cz.js} +1 -1
  94. package/dist/dashboard/assets/select-C980c4cz.js.gz +0 -0
  95. package/dist/dashboard/assets/{settings-DNX9sydi.js → settings--3hxSyry.js} +1 -1
  96. package/dist/dashboard/assets/settings--3hxSyry.js.gz +0 -0
  97. package/dist/dashboard/assets/{stack-BHTfXdz_.js → stack-_gfTdLVB.js} +1 -1
  98. package/dist/dashboard/assets/stack-_gfTdLVB.js.gz +0 -0
  99. package/dist/dashboard/assets/{state-mPDRlQkl.js → state-2c5V4zo7.js} +1 -1
  100. package/dist/dashboard/assets/state-2c5V4zo7.js.gz +0 -0
  101. package/dist/dashboard/assets/{switch-DOmJxg7H.js → switch-Dkke7Naf.js} +1 -1
  102. package/dist/dashboard/assets/switch-Dkke7Naf.js.gz +0 -0
  103. package/dist/dashboard/assets/{useMutation-Dem0lXQj.js → useMutation-EDFRkn1i.js} +1 -1
  104. package/dist/dashboard/assets/useMutation-EDFRkn1i.js.gz +0 -0
  105. package/dist/dashboard/index.html +1 -1
  106. package/dist/dashboard/index.html.gz +0 -0
  107. package/dist/dashboard/precompressed-assets.json +51 -51
  108. package/migrations/README.md +52 -52
  109. package/migrations/full-postgres/0020_add_telemetry_event_analytics.sql +77 -0
  110. package/migrations/full-postgres/0021_add_api_key_concurrency_tolerance.sql +13 -0
  111. package/migrations/full-postgres/0022_add_inferhub_config_key.sql +17 -0
  112. package/migrations/full-postgres/0023_drop_api_key_concurrency_tolerance.sql +13 -0
  113. package/migrations/lite-sqlite3/0020_add_telemetry_event_analytics.sql +69 -0
  114. package/migrations/lite-sqlite3/0021_add_api_key_concurrency_tolerance.sql +13 -0
  115. package/migrations/lite-sqlite3/0022_add_inferhub_config_key.sql +17 -0
  116. package/migrations/lite-sqlite3/0023_drop_api_key_concurrency_tolerance.sql +13 -0
  117. package/package.json +96 -97
  118. package/scripts/cli/admin.ts +126 -125
  119. package/scripts/cli/autostart.ts +237 -237
  120. package/scripts/cli/background.ts +120 -110
  121. package/scripts/cli/bin/carte.cjs +8 -8
  122. package/scripts/cli/bin/cartethyia.cjs +167 -167
  123. package/scripts/cli/console-menu.ts +308 -275
  124. package/scripts/cli/controller.ts +145 -0
  125. package/scripts/cli/doctor.ts +1 -1
  126. package/scripts/cli/env.ts +99 -99
  127. package/scripts/cli/gateway.ts +264 -261
  128. package/scripts/{health.ts → cli/health.ts} +4 -4
  129. package/scripts/cli/instance.ts +234 -224
  130. package/scripts/cli/main.ts +188 -164
  131. package/scripts/cli/platform.ts +64 -64
  132. package/scripts/cli/prompt.ts +275 -107
  133. package/scripts/cli/services.ts +88 -88
  134. package/scripts/cli/setup.ts +445 -445
  135. package/scripts/cli/start.ts +85 -82
  136. package/scripts/cli/startup-signal.ts +23 -23
  137. package/scripts/cli/telemetry.ts +70 -0
  138. package/scripts/cli/tray/index.ts +263 -263
  139. package/scripts/cli/tray/windows.ps1 +107 -107
  140. package/scripts/cli/tray.ts +192 -208
  141. package/scripts/cli/update.ts +39 -39
  142. package/scripts/cli/version.ts +67 -67
  143. package/scripts/cli/wordmark.ts +58 -58
  144. package/src/boot/app.ts +16 -1
  145. package/src/boot/dependencies.ts +128 -25
  146. package/src/config/package-paths.ts +24 -0
  147. package/src/config/resources.ts +137 -0
  148. package/src/config/runtime.ts +133 -76
  149. package/src/config/spec.ts +30 -29
  150. package/src/config/telemetry.ts +0 -25
  151. package/src/console/api-keys/bucket-spend.ts +14 -17
  152. package/src/console/api-keys/contracts.ts +410 -410
  153. package/src/console/api-keys/routes.ts +12 -0
  154. package/src/console/audit/store.ts +2 -3
  155. package/src/console/auth/setup-service.ts +8 -1
  156. package/src/console/backup/routes.ts +7 -0
  157. package/src/console/backup/service.ts +463 -463
  158. package/src/console/backup/store.ts +16 -11
  159. package/src/console/backup/validate.ts +1 -4
  160. package/src/console/cli-tools/fs-ops.ts +18 -2
  161. package/src/console/data-management/contracts.ts +1 -8
  162. package/src/console/data-management/operations.ts +61 -48
  163. package/src/console/data-management/routes.ts +4 -2
  164. package/src/console/domain-registration.ts +25 -3
  165. package/src/console/inferhub/client.ts +139 -0
  166. package/src/console/inferhub/key-store.ts +129 -0
  167. package/src/console/inferhub/normalize.ts +347 -0
  168. package/src/console/inferhub/routes.ts +411 -0
  169. package/src/console/inferhub/store.ts +109 -0
  170. package/src/console/inferhub/types.ts +183 -0
  171. package/src/console/observability/contracts.ts +2 -41
  172. package/src/console/observability/store.ts +176 -371
  173. package/src/console/providers/catalog/public-model-store.ts +0 -0
  174. package/src/console/providers/catalog/store.ts +23 -36
  175. package/src/console/quota/account-quota-shared.ts +52 -52
  176. package/src/console/quota/account-quota-tenant.ts +16 -24
  177. package/src/console/quota/refresh.ts +441 -441
  178. package/src/console/remote-support/service.ts +270 -114
  179. package/src/console/routing/pools/import-parse.ts +206 -206
  180. package/src/console/routing/pools/operations.ts +543 -543
  181. package/src/console/routing/pools/probe-verdict.ts +132 -132
  182. package/src/console/routing/pools/routes.ts +181 -181
  183. package/src/console/routing/pools/store.ts +1 -1
  184. package/src/console/settings/contracts.ts +42 -40
  185. package/src/console/settings/store.ts +25 -25
  186. package/src/console/share/share-stats.ts +22 -4
  187. package/src/console/share/share-usage.ts +30 -4
  188. package/src/console/shared/cursor.ts +15 -0
  189. package/src/console/updates/repository-updates.ts +40 -39
  190. package/src/console/updates/routes.ts +12 -0
  191. package/src/main.ts +13 -5
  192. package/src/network/pool/resolver.ts +1104 -1104
  193. package/src/observability/client-name.ts +22 -0
  194. package/src/observability/event-log.ts +5 -29
  195. package/src/observability/event-query.ts +690 -0
  196. package/src/observability/log-ring.ts +26 -2
  197. package/src/observability/log-sanitize.ts +118 -0
  198. package/src/observability/logger.ts +17 -13
  199. package/src/observability/metrics.ts +35 -0
  200. package/src/observability/payload-capture.ts +114 -41
  201. package/src/observability/payload-store.ts +249 -24
  202. package/src/observability/raw-event-writer.ts +118 -0
  203. package/src/observability/runtime-metrics.ts +71 -1
  204. package/src/observability/telemetry-buffer.ts +100 -17
  205. package/src/observability/telemetry-reconciliation.ts +417 -0
  206. package/src/persistence/boot.ts +20 -9
  207. package/src/persistence/db-pg.ts +13 -0
  208. package/src/persistence/db-sqlite.ts +569 -497
  209. package/src/persistence/dialect.ts +3 -2
  210. package/src/persistence/migrate.ts +181 -181
  211. package/src/persistence/schema.ts +1496 -1406
  212. package/src/persistence/shared-cache.ts +5 -1
  213. package/src/persistence/stores/api-key-store.ts +581 -581
  214. package/src/persistence/stores/telemetry-store.ts +124 -63
  215. package/src/protocol/reasoning-text.ts +30 -0
  216. package/src/protocol/registry.ts +2 -0
  217. package/src/protocol/response/chat.ts +33 -7
  218. package/src/protocol/response/codex.ts +14 -2
  219. package/src/protocol/response/messages.ts +5 -2
  220. package/src/providers/authentication/oauth-flow-store.ts +3 -10
  221. package/src/providers/bundled-discovery-providers.ts +122 -122
  222. package/src/providers/default-registry.ts +14 -0
  223. package/src/providers/discovery/catalog/catalog-blob.ts +18 -18
  224. package/src/providers/discovery/models-dev-catalog.ts +354 -354
  225. package/src/providers/discovery/probe-phases.ts +43 -7
  226. package/src/providers/discovery/probing-service.ts +70 -32
  227. package/src/providers/integrations/antigravity/antigravity.ts +9 -2
  228. package/src/providers/integrations/buddy/buddy-catalog-shared.ts +85 -17
  229. package/src/providers/integrations/buddy/buddy-chat-shared.ts +934 -934
  230. package/src/providers/integrations/buddy/buddy-checkin.ts +5 -9
  231. package/src/providers/integrations/buddy/buddy-discovery-shared.ts +3 -7
  232. package/src/providers/integrations/buddy/buddy-quota-shared.ts +3 -1
  233. package/src/providers/integrations/buddy/capabilities.ts +4 -0
  234. package/src/providers/integrations/buddy/codebuddy/cn-provider.ts +57 -49
  235. package/src/providers/integrations/buddy/codebuddy/provider.ts +180 -180
  236. package/src/providers/integrations/buddy/workbuddy/provider.ts +206 -206
  237. package/src/providers/integrations/buddy/workbuddy/quota.ts +161 -161
  238. package/src/providers/integrations/claude/claude-quota.ts +2 -2
  239. package/src/providers/integrations/claude/claude-user-profiles.ts +3 -2
  240. package/src/providers/integrations/claude/claude.ts +3 -4
  241. package/src/providers/integrations/cline/cline.ts +94 -8
  242. package/src/providers/integrations/codex/codex.ts +61 -37
  243. package/src/providers/integrations/cursor/cursor-catalog.ts +368 -368
  244. package/src/providers/integrations/cursor/cursor-http2.ts +300 -300
  245. package/src/providers/integrations/cursor/cursor-identity.ts +2 -4
  246. package/src/providers/integrations/cursor/cursor-request.ts +11 -0
  247. package/src/providers/integrations/cursor/cursor.ts +29 -17
  248. package/src/providers/integrations/cursor/protocol/framing.ts +129 -129
  249. package/src/providers/integrations/cursor/protocol/messages.ts +2380 -2380
  250. package/src/providers/integrations/cursor/protocol/struct.ts +305 -305
  251. package/src/providers/integrations/cursor/protocol/tool-canonical.ts +275 -0
  252. package/src/providers/integrations/github/github.ts +3 -1
  253. package/src/providers/integrations/grok/grok-quota.ts +279 -279
  254. package/src/providers/integrations/grok/grok-ratelimit-store.ts +73 -73
  255. package/src/providers/integrations/grok/grok-ratelimit.ts +218 -218
  256. package/src/providers/integrations/hermes.ts +7 -1
  257. package/src/providers/integrations/inferhub.ts +201 -73
  258. package/src/providers/integrations/kilo/kilo.ts +152 -152
  259. package/src/providers/integrations/kiro/kiro-machine-id.ts +2 -4
  260. package/src/providers/integrations/opencode/provider.ts +2 -0
  261. package/src/providers/integrations/openrouter/provider.ts +129 -129
  262. package/src/providers/integrations/qoder/qoder-quota.ts +193 -192
  263. package/src/providers/integrations/qoder/qoder-realm.ts +106 -106
  264. package/src/providers/integrations/trae/trae-headers.ts +17 -48
  265. package/src/providers/integrations/trae/trae-oauth.ts +4 -26
  266. package/src/providers/integrations/trae/trae-quota.ts +389 -384
  267. package/src/providers/integrations/trae/trae-realm.ts +15 -2
  268. package/src/providers/integrations/trae/trae.ts +22 -24
  269. package/src/providers/integrations/xiaomi-mimo/think-stream.ts +100 -24
  270. package/src/providers/integrations/zcode/oauth.ts +1 -1
  271. package/src/providers/operations/account-health-service.ts +605 -279
  272. package/src/providers/provider-metadata.ts +12 -1
  273. package/src/providers/provider-model-definition.ts +373 -373
  274. package/src/providers/provider-probe.ts +3 -0
  275. package/src/providers/quota/quota-contracts.ts +3 -7
  276. package/src/providers/search/search-provider.ts +2 -6
  277. package/src/security/admission/contracts.ts +10 -0
  278. package/src/security/admission/in-memory-store.ts +89 -14
  279. package/src/security/admission/lua.ts +191 -182
  280. package/src/security/admission/redis-store.ts +30 -0
  281. package/src/security/admission/service.ts +18 -0
  282. package/src/security/api-key-auth-cache.ts +96 -0
  283. package/src/security/api-key-auth.ts +11 -100
  284. package/src/security/client-router-fingerprint.ts +3 -7
  285. package/src/security/ip-boundary.ts +7 -3
  286. package/src/shared/coerce.ts +67 -0
  287. package/src/shared/hash.ts +6 -0
  288. package/src/shared/time.ts +7 -0
  289. package/src/transport/dispatch/attempt-finalize.ts +26 -138
  290. package/src/transport/dispatch/attempt-loop.ts +103 -81
  291. package/src/transport/dispatch/capture-policy.ts +78 -0
  292. package/src/transport/dispatch/proxy-request.ts +4 -2
  293. package/src/transport/dispatch/streaming/encoder.ts +111 -5
  294. package/src/transport/dispatch/streaming/stream.ts +19 -2
  295. package/src/transport/dispatch/streaming/thinking-loop.ts +300 -0
  296. package/src/transport/failure-policy.ts +27 -0
  297. package/src/transport/guards/abuse-guard.ts +2 -2
  298. package/src/transport/guards/auth-guard.ts +17 -0
  299. package/src/transport/guards/body-policy.ts +3 -2
  300. package/src/transport/guards/concurrency-guard.ts +89 -13
  301. package/src/transport/guards/early-rejection-capture.ts +43 -3
  302. package/src/transport/guards/error-lifecycle.ts +10 -2
  303. package/src/transport/guards/guard-errors.ts +23 -0
  304. package/src/transport/guards/headroom-guard.ts +41 -7
  305. package/src/transport/guards/pipeline.ts +24 -0
  306. package/src/transport/guards/request-context.ts +2 -1
  307. package/src/transport/routing/admission.ts +51 -9
  308. package/src/transport/routing/bounded-lru.ts +49 -0
  309. package/src/transport/routing/candidate-index.ts +88 -0
  310. package/src/transport/routing/reservations.ts +121 -7
  311. package/src/transport/routing/round-robin.ts +10 -22
  312. package/src/transport/routing/route-catalog.ts +26 -13
  313. package/src/transport/routing/route-model.ts +22 -2
  314. package/src/transport/routing/router.ts +53 -31
  315. package/src/transport/surface/chat/encode.ts +2 -3
  316. package/src/transport/surface/chat/parse.ts +2 -1
  317. package/src/transport/surface/dialects.ts +11 -3
  318. package/src/transport/surface/messages/encode.ts +2 -1
  319. package/src/transport/surface/messages/parse.ts +3 -1
  320. package/src/transport/surface/messages/stream.ts +2 -6
  321. package/src/workers/maintenance-lease.ts +200 -0
  322. package/src/workers/scheduler.ts +101 -1
  323. package/dist/dashboard/assets/BannedPage-Brvuj_Eb.js.gz +0 -0
  324. package/dist/dashboard/assets/CliToolDetailPage-CqfXtI3y.js.gz +0 -0
  325. package/dist/dashboard/assets/CliToolsPage-GQeS91bg.js.gz +0 -0
  326. package/dist/dashboard/assets/CombosPage-BDRsTXBB.js.gz +0 -0
  327. package/dist/dashboard/assets/ConsoleLogPage-zP8AFHX0.js.gz +0 -0
  328. package/dist/dashboard/assets/CustomizationPage-BmfrNZ14.js.gz +0 -0
  329. package/dist/dashboard/assets/HealthEventsModal-Dn3M6WZc.js +0 -1
  330. package/dist/dashboard/assets/HealthEventsModal-Dn3M6WZc.js.gz +0 -0
  331. package/dist/dashboard/assets/LoginPage-DoreIgm8.js.gz +0 -0
  332. package/dist/dashboard/assets/ModelPicker-C7pDb41R.js.gz +0 -0
  333. package/dist/dashboard/assets/OverviewPage-CvvD1Ugk.js +0 -1
  334. package/dist/dashboard/assets/OverviewPage-CvvD1Ugk.js.gz +0 -0
  335. package/dist/dashboard/assets/ProviderDetailPage-Clbn1gsW.js +0 -3
  336. package/dist/dashboard/assets/ProviderDetailPage-Clbn1gsW.js.gz +0 -0
  337. package/dist/dashboard/assets/ProvidersPage-BnoPgA7w.js.gz +0 -0
  338. package/dist/dashboard/assets/ProxyPage-Bq_TGgdb.js.gz +0 -0
  339. package/dist/dashboard/assets/QuotaPage-D9DHXvom.js +0 -1
  340. package/dist/dashboard/assets/QuotaPage-D9DHXvom.js.gz +0 -0
  341. package/dist/dashboard/assets/SettingsPage-7xV8WkWL.js +0 -1
  342. package/dist/dashboard/assets/SettingsPage-7xV8WkWL.js.gz +0 -0
  343. package/dist/dashboard/assets/SetupPage-Day3mCOn.js.gz +0 -0
  344. package/dist/dashboard/assets/SortableList-DQxllnB5.js.gz +0 -0
  345. package/dist/dashboard/assets/UsagePage-DXa1oR-4.js.gz +0 -0
  346. package/dist/dashboard/assets/api-keys-DQYLQxpW.js.gz +0 -0
  347. package/dist/dashboard/assets/app-CX_Z8cMs.css +0 -2
  348. package/dist/dashboard/assets/app-CX_Z8cMs.css.gz +0 -0
  349. package/dist/dashboard/assets/assert-C9FD_JwJ.js.gz +0 -0
  350. package/dist/dashboard/assets/badge-CR72dasT.js.gz +0 -0
  351. package/dist/dashboard/assets/banner-CI9_eSfO.js.gz +0 -0
  352. package/dist/dashboard/assets/card-DS7CQEsO.js.gz +0 -0
  353. package/dist/dashboard/assets/cli-tools-CNqzrfdb.js.gz +0 -0
  354. package/dist/dashboard/assets/clipboard-button-611pSsaX.js.gz +0 -0
  355. package/dist/dashboard/assets/dialog-k37exjNt.js.gz +0 -0
  356. package/dist/dashboard/assets/drawer-CX7N8ucR.js.gz +0 -0
  357. package/dist/dashboard/assets/entry-B9Xvtnfj.js +0 -1
  358. package/dist/dashboard/assets/entry-B9Xvtnfj.js.gz +0 -0
  359. package/dist/dashboard/assets/entry-ByMGkR3C.js +0 -4
  360. package/dist/dashboard/assets/entry-ByMGkR3C.js.gz +0 -0
  361. package/dist/dashboard/assets/entry-CTP8AyiS.js.gz +0 -0
  362. package/dist/dashboard/assets/github-badge-sltk1qUi.js.gz +0 -0
  363. package/dist/dashboard/assets/index-z3zDOSMM.js.gz +0 -0
  364. package/dist/dashboard/assets/inline-BhY2sSnO.js.gz +0 -0
  365. package/dist/dashboard/assets/input-V1umFiBk.js.gz +0 -0
  366. package/dist/dashboard/assets/layout-BBOYycyS.js.gz +0 -0
  367. package/dist/dashboard/assets/list-row-1zzZYM0B.js.gz +0 -0
  368. package/dist/dashboard/assets/live-BivGfuUs.js.gz +0 -0
  369. package/dist/dashboard/assets/model-bans-CmffjLuG.js.gz +0 -0
  370. package/dist/dashboard/assets/mutation-46P0oWMe.js.gz +0 -0
  371. package/dist/dashboard/assets/numbers-DkfMR5Qs.js.gz +0 -0
  372. package/dist/dashboard/assets/query-keys-BFhGpwR1.js.gz +0 -0
  373. package/dist/dashboard/assets/routing-CAb4F37R.js.gz +0 -0
  374. package/dist/dashboard/assets/select-C6MMiaio.js.gz +0 -0
  375. package/dist/dashboard/assets/settings-DNX9sydi.js.gz +0 -0
  376. package/dist/dashboard/assets/stack-BHTfXdz_.js.gz +0 -0
  377. package/dist/dashboard/assets/state-mPDRlQkl.js.gz +0 -0
  378. package/dist/dashboard/assets/switch-DOmJxg7H.js.gz +0 -0
  379. package/dist/dashboard/assets/useMutation-Dem0lXQj.js.gz +0 -0
  380. package/scripts/build/aot.ts +0 -143
  381. package/scripts/build/build.ts +0 -24
  382. package/scripts/build/compile.ts +0 -88
  383. package/scripts/build/restart.ts +0 -120
  384. package/scripts/build/start.ts +0 -25
  385. package/src/observability/event-compaction.ts +0 -317
  386. package/src/observability/event-day-index.ts +0 -440
@@ -0,0 +1,145 @@
1
+ import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { pidAlive } from "./instance";
4
+
5
+ /** A menu or tray that exclusively owns this installation's interactive UI. */
6
+ export type ControllerKind = "menu" | "tray";
7
+
8
+ /** Proof passed to the tray during Hide to Tray. Never printed or persisted in logs. */
9
+ export interface ControllerHandoff {
10
+ readonly token: string;
11
+ readonly parentPid: number;
12
+ }
13
+
14
+ export interface ControllerLease {
15
+ readonly handoff: ControllerHandoff;
16
+ readonly release: () => void;
17
+ }
18
+
19
+ interface ControllerRecord extends ControllerHandoff {
20
+ readonly pid: number;
21
+ readonly kind: ControllerKind;
22
+ readonly startedAt: string;
23
+ }
24
+
25
+ const CONTROLLER_FILE = "controller.json";
26
+
27
+ function controllerPath(): string {
28
+ const configDir = process.env.CARTETHYIA_CONFIG_DIR;
29
+ if (!configDir) throw new Error("Cartethyia config directory is unavailable");
30
+ mkdirSync(configDir, { recursive: true });
31
+ return join(configDir, CONTROLLER_FILE);
32
+ }
33
+
34
+ function readController(path: string): ControllerRecord | null {
35
+ try {
36
+ const value = JSON.parse(readFileSync(path, "utf8")) as Partial<ControllerRecord>;
37
+ if (typeof value.pid !== "number" || typeof value.parentPid !== "number" ||
38
+ typeof value.token !== "string" || value.token.length === 0 ||
39
+ (value.kind !== "menu" && value.kind !== "tray") || typeof value.startedAt !== "string") return null;
40
+ return value as ControllerRecord;
41
+ } catch (error) {
42
+ if ((error as NodeJS.ErrnoException).code === "ENOENT") return null;
43
+ // A partially rewritten or corrupt file must not be treated as permission
44
+ // to start a second gateway. It is only safe to reclaim a record whose old
45
+ // owner can be identified and is definitely dead.
46
+ throw new Error("The Cartethyia controller lock is unreadable; close carte/tray before retrying");
47
+ }
48
+ }
49
+
50
+ function writeController(path: string, record: ControllerRecord, exclusive: boolean): void {
51
+ writeFileSync(path, JSON.stringify(record), {
52
+ encoding: "utf8",
53
+ mode: 0o600,
54
+ ...(exclusive ? { flag: "wx" } : {}),
55
+ });
56
+ }
57
+
58
+ /**
59
+ * Acquire the one interactive controller for an installation.
60
+ *
61
+ * Hide to Tray passes the existing token to its child. The child replaces the
62
+ * pid in the same file without unlinking it, so a second menu cannot sneak into
63
+ * the handoff gap and drain the gateway while the first tray is taking over.
64
+ */
65
+ export function acquireController(kind: ControllerKind, handoff?: ControllerHandoff): ControllerLease {
66
+ const path = controllerPath();
67
+ if (handoff !== undefined) {
68
+ const current = readController(path);
69
+ if (current === null || current.token !== handoff.token || current.parentPid !== handoff.parentPid ||
70
+ current.kind !== "menu") {
71
+ throw new Error("The menu-to-tray handoff is no longer owned by its original menu");
72
+ }
73
+ writeController(path, { ...current, pid: process.pid, kind: "tray" }, false);
74
+ } else {
75
+ const current = readController(path);
76
+ if (current !== null && pidAlive(current.pid)) {
77
+ throw new Error(`Cartethyia is already controlled by a ${current.kind} (PID ${current.pid}); not starting another instance`);
78
+ }
79
+ const token = crypto.randomUUID();
80
+ // Writing the replacement atomically avoids a corruption window in which
81
+ // another carte cannot tell whether the old owner was alive. A concurrent
82
+ // claimant reads either the complete old record or this complete new one.
83
+ const next: ControllerRecord = {
84
+ pid: process.pid,
85
+ parentPid: process.pid,
86
+ token,
87
+ kind,
88
+ startedAt: new Date().toISOString(),
89
+ };
90
+ try {
91
+ if (current !== null) {
92
+ const temporary = `${path}.${process.pid}.tmp`;
93
+ writeFileSync(temporary, JSON.stringify(next), { encoding: "utf8", mode: 0o600 });
94
+ try { renameSync(temporary, path); } catch (error) {
95
+ try { unlinkSync(temporary); } catch { /* Preserve the rename error. */ }
96
+ throw error;
97
+ }
98
+ } else writeController(path, next, true);
99
+ } catch (error) {
100
+ if ((error as NodeJS.ErrnoException).code === "EEXIST") {
101
+ throw new Error("Another Cartethyia menu or tray acquired the controller; not starting another instance");
102
+ }
103
+ throw error;
104
+ }
105
+ }
106
+
107
+ const token = handoff?.token ?? readController(path)?.token;
108
+ if (!token) throw new Error("Could not establish the Cartethyia controller lock");
109
+ const pid = process.pid;
110
+ let released = false;
111
+ return {
112
+ handoff: { token, parentPid: pid },
113
+ release: () => {
114
+ if (released) return;
115
+ released = true;
116
+ const current = readController(path);
117
+ // During a successful handoff the file already belongs to the tray. The
118
+ // parent must not delete its child's lease while returning to the shell.
119
+ if (current?.token === token && current.pid === pid) {
120
+ try { unlinkSync(path); } catch { /* A dead owner is reclaimed next start. */ }
121
+ }
122
+ },
123
+ };
124
+ }
125
+
126
+ /** Hand a failed tray startup back to the still-running menu. */
127
+ export function restoreControllerAfterFailedHandoff(handoff: ControllerHandoff): void {
128
+ const path = controllerPath();
129
+ const current = readController(path);
130
+ if (current?.token === handoff.token && current.parentPid === handoff.parentPid && current.kind === "tray") {
131
+ writeController(path, { ...current, pid: handoff.parentPid, kind: "menu" }, false);
132
+ }
133
+ }
134
+
135
+ /** Read the one-shot handoff proof without exposing it to normal process logs. */
136
+ export function inheritedControllerHandoff(env: NodeJS.ProcessEnv = process.env): ControllerHandoff | undefined {
137
+ const token = env.CARTETHYIA_CONTROLLER_TOKEN;
138
+ const parentPid = Number(env.CARTETHYIA_CONTROLLER_PARENT_PID);
139
+ if (!token || !Number.isInteger(parentPid) || parentPid <= 0) {
140
+ delete env.CARTETHYIA_CONTROLLER_TOKEN;
141
+ delete env.CARTETHYIA_CONTROLLER_PARENT_PID;
142
+ return undefined;
143
+ }
144
+ return { token, parentPid };
145
+ }
@@ -1,6 +1,6 @@
1
1
  import { ENV_PATH } from "./env";
2
2
  import { getLocalPlatform } from "./platform";
3
- import { hasRequiredFailure, runHealthChecks, type CheckPhase } from "../health";
3
+ import { hasRequiredFailure, runHealthChecks, type CheckPhase } from "./health";
4
4
 
5
5
  const phases: readonly CheckPhase[] = ["preflight", "configuration", "runtime"];
6
6
 
@@ -1,99 +1,99 @@
1
- import { existsSync } from "node:fs";
2
- import { readFile } from "node:fs/promises";
3
- import { resolve } from "node:path";
4
- import { PACKAGE_ROOT } from "../../src/config/package-paths";
5
-
6
- /**
7
- * Absolute path of the repository root.
8
- *
9
- * Operational scripts and the npm runtime share one package-root resolver so
10
- * assets and repository config do not depend on the caller's working directory.
11
- */
12
- export const PROJECT_ROOT = PACKAGE_ROOT;
13
-
14
- /** Resolve the active `.env`; npm CLI sets a user-owned config directory. */
15
- export function resolveEnvPath(env: NodeJS.ProcessEnv = process.env): string {
16
- const configDir = env.CARTETHYIA_CONFIG_DIR?.trim();
17
- return configDir ? resolve(configDir, ".env") : resolve(PROJECT_ROOT, ".env");
18
- }
19
-
20
- /** Absolute path of the active `.env`. */
21
- export const ENV_PATH = resolveEnvPath();
22
-
23
- /**
24
- * Reads a dotenv-style file without overriding already-exported variables.
25
- */
26
- export async function readEnvFile(path: string): Promise<Record<string, string>> {
27
- if (!existsSync(path)) return {};
28
- const content = await readFile(path, "utf8");
29
- const values: Record<string, string> = {};
30
- for (const line of content.split(/\r?\n/)) {
31
- if (line.startsWith("#")) continue;
32
- const separator = line.indexOf("=");
33
- if (separator <= 0) continue;
34
- const key = line.slice(0, separator).trim();
35
- const value = line.slice(separator + 1).trim();
36
- if (key) values[key] = value;
37
- }
38
- return values;
39
- }
40
-
41
- /**
42
- * Checks if a string contains a configured placeholder value.
43
- */
44
- export function hasPlaceholderSecrets(value: string): boolean {
45
- const normalized = value.toLowerCase();
46
- return (
47
- normalized.includes("replace-with") ||
48
- normalized.includes("replace_me") ||
49
- normalized.includes("your_")
50
- );
51
- }
52
-
53
- /**
54
- * Generates a 256-bit hex cartethyia encryption key.
55
- *
56
- * Hex is preferred over base64 because it never carries padding or `+`/`/`
57
- * characters that confuse some dotenv shells, and it round-trips through
58
- * every adapter that accepts either encoding. The install/setup helpers call
59
- * this when the key is absent or still a placeholder.
60
- */
61
- export function generateCartethyiaEncryptionKey(): string {
62
- const bytes = new Uint8Array(32);
63
- crypto.getRandomValues(bytes);
64
- let hex = "";
65
- for (let i = 0; i < bytes.length; i += 1) hex += bytes[i]!.toString(16).padStart(2, "0");
66
- return hex;
67
- }
68
-
69
- /**
70
- * Returns the mandatory-only `.env` body derived from `.env.example`.
71
- *
72
- * Mandatory means the key is assigned without a leading `#`. Optional entries
73
- * (leading `#`) carry built-in defaults and must not be copied into a fresh
74
- * `.env` — they would override the default with a literal `example` value.
75
- * The generated body therefore contains only mandatory rows, plus a single
76
- * `CARTETHYIA_ENCRYPTION_KEY` replacement when the caller supplies one.
77
- */
78
- export async function mandatoryEnvBody(
79
- examplePath: string,
80
- overrides: Readonly<Record<string, string>> = {},
81
- ): Promise<string> {
82
- const raw = await readFile(examplePath, "utf8");
83
- const lines: string[] = [];
84
- for (const line of raw.split(/\r?\n/)) {
85
- const trimmed = line.trim();
86
- if (trimmed === "" || trimmed.startsWith("#")) continue;
87
- const sep = line.indexOf("=");
88
- if (sep <= 0) continue;
89
- const key = line.slice(0, sep).trim();
90
- if (!key) continue;
91
- const value = (overrides as Record<string, string>)[key] ?? line.slice(sep + 1).trim();
92
- lines.push(`${key}=${value}`);
93
- }
94
- // Preserve overrides even when the example row was commented out (legacy case).
95
- for (const [key, value] of Object.entries(overrides)) {
96
- if (!lines.some((l) => l.startsWith(`${key}=`))) lines.push(`${key}=${value}`);
97
- }
98
- return `${lines.join("\n")}\n`;
99
- }
1
+ import { existsSync } from "node:fs";
2
+ import { readFile } from "node:fs/promises";
3
+ import { resolve } from "node:path";
4
+ import { PACKAGE_ROOT } from "../../src/config/package-paths";
5
+
6
+ /**
7
+ * Absolute path of the repository root.
8
+ *
9
+ * Operational scripts and the npm runtime share one package-root resolver so
10
+ * assets and repository config do not depend on the caller's working directory.
11
+ */
12
+ export const PROJECT_ROOT = PACKAGE_ROOT;
13
+
14
+ /** Resolve the active `.env`; npm CLI sets a user-owned config directory. */
15
+ export function resolveEnvPath(env: NodeJS.ProcessEnv = process.env): string {
16
+ const configDir = env.CARTETHYIA_CONFIG_DIR?.trim();
17
+ return configDir ? resolve(configDir, ".env") : resolve(PROJECT_ROOT, ".env");
18
+ }
19
+
20
+ /** Absolute path of the active `.env`. */
21
+ export const ENV_PATH = resolveEnvPath();
22
+
23
+ /**
24
+ * Reads a dotenv-style file without overriding already-exported variables.
25
+ */
26
+ export async function readEnvFile(path: string): Promise<Record<string, string>> {
27
+ if (!existsSync(path)) return {};
28
+ const content = await readFile(path, "utf8");
29
+ const values: Record<string, string> = {};
30
+ for (const line of content.split(/\r?\n/)) {
31
+ if (line.startsWith("#")) continue;
32
+ const separator = line.indexOf("=");
33
+ if (separator <= 0) continue;
34
+ const key = line.slice(0, separator).trim();
35
+ const value = line.slice(separator + 1).trim();
36
+ if (key) values[key] = value;
37
+ }
38
+ return values;
39
+ }
40
+
41
+ /**
42
+ * Checks if a string contains a configured placeholder value.
43
+ */
44
+ export function hasPlaceholderSecrets(value: string): boolean {
45
+ const normalized = value.toLowerCase();
46
+ return (
47
+ normalized.includes("replace-with") ||
48
+ normalized.includes("replace_me") ||
49
+ normalized.includes("your_")
50
+ );
51
+ }
52
+
53
+ /**
54
+ * Generates a 256-bit hex cartethyia encryption key.
55
+ *
56
+ * Hex is preferred over base64 because it never carries padding or `+`/`/`
57
+ * characters that confuse some dotenv shells, and it round-trips through
58
+ * every adapter that accepts either encoding. The install/setup helpers call
59
+ * this when the key is absent or still a placeholder.
60
+ */
61
+ export function generateCartethyiaEncryptionKey(): string {
62
+ const bytes = new Uint8Array(32);
63
+ crypto.getRandomValues(bytes);
64
+ let hex = "";
65
+ for (let i = 0; i < bytes.length; i += 1) hex += bytes[i]!.toString(16).padStart(2, "0");
66
+ return hex;
67
+ }
68
+
69
+ /**
70
+ * Returns the mandatory-only `.env` body derived from `.env.example`.
71
+ *
72
+ * Mandatory means the key is assigned without a leading `#`. Optional entries
73
+ * (leading `#`) carry built-in defaults and must not be copied into a fresh
74
+ * `.env` — they would override the default with a literal `example` value.
75
+ * The generated body therefore contains only mandatory rows, plus a single
76
+ * `CARTETHYIA_ENCRYPTION_KEY` replacement when the caller supplies one.
77
+ */
78
+ export async function mandatoryEnvBody(
79
+ examplePath: string,
80
+ overrides: Readonly<Record<string, string>> = {},
81
+ ): Promise<string> {
82
+ const raw = await readFile(examplePath, "utf8");
83
+ const lines: string[] = [];
84
+ for (const line of raw.split(/\r?\n/)) {
85
+ const trimmed = line.trim();
86
+ if (trimmed === "" || trimmed.startsWith("#")) continue;
87
+ const sep = line.indexOf("=");
88
+ if (sep <= 0) continue;
89
+ const key = line.slice(0, sep).trim();
90
+ if (!key) continue;
91
+ const value = (overrides as Record<string, string>)[key] ?? line.slice(sep + 1).trim();
92
+ lines.push(`${key}=${value}`);
93
+ }
94
+ // Preserve overrides even when the example row was commented out (legacy case).
95
+ for (const [key, value] of Object.entries(overrides)) {
96
+ if (!lines.some((l) => l.startsWith(`${key}=`))) lines.push(`${key}=${value}`);
97
+ }
98
+ return `${lines.join("\n")}\n`;
99
+ }