codexLB-up 1.25.0b10__py3-none-any.whl

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.

Potentially problematic release.


This version of codexLB-up might be problematic. Click here for more details.

Files changed (827) hide show
  1. app/__init__.py +10 -0
  2. app/admin_cli.py +494 -0
  3. app/cli.py +339 -0
  4. app/codex_sessions_retag.py +487 -0
  5. app/core/__init__.py +0 -0
  6. app/core/audit/__init__.py +0 -0
  7. app/core/audit/service.py +216 -0
  8. app/core/audit/types.py +94 -0
  9. app/core/auth/__init__.py +236 -0
  10. app/core/auth/api_key_cache.py +65 -0
  11. app/core/auth/dashboard_access.py +429 -0
  12. app/core/auth/dashboard_mode.py +171 -0
  13. app/core/auth/dashboard_session_ttl.py +74 -0
  14. app/core/auth/dashboard_users_cache.py +120 -0
  15. app/core/auth/dependencies.py +710 -0
  16. app/core/auth/external_identity.py +78 -0
  17. app/core/auth/guardian.py +374 -0
  18. app/core/auth/models.py +49 -0
  19. app/core/auth/providers/__init__.py +129 -0
  20. app/core/auth/providers/oidc.py +838 -0
  21. app/core/auth/providers/registry.py +118 -0
  22. app/core/auth/refresh.py +394 -0
  23. app/core/auth/step_up.py +117 -0
  24. app/core/auth/totp.py +81 -0
  25. app/core/balancer/__init__.py +71 -0
  26. app/core/balancer/logic.py +1612 -0
  27. app/core/balancer/rendezvous_hash.py +21 -0
  28. app/core/balancer/types.py +21 -0
  29. app/core/bootstrap.py +172 -0
  30. app/core/cache/invalidation.py +426 -0
  31. app/core/clients/__init__.py +0 -0
  32. app/core/clients/codex.py +996 -0
  33. app/core/clients/codex_version.py +187 -0
  34. app/core/clients/codex_version_snapshot.py +2 -0
  35. app/core/clients/files.py +534 -0
  36. app/core/clients/headers.py +29 -0
  37. app/core/clients/http.py +511 -0
  38. app/core/clients/model_fetcher.py +276 -0
  39. app/core/clients/native_egress.py +1304 -0
  40. app/core/clients/oauth.py +477 -0
  41. app/core/clients/proxy.py +6089 -0
  42. app/core/clients/proxy_websocket.py +1411 -0
  43. app/core/clients/rate_limit_reset_credits.py +412 -0
  44. app/core/clients/stream_errors.py +12 -0
  45. app/core/clients/thread_cache_identity.py +347 -0
  46. app/core/clients/usage.py +467 -0
  47. app/core/clock.py +170 -0
  48. app/core/config/__init__.py +0 -0
  49. app/core/config/background_jobs.py +73 -0
  50. app/core/config/context_window_overrides.py +166 -0
  51. app/core/config/dashboard_overrides.py +145 -0
  52. app/core/config/inheritable.py +47 -0
  53. app/core/config/key_fingerprint.py +115 -0
  54. app/core/config/settings.py +872 -0
  55. app/core/config/settings_cache.py +100 -0
  56. app/core/config/spool_retention.py +217 -0
  57. app/core/config/tiers.py +174 -0
  58. app/core/conversation_archive.py +568 -0
  59. app/core/crypto.py +37 -0
  60. app/core/draining.py +11 -0
  61. app/core/errors.py +365 -0
  62. app/core/exceptions.py +155 -0
  63. app/core/handlers/__init__.py +3 -0
  64. app/core/handlers/exceptions.py +478 -0
  65. app/core/http_protocol.py +176 -0
  66. app/core/http_protocol_httptools.py +204 -0
  67. app/core/ingress_limits.py +17 -0
  68. app/core/metadata_store.py +18 -0
  69. app/core/metrics/__init__.py +0 -0
  70. app/core/metrics/middleware.py +74 -0
  71. app/core/metrics/prometheus.py +604 -0
  72. app/core/middleware/__init__.py +25 -0
  73. app/core/middleware/api_firewall.py +111 -0
  74. app/core/middleware/app_version.py +37 -0
  75. app/core/middleware/dashboard_auth_proxy.py +55 -0
  76. app/core/middleware/dashboard_csrf.py +177 -0
  77. app/core/middleware/dashboard_gzip.py +41 -0
  78. app/core/middleware/dashboard_overrides.py +59 -0
  79. app/core/middleware/firewall_cache.py +91 -0
  80. app/core/middleware/inflight.py +126 -0
  81. app/core/middleware/multipart_content_encoding.py +129 -0
  82. app/core/middleware/path_rewrite.py +148 -0
  83. app/core/middleware/request_body_limit.py +196 -0
  84. app/core/middleware/request_decompression.py +209 -0
  85. app/core/middleware/request_id.py +72 -0
  86. app/core/middleware/required_capability_http.py +116 -0
  87. app/core/middleware/trusted_proxy_headers.py +36 -0
  88. app/core/multipart.py +237 -0
  89. app/core/multipart_fields.py +91 -0
  90. app/core/openai/__init__.py +0 -0
  91. app/core/openai/chat_requests.py +493 -0
  92. app/core/openai/chat_responses.py +931 -0
  93. app/core/openai/contracts.py +46 -0
  94. app/core/openai/exceptions.py +24 -0
  95. app/core/openai/host_models.py +14 -0
  96. app/core/openai/images.py +413 -0
  97. app/core/openai/message_coercion.py +376 -0
  98. app/core/openai/model_refresh_scheduler.py +423 -0
  99. app/core/openai/model_registry.py +997 -0
  100. app/core/openai/model_registry_store.py +548 -0
  101. app/core/openai/models.py +172 -0
  102. app/core/openai/parsing.py +97 -0
  103. app/core/openai/requests.py +1980 -0
  104. app/core/openai/strict_schema.py +199 -0
  105. app/core/openai/tool_call_safety.py +99 -0
  106. app/core/openai/v1_requests.py +187 -0
  107. app/core/plan_types.py +90 -0
  108. app/core/prestop.py +202 -0
  109. app/core/rate_limiter/__init__.py +0 -0
  110. app/core/rate_limiter/db_rate_limiter.py +215 -0
  111. app/core/request_locality.py +473 -0
  112. app/core/resilience/__init__.py +0 -0
  113. app/core/resilience/backpressure.py +57 -0
  114. app/core/resilience/bulkhead.py +202 -0
  115. app/core/resilience/circuit_breaker.py +150 -0
  116. app/core/resilience/degradation.py +55 -0
  117. app/core/resilience/loop_lag_monitor.py +60 -0
  118. app/core/resilience/memory_monitor.py +137 -0
  119. app/core/resilience/network_recovery.py +256 -0
  120. app/core/resilience/overload.py +98 -0
  121. app/core/resilience/toggles.py +114 -0
  122. app/core/retention/__init__.py +0 -0
  123. app/core/retention/job.py +240 -0
  124. app/core/retention/scheduler.py +69 -0
  125. app/core/runtime_logging.py +601 -0
  126. app/core/scheduling/__init__.py +0 -0
  127. app/core/scheduling/leader_election.py +993 -0
  128. app/core/scheduling/leader_election_handle.py +25 -0
  129. app/core/server.py +140 -0
  130. app/core/shutdown.py +326 -0
  131. app/core/socket_peer.py +22 -0
  132. app/core/startup.py +41 -0
  133. app/core/timeout_invariants.py +347 -0
  134. app/core/tracing/__init__.py +0 -0
  135. app/core/tracing/otel.py +207 -0
  136. app/core/types.py +6 -0
  137. app/core/upstream_proxy/__init__.py +13 -0
  138. app/core/upstream_proxy/cache.py +130 -0
  139. app/core/upstream_proxy/resolver.py +189 -0
  140. app/core/upstream_proxy/types.py +104 -0
  141. app/core/usage/__init__.py +407 -0
  142. app/core/usage/depletion.py +109 -0
  143. app/core/usage/live_hub.py +41 -0
  144. app/core/usage/live_snapshots.py +174 -0
  145. app/core/usage/logs.py +212 -0
  146. app/core/usage/metadata_scheduler.py +118 -0
  147. app/core/usage/models.py +54 -0
  148. app/core/usage/pricing.py +576 -0
  149. app/core/usage/pricing_catalog.py +241 -0
  150. app/core/usage/pricing_snapshot.json +821 -0
  151. app/core/usage/quota.py +133 -0
  152. app/core/usage/refresh_policy.py +21 -0
  153. app/core/usage/refresh_scheduler.py +713 -0
  154. app/core/usage/reset_credits_refresh_scheduler.py +435 -0
  155. app/core/usage/types.py +168 -0
  156. app/core/utils/__init__.py +0 -0
  157. app/core/utils/json_guards.py +18 -0
  158. app/core/utils/locks.py +33 -0
  159. app/core/utils/masking.py +20 -0
  160. app/core/utils/proxy_env.py +104 -0
  161. app/core/utils/request_id.py +65 -0
  162. app/core/utils/retry.py +77 -0
  163. app/core/utils/shared_future.py +172 -0
  164. app/core/utils/sse.py +286 -0
  165. app/core/utils/time.py +24 -0
  166. app/db/__init__.py +0 -0
  167. app/db/account_identity_lock.py +56 -0
  168. app/db/alembic/__init__.py +1 -0
  169. app/db/alembic/env.py +70 -0
  170. app/db/alembic/revision_ids.py +43 -0
  171. app/db/alembic/versions/20260213_000000_base_schema.py +248 -0
  172. app/db/alembic/versions/20260213_000100_normalize_account_plan_types.py +45 -0
  173. app/db/alembic/versions/20260213_000200_add_request_logs_reasoning_effort.py +45 -0
  174. app/db/alembic/versions/20260213_000300_add_accounts_reset_at.py +45 -0
  175. app/db/alembic/versions/20260213_000400_add_accounts_chatgpt_account_id.py +45 -0
  176. app/db/alembic/versions/20260213_000500_add_dashboard_settings.py +70 -0
  177. app/db/alembic/versions/20260213_000600_add_dashboard_settings_totp.py +64 -0
  178. app/db/alembic/versions/20260213_000700_add_dashboard_settings_password.py +59 -0
  179. app/db/alembic/versions/20260213_000800_add_api_keys.py +87 -0
  180. app/db/alembic/versions/20260214_000000_add_api_key_limits.py +143 -0
  181. app/db/alembic/versions/20260215_000000_add_idx_logs_requested_at.py +38 -0
  182. app/db/alembic/versions/20260218_000000_add_api_key_usage_reservations.py +117 -0
  183. app/db/alembic/versions/20260218_000100_add_import_without_overwrite_and_drop_accounts_email_unique.py +198 -0
  184. app/db/alembic/versions/20260225_000000_add_dashboard_settings_routing_strategy.py +53 -0
  185. app/db/alembic/versions/20260228_020000_align_api_key_limit_enum_types.py +104 -0
  186. app/db/alembic/versions/20260228_030000_add_api_firewall_allowlist.py +42 -0
  187. app/db/alembic/versions/20260306_000000_add_request_logs_service_tier.py +45 -0
  188. app/db/alembic/versions/20260307_000000_add_api_key_enforcement_fields.py +56 -0
  189. app/db/alembic/versions/20260308_000000_add_sqlite_performance_indexes.py +41 -0
  190. app/db/alembic/versions/20260309_000000_add_additional_usage_history.py +71 -0
  191. app/db/alembic/versions/20260309_000000_request_logs_nullable_account_id.py +28 -0
  192. app/db/alembic/versions/20260310_000000_add_request_logs_transport.py +45 -0
  193. app/db/alembic/versions/20260310_000000_fix_postgresql_enum_value_casing.py +79 -0
  194. app/db/alembic/versions/20260310_120000_add_sticky_session_kinds_and_affinity_ttl.py +110 -0
  195. app/db/alembic/versions/20260312_000000_add_additional_usage_quota_key.py +193 -0
  196. app/db/alembic/versions/20260312_000000_split_sticky_sessions_primary_key_by_kind.py +96 -0
  197. app/db/alembic/versions/20260312_010000_merge_additional_usage_and_sticky_session_heads.py +25 -0
  198. app/db/alembic/versions/20260312_020000_merge_request_logs_transport_and_feature_heads.py +25 -0
  199. app/db/alembic/versions/20260312_020000_merge_request_logs_transport_and_sticky_heads.py +25 -0
  200. app/db/alembic/versions/20260312_120000_add_dashboard_upstream_stream_transport.py +62 -0
  201. app/db/alembic/versions/20260313_024500_merge_request_log_transport_heads.py +27 -0
  202. app/db/alembic/versions/20260319_100937_increase_prompt_cache_ttl_to_1800s.py +73 -0
  203. app/db/alembic/versions/20260319_111500_merge_prompt_cache_ttl_and_upstream_transport_heads.py +25 -0
  204. app/db/alembic/versions/20260319_183000_normalize_sqlite_account_status_casing.py +48 -0
  205. app/db/alembic/versions/20260320_000000_add_request_log_requested_actual_tiers.py +51 -0
  206. app/db/alembic/versions/20260321_190000_tighten_dashboard_db_indexes.py +64 -0
  207. app/db/alembic/versions/20260321_210000_merge_request_log_tiers_and_dashboard_index_heads.py +25 -0
  208. app/db/alembic/versions/20260325_000000_add_request_log_cost.py +193 -0
  209. app/db/alembic/versions/20260328_000000_add_rate_limit_attempts.py +48 -0
  210. app/db/alembic/versions/20260328_120000_add_request_log_ttft.py +37 -0
  211. app/db/alembic/versions/20260328_130000_add_audit_logs_table.py +45 -0
  212. app/db/alembic/versions/20260328_140000_add_scheduler_leader_table.py +39 -0
  213. app/db/alembic/versions/20260330_000000_add_cache_locality_settings.py +69 -0
  214. app/db/alembic/versions/20260330_010000_merge_scheduler_leader_and_cache_locality_heads.py +25 -0
  215. app/db/alembic/versions/20260330_020000_add_bridge_ring_members.py +46 -0
  216. app/db/alembic/versions/20260401_000000_add_api_key_enforced_service_tier.py +52 -0
  217. app/db/alembic/versions/20260401_000000_add_cache_invalidation.py +41 -0
  218. app/db/alembic/versions/20260401_020000_merge_cache_invalidation_and_api_key_service_tier_heads.py +22 -0
  219. app/db/alembic/versions/20260402_000000_switch_dashboard_routing_default_to_capacity_weighted.py +66 -0
  220. app/db/alembic/versions/20260403_000000_add_credit_api_key_limit_values.py +44 -0
  221. app/db/alembic/versions/20260406_000000_add_api_key_account_assignments.py +57 -0
  222. app/db/alembic/versions/20260406_010000_add_api_key_assignment_scope_flag.py +75 -0
  223. app/db/alembic/versions/20260407_000000_add_bridge_gateway_safe_mode.py +51 -0
  224. app/db/alembic/versions/20260407_010000_merge_api_key_assignment_and_bridge_gateway_heads.py +25 -0
  225. app/db/alembic/versions/20260408_000000_switch_import_without_overwrite_default_to_true.py +73 -0
  226. app/db/alembic/versions/20260408_010000_merge_import_without_overwrite_and_assignment_heads.py +25 -0
  227. app/db/alembic/versions/20260409_000000_add_http_bridge_sessions.py +130 -0
  228. app/db/alembic/versions/20260409_000000_switch_sticky_threads_and_prefer_earlier_reset_defaults_to_true.py +89 -0
  229. app/db/alembic/versions/20260409_010000_add_dashboard_settings_bootstrap_token.py +57 -0
  230. app/db/alembic/versions/20260409_010000_merge_http_bridge_and_import_without_overwrite_heads.py +25 -0
  231. app/db/alembic/versions/20260409_020000_fix_http_bridge_last_seen_index.py +46 -0
  232. app/db/alembic/versions/20260410_000000_backfill_pristine_dashboard_settings_defaults.py +77 -0
  233. app/db/alembic/versions/20260410_030000_restore_import_without_overwrite_default_true.py +73 -0
  234. app/db/alembic/versions/20260410_040000_merge_dashboard_defaults_and_import_default_heads.py +25 -0
  235. app/db/alembic/versions/20260413_000000_add_accounts_blocked_at.py +44 -0
  236. app/db/alembic/versions/20260415_160000_add_automations_tables.py +189 -0
  237. app/db/alembic/versions/20260415_160000_add_request_logs_response_lookup_index.py +67 -0
  238. app/db/alembic/versions/20260417_000000_add_request_log_plan_type.py +44 -0
  239. app/db/alembic/versions/20260418_190000_add_automation_runs_cycle_key.py +87 -0
  240. app/db/alembic/versions/20260419_000000_add_automation_run_cycle_metadata.py +56 -0
  241. app/db/alembic/versions/20260419_020000_add_automation_run_cycles_snapshot_tables.py +342 -0
  242. app/db/alembic/versions/20260421_000000_add_dashboard_session_ttl_setting.py +51 -0
  243. app/db/alembic/versions/20260421_120000_merge_request_log_lookup_and_plan_type_heads.py +25 -0
  244. app/db/alembic/versions/20260421_130000_merge_automation_and_request_log_heads.py +25 -0
  245. app/db/alembic/versions/20260422_103000_normalize_legacy_automation_run_cycle_keys.py +648 -0
  246. app/db/alembic/versions/20260423_120000_add_api_key_limit_reset_at_index.py +43 -0
  247. app/db/alembic/versions/20260424_000000_merge_dashboard_session_ttl_and_request_log_heads.py +25 -0
  248. app/db/alembic/versions/20260426_000000_add_dashboard_relative_availability_settings.py +68 -0
  249. app/db/alembic/versions/20260427_130000_add_warmup_model_and_request_kind.py +75 -0
  250. app/db/alembic/versions/20260506_000000_add_account_routing_policy.py +37 -0
  251. app/db/alembic/versions/20260509_000000_add_api_key_traffic_class.py +37 -0
  252. app/db/alembic/versions/20260509_010000_add_additional_quota_routing_policies.py +37 -0
  253. app/db/alembic/versions/20260513_000000_add_accounts_alias.py +44 -0
  254. app/db/alembic/versions/20260513_000000_add_api_key_apply_to_codex_model.py +59 -0
  255. app/db/alembic/versions/20260514_000000_add_request_logs_api_key_time_index.py +43 -0
  256. app/db/alembic/versions/20260515_000000_add_prefer_earlier_reset_window.py +47 -0
  257. app/db/alembic/versions/20260515_000000_soft_delete_request_logs_on_account_delete.py +83 -0
  258. app/db/alembic/versions/20260515_020000_add_split_sticky_budget_thresholds.py +62 -0
  259. app/db/alembic/versions/20260516_000000_add_sqlite_hot_path_indexes.py +75 -0
  260. app/db/alembic/versions/20260517_000000_merge_sqlite_hot_path_and_request_log_delete_heads.py +24 -0
  261. app/db/alembic/versions/20260518_000000_add_http_bridge_durable_input_prefix.py +44 -0
  262. app/db/alembic/versions/20260518_010000_merge_http_bridge_and_sqlite_recovery_heads.py +25 -0
  263. app/db/alembic/versions/20260518_120000_add_dashboard_guest_access.py +57 -0
  264. app/db/alembic/versions/20260520_000000_merge_api_key_and_http_bridge_heads.py +26 -0
  265. app/db/alembic/versions/20260520_010000_add_request_logs_api_key_account_index.py +45 -0
  266. app/db/alembic/versions/20260520_010000_merge_automation_and_api_key_heads.py +26 -0
  267. app/db/alembic/versions/20260520_030000_add_quota_planner.py +194 -0
  268. app/db/alembic/versions/20260520_040000_merge_quota_planner_and_request_log_index_heads.py +24 -0
  269. app/db/alembic/versions/20260521_000000_add_account_security_work_authorized.py +46 -0
  270. app/db/alembic/versions/20260521_000000_merge_dashboard_guest_and_api_key_heads.py +26 -0
  271. app/db/alembic/versions/20260521_000000_merge_prefer_reset_window_head.py +26 -0
  272. app/db/alembic/versions/20260521_000000_merge_warmup_and_request_log_index_heads.py +25 -0
  273. app/db/alembic/versions/20260522_000000_add_limit_warmup_trigger.py +195 -0
  274. app/db/alembic/versions/20260524_000000_merge_accounts_alias_and_reset_window_heads.py +24 -0
  275. app/db/alembic/versions/20260525_000000_add_usage_raw_window_latest_index.py +31 -0
  276. app/db/alembic/versions/20260526_000000_add_request_log_failure_metadata.py +100 -0
  277. app/db/alembic/versions/20260531_000000_add_account_workspace_identity.py +39 -0
  278. app/db/alembic/versions/20260531_000000_add_single_account_routing.py +42 -0
  279. app/db/alembic/versions/20260601_000000_merge_relative_availability_and_usage_raw_heads.py +24 -0
  280. app/db/alembic/versions/20260601_010000_add_api_key_usage_sections.py +58 -0
  281. app/db/alembic/versions/20260601_010000_add_routing_policy_persistence.py +67 -0
  282. app/db/alembic/versions/20260601_010000_merge_security_work_and_relative_availability_heads.py +25 -0
  283. app/db/alembic/versions/20260601_010000_merge_split_sticky_and_relative_usage_heads.py +25 -0
  284. app/db/alembic/versions/20260601_010000_merge_warmup_and_relative_availability_heads.py +25 -0
  285. app/db/alembic/versions/20260601_020000_merge_additional_quota_routing_and_relative_availability_heads.py +25 -0
  286. app/db/alembic/versions/20260601_020000_merge_quota_planner_and_relative_availability_heads.py +25 -0
  287. app/db/alembic/versions/20260601_020000_merge_reset_window_and_relative_availability_heads.py +25 -0
  288. app/db/alembic/versions/20260601_020000_merge_routing_policy_and_split_threshold_heads.py +24 -0
  289. app/db/alembic/versions/20260601_020000_merge_warmup_and_request_log_failure_heads.py +25 -0
  290. app/db/alembic/versions/20260601_030000_merge_single_account_and_routing_quota_heads.py +29 -0
  291. app/db/alembic/versions/20260601_040000_merge_security_work_and_routing_consolidation_heads.py +25 -0
  292. app/db/alembic/versions/20260601_050000_merge_quota_planner_and_routing_consolidation_heads.py +25 -0
  293. app/db/alembic/versions/20260602_050000_add_upstream_proxy_routing.py +164 -0
  294. app/db/alembic/versions/20260602_060000_merge_account_workspace_and_failure_heads.py +25 -0
  295. app/db/alembic/versions/20260602_070000_add_request_log_useragent_fields.py +86 -0
  296. app/db/alembic/versions/20260602_070000_merge_quota_planner_and_account_workspace_heads.py +25 -0
  297. app/db/alembic/versions/20260602_080000_merge_upstream_proxy_and_quota_planner_heads.py +25 -0
  298. app/db/alembic/versions/20260602_080000_merge_useragent_and_upstream_proxy_heads.py +24 -0
  299. app/db/alembic/versions/20260603_000000_add_weekly_pace_working_days.py +52 -0
  300. app/db/alembic/versions/20260603_000000_free_account_monthly_window.py +60 -0
  301. app/db/alembic/versions/20260604_000000_add_reauth_required_account_status.py +159 -0
  302. app/db/alembic/versions/20260604_010000_merge_automations_and_reauth_status_heads.py +25 -0
  303. app/db/alembic/versions/20260604_010000_merge_dashboard_guest_and_reauth_status_heads.py +25 -0
  304. app/db/alembic/versions/20260604_010000_merge_useragent_and_reauth_heads.py +24 -0
  305. app/db/alembic/versions/20260607_000000_merge_weekly_monthly_useragent_heads.py +28 -0
  306. app/db/alembic/versions/20260608_000000_add_hide_upstream_quota_from_api_keys.py +50 -0
  307. app/db/alembic/versions/20260611_000000_add_request_log_archive_request_id.py +47 -0
  308. app/db/alembic/versions/20260611_000000_merge_automations_and_weekly_monthly_useragent_heads.py +26 -0
  309. app/db/alembic/versions/20260611_000000_merge_dashboard_guest_and_weekly_useragent_heads.py +26 -0
  310. app/db/alembic/versions/20260611_010000_add_request_log_client_ip.py +57 -0
  311. app/db/alembic/versions/20260611_020000_merge_request_log_archive_and_client_ip_heads.py +26 -0
  312. app/db/alembic/versions/20260611_030000_merge_dashboard_guest_and_request_log_client_ip_heads.py +26 -0
  313. app/db/alembic/versions/20260613_000000_add_accounts_codex_installation_id.py +57 -0
  314. app/db/alembic/versions/20260613_010000_merge_installation_id_and_dashboard_weekly_heads.py +26 -0
  315. app/db/alembic/versions/20260615_000000_merge_automations_and_dashboard_guest_heads.py +26 -0
  316. app/db/alembic/versions/20260623_000000_add_limit_warmup_exhausted_threshold.py +51 -0
  317. app/db/alembic/versions/20260626_000000_add_http_downstream_transport_policy.py +46 -0
  318. app/db/alembic/versions/20260626_010000_add_request_logs_upstream_transport.py +31 -0
  319. app/db/alembic/versions/20260629_000000_add_dashboard_query_hot_path_indexes.py +53 -0
  320. app/db/alembic/versions/20260630_000000_add_limit_warmup_staggered_idle.py +47 -0
  321. app/db/alembic/versions/20260630_000000_merge_request_log_client_ip_and_dashboard_hot_path_heads.py +26 -0
  322. app/db/alembic/versions/20260630_010000_merge_warmup_and_request_log_dashboard_heads.py +26 -0
  323. app/db/alembic/versions/20260630_020000_merge_automations_and_main_heads.py +26 -0
  324. app/db/alembic/versions/20260630_020000_merge_warmup_threshold_and_main_heads.py +26 -0
  325. app/db/alembic/versions/20260630_030000_add_automation_run_model_snapshot.py +59 -0
  326. app/db/alembic/versions/20260630_040000_merge_automation_snapshot_and_warmup_threshold_heads.py +26 -0
  327. app/db/alembic/versions/20260630_050000_add_automation_run_prompt_snapshot.py +52 -0
  328. app/db/alembic/versions/20260701_000000_add_weekly_pace_smoothing_minutes.py +51 -0
  329. app/db/alembic/versions/20260702_000000_add_model_sources.py +176 -0
  330. app/db/alembic/versions/20260705_000000_add_model_source_audio_transcriptions.py +50 -0
  331. app/db/alembic/versions/20260705_000000_harden_dashboard_session_ttl.py +62 -0
  332. app/db/alembic/versions/20260706_000000_add_model_source_audio_per_minute.py +43 -0
  333. app/db/alembic/versions/20260707_000000_merge_model_sources_and_session_ttl.py +24 -0
  334. app/db/alembic/versions/20260707_010000_merge_automations_and_model_sources_heads.py +24 -0
  335. app/db/alembic/versions/20260707_020000_add_automation_job_account_scope.py +125 -0
  336. app/db/alembic/versions/20260709_000000_add_ttft_phase_observability.py +66 -0
  337. app/db/alembic/versions/20260711_000000_add_dashboard_prohibit_fast_mode.py +42 -0
  338. app/db/alembic/versions/20260711_010000_add_account_chatgpt_user_id.py +40 -0
  339. app/db/alembic/versions/20260711_020000_add_dashboard_account_concurrency_caps.py +71 -0
  340. app/db/alembic/versions/20260711_030000_add_limit_warmup_idle_threshold.py +51 -0
  341. app/db/alembic/versions/20260712_010000_add_account_usage_rollups.py +56 -0
  342. app/db/alembic/versions/20260712_020000_add_api_key_usage_rollups.py +53 -0
  343. app/db/alembic/versions/20260713_020000_add_model_registry_snapshot.py +42 -0
  344. app/db/alembic/versions/20260713_040000_add_account_refresh_claims.py +42 -0
  345. app/db/alembic/versions/20260713_040000_add_replica_guardrails.py +64 -0
  346. app/db/alembic/versions/20260713_070000_add_reset_credit_redeem_tables.py +58 -0
  347. app/db/alembic/versions/20260714_000000_add_oauth_flow_states.py +63 -0
  348. app/db/alembic/versions/20260715_000000_add_request_log_queue_latency.py +44 -0
  349. app/db/alembic/versions/20260716_000000_add_oauth_device_flow_slots.py +41 -0
  350. app/db/alembic/versions/20260716_010000_add_dashboard_retention_settings.py +48 -0
  351. app/db/alembic/versions/20260716_010000_add_reset_credit_display_settings.py +73 -0
  352. app/db/alembic/versions/20260717_000000_add_http_bridge_retry_circuits.py +47 -0
  353. app/db/alembic/versions/20260717_000000_merge_retention_and_reset_credit_display_heads.py +26 -0
  354. app/db/alembic/versions/20260717_000000_optimize_dashboard_hot_path_indexes.py +162 -0
  355. app/db/alembic/versions/20260717_000001_merge_retry_circuits_and_dashboard_indexes.py +22 -0
  356. app/db/alembic/versions/20260720_000000_add_request_log_conversation_id.py +57 -0
  357. app/db/alembic/versions/20260722_000000_backfill_request_log_useragent_families.py +40 -0
  358. app/db/alembic/versions/20260724_000000_add_request_usage_time_rollups.py +176 -0
  359. app/db/alembic/versions/20260724_000000_merge_request_log_schema_heads.py +33 -0
  360. app/db/alembic/versions/20260725_000000_add_http_bridge_pending_tool_calls.py +43 -0
  361. app/db/alembic/versions/20260726_000000_add_account_plan_downgrade_observations.py +44 -0
  362. app/db/alembic/versions/20260726_000000_repair_request_usage_rollups_after_merge.py +37 -0
  363. app/db/alembic/versions/20260727_000000_add_sticky_session_continuity_abandoned_at.py +45 -0
  364. app/db/alembic/versions/20260728_000000_merge_pending_tool_calls_and_rollup_repair_heads.py +31 -0
  365. app/db/alembic/versions/20260730_000000_add_api_key_fair_share_threshold.py +44 -0
  366. app/db/alembic/versions/20260730_000000_add_http_bridge_recovery_attempts.py +60 -0
  367. app/db/alembic/versions/20260731_000000_add_capability_lineage_markers.py +38 -0
  368. app/db/alembic/versions/20260803_000000_merge_http_bridge_recovery_and_capability_lineage_heads.py +30 -0
  369. app/db/alembic/versions/20260804_000000_add_http_bridge_operations.py +63 -0
  370. app/db/alembic/versions/20260804_000001_add_global_http_bridge_operation_fingerprint.py +53 -0
  371. app/db/alembic/versions/20260804_230000_add_request_log_connection_request_kind.py +43 -0
  372. app/db/alembic/versions/20260805_000000_add_http_bridge_operation_spool.py +75 -0
  373. app/db/alembic/versions/20260805_000001_finalize_http_bridge_operation_spool.py +65 -0
  374. app/db/alembic/versions/20260806_000000_add_additional_usage_alias_probe_indexes.py +84 -0
  375. app/db/alembic/versions/20260806_000000_add_anonymous_telemetry.py +49 -0
  376. app/db/alembic/versions/20260806_010000_add_conversation_presence_rollup.py +72 -0
  377. app/db/alembic/versions/20260806_020000_add_usage_history_bulk_covering_indexes.py +99 -0
  378. app/db/alembic/versions/20260806_030000_add_api_key_allowed_reasoning_efforts.py +65 -0
  379. app/db/alembic/versions/20260806_120000_add_http_bridge_owner_process_epoch.py +57 -0
  380. app/db/alembic/versions/20260807_000000_merge_http_bridge_operation_spool_and_latest_main.py +24 -0
  381. app/db/alembic/versions/20260808_000000_tune_usage_history_autovacuum.py +54 -0
  382. app/db/alembic/versions/20260810_000000_add_http_bridge_recovery_dispatch_count.py +44 -0
  383. app/db/alembic/versions/20260811_000000_add_hourly_rollup_cancelled_count.py +92 -0
  384. app/db/alembic/versions/20260812_000000_merge_recovery_dispatch_and_hourly_cancelled_heads.py +25 -0
  385. app/db/alembic/versions/20260812_120000_add_sticky_abandonment_scope.py +43 -0
  386. app/db/alembic/versions/20260813_000000_add_file_account_pins.py +40 -0
  387. app/db/alembic/versions/20260816_000000_add_account_pending_deletion.py +81 -0
  388. app/db/alembic/versions/20260816_000000_add_model_source_embeddings.py +50 -0
  389. app/db/alembic/versions/20260821_000000_add_retry_circuit_admission_generation.py +49 -0
  390. app/db/alembic/versions/20260826_000000_add_http_bridge_event_chunks.py +107 -0
  391. app/db/alembic/versions/20260828_000000_add_accounts_chatgpt_identity_index.py +55 -0
  392. app/db/alembic/versions/20260830_000000_add_quota_warmup_claim_expiry.py +83 -0
  393. app/db/alembic/versions/20260908_000000_add_guest_session_generation.py +37 -0
  394. app/db/alembic/versions/20260908_000000_add_subscription_overflow.py +140 -0
  395. app/db/alembic/versions/20260908_000000_replace_upstream_stream_transport_default_sentinel.py +50 -0
  396. app/db/alembic/versions/20260908_020000_merge_overflow_transport_heads.py +27 -0
  397. app/db/alembic/versions/20260909_000000_add_dashboard_roles.py +72 -0
  398. app/db/alembic/versions/20260909_010000_add_dashboard_users.py +183 -0
  399. app/db/alembic/versions/20260909_020000_reproject_compat_admin_credentials.py +105 -0
  400. app/db/alembic/versions/20260909_030000_add_audit_actor_columns.py +103 -0
  401. app/db/alembic/versions/20260909_030000_dashboard_resilience_toggle_settings.py +63 -0
  402. app/db/alembic/versions/20260909_040000_add_dashboard_user_invites.py +54 -0
  403. app/db/alembic/versions/20260909_040000_dashboard_timeout_settings.py +68 -0
  404. app/db/alembic/versions/20260909_050000_dashboard_routing_overload_settings.py +65 -0
  405. app/db/alembic/versions/20260909_060000_add_report_rollup.py +74 -0
  406. app/db/alembic/versions/20260909_070000_automation_run_claim_budget.py +50 -0
  407. app/db/alembic/versions/20260909_080000_dashboard_stream_bridge_budgets.py +62 -0
  408. app/db/alembic/versions/20260909_090000_dashboard_background_job_toggles.py +63 -0
  409. app/db/alembic/versions/20260909_100000_dashboard_codex_prewarm.py +49 -0
  410. app/db/alembic/versions/20260909_110000_model_context_window_overrides.py +45 -0
  411. app/db/alembic/versions/20260909_120000_dashboard_conversation_archive.py +48 -0
  412. app/db/alembic/versions/20260909_130000_add_request_logs_live_facet_indexes.py +96 -0
  413. app/db/alembic/versions/20260910_000000_add_totp_required_for_admin_role.py +44 -0
  414. app/db/alembic/versions/20260910_000000_request_logs_missing_cost_index.py +52 -0
  415. app/db/alembic/versions/20260910_010000_add_dashboard_auth_providers.py +134 -0
  416. app/db/alembic/versions/20260910_010000_dashboard_spool_retention.py +52 -0
  417. app/db/alembic/versions/20260910_020000_add_dashboard_role_mappings.py +74 -0
  418. app/db/alembic/versions/20260910_143000_request_log_affinity.py +28 -0
  419. app/db/alembic/versions/20260910_180000_merge_affinity_guest_heads.py +17 -0
  420. app/db/alembic/versions/20260910_200000_merge_affinity_identity_heads.py +17 -0
  421. app/db/alembic/versions/20260910_220000_merge_affinity_invite_heads.py +17 -0
  422. app/db/alembic/versions/20260911_000000_model_source_pins_kind_expires_index.py +43 -0
  423. app/db/alembic/versions/20260911_010000_merge_pin_index_and_affinity_heads.py +17 -0
  424. app/db/alembic/versions/20260911_020000_add_http_bridge_terminal_append_phase.py +54 -0
  425. app/db/alembic/versions/20260911_030000_add_local_login_policy.py +48 -0
  426. app/db/alembic/versions/20260911_040000_add_thread_cache_identity_mode.py +48 -0
  427. app/db/alembic/versions/20260911_060000_add_bridge_session_continuity_abandonment.py +40 -0
  428. app/db/alembic/versions/20260912_000000_merge_thread_cache_and_bridge_retirement_heads.py +22 -0
  429. app/db/alembic/versions/20260912_010000_drop_legacy_dashboard_credentials.py +140 -0
  430. app/db/alembic/versions/20260913_000000_add_oidc_provider_flow.py +134 -0
  431. app/db/alembic/versions/20260914_000000_add_scim_tokens.py +78 -0
  432. app/db/alembic/versions/20260914_000000_drop_subscription_overflow_schema.py +132 -0
  433. app/db/alembic/versions/20260918_000000_merge_scim_and_overflow_heads.py +17 -0
  434. app/db/alembic/versions/__init__.py +1 -0
  435. app/db/backup.py +64 -0
  436. app/db/migrate.py +1249 -0
  437. app/db/migration_lock.py +160 -0
  438. app/db/migration_url.py +18 -0
  439. app/db/models.py +3100 -0
  440. app/db/recover.py +244 -0
  441. app/db/session.py +1295 -0
  442. app/db/snapshot.py +46 -0
  443. app/db/sqlite_lock_retry.py +190 -0
  444. app/db/sqlite_utils.py +549 -0
  445. app/dependencies.py +462 -0
  446. app/main.py +1240 -0
  447. app/modules/__init__.py +0 -0
  448. app/modules/accounts/__init__.py +0 -0
  449. app/modules/accounts/api.py +426 -0
  450. app/modules/accounts/auth_manager.py +1439 -0
  451. app/modules/accounts/background_repository.py +160 -0
  452. app/modules/accounts/deletion.py +540 -0
  453. app/modules/accounts/mappers.py +654 -0
  454. app/modules/accounts/refresh_claims.py +352 -0
  455. app/modules/accounts/repository.py +1679 -0
  456. app/modules/accounts/schemas.py +308 -0
  457. app/modules/accounts/service.py +809 -0
  458. app/modules/accounts/usage_rollup.py +486 -0
  459. app/modules/accounts/usage_rollup_scheduler.py +75 -0
  460. app/modules/accounts/usage_time_rollup.py +1037 -0
  461. app/modules/accounts/usage_time_rollup_read.py +522 -0
  462. app/modules/api_keys/__init__.py +1 -0
  463. app/modules/api_keys/api.py +344 -0
  464. app/modules/api_keys/last_used_coalescer.py +216 -0
  465. app/modules/api_keys/limit_windows.py +41 -0
  466. app/modules/api_keys/repository.py +1200 -0
  467. app/modules/api_keys/reset_scheduler.py +85 -0
  468. app/modules/api_keys/schemas.py +135 -0
  469. app/modules/api_keys/service.py +2123 -0
  470. app/modules/audit/__init__.py +0 -0
  471. app/modules/audit/api.py +88 -0
  472. app/modules/audit/repository.py +74 -0
  473. app/modules/audit/schemas.py +33 -0
  474. app/modules/audit/service.py +71 -0
  475. app/modules/auth_providers/__init__.py +0 -0
  476. app/modules/auth_providers/api.py +127 -0
  477. app/modules/auth_providers/config.py +343 -0
  478. app/modules/auth_providers/repository.py +101 -0
  479. app/modules/auth_providers/schemas.py +88 -0
  480. app/modules/auth_providers/seed.py +105 -0
  481. app/modules/auth_providers/service.py +289 -0
  482. app/modules/automations/__init__.py +1 -0
  483. app/modules/automations/api.py +369 -0
  484. app/modules/automations/repository.py +1896 -0
  485. app/modules/automations/scheduler.py +107 -0
  486. app/modules/automations/schemas.py +158 -0
  487. app/modules/automations/service.py +2548 -0
  488. app/modules/cache_isolation_probe/__init__.py +0 -0
  489. app/modules/cache_isolation_probe/api.py +188 -0
  490. app/modules/cache_isolation_probe/prefix.py +144 -0
  491. app/modules/cache_isolation_probe/schemas.py +94 -0
  492. app/modules/cache_isolation_probe/sender.py +229 -0
  493. app/modules/cache_isolation_probe/service.py +525 -0
  494. app/modules/conversation_archive/__init__.py +1 -0
  495. app/modules/conversation_archive/api.py +101 -0
  496. app/modules/conversation_archive/schemas.py +28 -0
  497. app/modules/conversation_archive/service.py +165 -0
  498. app/modules/dashboard/__init__.py +1 -0
  499. app/modules/dashboard/api.py +106 -0
  500. app/modules/dashboard/builders.py +107 -0
  501. app/modules/dashboard/repository.py +304 -0
  502. app/modules/dashboard/schemas.py +148 -0
  503. app/modules/dashboard/service.py +534 -0
  504. app/modules/dashboard/timeframes.py +19 -0
  505. app/modules/dashboard/weekly_pace.py +617 -0
  506. app/modules/dashboard_auth/__init__.py +1 -0
  507. app/modules/dashboard_auth/api.py +1344 -0
  508. app/modules/dashboard_auth/oidc_api.py +753 -0
  509. app/modules/dashboard_auth/oidc_flows.py +330 -0
  510. app/modules/dashboard_auth/repository.py +452 -0
  511. app/modules/dashboard_auth/schemas.py +232 -0
  512. app/modules/dashboard_auth/service.py +1384 -0
  513. app/modules/dashboard_roles/__init__.py +0 -0
  514. app/modules/dashboard_roles/api.py +64 -0
  515. app/modules/dashboard_roles/repository.py +54 -0
  516. app/modules/dashboard_roles/schemas.py +29 -0
  517. app/modules/dashboard_roles/seed.py +80 -0
  518. app/modules/dashboard_roles/service.py +142 -0
  519. app/modules/dashboard_users/__init__.py +0 -0
  520. app/modules/dashboard_users/api.py +278 -0
  521. app/modules/dashboard_users/break_glass.py +169 -0
  522. app/modules/dashboard_users/credentials.py +18 -0
  523. app/modules/dashboard_users/identity_resolver.py +665 -0
  524. app/modules/dashboard_users/repository.py +725 -0
  525. app/modules/dashboard_users/schemas.py +117 -0
  526. app/modules/dashboard_users/service.py +1054 -0
  527. app/modules/firewall/__init__.py +1 -0
  528. app/modules/firewall/api.py +78 -0
  529. app/modules/firewall/repository.py +51 -0
  530. app/modules/firewall/schemas.py +28 -0
  531. app/modules/firewall/service.py +93 -0
  532. app/modules/fleet/__init__.py +1 -0
  533. app/modules/fleet/api.py +177 -0
  534. app/modules/fleet/mappers.py +56 -0
  535. app/modules/fleet/observability.py +372 -0
  536. app/modules/fleet/schemas.py +119 -0
  537. app/modules/health/__init__.py +0 -0
  538. app/modules/health/api.py +246 -0
  539. app/modules/health/schemas.py +27 -0
  540. app/modules/limit_warmup/__init__.py +1 -0
  541. app/modules/limit_warmup/repository.py +159 -0
  542. app/modules/limit_warmup/service.py +1001 -0
  543. app/modules/model_sources/__init__.py +1 -0
  544. app/modules/model_sources/api.py +99 -0
  545. app/modules/model_sources/catalog.py +307 -0
  546. app/modules/model_sources/forwarding.py +1435 -0
  547. app/modules/model_sources/projection.py +55 -0
  548. app/modules/model_sources/repository.py +201 -0
  549. app/modules/model_sources/schemas.py +79 -0
  550. app/modules/model_sources/selection.py +166 -0
  551. app/modules/model_sources/service.py +236 -0
  552. app/modules/oauth/__init__.py +0 -0
  553. app/modules/oauth/api.py +101 -0
  554. app/modules/oauth/repository.py +238 -0
  555. app/modules/oauth/schemas.py +49 -0
  556. app/modules/oauth/service.py +1196 -0
  557. app/modules/oauth/templates/oauth_success.html +122 -0
  558. app/modules/proxy/__init__.py +0 -0
  559. app/modules/proxy/_load_balancer/__init__.py +1 -0
  560. app/modules/proxy/_load_balancer/error_rate.py +116 -0
  561. app/modules/proxy/_load_balancer/latency_cohort.py +154 -0
  562. app/modules/proxy/_load_balancer/model_eligibility.py +250 -0
  563. app/modules/proxy/_load_balancer/opportunistic_admission.py +350 -0
  564. app/modules/proxy/_load_balancer/overload_backoff.py +394 -0
  565. app/modules/proxy/_load_balancer/sticky_selection.py +2417 -0
  566. app/modules/proxy/_load_balancer/throughput_cohort.py +233 -0
  567. app/modules/proxy/_load_balancer/ttft_cohort.py +214 -0
  568. app/modules/proxy/_load_balancer/tunables.py +97 -0
  569. app/modules/proxy/_load_balancer/types.py +96 -0
  570. app/modules/proxy/_load_balancer/unbound_selection.py +534 -0
  571. app/modules/proxy/_service/__init__.py +6 -0
  572. app/modules/proxy/_service/api_key_usage.py +745 -0
  573. app/modules/proxy/_service/clock_budget.py +38 -0
  574. app/modules/proxy/_service/codex_control.py +611 -0
  575. app/modules/proxy/_service/compact.py +2211 -0
  576. app/modules/proxy/_service/file_ops.py +749 -0
  577. app/modules/proxy/_service/http_bridge/__init__.py +3 -0
  578. app/modules/proxy/_service/http_bridge/accepted_replay.py +331 -0
  579. app/modules/proxy/_service/http_bridge/account_sessions.py +57 -0
  580. app/modules/proxy/_service/http_bridge/activity.py +178 -0
  581. app/modules/proxy/_service/http_bridge/helpers.py +3959 -0
  582. app/modules/proxy/_service/http_bridge/mixin.py +2435 -0
  583. app/modules/proxy/_service/http_bridge/owner_forwarding.py +609 -0
  584. app/modules/proxy/_service/http_bridge/protocol.py +167 -0
  585. app/modules/proxy/_service/http_bridge/proxy_failover.py +58 -0
  586. app/modules/proxy/_service/http_bridge/quarantine.py +443 -0
  587. app/modules/proxy/_service/http_bridge/request_submit.py +4582 -0
  588. app/modules/proxy/_service/http_bridge/retry_circuit.py +2442 -0
  589. app/modules/proxy/_service/http_bridge/service_stubs.py +492 -0
  590. app/modules/proxy/_service/http_bridge/session_registry.py +778 -0
  591. app/modules/proxy/_service/http_bridge/streaming.py +5328 -0
  592. app/modules/proxy/_service/http_bridge/upstream_events.py +4538 -0
  593. app/modules/proxy/_service/observability.py +410 -0
  594. app/modules/proxy/_service/rate_limit.py +361 -0
  595. app/modules/proxy/_service/realtime_live.py +655 -0
  596. app/modules/proxy/_service/refresh.py +154 -0
  597. app/modules/proxy/_service/request_log.py +585 -0
  598. app/modules/proxy/_service/response_create.py +930 -0
  599. app/modules/proxy/_service/streaming/__init__.py +3 -0
  600. app/modules/proxy/_service/streaming/helpers.py +1317 -0
  601. app/modules/proxy/_service/streaming/mixin.py +1100 -0
  602. app/modules/proxy/_service/streaming/protocol.py +32 -0
  603. app/modules/proxy/_service/streaming/retry.py +3762 -0
  604. app/modules/proxy/_service/support.py +2122 -0
  605. app/modules/proxy/_service/transcribe.py +434 -0
  606. app/modules/proxy/_service/warmup.py +483 -0
  607. app/modules/proxy/_service/websocket/__init__.py +3 -0
  608. app/modules/proxy/_service/websocket/helpers.py +2360 -0
  609. app/modules/proxy/_service/websocket/mixin.py +7285 -0
  610. app/modules/proxy/_service/websocket/protocol.py +74 -0
  611. app/modules/proxy/account_cache.py +229 -0
  612. app/modules/proxy/account_eligibility.py +87 -0
  613. app/modules/proxy/additional_model_limits.py +40 -0
  614. app/modules/proxy/affinity.py +830 -0
  615. app/modules/proxy/affinity_observation.py +101 -0
  616. app/modules/proxy/api.py +10254 -0
  617. app/modules/proxy/api_key_usage.py +113 -0
  618. app/modules/proxy/cap_partitioning.py +280 -0
  619. app/modules/proxy/capability_lineage.py +65 -0
  620. app/modules/proxy/capability_lineage_repository.py +82 -0
  621. app/modules/proxy/capability_routing.py +253 -0
  622. app/modules/proxy/continuity.py +112 -0
  623. app/modules/proxy/downstream_delivery.py +277 -0
  624. app/modules/proxy/durable_bridge_coordinator.py +1217 -0
  625. app/modules/proxy/durable_bridge_repository.py +4516 -0
  626. app/modules/proxy/durable_bridge_runtime.py +9 -0
  627. app/modules/proxy/durable_bridge_transcript_codec.py +122 -0
  628. app/modules/proxy/fair_share.py +131 -0
  629. app/modules/proxy/file_pin_repository.py +210 -0
  630. app/modules/proxy/helpers.py +439 -0
  631. app/modules/proxy/http_bridge_event_batcher.py +613 -0
  632. app/modules/proxy/http_bridge_forwarding.py +797 -0
  633. app/modules/proxy/http_continuation.py +76 -0
  634. app/modules/proxy/images_observability.py +62 -0
  635. app/modules/proxy/images_service.py +1054 -0
  636. app/modules/proxy/load_balancer.py +3016 -0
  637. app/modules/proxy/rate_limit_cache.py +46 -0
  638. app/modules/proxy/replay_safety.py +1063 -0
  639. app/modules/proxy/repo_bundle.py +31 -0
  640. app/modules/proxy/request_policy.py +1054 -0
  641. app/modules/proxy/ring_membership.py +251 -0
  642. app/modules/proxy/schemas.py +345 -0
  643. app/modules/proxy/selection_errors.py +41 -0
  644. app/modules/proxy/service.py +2600 -0
  645. app/modules/proxy/source_admission.py +125 -0
  646. app/modules/proxy/source_dispatch.py +999 -0
  647. app/modules/proxy/sticky_repository.py +831 -0
  648. app/modules/proxy/thread_anchors.py +491 -0
  649. app/modules/proxy/tool_call_dedupe.py +802 -0
  650. app/modules/proxy/types.py +54 -0
  651. app/modules/proxy/work_admission.py +121 -0
  652. app/modules/quota_planner/__init__.py +1 -0
  653. app/modules/quota_planner/api.py +276 -0
  654. app/modules/quota_planner/logic.py +743 -0
  655. app/modules/quota_planner/repository.py +722 -0
  656. app/modules/quota_planner/scheduler.py +212 -0
  657. app/modules/quota_planner/schemas.py +102 -0
  658. app/modules/quota_planner/warmup.py +693 -0
  659. app/modules/rate_limit_reset_credits/__init__.py +0 -0
  660. app/modules/rate_limit_reset_credits/api.py +601 -0
  661. app/modules/rate_limit_reset_credits/redeem_coordination.py +274 -0
  662. app/modules/rate_limit_reset_credits/store.py +114 -0
  663. app/modules/reports/__init__.py +1 -0
  664. app/modules/reports/api.py +134 -0
  665. app/modules/reports/cache.py +74 -0
  666. app/modules/reports/filters.py +27 -0
  667. app/modules/reports/repository.py +525 -0
  668. app/modules/reports/rollup.py +150 -0
  669. app/modules/reports/rollup_read.py +148 -0
  670. app/modules/reports/schemas.py +123 -0
  671. app/modules/reports/service.py +287 -0
  672. app/modules/reports/thread_identity.py +256 -0
  673. app/modules/request_logs/__init__.py +0 -0
  674. app/modules/request_logs/api.py +224 -0
  675. app/modules/request_logs/cost_backfill.py +154 -0
  676. app/modules/request_logs/mappers.py +97 -0
  677. app/modules/request_logs/repository.py +1765 -0
  678. app/modules/request_logs/schemas.py +145 -0
  679. app/modules/request_logs/service.py +348 -0
  680. app/modules/role_mappings/__init__.py +0 -0
  681. app/modules/role_mappings/api.py +206 -0
  682. app/modules/role_mappings/matching.py +55 -0
  683. app/modules/role_mappings/repository.py +106 -0
  684. app/modules/role_mappings/schemas.py +67 -0
  685. app/modules/role_mappings/service.py +334 -0
  686. app/modules/runtime/__init__.py +1 -0
  687. app/modules/runtime/api.py +18 -0
  688. app/modules/runtime/schemas.py +14 -0
  689. app/modules/runtime/service.py +218 -0
  690. app/modules/scim/__init__.py +1 -0
  691. app/modules/scim/api.py +194 -0
  692. app/modules/scim/dependencies.py +112 -0
  693. app/modules/scim/errors.py +77 -0
  694. app/modules/scim/management_api.py +156 -0
  695. app/modules/scim/repository.py +212 -0
  696. app/modules/scim/schemas.py +145 -0
  697. app/modules/scim/service.py +786 -0
  698. app/modules/scim/tokens.py +43 -0
  699. app/modules/settings/__init__.py +1 -0
  700. app/modules/settings/api.py +1677 -0
  701. app/modules/settings/repository.py +606 -0
  702. app/modules/settings/schemas.py +496 -0
  703. app/modules/settings/service.py +769 -0
  704. app/modules/shared/__init__.py +0 -0
  705. app/modules/shared/schemas.py +22 -0
  706. app/modules/sticky_sessions/__init__.py +1 -0
  707. app/modules/sticky_sessions/api.py +118 -0
  708. app/modules/sticky_sessions/cleanup_scheduler.py +487 -0
  709. app/modules/sticky_sessions/schemas.py +78 -0
  710. app/modules/sticky_sessions/service.py +196 -0
  711. app/modules/telemetry/__init__.py +5 -0
  712. app/modules/telemetry/api.py +115 -0
  713. app/modules/telemetry/clients.py +62 -0
  714. app/modules/telemetry/consent.py +115 -0
  715. app/modules/telemetry/scheduler.py +85 -0
  716. app/modules/telemetry/schemas.py +163 -0
  717. app/modules/telemetry/sender.py +221 -0
  718. app/modules/telemetry/snapshot.py +490 -0
  719. app/modules/usage/__init__.py +0 -0
  720. app/modules/usage/additional_quota_keys.py +379 -0
  721. app/modules/usage/api.py +45 -0
  722. app/modules/usage/background_repository.py +147 -0
  723. app/modules/usage/builders.py +559 -0
  724. app/modules/usage/depletion_service.py +277 -0
  725. app/modules/usage/live_ingest.py +356 -0
  726. app/modules/usage/mappers.py +29 -0
  727. app/modules/usage/plan_downgrade_observations.py +488 -0
  728. app/modules/usage/repository.py +1890 -0
  729. app/modules/usage/schemas.py +68 -0
  730. app/modules/usage/service.py +102 -0
  731. app/modules/usage/updater.py +1488 -0
  732. app/static/assets/Trans-Cj-J9mVA.js +1 -0
  733. app/static/assets/access-page-DHzZiXZi.js +1 -0
  734. app/static/assets/account-cost-donut-DGhfA4U8.js +1 -0
  735. app/static/assets/account-identifiers-CxbdLshZ.js +1 -0
  736. app/static/assets/account-status-DIsU5sUS.js +1 -0
  737. app/static/assets/account-trend-chart-BptlfwwQ.js +1 -0
  738. app/static/assets/accounts-page-Bbai8ift.js +3 -0
  739. app/static/assets/api-Dwa7XxPe.js +1 -0
  740. app/static/assets/api-client-dugX1Pti.js +55 -0
  741. app/static/assets/api-key-create-dialog-DnRm0oYN.js +1 -0
  742. app/static/assets/api-key-created-dialog-B6jkDG9f.js +1 -0
  743. app/static/assets/api-key-edit-dialog-Ck3Bnc3V.js +1 -0
  744. app/static/assets/api-trend-chart-BchCw7Hj.js +1 -0
  745. app/static/assets/apis-page-BvXz9c6i.js +2 -0
  746. app/static/assets/arrow-up-Dqh_KzJo.js +1 -0
  747. app/static/assets/arrow-up-down-LBRgVDGY.js +1 -0
  748. app/static/assets/automations-page-DQgNAJOR.js +3 -0
  749. app/static/assets/badge-DqMb9es0.js +1 -0
  750. app/static/assets/blur-email-HEvKagG2.js +1 -0
  751. app/static/assets/button-BjVmmiGW.js +1 -0
  752. app/static/assets/checkbox-apsl9vzk.js +1 -0
  753. app/static/assets/chevron-left-1d_pHVa5.js +1 -0
  754. app/static/assets/circle-alert-BS0xd_o1.js +1 -0
  755. app/static/assets/clsx-DB0hHKMi.js +1 -0
  756. app/static/assets/colors-BBy8GEtr.js +1 -0
  757. app/static/assets/copy-button-D7nAvOKR.js +1 -0
  758. app/static/assets/cost-per-day-chart-YdqlkZVM.js +1 -0
  759. app/static/assets/createLucideIcon-DBLzLNh2.js +1 -0
  760. app/static/assets/dashboard-page-CSdhBy0f.js +2 -0
  761. app/static/assets/distribution-metric-format-yZTy1ZEu.js +1 -0
  762. app/static/assets/donut-chart-Bxc69cra.js +1 -0
  763. app/static/assets/download-kQteIcsB.js +1 -0
  764. app/static/assets/ellipsis-B_5OgIre.js +1 -0
  765. app/static/assets/empty-state-JcA7tc8m.js +1 -0
  766. app/static/assets/es2015-bMH8YKZT.js +41 -0
  767. app/static/assets/es6-B264ni6W.js +69 -0
  768. app/static/assets/external-link-UVAOgMQ0.js +1 -0
  769. app/static/assets/i18n-BWqZ9Ua2.js +1 -0
  770. app/static/assets/inbox-B_RM2s1J.js +1 -0
  771. app/static/assets/index-DIpd264Z.js +23 -0
  772. app/static/assets/index-DMeLKRJx.css +2 -0
  773. app/static/assets/inherit-badge-QhTYVaU6.js +1 -0
  774. app/static/assets/invite-dialog-0CYh0GiQ.js +1 -0
  775. app/static/assets/iso-Bpe5Ihbb.js +1 -0
  776. app/static/assets/label-CGaLmLNf.js +1 -0
  777. app/static/assets/lazy-recharts-Pv8p9ArM.js +2 -0
  778. app/static/assets/loading-overlay-CzKQfHLI.js +1 -0
  779. app/static/assets/mini-quota-bar-cGT_t8Ae.js +1 -0
  780. app/static/assets/model-distribution-donut-BKjAfT48.js +1 -0
  781. app/static/assets/model-source-multi-select-D2d06Vc7.js +1 -0
  782. app/static/assets/multi-select-filter-KIA5qU6Z.js +1 -0
  783. app/static/assets/oauth-dialog-XeaGGDjS.js +1 -0
  784. app/static/assets/pagination-controls-D1Ypd0RU.js +1 -0
  785. app/static/assets/payload-CIYnGZz9.js +1 -0
  786. app/static/assets/queue-wait-chart-VoV7Yg9L.js +1 -0
  787. app/static/assets/report-chart-card-BXDliwcc.js +1 -0
  788. app/static/assets/reports-page-CGCJeMHG.js +3 -0
  789. app/static/assets/reset-credit-confirm-dialog-QOifTnVB.js +1 -0
  790. app/static/assets/rolldown-runtime-hePW80VL.js +1 -0
  791. app/static/assets/search-HfhqwERt.js +1 -0
  792. app/static/assets/select-Cl33bz-g.js +1 -0
  793. app/static/assets/settings-page-mZj01HYl.js +2 -0
  794. app/static/assets/shim-CZwyM4Q7.js +1 -0
  795. app/static/assets/skeleton-C_EUc4Rp.js +1 -0
  796. app/static/assets/sparkline-chart-DdNNsddM.js +1 -0
  797. app/static/assets/status-badge-CHHA5X6c.js +1 -0
  798. app/static/assets/switch-CzxgokcM.js +1 -0
  799. app/static/assets/table-DXaNSQ0G.js +1 -0
  800. app/static/assets/time-to-first-token-chart--68L0u_v.js +1 -0
  801. app/static/assets/tokens-per-day-chart-Cs82BFuE.js +1 -0
  802. app/static/assets/tokens-per-second-chart-AD2dfOn6.js +1 -0
  803. app/static/assets/totp-settings-CRHtxQ7j.js +1 -0
  804. app/static/assets/trash-D3KyWr1h.js +1 -0
  805. app/static/assets/use-account-quota-display-BPmrTBTC.js +1 -0
  806. app/static/assets/use-accounts-PWlVGw3z.js +1 -0
  807. app/static/assets/use-auth-CuDlW3iC.js +1 -0
  808. app/static/assets/use-chart-colors-DIu6tClI.js +1 -0
  809. app/static/assets/use-model-sources-Bul24JBu.js +1 -0
  810. app/static/assets/use-models-DUCPUuZg.js +1 -0
  811. app/static/assets/use-reduced-motion-hAm5r6_d.js +1 -0
  812. app/static/assets/useTranslation--56nHhlH.js +1 -0
  813. app/static/assets/useragent-distribution-donut-Dup6sf_n.js +1 -0
  814. app/static/assets/users-uIC3TIlE.js +1 -0
  815. app/static/assets/vendor-query-_bHZuxEx.js +1 -0
  816. app/static/assets/vendor-react-BVL0YZPW.js +9 -0
  817. app/static/favicon.svg +10 -0
  818. app/static/fonts/GeistSans-Variable.woff2 +0 -0
  819. app/static/fonts/jetbrains-mono-latin-ext.woff2 +0 -0
  820. app/static/fonts/jetbrains-mono-latin.woff2 +0 -0
  821. app/static/index.html +29 -0
  822. codexlb_up-1.25.0b10.dist-info/METADATA +124 -0
  823. codexlb_up-1.25.0b10.dist-info/RECORD +827 -0
  824. codexlb_up-1.25.0b10.dist-info/WHEEL +4 -0
  825. codexlb_up-1.25.0b10.dist-info/entry_points.txt +3 -0
  826. codexlb_up-1.25.0b10.dist-info/licenses/LICENSE +21 -0
  827. config/additional_quota_registry.json +11 -0
@@ -0,0 +1,1054 @@
1
+ """Account management: invite, edit, disable (with the owned-key cascade), delete, invite lifecycle.
2
+
3
+ Every mutation is attributed to the calling principal (``AuditActor``), bumps
4
+ the ``dashboard_users`` cache namespace so peers drop their copy, and applies
5
+ the invariants in one place: no self role/status change, at least one active
6
+ admin preset, delegation subset checks, and the credential-required rule.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import hashlib
12
+ import secrets
13
+ import uuid
14
+ from collections.abc import Sequence
15
+ from dataclasses import dataclass
16
+ from datetime import UTC, datetime, timedelta
17
+
18
+ from sqlalchemy.exc import IntegrityError
19
+
20
+ import app.modules.dashboard_users.repository as users_repository
21
+ from app.core.audit.service import AuditActor, AuditDetails, AuditService, AuditSeverity, AuditTarget
22
+ from app.core.auth.api_key_cache import get_api_key_cache
23
+ from app.core.auth.dashboard_access import (
24
+ PRESET_ROLE_IDS,
25
+ DashboardPrincipal,
26
+ PresetRoleSlug,
27
+ assert_can_act_on,
28
+ assert_can_delegate,
29
+ )
30
+ from app.core.auth.dashboard_users_cache import get_dashboard_users_cache
31
+ from app.core.auth.providers.registry import get_auth_provider_registry
32
+ from app.core.cache.invalidation import NAMESPACE_API_KEY, get_cache_invalidation_poller
33
+ from app.core.config.settings import get_settings
34
+ from app.core.utils.time import utcnow
35
+ from app.db.models import (
36
+ COMPAT_ADMIN_USERNAME,
37
+ AuthProviderKind,
38
+ DashboardRoleRecord,
39
+ DashboardUser,
40
+ DashboardUserInvite,
41
+ DashboardUserRoleSource,
42
+ DashboardUserStatus,
43
+ )
44
+ from app.modules.dashboard_auth.repository import DashboardAuthRepository
45
+ from app.modules.dashboard_roles.repository import DashboardRolesRepository
46
+ from app.modules.dashboard_roles.service import resolve_assignable_role, resolve_role_grants
47
+ from app.modules.dashboard_users.break_glass import (
48
+ BreakGlassRoleRequiredError,
49
+ LastBreakGlassProtectedError,
50
+ assert_break_glass_remains,
51
+ is_admin_preset,
52
+ )
53
+ from app.modules.dashboard_users.credentials import assert_credential_remains
54
+ from app.modules.dashboard_users.repository import (
55
+ DashboardUsersRepository,
56
+ is_valid_email,
57
+ is_valid_username,
58
+ normalize_email,
59
+ normalize_username,
60
+ )
61
+ from app.modules.dashboard_users.schemas import (
62
+ DashboardUserCreateRequest,
63
+ DashboardUserUpdateRequest,
64
+ ExpectedIdentityRequest,
65
+ ProfileUpdateRequest,
66
+ )
67
+
68
+ INVITE_TTL = timedelta(hours=24)
69
+ _AUTH_METHOD_PASSWORD = "password"
70
+
71
+
72
+ class AdminAccountRequiredError(ValueError):
73
+ pass
74
+
75
+
76
+ class UserNotFoundError(LookupError):
77
+ pass
78
+
79
+
80
+ class UsernameTakenError(ValueError):
81
+ pass
82
+
83
+
84
+ class EmailTakenError(ValueError):
85
+ pass
86
+
87
+
88
+ class InvalidUsernameError(ValueError):
89
+ pass
90
+
91
+
92
+ class InvalidEmailError(ValueError):
93
+ pass
94
+
95
+
96
+ class SelfModificationForbiddenError(ValueError):
97
+ pass
98
+
99
+
100
+ class LastAdminProtectedError(ValueError):
101
+ pass
102
+
103
+
104
+ class InviteNotPendingError(ValueError):
105
+ pass
106
+
107
+
108
+ class InvitePendingError(ValueError):
109
+ pass
110
+
111
+
112
+ class InviteNotFoundError(LookupError):
113
+ pass
114
+
115
+
116
+ class UsernameLockedError(ValueError):
117
+ pass
118
+
119
+
120
+ class UserNotActiveError(ValueError):
121
+ pass
122
+
123
+
124
+ class RoleManagedExternallyError(ValueError):
125
+ pass
126
+
127
+
128
+ class ForceWithoutRoleChangeError(ValueError):
129
+ pass
130
+
131
+
132
+ class SsoNotAvailableError(ValueError):
133
+ pass
134
+
135
+
136
+ class IdentityTakenError(ValueError):
137
+ pass
138
+
139
+
140
+ class SsoOnlyInviteError(ValueError):
141
+ pass
142
+
143
+
144
+ @dataclass(frozen=True, slots=True)
145
+ class IssuedInvite:
146
+ token: str
147
+ expires_at: datetime
148
+
149
+
150
+ @dataclass(frozen=True, slots=True)
151
+ class CreatedAccount:
152
+ """A pre-created account and its invite; the token is handed out only when ``sso_only`` is false."""
153
+
154
+ user: DashboardUser
155
+ invite: IssuedInvite
156
+ sso_only: bool
157
+
158
+
159
+ @dataclass(frozen=True, slots=True)
160
+ class InviteDescription:
161
+ role_name: str
162
+ inviter_display_name: str | None
163
+ suggested_username: str
164
+ username_locked: bool
165
+ expires_at: datetime
166
+
167
+
168
+ @dataclass(frozen=True, slots=True)
169
+ class UserListing:
170
+ user: DashboardUser
171
+ pending_invite: DashboardUserInvite | None
172
+
173
+
174
+ def _now() -> datetime:
175
+ # Looked up through the module so one patched clock drives the service and the counts alike.
176
+ return users_repository.utc_now()
177
+
178
+
179
+ def as_utc(value: datetime) -> datetime:
180
+ """Rows come back naive on SQLite; they were written as UTC."""
181
+
182
+ return value.replace(tzinfo=UTC) if value.tzinfo is None else value.astimezone(UTC)
183
+
184
+
185
+ def invite_token_hash(token: str) -> bytes:
186
+ return hashlib.sha256(token.encode("utf-8")).digest()
187
+
188
+
189
+ def _clean(value: str | None) -> str | None:
190
+ cleaned = (value or "").strip()
191
+ return cleaned or None
192
+
193
+
194
+ def _is_active(user: DashboardUser) -> bool:
195
+ return user.status == DashboardUserStatus.ACTIVE.value
196
+
197
+
198
+ def _is_admin_preset(user: DashboardUser) -> bool:
199
+ return is_admin_preset(user.role_id)
200
+
201
+
202
+ def _user_actor(user: DashboardUser) -> AuditActor:
203
+ return AuditActor(
204
+ user_id=user.id, username=user.username, role_slug=user.role.slug, auth_method=_AUTH_METHOD_PASSWORD
205
+ )
206
+
207
+
208
+ class DashboardUsersService:
209
+ def __init__(
210
+ self,
211
+ repository: DashboardUsersRepository,
212
+ roles: DashboardRolesRepository,
213
+ auth_repository: DashboardAuthRepository,
214
+ ) -> None:
215
+ self._repo = repository
216
+ self._roles = roles
217
+ self._auth = auth_repository
218
+
219
+ # --- reads ---
220
+
221
+ async def list_users(self) -> list[UserListing]:
222
+ await self._purge_expired()
223
+ now = _now()
224
+ invites = {invite.user_id: invite for invite in await self._repo.list_live_invites(now)}
225
+ return [UserListing(user=user, pending_invite=invites.get(user.id)) for user in await self._repo.list_users()]
226
+
227
+ async def list_pending_invites(self) -> Sequence[DashboardUserInvite]:
228
+ await self._purge_expired()
229
+ return await self._repo.list_live_invites(_now())
230
+
231
+ # --- account lifecycle ---
232
+
233
+ async def create_user(
234
+ self, principal: DashboardPrincipal, payload: DashboardUserCreateRequest, *, actor_ip: str | None
235
+ ) -> CreatedAccount:
236
+ """Pre-create an account. With a link (the default) the person sets a password;
237
+ SSO-only accounts get no link and are activated by their first provider sign-in
238
+ matching ``expected_identity`` exactly."""
239
+
240
+ caller_id = self._require_account(principal)
241
+ await self._purge_expired()
242
+ username = self._new_username(payload.username)
243
+ email = self._normalized_email(payload.email)
244
+ role = await self._assignable_role(payload.role_id)
245
+ assert_can_delegate(principal.grants, resolve_role_grants(role))
246
+ expected = await self._expected_identity(payload)
247
+ if await self._repo.get_by_username(username) is not None:
248
+ raise UsernameTakenError("Username is already taken")
249
+ if email is not None and await self._repo.get_by_email(email) is not None:
250
+ raise EmailTakenError("E-mail is already in use")
251
+ user = DashboardUser(
252
+ id=str(uuid.uuid4()),
253
+ username=username,
254
+ display_name=_clean(payload.display_name),
255
+ email=email,
256
+ role_id=role.id,
257
+ role_source=DashboardUserRoleSource.MANUAL.value,
258
+ status=DashboardUserStatus.INVITED.value,
259
+ created_by_user_id=caller_id,
260
+ )
261
+ issued, invite = self._new_invite(
262
+ user.id,
263
+ created_by_user_id=caller_id,
264
+ username_locked=payload.username_locked,
265
+ expires_at=_now() + INVITE_TTL,
266
+ )
267
+ invite.sso_only = payload.sso_only
268
+ if expected is not None:
269
+ invite.expected_provider = expected.provider
270
+ invite.expected_provider_key = expected.provider_key
271
+ invite.expected_subject = expected.subject
272
+ role_slug = role.slug
273
+ self._repo.add(user, invite)
274
+ try:
275
+ user = await self._repo.commit_user(user.id)
276
+ except IntegrityError as exc:
277
+ conflict = await self._repo.conflicting_field(username, email)
278
+ if conflict == "email":
279
+ raise EmailTakenError("E-mail is already in use") from exc
280
+ if conflict is None and expected is not None:
281
+ # The partial unique index on the open expected identity fired: a concurrent create won.
282
+ raise IdentityTakenError("Another pending account already waits for that identity") from exc
283
+ raise UsernameTakenError("Username is already taken") from exc
284
+ await self._invalidate_users()
285
+ self._audit("user_created", principal, user.id, actor_ip, {"username": user.username, "role": role_slug})
286
+ invited: AuditDetails = {"sso_only": payload.sso_only}
287
+ if not payload.sso_only:
288
+ invited = {**invited, "expires_at": issued.expires_at.isoformat()}
289
+ if expected is not None:
290
+ invited = {**invited, "expected_provider": expected.provider, "expected_subject": expected.subject}
291
+ self._audit("user_invited", principal, user.id, actor_ip, invited)
292
+ return CreatedAccount(user=user, invite=issued, sso_only=payload.sso_only)
293
+
294
+ @staticmethod
295
+ def _new_username(raw: str) -> str:
296
+ """Normalise and validate a username chosen for a person; ``admin`` stays the break-glass account's.
297
+
298
+ The reservation is a rule about the *name*: the bootstrapped account
299
+ may be renamed away from it, and no account -- including that one --
300
+ may take it afterwards, so the name the recovery runbooks use can never
301
+ come to mean somebody else.
302
+ """
303
+
304
+ username = normalize_username(raw)
305
+ if not is_valid_username(username):
306
+ raise InvalidUsernameError("Username must be 1-64 characters of a-z, 0-9, '.', '_' or '-'")
307
+ if username == COMPAT_ADMIN_USERNAME:
308
+ raise InvalidUsernameError("'admin' is reserved for the local break-glass account")
309
+ return username
310
+
311
+ @classmethod
312
+ def _renamed_username(
313
+ cls, user: DashboardUser, payload: DashboardUserUpdateRequest, fields: set[str]
314
+ ) -> str | None:
315
+ """The normalised new name, or ``None`` when the request does not rename."""
316
+
317
+ if "username" not in fields:
318
+ return None
319
+ if payload.username is None:
320
+ raise InvalidUsernameError("A username cannot be cleared")
321
+ username = cls._new_username(payload.username)
322
+ return None if username == user.username else username
323
+
324
+ async def _expected_identity(self, payload: DashboardUserCreateRequest) -> ExpectedIdentityRequest | None:
325
+ """Validate the SSO fields: they need an active non-password provider, and the
326
+ identity must not be linked yet. Trusted-header subjects are case-folded like the
327
+ resolver does, so the first sign-in matches regardless of the proxy's spelling."""
328
+
329
+ expected = payload.expected_identity
330
+ if not payload.sso_only and expected is None:
331
+ return None
332
+ if expected is None:
333
+ raise InvalidUsernameError("An SSO-only account needs the identity it will sign in with")
334
+ mode = get_settings().dashboard_auth_mode
335
+ active = {
336
+ (item.row.kind, item.row.provider_key)
337
+ for item in await get_auth_provider_registry().get_active_providers(mode)
338
+ if item.row.kind != AuthProviderKind.PASSWORD.value
339
+ }
340
+ if (expected.provider, expected.provider_key) not in active:
341
+ raise SsoNotAvailableError("No sign-in provider other than the password is active")
342
+ subject = expected.subject.strip()
343
+ if expected.provider == AuthProviderKind.TRUSTED_HEADER.value:
344
+ subject = subject.casefold()
345
+ if not subject:
346
+ raise InvalidUsernameError("The expected identity must not be empty")
347
+ if await self._repo.get_identity(expected.provider, expected.provider_key, subject) is not None:
348
+ raise IdentityTakenError("That identity already belongs to an account")
349
+ if await self._repo.find_invite_expecting_identity(expected.provider, expected.provider_key, subject, _now()):
350
+ raise IdentityTakenError("Another pending account already waits for that identity")
351
+ return ExpectedIdentityRequest(provider=expected.provider, provider_key=expected.provider_key, subject=subject)
352
+
353
+ async def update_user(
354
+ self, principal: DashboardPrincipal, user_id: str, payload: DashboardUserUpdateRequest, *, actor_ip: str | None
355
+ ) -> UserListing:
356
+ """Rules, in this order: self, invite pending, externally managed role,
357
+ delegation (new role), act-on (current role), last admin, last
358
+ qualifying break-glass, credential required. The account the install
359
+ bootstrapped is subject to exactly these and to nothing else."""
360
+
361
+ caller_id = self._require_account(principal)
362
+ await self._purge_expired()
363
+ await self._repo.acquire_write_intent()
364
+ user = await self._get(user_id)
365
+ is_self = user.id == caller_id
366
+ fields = payload.model_fields_set
367
+ role_changes = payload.role_id is not None and payload.role_id != user.role_id
368
+ new_status = payload.status if payload.status is not None and payload.status != user.status else None
369
+ designation = (
370
+ payload.is_break_glass
371
+ if payload.is_break_glass is not None and payload.is_break_glass != user.is_break_glass
372
+ else None
373
+ )
374
+ # A rename is not a role or status change: it is allowed on the
375
+ # caller's own account and never moves ``session_generation``. It is
376
+ # validated up front so a taken or reserved name is refused before any
377
+ # other field is applied.
378
+ new_username = self._renamed_username(user, payload, fields)
379
+ if new_username is not None and await self._repo.get_by_username(new_username) is not None:
380
+ raise UsernameTakenError("Username is already taken")
381
+ if (role_changes or new_status is not None) and is_self:
382
+ raise SelfModificationForbiddenError("You cannot change your own role or status")
383
+ if new_status is not None and user.status == DashboardUserStatus.INVITED.value:
384
+ raise InvitePendingError("The account has not accepted its invite yet; revoke the invite instead")
385
+ if payload.force and not role_changes:
386
+ raise ForceWithoutRoleChangeError("force only applies to a role change")
387
+ # A role a sign-in provider manages is only edited on purpose: without
388
+ # ``force`` the next sign-in would silently move it back.
389
+ overridden_source = (
390
+ user.role_source if role_changes and user.role_source != DashboardUserRoleSource.MANUAL.value else None
391
+ )
392
+ if overridden_source is not None and not payload.force:
393
+ raise RoleManagedExternallyError(
394
+ "That account's role is managed by its sign-in method; repeat with force to take it over"
395
+ )
396
+ designation_takes_over = designation is True and user.role_source != DashboardUserRoleSource.MANUAL.value
397
+ if overridden_source is None and designation_takes_over:
398
+ # Designating an emergency account takes its role over by hand;
399
+ # it must not be a role the next sign-in can move.
400
+ overridden_source = user.role_source
401
+ new_role: DashboardRoleRecord | None = None
402
+ if role_changes:
403
+ assert payload.role_id is not None
404
+ new_role = await self._assignable_role(payload.role_id)
405
+ assert_can_delegate(principal.grants, resolve_role_grants(new_role))
406
+ if not is_self:
407
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
408
+ role_id_after = new_role.id if new_role is not None else user.role_id
409
+ status_after = new_status or user.status
410
+ # The designation says "this account is the way in when the identity
411
+ # provider is not": it is meaningless on any other role, and it must
412
+ # never be a role a provider can re-evaluate away. Asking for it on a
413
+ # non-admin is a mistake; a role change that moves a designated
414
+ # account off admin simply drops it -- and then meets the guard below.
415
+ if designation is True and not is_admin_preset(role_id_after):
416
+ raise BreakGlassRoleRequiredError("Only an admin account can be an emergency (break-glass) account")
417
+ designation_after = (user.is_break_glass if designation is None else designation) and is_admin_preset(
418
+ role_id_after
419
+ )
420
+ leaves_admin = (
421
+ _is_active(user)
422
+ and _is_admin_preset(user)
423
+ and not (role_id_after == PRESET_ROLE_IDS[PresetRoleSlug.ADMIN] and status_after == "active")
424
+ )
425
+ if leaves_admin:
426
+ await self._assert_other_active_admin(user.id)
427
+ # One guard, whatever the field: demoting, disabling and clearing the
428
+ # designation are the same question to the install.
429
+ loses_break_glass = await self.assert_break_glass_remains(
430
+ user, role_id=role_id_after, status=status_after, is_break_glass=designation_after
431
+ )
432
+ if new_status == DashboardUserStatus.ACTIVE.value:
433
+ assert_credential_remains(
434
+ password_hash=user.password_hash,
435
+ identity_count=await self._repo.count_identities(user.id),
436
+ solo_install=False,
437
+ )
438
+
439
+ old_role_slug = user.role.slug
440
+ old_username = user.username
441
+ new_role_slug = new_role.slug if new_role is not None else None
442
+ key_hashes: list[str] = []
443
+ try:
444
+ profile_changed = await self._apply_profile(user, payload, fields)
445
+ if new_username is not None:
446
+ user.username = new_username
447
+ if new_status == DashboardUserStatus.DISABLED.value:
448
+ key_hashes = await self._repo.deactivate_owned_keys(user.id)
449
+ if overridden_source is not None or designation_after:
450
+ # Taken over by hand (or designated): no later re-evaluation
451
+ # moves this role again -- which is what makes the mapping
452
+ # exemption a fact rather than a check.
453
+ user.role_source = DashboardUserRoleSource.MANUAL.value
454
+ if leaves_admin or loses_break_glass:
455
+ # The invariants are part of the write: the row only changes
456
+ # while another active admin (and, once local sign-in is
457
+ # restricted, another qualifying emergency account) exists at
458
+ # the moment of the UPDATE.
459
+ if not await self._repo.update_role_status_guarded(
460
+ user.id,
461
+ role_id=role_id_after,
462
+ status=status_after,
463
+ is_break_glass=designation_after,
464
+ require_other_admin=leaves_admin,
465
+ require_other_break_glass=loses_break_glass,
466
+ ):
467
+ await self._repo.rollback()
468
+ if leaves_admin and await self._repo.count_active_admins(exclude_user_id=user.id) == 0:
469
+ raise LastAdminProtectedError("At least one active admin account must remain")
470
+ raise LastBreakGlassProtectedError(
471
+ "This is the only emergency account that can still sign in while local sign-in is "
472
+ "restricted; designate another admin with two-factor first"
473
+ )
474
+ else:
475
+ user.role_id = role_id_after
476
+ user.status = status_after
477
+ user.is_break_glass = designation_after
478
+ bump = new_role is not None or new_status == DashboardUserStatus.DISABLED.value
479
+ user = await self._repo.commit_user(user.id, bump_generation=bump)
480
+ except IntegrityError as exc:
481
+ await self._repo.rollback()
482
+ # A concurrent writer took the name or the address between the
483
+ # pre-check and this commit; the unique index says which.
484
+ if new_username is not None and await self._repo.conflicting_field(new_username, None) == "username":
485
+ raise UsernameTakenError("Username is already taken") from exc
486
+ raise EmailTakenError("E-mail is already in use") from exc
487
+ await self._invalidate_users()
488
+ await self._invalidate_api_keys(key_hashes)
489
+
490
+ if new_username is not None:
491
+ self._audit(
492
+ "user_renamed",
493
+ principal,
494
+ user.id,
495
+ actor_ip,
496
+ {"username": user.username, "from": old_username, "to": user.username},
497
+ )
498
+ if profile_changed or designation is not None:
499
+ self._audit(
500
+ "user_updated",
501
+ principal,
502
+ user.id,
503
+ actor_ip,
504
+ {"username": user.username, "is_break_glass": user.is_break_glass}
505
+ if designation is not None
506
+ else {"username": user.username},
507
+ )
508
+ if new_role is not None:
509
+ self._audit(
510
+ "user_role_changed",
511
+ principal,
512
+ user.id,
513
+ actor_ip,
514
+ {"username": user.username, "from": old_role_slug, "to": new_role_slug},
515
+ )
516
+ if overridden_source is not None:
517
+ self._audit(
518
+ "role_source_overridden",
519
+ principal,
520
+ user.id,
521
+ actor_ip,
522
+ {
523
+ "username": user.username,
524
+ "from_source": overridden_source,
525
+ "to_source": DashboardUserRoleSource.MANUAL.value,
526
+ "provider": await self._repo.primary_identity_provider(user.id),
527
+ },
528
+ )
529
+ if new_status == DashboardUserStatus.DISABLED.value:
530
+ self._audit("user_disabled", principal, user.id, actor_ip, {"username": user.username})
531
+ self._audit("user_keys_deactivated", principal, user.id, actor_ip, {"count": len(key_hashes)})
532
+ elif new_status == DashboardUserStatus.ACTIVE.value:
533
+ self._audit("user_enabled", principal, user.id, actor_ip, {"username": user.username})
534
+ return UserListing(user=user, pending_invite=await self._repo.live_invite_for_user(user.id, _now()))
535
+
536
+ async def update_profile(
537
+ self, user: DashboardUser, payload: ProfileUpdateRequest, *, actor_ip: str | None
538
+ ) -> DashboardUser:
539
+ """Self-service edit: display name and e-mail only, audited as the account itself."""
540
+
541
+ user = await self._get(user.id)
542
+ changed = await self._apply_profile(user, payload, payload.model_fields_set)
543
+ try:
544
+ user = await self._repo.commit_user(user.id)
545
+ except IntegrityError as exc:
546
+ raise EmailTakenError("E-mail is already in use") from exc
547
+ if changed:
548
+ await self._invalidate_users()
549
+ AuditService.log_async(
550
+ "user_updated",
551
+ actor_ip=actor_ip,
552
+ details={"username": user.username, "self": True},
553
+ actor=_user_actor(user),
554
+ target=AuditTarget("user", user.id),
555
+ )
556
+ return user
557
+
558
+ async def delete_user(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
559
+ caller_id = self._require_account(principal)
560
+ await self._purge_expired()
561
+ await self._repo.acquire_write_intent()
562
+ user = await self._get(user_id)
563
+ if user.id == caller_id:
564
+ raise SelfModificationForbiddenError("You cannot delete your own account")
565
+ counts_as_admin = _is_active(user) and _is_admin_preset(user)
566
+ if counts_as_admin:
567
+ await self._assert_other_active_admin(user.id)
568
+ counts_as_break_glass = await self.assert_break_glass_remains(user, is_break_glass=False)
569
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
570
+ details: AuditDetails = {"username": user.username, "role": user.role.slug}
571
+ key_hashes = await self._repo.delete_user(
572
+ user, require_other_admin=counts_as_admin, require_other_break_glass=counts_as_break_glass
573
+ )
574
+ if key_hashes is None:
575
+ if counts_as_admin and await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
576
+ raise LastAdminProtectedError("At least one active admin account must remain")
577
+ raise LastBreakGlassProtectedError(
578
+ "This is the only emergency account that can still sign in while local sign-in is restricted; "
579
+ "designate another admin with two-factor first"
580
+ )
581
+ await self._invalidate_users()
582
+ await self._invalidate_api_keys(key_hashes)
583
+ self._audit("user_deleted", principal, user_id, actor_ip, details)
584
+ if key_hashes:
585
+ self._audit("user_keys_deactivated", principal, user_id, actor_ip, {"count": len(key_hashes)})
586
+
587
+ # --- the break-glass invariant (one guard, every mutation) ---
588
+
589
+ async def assert_break_glass_remains(
590
+ self,
591
+ user: DashboardUser,
592
+ *,
593
+ role_id: str | None = None,
594
+ status: str | None = None,
595
+ is_break_glass: bool | None = None,
596
+ has_totp: bool | None = None,
597
+ has_password: bool | None = None,
598
+ ) -> bool:
599
+ """Refuse a change that would leave no qualifying emergency account (PLAN §4.2).
600
+
601
+ The single entry point for every call site: the role and status
602
+ branches of the account PATCH, deletion, clearing the designation,
603
+ self-service ``/totp/disable`` (through the auth service, which calls
604
+ the same free function), the administrative TOTP reset, and
605
+ :meth:`deactivate_user`. Each keyword is the value the field would
606
+ carry after the write. Returns whether the caller's conditional write
607
+ must re-apply the count (see the free function).
608
+ """
609
+
610
+ settings = await self._auth.get_settings()
611
+ return await assert_break_glass_remains(
612
+ user,
613
+ policy=settings.local_login_policy,
614
+ count_other_qualifying=lambda: self._repo.count_qualifying_break_glass(exclude_user_id=user.id),
615
+ role_id=role_id,
616
+ status=status,
617
+ is_break_glass=is_break_glass,
618
+ has_totp=has_totp,
619
+ has_password=has_password,
620
+ )
621
+
622
+ async def deactivate_user(
623
+ self,
624
+ user_id: str,
625
+ *,
626
+ actor: AuditActor,
627
+ actor_ip: str | None,
628
+ source: str,
629
+ ) -> bool:
630
+ """Disable an account through one back-channel: guard, status, generation, key cascade, audit.
631
+
632
+ This is the shared path for deactivations that do not come from the
633
+ account PATCH — the SCIM ``active=false`` endpoint of Phase 3b and the
634
+ identity resolver — so none of them can bypass the break-glass guard.
635
+ A refusal audits ``scim_deprovision_refused`` next to raising, because
636
+ the caller is a machine whose 409 nobody reads.
637
+
638
+ An account that never accepted its invitation is deactivated rather
639
+ than ignored: its invite is deleted in this same transaction and the
640
+ row moves to ``disabled``. A human revoke deletes such an account
641
+ outright, which a back channel must not do — the caller has to keep
642
+ finding that person by the name it pushed — and an ``sso_only`` invite
643
+ never expires, so ignoring it would leave a way in open forever.
644
+ Returns ``False`` when the account was already inactive (nothing to do,
645
+ nothing audited), which is what makes a redelivered push idempotent.
646
+ """
647
+
648
+ await self._repo.acquire_write_intent()
649
+ user = await self._get(user_id)
650
+ invited = user.status == DashboardUserStatus.INVITED.value
651
+ if not _is_active(user) and not invited:
652
+ return False
653
+ # An invited account is not active, so it counts for neither invariant:
654
+ # the guards below read the same way the account PATCH reads them.
655
+ counts_as_admin = _is_active(user) and _is_admin_preset(user)
656
+ # Read off the row while it is still loaded: a rollback below expires
657
+ # every attribute, and reading one back then is synchronous IO in an
658
+ # async context — the refusal would surface as a driver error.
659
+ username = user.username
660
+ role_id = user.role_id
661
+ try:
662
+ guarded = await self.assert_break_glass_remains(user, status=DashboardUserStatus.DISABLED.value)
663
+ except LastBreakGlassProtectedError:
664
+ self._audit_deprovision_refused(user_id, username, actor=actor, actor_ip=actor_ip, source=source)
665
+ raise
666
+ if counts_as_admin:
667
+ await self._assert_other_active_admin(user_id)
668
+ key_hashes = await self._repo.deactivate_owned_keys(user_id)
669
+ invite_deleted = await self._repo.delete_invite(user_id) if invited else False
670
+ if not await self._repo.update_role_status_guarded(
671
+ user_id,
672
+ role_id=role_id,
673
+ status=DashboardUserStatus.DISABLED.value,
674
+ require_other_admin=counts_as_admin,
675
+ require_other_break_glass=guarded,
676
+ ):
677
+ # Which invariant actually lost is a re-read, not a guess: both
678
+ # predicates rode into the one UPDATE, and naming the wrong one
679
+ # sends the operator to fix an account that was never the problem.
680
+ await self._repo.rollback()
681
+ if counts_as_admin and await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
682
+ raise LastAdminProtectedError("At least one active admin account must remain")
683
+ self._audit_deprovision_refused(user_id, username, actor=actor, actor_ip=actor_ip, source=source)
684
+ raise LastBreakGlassProtectedError(
685
+ "This is the only emergency account that can still sign in while local sign-in is restricted; "
686
+ "designate another admin with two-factor first"
687
+ )
688
+ await self._repo.commit_user(user_id, bump_generation=True)
689
+ await self._invalidate_users()
690
+ await self._invalidate_api_keys(key_hashes)
691
+ AuditService.log_async(
692
+ "user_disabled",
693
+ actor_ip=actor_ip,
694
+ details={"username": username, "source": source},
695
+ actor=actor,
696
+ target=AuditTarget("user", user_id),
697
+ )
698
+ AuditService.log_async(
699
+ "user_keys_deactivated",
700
+ actor_ip=actor_ip,
701
+ details={"count": len(key_hashes), "source": source},
702
+ actor=actor,
703
+ target=AuditTarget("user", user_id),
704
+ )
705
+ if invite_deleted:
706
+ # The same action the management side writes when an invitation
707
+ # stops being usable, so one search answers "when did this link
708
+ # die" whoever killed it.
709
+ AuditService.log_async(
710
+ "invite_revoked",
711
+ actor_ip=actor_ip,
712
+ details={"username": username, "source": source},
713
+ actor=actor,
714
+ target=AuditTarget("user", user_id),
715
+ )
716
+ return True
717
+
718
+ def _audit_deprovision_refused(
719
+ self, user_id: str, username: str, *, actor: AuditActor, actor_ip: str | None, source: str
720
+ ) -> None:
721
+ """One row per refusal, written where the refusal is raised.
722
+
723
+ Both places that raise it are inside :meth:`deactivate_user`, so the
724
+ machine caller that maps the exception to its own envelope adds
725
+ nothing: a second row written there would double-count every refused
726
+ leaver. It takes plain values rather than the row because one caller
727
+ has already rolled the transaction back.
728
+ """
729
+
730
+ AuditService.log_async(
731
+ "scim_deprovision_refused",
732
+ actor_ip=actor_ip,
733
+ details={"username": username, "source": source, "reason": "last_break_glass_protected"},
734
+ actor=actor,
735
+ target=AuditTarget("user", user_id),
736
+ severity=AuditSeverity.WARNING,
737
+ )
738
+
739
+ async def reactivate_user(
740
+ self,
741
+ user_id: str,
742
+ *,
743
+ actor: AuditActor,
744
+ actor_ip: str | None,
745
+ source: str,
746
+ ) -> bool:
747
+ """Re-enable an account through one back-channel: status, commit, then the owner keys.
748
+
749
+ The principal-free twin of :meth:`deactivate_user`, for callers that are
750
+ machines rather than people — the SCIM ``active=true`` push. Fabricating
751
+ a :class:`DashboardPrincipal` to reuse the administrative
752
+ :meth:`reactivate_keys` instead would hand a bearer token a blanket
753
+ ``assert_can_act_on`` bypass over every account on the install, which is
754
+ exactly the escalation this separation exists to prevent.
755
+
756
+ The two halves are ordered, not merged: the restoring ``UPDATE`` reads
757
+ the owner's status in an ``EXISTS`` predicate, so the status flip has to
758
+ be committed before it runs or it would restore nothing. Only keys the
759
+ owner cascade turned off come back; an administrator's explicit revoke
760
+ (``manual``) and an expiry are never resurrected. Returns ``False`` when
761
+ the account was already active (nothing written, nothing audited).
762
+ """
763
+
764
+ await self._repo.acquire_write_intent()
765
+ user = await self._get(user_id)
766
+ if _is_active(user):
767
+ return False
768
+ if user.status == DashboardUserStatus.INVITED.value:
769
+ raise InvitePendingError("The account has not accepted its invitation yet")
770
+ username = user.username
771
+ user.status = DashboardUserStatus.ACTIVE.value
772
+ await self._repo.commit_user(user.id)
773
+ await self._invalidate_users()
774
+ AuditService.log_async(
775
+ "user_enabled",
776
+ actor_ip=actor_ip,
777
+ details={"username": username, "source": source},
778
+ actor=actor,
779
+ target=AuditTarget("user", user_id),
780
+ )
781
+ key_hashes = await self._repo.reactivate_owner_disabled_keys(user.id)
782
+ if key_hashes:
783
+ await self._invalidate_api_keys(key_hashes)
784
+ AuditService.log_async(
785
+ "user_keys_reactivated",
786
+ actor_ip=actor_ip,
787
+ details={"count": len(key_hashes), "source": source},
788
+ actor=actor,
789
+ target=AuditTarget("user", user_id),
790
+ )
791
+ return True
792
+
793
+ # --- invites (management side) ---
794
+
795
+ async def resend_invite(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> IssuedInvite:
796
+ caller_id = self._require_account(principal)
797
+ await self._purge_expired()
798
+ user = await self._get(user_id)
799
+ if user.status != DashboardUserStatus.INVITED.value:
800
+ raise InviteNotPendingError("The account has no pending invite")
801
+ current = await self._repo.get_invite_for_user(user.id)
802
+ if current is not None and current.sso_only:
803
+ raise SsoOnlyInviteError("This account signs in through a provider; there is no link to resend")
804
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
805
+ issued, fresh = self._new_invite(
806
+ user.id, created_by_user_id=caller_id, username_locked=False, expires_at=_now() + INVITE_TTL
807
+ )
808
+ # Conditional on the account still being invited: an acceptance that
809
+ # committed since the read must not have its consumed invite re-armed.
810
+ rotated = await self._repo.rotate_invite(user.id, token_hash=fresh.token_hash, expires_at=fresh.expires_at)
811
+ if not rotated:
812
+ await self._repo.rollback()
813
+ raise InviteNotPendingError("The account has no pending invite")
814
+ user = await self._repo.commit_user(user.id)
815
+ await self._invalidate_users()
816
+ self._audit("invite_resent", principal, user.id, actor_ip, {"username": user.username})
817
+ return issued
818
+
819
+ async def revoke_invite(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
820
+ self._require_account(principal)
821
+ await self._purge_expired()
822
+ user = await self._get(user_id)
823
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
824
+ username = user.username
825
+ if user.status == DashboardUserStatus.INVITED.value:
826
+ # An invited account has no credential, no keys and no sessions: the
827
+ # row goes with the link -- unless an acceptance committed meanwhile.
828
+ if await self._repo.delete_user(user, only_while_invited=True) is None:
829
+ raise InviteNotPendingError("The account has no pending invite")
830
+ else:
831
+ invite = await self._repo.get_invite_for_user(user.id)
832
+ if invite is None or invite.consumed_at is not None or invite.revoked_at is not None:
833
+ raise InviteNotPendingError("The account has no pending invite")
834
+ invite.revoked_at = _now()
835
+ await self._repo.commit_user(user.id)
836
+ await self._invalidate_users()
837
+ self._audit("invite_revoked", principal, user_id, actor_ip, {"username": username})
838
+
839
+ # --- account actions ---
840
+
841
+ async def reset_totp(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
842
+ caller_id = self._require_account(principal)
843
+ await self._purge_expired()
844
+ # Serialised with the other account mutations *before the first read*,
845
+ # exactly as the account PATCH does, and held until the secret write
846
+ # commits: the write has no conditional form, so the lock is the only
847
+ # thing stopping two admins from clearing the last two second factors
848
+ # after both passed the count. Acquiring before the first read also
849
+ # keeps ``BEGIN IMMEDIATE`` on its primary path rather than the
850
+ # in-transaction fallback.
851
+ await self._repo.acquire_write_intent()
852
+ user = await self._get(user_id)
853
+ if user.id == caller_id:
854
+ raise SelfModificationForbiddenError("Disable your own TOTP through /totp/disable")
855
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
856
+ await self.assert_break_glass_remains(user, has_totp=False)
857
+ await self._auth.set_user_totp_secret(user.id, None, bump_generation=True, preserve_policy=True)
858
+ await self._invalidate_users()
859
+ self._audit("user_totp_reset", principal, user.id, actor_ip, {"username": user.username})
860
+
861
+ async def revoke_sessions(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
862
+ self._require_account(principal)
863
+ await self._purge_expired()
864
+ user = await self._get(user_id)
865
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
866
+ await self._auth.bump_session_generation(user.id)
867
+ await self._invalidate_users()
868
+ self._audit(
869
+ "user_sessions_revoked", principal, user.id, actor_ip, {"username": user.username, "scope": "admin"}
870
+ )
871
+
872
+ async def reactivate_keys(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> int:
873
+ self._require_account(principal)
874
+ await self._purge_expired()
875
+ # Serialised with disable (same write-intent lock); the UPDATE itself is
876
+ # also conditional on the owner still being active.
877
+ await self._repo.acquire_write_intent()
878
+ user = await self._get(user_id)
879
+ if not _is_active(user):
880
+ raise UserNotActiveError("Keys can only be restored for an active account")
881
+ assert_can_act_on(principal.grants, resolve_role_grants(user.role))
882
+ key_hashes = await self._repo.reactivate_owner_disabled_keys(user.id)
883
+ if key_hashes is None:
884
+ raise UserNotActiveError("Keys can only be restored for an active account")
885
+ await self._invalidate_api_keys(key_hashes)
886
+ self._audit("user_keys_reactivated", principal, user.id, actor_ip, {"count": len(key_hashes)})
887
+ return len(key_hashes)
888
+
889
+ # --- invites (public side) ---
890
+
891
+ async def describe_invite(self, token: str) -> InviteDescription:
892
+ invite = await self._pending_invite(token)
893
+ inviter = await self._repo.get_by_id(invite.created_by_user_id)
894
+ return InviteDescription(
895
+ role_name=invite.user.role.name,
896
+ inviter_display_name=(inviter.display_name or inviter.username) if inviter is not None else None,
897
+ suggested_username=invite.user.username,
898
+ username_locked=invite.username_locked,
899
+ expires_at=as_utc(invite.expires_at),
900
+ )
901
+
902
+ async def accept_invite(
903
+ self,
904
+ token: str,
905
+ *,
906
+ username: str | None,
907
+ password_hash: str,
908
+ display_name: str | None,
909
+ actor_ip: str | None,
910
+ ) -> DashboardUser:
911
+ """Activate the invited account; the invite is consumed compare-and-set so a link works once."""
912
+
913
+ invite = await self._pending_invite(token)
914
+ user = invite.user
915
+ try:
916
+ if username is not None and normalize_username(username) != user.username:
917
+ if invite.username_locked:
918
+ raise UsernameLockedError("The username of this invite cannot be changed")
919
+ normalized = self._new_username(username)
920
+ if await self._repo.get_by_username(normalized) is not None:
921
+ raise UsernameTakenError("Username is already taken")
922
+ user.username = normalized
923
+ if display_name is not None:
924
+ user.display_name = _clean(display_name)
925
+ user.password_hash = password_hash
926
+ user.status = DashboardUserStatus.ACTIVE.value
927
+ user.last_login_at = utcnow()
928
+ if not await self._repo.consume_invite(invite.id, token_hash=invite_token_hash(token), now=_now()):
929
+ await self._repo.rollback()
930
+ raise InviteNotFoundError("This invite is no longer valid")
931
+ user = await self._repo.commit_user(user.id, bump_generation=True)
932
+ except IntegrityError as exc:
933
+ # The autoflush inside consume_invite (or the commit) hit the unique
934
+ # username: a concurrent create or accept won the name.
935
+ await self._repo.rollback()
936
+ raise UsernameTakenError("Username is already taken") from exc
937
+ await self._invalidate_users()
938
+ AuditService.log_async(
939
+ "invite_accepted",
940
+ actor_ip=actor_ip,
941
+ details={"username": user.username, "role": user.role.slug},
942
+ actor=_user_actor(user),
943
+ target=AuditTarget("user", user.id),
944
+ )
945
+ return user
946
+
947
+ # --- helpers ---
948
+
949
+ async def _pending_invite(self, token: str) -> DashboardUserInvite:
950
+ """Expired, consumed, revoked and unknown tokens are indistinguishable to the caller."""
951
+
952
+ invite = await self._repo.get_invite_by_token_hash(invite_token_hash(token))
953
+ if (
954
+ invite is None
955
+ or invite.sso_only # no link exists for an SSO-only account, whatever the token claims
956
+ or invite.consumed_at is not None
957
+ or invite.revoked_at is not None
958
+ or as_utc(invite.expires_at) <= _now()
959
+ or invite.user.status != DashboardUserStatus.INVITED.value
960
+ ):
961
+ raise InviteNotFoundError("This invite is no longer valid")
962
+ return invite
963
+
964
+ @staticmethod
965
+ def _new_invite(
966
+ user_id: str, *, created_by_user_id: str, username_locked: bool, expires_at: datetime
967
+ ) -> tuple[IssuedInvite, DashboardUserInvite]:
968
+ """A fresh token: the plaintext goes to the caller once, only its hash is stored."""
969
+
970
+ token = secrets.token_urlsafe(32)
971
+ invite = DashboardUserInvite(
972
+ id=str(uuid.uuid4()),
973
+ user_id=user_id,
974
+ token_hash=invite_token_hash(token),
975
+ expires_at=expires_at,
976
+ created_by_user_id=created_by_user_id,
977
+ username_locked=username_locked,
978
+ )
979
+ return IssuedInvite(token=token, expires_at=expires_at), invite
980
+
981
+ async def _purge_expired(self) -> None:
982
+ if await self._repo.purge_expired_invited_users(_now()):
983
+ await self._invalidate_users()
984
+
985
+ async def _get(self, user_id: str) -> DashboardUser:
986
+ user = await self._repo.get_by_id(user_id)
987
+ if user is None:
988
+ raise UserNotFoundError("Account not found")
989
+ return user
990
+
991
+ async def _assignable_role(self, role_id: str) -> DashboardRoleRecord:
992
+ return await resolve_assignable_role(self._roles, role_id)
993
+
994
+ async def _assert_other_active_admin(self, user_id: str) -> None:
995
+ if await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
996
+ raise LastAdminProtectedError("At least one active admin account must remain")
997
+
998
+ async def _apply_profile(
999
+ self, user: DashboardUser, payload: DashboardUserUpdateRequest | ProfileUpdateRequest, fields: set[str]
1000
+ ) -> bool:
1001
+ changed = False
1002
+ if "display_name" in fields and _clean(payload.display_name) != user.display_name:
1003
+ user.display_name = _clean(payload.display_name)
1004
+ changed = True
1005
+ if "email" in fields:
1006
+ email = self._normalized_email(payload.email)
1007
+ if email != user.email:
1008
+ if email is not None:
1009
+ other = await self._repo.get_by_email(email)
1010
+ if other is not None and other.id != user.id:
1011
+ raise EmailTakenError("E-mail is already in use")
1012
+ user.email = email
1013
+ changed = True
1014
+ return changed
1015
+
1016
+ @staticmethod
1017
+ def _normalized_email(value: str | None) -> str | None:
1018
+ email = normalize_email(value)
1019
+ if email is not None and not is_valid_email(email):
1020
+ raise InvalidEmailError("E-mail address is not valid")
1021
+ return email
1022
+
1023
+ @staticmethod
1024
+ def _require_account(principal: DashboardPrincipal) -> str:
1025
+ if principal.user_id is None:
1026
+ raise AdminAccountRequiredError("Set a dashboard password and sign in before managing accounts")
1027
+ return principal.user_id
1028
+
1029
+ @staticmethod
1030
+ def _audit(
1031
+ action: str, principal: DashboardPrincipal, user_id: str, actor_ip: str | None, details: AuditDetails
1032
+ ) -> None:
1033
+ AuditService.log_async(
1034
+ action,
1035
+ actor_ip=actor_ip,
1036
+ details=details,
1037
+ actor=AuditActor.from_principal(principal),
1038
+ target=AuditTarget("user", user_id),
1039
+ )
1040
+
1041
+ @staticmethod
1042
+ async def _invalidate_users() -> None:
1043
+ await get_dashboard_users_cache().invalidate()
1044
+
1045
+ @staticmethod
1046
+ async def _invalidate_api_keys(key_hashes: Sequence[str]) -> None:
1047
+ if not key_hashes:
1048
+ return
1049
+ cache = get_api_key_cache()
1050
+ for key_hash in key_hashes:
1051
+ await cache.invalidate(key_hash)
1052
+ poller = get_cache_invalidation_poller()
1053
+ if poller is not None:
1054
+ await poller.bump(NAMESPACE_API_KEY)